45 lines
3.6 KiB
Markdown
45 lines
3.6 KiB
Markdown
# Task: 排查知识库向量模型目录与配置入口
|
||
|
||
## Identity
|
||
|
||
- Task ID: 20260912-kb-embedding-ml-6f8a21dc
|
||
- Mode: Feature
|
||
- Branch: codex/20260912-kb-embedding-ml-6f8a21dc-kb-embedding
|
||
- Worktree: D:\Datas\OthersProjects\.codex-worktrees\makelore\20260912-kb-embedding-ml-6f8a21dc
|
||
- Base commit: a0b869a333b12d28bfd96dcd89e8bc03ad47647d
|
||
- Owner: codex
|
||
- Status: Ready for Integration
|
||
|
||
## Scope
|
||
|
||
- 排查创建知识库的空向量模型下拉框，补齐云端配置说明、加载/失败/空状态及原地刷新，保留知识库名称和未确认创建请求。
|
||
|
||
## Intent And Constraints
|
||
|
||
- 已加载 maintain-project-docs 与 diagnosing-bugs；bundled check/start/status 验证独立 feature 任务、分支、绝对工作树及主线基线一致，Concurrent/Planning Gates Passed。已读入口、本人记录、项目记忆、已接受个人云智能体决策、架构与相关证据/反思/承诺；peer 作用域已核对，历史占位保持未知但无具体语义依赖。
|
||
- 不创建子智能体，不读取/写入线上模型凭据、部署配置或用户数据，不调用真实收费模型，不修改主目录或 canonical memory。WS 管理可用模型和账本，Yuxi 管理向量模型定义/维度及知识执行，客户端只消费 Main Host API。
|
||
- 截图只证明空下拉框，未读取用户线上目录响应及模型配置；不把本地替身输入当作已确认生产根因。
|
||
|
||
## Outcome
|
||
|
||
- CloudKnowledge 显式区分加载、失败、空目录；增加刷新知识库与模型按钮、平台管理员说明及可折叠的 Yuxi/WS/one-api 配置步骤。成功刷新清除目录错误，保留输入名称；已下线模型不能用于新创建，未知创建结果仍复用原 operation_id/name/model。
|
||
- README 同步配置入口；新增五个组件行为回归，扩展既有真实 Electron fixture 覆盖空状态、管理员说明、刷新恢复和名称保留。
|
||
|
||
## Verification
|
||
|
||
- pnpm 10.33.4 install --frozen-lockfile --offline 通过，未修改 lockfile。
|
||
- pnpm exec vitest run tests/unit/cloud-knowledge-catalog.test.tsx --maxWorkers=1：修复前四项因缺少说明/加载状态/刷新入口失败，修复后通过；追加未知创建重试案例后，连同四个既有云模块测试文件共 50 tests passed。
|
||
- pnpm run typecheck 与 scoped ESLint（CloudKnowledge、新单测、cloud-agents.spec）通过，无诊断。
|
||
- pnpm run build:vite 四个目标成功，保留既有 chunk/混合导入/Browserslist 提示。
|
||
- pnpm exec playwright test tests/e2e/cloud-agents.spec.ts --workers=1 --reporter=list：真实 Windows Electron 1 passed；回读 knowledge-empty.png，配置区独立滚动、提示与操作可见。Host API 为 fixture，无线上模型调用。
|
||
- git diff --check 与 task-aware 文档检查通过。
|
||
|
||
## Follow-ups
|
||
|
||
- 需要平台管理员在现有云端配置入口核对并接入模型；当前安装版配置完成后离开智能体再进入以重新加载目录。新增原地刷新与说明需后续合并/打包才能进入安装版。
|
||
- 本次无主分支合并、推送、部署或安装包发布。线上具体配置缺口及真实向量收费调用仍未验证。
|
||
|
||
## Promotion Candidates
|
||
|
||
- Target: 集成 current-state/云智能体客户端记录。Proposal: 记录知识模型配置由平台管理员在 Yuxi/WS 完成，客户端提供明确目录状态、刷新及恢复语义。Evidence: 当前 Owner 代码、五项组件回归和 Electron 验证。Impact: 后续配置体验沿用现有目录与凭据边界。Conflict: 无产品方向冲突。Human confirmation: 无新产品决定，canonical 提升由后续 Integration Gate 执行。
|