deerflow-code/docs/ji-knowledge-projects-acceptance.md

ji 分支知识库与我的项目验收

日期：2026-09-14。基线：ji / f62a512a，已从 origin fast-forward 更新。

修复范围

1. 简洁模式进入我的项目保留功能导航，覆盖列表、策略工作台和问答项目；移动端有菜单展开入口。
2. 策略结果卡片的模型思考前置；检查意图、评判、方案、展开视图保持过程在正文前。
3. 普通问答改为真实项目分组：先填写项目名称创建项目，再在项目中创建多条问答。服务端持久归属与权限校验沿用 analysis-projects；不自动迁移或标记历史普通聊天。官方入口支持对应 groups 子路由。
4. 修复方案列表要求预先选中策略导致无法进入的问题；任务变化后已有方案仍可查看；请求序号避免旧请求失败覆盖成功结果。
5. 修复知识库管理目录缓存导致上游删除后仍显示的问题；保留检索端缓存。
6. 项目编辑保留知识库绑定，助手知识库补充普通用户空态。

自动化

• 后端 22 个相关测试文件：273 passed（知识库、Wiki、向量、编码器、项目归属、策略配置与持久化、边界等）。
• 前端策略与项目测试：31 passed。新增用例覆盖未选择策略、已有方案变更任务、未完成评判及全部策略失败。
• tests/test_knowledge_live_embedding.py：真实接口 1 passed；默认跳过，设置 KNOWLEDGE_TEST_EMBEDDING_KEY 后运行。默认服务 SiliconFlow、模型 BAAI/bge-m3；可用 KNOWLEDGE_TEST_EMBEDDING_URL / KNOWLEDGE_TEST_EMBEDDING_MODEL 更换。
• pnpm build：通过。
• pnpm typecheck：未完全通过，59 个错误位于此次未改动文件（nextra 缺失、Markdown 插件类型、旧 JSX 类型及旧问答页等）；修改文件无类型错误。不能将生产构建通过等同于全仓类型检查通过。

真实接口与浏览器

测试使用 .runtime/ji-acceptance 独立数据目录，保留测试数据便于复查，未操作业务数据库已有项目。

• BAAI/bge-m3：中英文 3 条输入，均返回 1024 维有效向量。
• 实际检索服务：相关正文排名、指定库范围、草稿排除、概览查询通过。
• 两个项目 A/B：A 创建两条对话，B 列表为零；跨项目读取 A 的对话返回 404。
• 浏览器：简洁模式完整菜单可见；新建具名普通问答项目；项目内真实发送并收到回答；第二条对话独立；回列表仍是一张项目卡，刷新后保留。
• 方案整理：真实模型返回 1539 字符正文，含 agent_done / all_done，流正常结束。
• 方案入口：完成评判但尚未勾选策略的测试项目出现在方案列表。浏览器进入后勾选策略、生成 2755 字符正文、保存成功；服务端校验 synthesisStatus=done 且 solutionSavedAt 非空，刷新后正文与导出按钮恢复。
• 官方入口：/official/workspace/projects/groups/new 正常展示具名问答项目表单，官方侧栏保留。
• 助手知识库：创建、重命名、列表、拒绝 .py 上传通过；上传测试文本任务 completed；生成 Wiki 页面，向量检索命中 1 条，详情 HTTP 200。

限制

真实模型测试使用最小合成读书活动/设备资料，未对生产全量知识语料进行质量评估。API 密钥仅用于测试进程，不提交配置。仓库原有未跟踪 docx 与 packages1.zip 保持不变。未提交、推送代码，也未执行离线发布。