diff --git a/context.md b/context.md deleted file mode 100644 index afbae13..0000000 --- a/context.md +++ /dev/null @@ -1,129 +0,0 @@ -# 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`)