docs(provider): 补充模型服务商配置说明

2026-09-18 16:48:30 +08:00
parent 6b365d9953
commit 3000274c77
7 changed files with 71 additions and 3 deletions
@@ -49,6 +49,7 @@ replacedBy: null
 | 个人资料 | `/accounts/profile/` | 普通用户、管理员 | 查看和修改自己的资料 |
 | 运行列表 | `/runs/` | 普通用户、管理员 | 查看当前用户的运行记录 |
 | 运行详情 | `/runs/<uuid>/` | 记录所属用户、管理员 | 查看状态、事件和工具调用摘要 |
+| API 服务商 | `/runs/providers/` | 普通用户、管理员 | 搜索、筛选并配置自己的模型服务商 |
 | 管理后台 | `/admin/` | 管理员 | 管理用户和审计记录 |

 登录成功默认进入运行列表；退出成功返回登录页。详情页返回列表时保留原分页参数，非法或越权的运行编号统一展示 404 页面。
@@ -114,6 +115,15 @@ replacedBy: null

 详情页不展示 API Key、Cookie、密码、完整工具参数或原始模型敏感内容。

+### 4.6 API 服务商页
+
+- 使用服务商卡片目录展示官方直连、国内平台、聚合平台和云平台。
+- 卡片明确区分“仅 API Key”和“需要额外配置”，未完成专用适配的平台不开放保存操作。
+- 配置抽屉只接收 API Key、可选模型标识和是否设为默认服务商；Base URL 与协议由服务端预设。
+- 页面只显示密钥末四位提示，保存后不可读取完整密钥。
+- 连接测试通过后才替换已有配置；失败输入不得破坏原有可用密钥。
+- 搜索与分类使用 GET 查询参数，保存和移除使用 POST、CSRF 与重定向。
+
 ## 5. 模板复用边界

 建议模板层级：