jerryandClaude Fable 5
0875bb036c
- git mv 保留历史：ui/(Vue3+Vite)、sdk/(BFF 中间层)
- 路径语义修正：db_path/figures_cache 改相对 sdk/(BFF cwd)，
历史库 sdk/backend/data 迁移至 sdk/data/(会话/图片缓存无损)
- 引用修复 ~15 处：config.py、deploy/*.sh、vitest/playwright 配置、
单测导入路径、docs、README、gitignore、.env.example
- 骨架：agent/{qa,methodology,legacy-rag,vendor}、knowledge/manifest.yaml、
tooling/{compile,kb,crypto,assemble,audit,tools,scripts} + README
- 门禁验证：sdk pytest 125 通过、ui vitest 158 通过、
生产 BFF 脚本重启四上游全绿 + 静态托管 + 会话库无损
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
3.3 KiB
3.3 KiB
ACCEPTANCE.md —— M5 最终验收记录
验收人：PM ｜ 日期：2026-08-25 ｜ 结论：通过
1. 验收范围与结果
| 验收项 | 结果 | 证据 |
|---|---|---|
| 生产形态（BFF 静态托管单进程） | ✅ | :8090/ 渲染 AppShell、同源 /api/health 200、无 JS 错误 |
| 桌面：真实 SQLite 会话列表 | ✅ | 7 条会话（T 已清理测试污染数据） |
| 桌面：历史恢复（markdown/相位卡/引用） | ✅ | 相位卡 5/5 done 恢复、md-text 渲染、引用 chip → 来源 tab 高亮定位 |
| 真实问答全链路 | ✅ | 五相位终态全 done、答案 698 字、内联引用 chip 4 个、无 JS 错误 |
| 三档视口档位 | ✅ | mobile（drawers-mode+mobile+has-tools）/ tablet（drawers-mode）/ desktop 全正确 |
| 自动化验收脚本 | ✅ | deploy/m5_acceptance.js 15/15 通过 |
历史验收基线（前序里程碑，全部通过）：
- M2
deploy/m2_e2e.js12/12（真实端到端 + 刷新恢复 + 相位推进） - M3
deploy/m3_e2e.js16/16（真实 KG 浏览 + 抽取 + 三档交互 + 主题） - M4 R2 全量：后端 121/121（行覆盖 87%）、前端 156/156（80.59%）、Playwright 48 条（35 pass/12 skip 依赖充值/1 环境性 flake 复跑通过）、上游 smoke 7/7、FR 追溯 81/81 双向零失配
2. 测试门禁终态
| 门禁 | 要求 | 实际 | 判定 |
|---|---|---|---|
| FR→TC 追溯矩阵 | 81/81 双向完整 | 81/81 零失配 | ✅ |
| 后端行覆盖 | ≥85% | 87% | ✅ |
| 前端行覆盖 | ≥80% | 80.59% | ✅ |
| 产品缺陷 | 0 未修复 | R1 的 8 项全部修复并在 R2 确认 | ✅ |
3. 已知限制（验收时明确，不视为缺陷）
DeepSeek LLM 余额用尽（402）已于 2026-08-25 解决：换用 PlantAI-dev 的 NEW_API_KEY（余额充足），QA 服务经官方脚本start_plantAI_RAG.sh重启后自然语言答案完全恢复（实测：PlantAI-rag-new 答案 1379 字 + 15 来源；PlantAI-dev 答案 2671 字 + 14 来源，超时配置提至 600s）。详见 CHANGELOG「DeepSeek 恢复与 QA 修复」。- 上游 QA 无 token 级流式：打字机为客户端揭示动画（设计内既定）。
- 每次提问独立检索（
max_rounds:1），无多轮上下文（设计内既定）。 - 移动端覆盖层内 BenchPanel 自带 tab 已 CSS 隐藏，以外壳 tab 条为准（已验收）。
- Laptop 档（1024–1279px）无独立 Playwright project（T 遗留建议，不影响验收；该档行为已由 CSS + AppShell 逻辑覆盖并经人工走查）。
4. 验收执行记录
- 验收脚本：
deploy/m5_acceptance.js（15 断言，chromium headless） - 运行位置：远端（真实 BFF 8090 生产形态 + Vite 5180 开发形态双链路）
- 用时：约 3 分钟（含一次真实 QA ≈ 50s）
- 期间修复：BFF 静态托管 dist 路径解析（
sdk/ui/dist→ 项目根解析，2026-08-25 PM）
5. 结论
PlantAI-rag-new 通过最终验收。 所有需求功能点（PRD 81 FR）有测试覆盖且通过；生产形态可部署；三档视口可用；外部依赖（DeepSeek 余额）恢复后无需任何代码改动即可获得完整体验。
下一步建议（用户决策，不在本次范围）：
- DeepSeek 充值 → 验证自然语言答案质量
- 长期运行监控（/api/health 轮询、上游探活）
- 可选：laptop 档 E2E project 补齐、tests/sdk L2 respx 独立测试