fix: 模型管理审查修复与归档

- 修复 registry 测试 ai mock 缺失 createProviderRegistry 导出
- 新增 POST /api/providers/test 支持未保存供应商配置连通性测试
- 供应商表单新增测试连接按钮，新建默认 openai-compatible
- 连通性测试按 ok 展示成功/失败，不再统一 success 样式
- 模型表单新建时也可测试供应商连接
- 模型页使用独立 provider 列表避免分页/搜索影响
- 移除模型管理组件内联 style
- 新增 ProviderTestResultResponse 共享响应类型
- 新增 bun run format:check 脚本
- 补充关键测试覆盖（删除关联、连通性、默认类型、表单测试）
- 更新 docs/user/usage.md、docs/development/*、design.md、tasks.md
- 归档 change 至 openspec/changes/archive/2026-05-29-add-model-management

docs/development/README.md

@@ -27,6 +27,7 @@
 | `bun run typecheck`              | TypeScript 类型检查                    |
 | `bun run lint`                   | ESLint 和 Prettier 格式检查            |
 | `bun run format`                 | Prettier 自动格式化                    |
+| `bun run format:check`           | Prettier 格式检查                      |
 | `bun test`                       | 运行全部测试                           |
 | `bun run check`                  | schema:check + typecheck + lint + test |
 | `bun run build`                  | 构建生产可执行文件                     |

docs/development/backend.md

@@ -74,7 +74,7 @@ middleware.ts 提供 API 参数校验函数：
 
 - `AIProviderConfig` — 供应商配置（name、type、baseUrl、apiKey）
 - `AIModelConfig` — 模型配置（providerId、modelId、capabilities）
-- `AIRegistryConfig` — Registry 构建配置（providers、models）
+- `AIRegistryConfig` — Registry 构建配置（providers、models），供后续 AI 调用层组合使用
 
 ### Registry 构建
 
@@ -83,7 +83,14 @@ middleware.ts 提供 API 参数校验函数：
 - `buildProviderRegistry(db)` — 从 DB 查询启用的供应商，构建 Vercel AI SDK Provider Registry
 - `testProviderConnection(config)` — 使用 generateText 测试供应商连接
 
-每次 AI 调用时从 DB 查询 providers，构建 registry 后通过 `registry.languageModel('providerId:modelId')` 获取模型实例。不使用缓存层。
+每次 AI 调用时从 DB 查询 enabled providers，构建 registry 后通过 `registry.languageModel('providerId:modelId')` 获取模型实例。不使用缓存层。模型是否存在、是否启用以及业务能力标签由调用方基于 models 表先行校验，registry 只负责将 providerId/modelId 映射到 AI SDK 模型实例。
+
+### 供应商连通性测试
+
+供应商连通性测试返回 `{ providerTestResponse: { ok, message } }`，前端根据 `ok` 展示成功或失败提示。
+
+- `POST /api/providers/:id/test` — 使用已保存供应商配置测试连接
+- `POST /api/providers/test` — 使用表单中尚未保存的供应商配置测试连接
 
 ### 支持的供应商类型
 

docs/development/frontend.md

@@ -131,6 +131,10 @@ Sidebar（`src/web/components/Sidebar/index.tsx`）是纯展示/导航组件，
 
 Workbench 项目上下文通过 `ProjectContext` 提供，在 `WorkbenchProjectGate` 中从 URL path param 读取 `projectId`，通过 `useProject(projectId)` 加载项目，仅 active 项目渲染工作台布局，不存在或 archived 项目显示"项目不存在或不可访问"。
 
+模型管理页面（`src/web/pages/models/index.tsx`）属于 Admin 路由 `/models`，通过 antd `Tabs` 在同页组织供应商和模型两个视图。页面使用 `ProviderToolbar`、`ProviderTable`、`ProviderFormModal`、`ModelToolbar`、`ModelTable`、`ModelFormModal` 拆分筛选、表格和表单职责；模型表单和模型表格使用独立 provider 列表查询，不能复用供应商标签页当前分页或搜索结果作为全量选项。
+
+供应商表单必须支持未保存配置的连通性测试，新建供应商时 type 默认 `openai-compatible`，baseURL 不设默认值。连通性测试返回 `ok: false` 时应展示失败反馈，不得使用成功提示样式。
+
 - 生产入口必须启用 `ErrorBoundary`，运行时渲染异常使用 antd `Result status="500"` 或等价组件展示。
 - `ReactQueryDevtools` 仅在 `import.meta.env.DEV` 条件下渲染，不进入生产渲染路径。
 - 主题切换统一通过 `ConfigProvider` 的 antd theme algorithm 控制，不使用硬编码主题色。

docs/user/usage.md

@@ -36,6 +36,7 @@ bun run dev config.yaml
 | ---------- | ----------------------- | ---------------------------------------- |
 | 总览       | `/`                     | Admin 管理台总览，展示运行时元信息       |
 | 项目管理   | `/projects`             | 创建、编辑、归档、恢复和永久删除项目     |
+| 模型管理   | `/models`               | 配置 AI 供应商和模型，供后续 AI 功能使用 |
 | 工作台总览 | `/workbench/:projectId` | Workbench 工作台总览，按项目维度查看信息 |
 | 用户管理   | `/users`                | 页面建设中                               |
 | 系统设置   | `/settings`             | 页面建设中                               |
@@ -46,3 +47,12 @@ bun run dev config.yaml
 - **Workbench（工作台）**：项目维度视角，通过 `/workbench/:projectId` 进入指定项目的工作台。URL 可保存为浏览器书签，下次直接进入。仅 active 状态的项目可进入工作台，archived 项目不可访问。
 
 从项目管理页面的 active 项目行可点击"进入工作台"跳转到对应项目的工作台。
+
+## 模型管理
+
+在 Admin 侧栏进入 `/models` 后，页面通过两个标签页管理 AI 基础配置：
+
+- **供应商**：新增、编辑、启用、禁用、删除 OpenAI、Anthropic 或 OpenAI 兼容供应商。新建供应商时类型默认是 `openai-compatible`，baseURL 和 API Key 由用户填写。
+- **模型**：为已启用供应商新增模型，填写模型显示名称、实际调用用的 modelId、能力标签，以及可选的上下文长度和最大输出 token。
+
+供应商表格和供应商表单都提供“测试连接”操作。测试连接只返回成功或失败提示，不会阻止保存供应商或模型。删除供应商前必须先删除或迁移其关联模型，否则系统会拒绝删除以避免误删模型配置。