Alfred/context.md

add-model-management 当前进度

变更信息

• Change: openspec/changes/add-model-management/
• Workflow: fast-drive (design.md + tasks.md)
• 状态: apply-review 修复进行中，有一个阻塞问题

已完成工作

核心功能（54/54 tasks 全部标记 [x]）

所有代码已实现并通过验证：

• DB Schema: providers + models 表（含 FK、唯一索引）
• 数据访问层: src/server/db/providers.ts, src/server/db/models.ts
• 后端路由: 15 个路由（providers 8 + models 7）注册在 src/server/server.ts
• AI 服务层: src/server/ai/registry.ts（含 testProviderConnection + buildProviderRegistry）, src/server/ai/types.ts
• 共享类型: src/shared/api.ts（含 MODEL_CAPABILITIES 常量）
• 前端 Hooks: src/web/hooks/use-providers.ts, src/web/hooks/use-models.ts
• 前端页面: src/web/pages/models/（6 个组件 + index）
• 前端路由+菜单: src/web/routes.tsx, src/web/consoles/admin/menu.tsx
• 测试: 10 个测试文件（66 个测试用例）
• 文档: backend.md, frontend.md, architecture.md, README.md 已更新

apply-review 修复（进行中）

已完成的修复：

• ✅ registry.ts 补充 buildProviderRegistry: 新增从 DB 查询启用供应商构建 AI SDK Provider Registry 的函数
• ✅ Q1 统一错误响应: providers/get.ts 和 models/get.ts 改用 createApiError()
• ✅ Q2 提取共享常量: MODEL_CAPABILITIES 从 shared/api.ts 导出，models/create.ts 和 models/update.ts 不再重复定义
• ✅ Q3 清理重复测试: tests/web/hooks/use-models.test.ts 移除了残留的 provider 相关测试
• ✅ 文档修正: docs/development/backend.md 中 buildProviderRegistry 签名已更新为 (db) 而非 (config)
• ✅ design.md + tasks.md 更新: tasks 6.1 和 design 执行计划第 12 项已反映 registry 完整范围

阻塞问题

bun test 无法解析 createProviderRegistry

现象: 运行 bun test tests/server/ai/registry.test.ts 时报错：

SyntaxError: Export named 'createProviderRegistry' not found in module '...\node_modules\ai\dist\index.mjs'

已确认:

• createProviderRegistry 在 node_modules/ai/dist/index.mjs 中存在
• bun -e "import { createProviderRegistry } from 'ai'; ..." 正常工作
• bun run typecheck 通过（类型存在）
• 问题仅出现在 bun test 环境
• 此前 registry.ts 只导入 generateText 时测试正常；添加 createProviderRegistry 后全部 registry 测试失败

可能原因: Bun 1.3.14 的 bun test ESM 模块解析缓存问题，或 mock.module("ai", ...) 与静态导入 createProviderRegistry 的交互问题

建议尝试方向:

1. 清除 Bun 缓存: rm -rf node_modules/.cache
2. 升级 Bun 版本
3. 改用动态导入 const { createProviderRegistry } = await import("ai") 在 buildProviderRegistry 函数内部
4. 将 buildProviderRegistry 的测试改为不 mock ai 模块（因为 createProviderRegistry 不需要 mock，只有 generateText 需要）
5. 将 registry 拆为两个文件：connection-test.ts（mock generateText）和 registry.ts（不 mock）

质量状态

• bun run typecheck: ✅ 0 errors
• bun run lint: ✅ 0 errors（修复后）
• 模型管理相关测试: ❌ 62/66 pass（4 个 registry 测试因上述问题失败，其他 62 个全部通过）
• 已有 projects.test.tsx 有一个预存超时问题（与本次变更无关）

文件清单

新增文件（untracked）

drizzle/0001_wooden_rocket_raccoon.sql
drizzle/meta/0001_snapshot.json
src/server/ai/registry.ts
src/server/ai/types.ts
src/server/db/models.ts
src/server/db/providers.ts
src/server/routes/models/{create,delete,disable,enable,get,list,update}.ts
src/server/routes/providers/{create,delete,disable,enable,get,list,test,update}.ts
src/web/hooks/use-models.ts
src/web/hooks/use-providers.ts
src/web/pages/models/index.tsx
src/web/pages/models/components/{ModelFormModal,ModelTable,ModelToolbar,ProviderFormModal,ProviderTable,ProviderToolbar}.tsx
tests/server/ai/registry.test.ts
tests/server/db/models.test.ts
tests/server/db/providers.test.ts
tests/server/routes/models.test.ts
tests/server/routes/providers.test.ts
tests/web/components/ModelTable.test.tsx
tests/web/components/ProviderTable.test.tsx
tests/web/hooks/use-models.test.ts
tests/web/hooks/use-providers.test.ts
tests/web/routes/models.test.tsx

修改文件（modified）

bun.lock
docs/development/README.md
docs/development/architecture.md
docs/development/backend.md
docs/development/frontend.md
drizzle/meta/_journal.json
package.json
src/server/db/schema.ts
src/server/server.ts
src/shared/api.ts
src/web/consoles/admin/menu.tsx
src/web/routes.tsx

OpenSpec 变更文档

openspec/changes/add-model-management/design.md
openspec/changes/add-model-management/tasks.md

后续步骤

1. 解决 bun test 与 createProviderRegistry 的兼容问题
2. 确保所有 66+ 测试通过
3. 归档变更（/opsx-archive）