chore: update test configuration and environment variable handling in RAGFlowSharp

Author: fengb3

.github/RELEASE.md

@@ -4,11 +4,13 @@
 
 ## 配置要求
 
-### 1. 设置 NuGet API Key
+### 1. 设置必需的 Secrets
 
 在 GitHub 仓库的 Settings → Secrets and variables → Actions 中添加以下秘钥：
 
 - `NUGET_API_KEY`: 您的 NuGet.org API 密钥
+- `RAGFLOW_API_KEY`: 您的 RAGFlow API 密钥（用于运行测试）
+- `RAGFLOW_BASE_URL`: RAGFlow 服务的基础 URL（例如：http://localhost:8000）
 
 ### 2. 获取 NuGet API Key
 
@@ -50,9 +52,43 @@
 - `.github/workflows/release.yml`: 在创建 Release 时触发，自动发布 NuGet 包
 - `.github/workflows/build-and-test.yml`: 在推送到 main 分支或创建 PR 时触发，进行构建和测试
 
+## 测试配置
+
+### 本地开发
+
+如果您想在本地运行测试，需要设置以下环境变量：
+
+```bash
+# Windows (PowerShell)
+$env:RAGFLOW_API_KEY="your-ragflow-api-key"
+$env:RAGFLOW_BASE_URL="http://localhost:8000"
+
+# Linux/macOS
+export RAGFLOW_API_KEY="your-ragflow-api-key"
+export RAGFLOW_BASE_URL="http://localhost:8000"
+```
+
+或者在 `RAGFlowSharp.Test/appsettings.json` 中直接配置：
+
+```json
+{
+  "RAGFlowSharp": {
+    "BaseUrl": "http://localhost:8000",
+    "ApiKey": "your-ragflow-api-key"
+  }
+}
+```
+
+**注意：** 为了安全起见，请不要将真实的 API 密钥提交到代码仓库中。
+
+### CI/CD 测试
+
+GitHub Actions 会自动从 Repository Secrets 中读取环境变量来运行测试。
+
 ## 注意事项
 
 - 确保标签版本号符合语义化版本规范
 - 发布前请确保所有测试通过
 - NuGet 包名会根据项目名称自动生成
-- 如果版本号已存在，发布会被跳过（使用 --skip-duplicate 参数） 
+- 如果版本号已存在，发布会被跳过（使用 --skip-duplicate 参数）
+- 测试需要有效的 RAGFlow API 密钥和服务 URL 

.github/workflows/build-and-test.yml

@@ -25,4 +25,7 @@ jobs:
       run: dotnet build --configuration Release --no-restore
 
     - name: Test
-      run: dotnet test --no-build --verbosity normal --configuration Release 
+      run: dotnet test --no-build --verbosity normal --configuration Release
+      env:
+        RAGFLOW_API_KEY: ${{ secrets.RAGFLOW_API_KEY }}
+        RAGFLOW_BASE_URL: ${{ secrets.RAGFLOW_BASE_URL }} 

.github/workflows/release.yml

@@ -24,6 +24,9 @@ jobs:
 
     - name: Test
       run: dotnet test --no-build --verbosity normal --configuration Release
+      env:
+        RAGFLOW_API_KEY: ${{ secrets.RAGFLOW_API_KEY }}
+        RAGFLOW_BASE_URL: ${{ secrets.RAGFLOW_BASE_URL }}
 
     - name: Extract version from tag
       id: get_version

.gitignore

@@ -482,3 +482,6 @@ $RECYCLE.BIN/
 
 # Vim temporary swap files
 *.swp
+
+# test configuration file
+RAGFlowSharp.Test/appsettings.json

RAGFlowSharp.Test/RAGFlowSharp.Test.csproj

@@ -10,6 +10,9 @@
     <ItemGroup>
         <PackageReference Include="coverlet.collector" Version="6.0.2"/>
         <PackageReference Include="JetBrains.Annotations" Version="2025.1.0-eap1" />
+        <PackageReference Include="Microsoft.AspNetCore.Http" Version="2.3.0"/>
+        <PackageReference Include="Microsoft.Extensions.Configuration.EnvironmentVariables" Version="9.0.0"/>
+        <PackageReference Include="Microsoft.Extensions.Configuration.Json" Version="9.0.0"/>
         <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.12.0"/>
         <PackageReference Include="xunit" Version="2.9.2"/>
         <PackageReference Include="xunit.runner.visualstudio" Version="2.8.2"/>

RAGFlowSharp.Test/Startup.cs

@@ -1,3 +1,5 @@
+using Microsoft.AspNetCore.Http;
+using Microsoft.Extensions.Configuration;
 using Microsoft.Extensions.DependencyInjection;
 using Microsoft.Extensions.Logging;
 using Xunit.DependencyInjection.Logging;
@@ -8,19 +10,35 @@ class Startup
 {
     public void ConfigureServices(IServiceCollection services)
     {
+        // 构建配置
+        var configuration = new ConfigurationBuilder()
+            .AddJsonFile("appsettings.json", optional: true, reloadOnChange: true)
+            .AddEnvironmentVariables()
+            .Build();
+
+        services.AddSingleton<IConfiguration>(configuration);
+        
+        // 添加测试用的 HttpContextAccessor
+        services.AddSingleton<IHttpContextAccessor, TestHttpContextAccessor>();
+
         services.AddRagflowSharp(options =>
         {
-            // options.ApiKey = "ragflow-U3MTFkNGFjMmMyNjExZjA5NjUxMDI0Mm";
-            // options.BaseUrl = "http://localhost";
+            // 从环境变量或配置文件中读取设置
+            options.ApiKey = Environment.GetEnvironmentVariable("RAGFLOW_API_KEY") 
+                           ?? configuration["RAGFlowSharp:ApiKey"] 
+                           ?? throw new InvalidOperationException("RAGFLOW_API_KEY environment variable or RAGFlowSharp:ApiKey configuration is required");
+            
+            options.BaseUrl = Environment.GetEnvironmentVariable("RAGFLOW_BASE_URL") 
+                            ?? configuration["RAGFlowSharp:BaseUrl"] 
+                            ?? "http://localhost:8000";
 
-            options.ApiKey = "ragflow-U3MTFkNGFjMmMyNjExZjA5NjUxMDI0Mm";
-            options.BaseUrl = "http://localhost";
             options.EnableLogging = true;
         });
 
         services.AddLogging(lb =>
         {
             lb.AddXunitOutput();
         });
+        
     }
 }

RAGFlowSharp.Test/appsettings.json

@@ -1,7 +1,7 @@
 {
   "RAGFlowSharp": {
     "BaseUrl": "http://localhost:8000",
-    "ApiKey": "your-api-key-here"
+    "ApiKey": ""
   },
   "Logging": {
     "LogLevel": {

RAGFlowSharp.Test/appsettings.json.example

@@ -0,0 +1,13 @@
+{
+  "RAGFlowSharp": {
+    "BaseUrl": "http://localhost:8000",
+    "ApiKey": "<your-api-key>"
+  },
+  "Logging": {
+    "LogLevel": {
+      "Default": "Information",
+      "Microsoft": "Warning",
+      "Microsoft.Hosting.Lifetime": "Information"
+    }
+  }
+}