绝尘
f30df333b3
巡检发现:
- 2196c77 workflow 整文件替换回退破坏(AiChat+Ideas 12项功能)
- B-260615-03 truncated 标志已落地
- AR-8-scroll scrollToBottom smooth 已补
- CR-260615-09 .ai-md 残余:4详情页各21处 scoped .ai-md
(全局 ai-md.css 75行已建,旧副本待清理但非阻塞)
10 KiB
文档全量核对报告（2026-06-15）
方法：4 路并行代理核对（A 根目录核心 / B 架构+模块 vs 代码 / C 审查+迭代+管理 / D 交叉引用+规范+重复） 范围：docs/ 全量 48 .md + 根目录 ARCHITECTURE.md / PROGRESS.md / URGENT.md 性质：核对记录，不改代码（本会话 session-role）。todo 待修项见 docs/todo.md「文档核对待修项」DOC-260615-01~14。 悬空链接：0（全量 markdown 链接核对，目标文件全部存在）。
P0 文档硬伤（按文档找代码会落空）
1. ARCHITECTURE.md 数据模型整段漂移（B-1 + A）
:262-475 列 14 表，6 虚构 7 遗漏：artifacts/connections/features/test_cases/test_runs/annotations/decisions 7 张不存在（df-traceability 删后未清）；workflow_defs/workflow_runs 应合并为 workflow_executions；实际 node_executions/branches/ai_conversations/knowledges/ai_tool_executions/knowledge_events/app_settings 7 张未列。projects 表字段（repo_path/priority/current_stage）多数从未加。建议：整段重写对齐 migrations.rs，或加「⚠️ 初稿，实际 schema 见 migrations.rs」横幅。
2. df-nodes 模块文档 8 节点全骨架 → 实际 3 节点 2 已实现（A-1/C-1/D-3.2）
:9,13,17-26 列 8 节点（AI/Script/Docker/Git/Human/Notify/HTTP/Subflow）全标骨架 execute() 空。实际 crates/df-nodes/src/ 仅 ai_node/script_node/human_node 3 文件，均完整实现（script 接 shell、ai 调 provider、human subscribe→send→select!）。Docker/Git/Notify/HTTP/Subflow 5 节点不存在。建议：重写，节点缩 3 个状态改 ✅。
3. df-ai 模块文档列不存在的文件 + 已删 trait（A-3）
:30-40 文件结构列 router.rs（ModelRouter）+ stream.rs（StreamCollector），实际均无（R-PD-7 删）。:50-72 LlmProvider trait 含 supported_features()（已删，新增 endpoint()）。:22/174 工具数 12 → 实际 13。建议：删两虚构文件行，trait 段对齐，12→13。
4. 使用手册 7 处与实际不符（C-4.4）
运行命令 bun→实际 npm；任务状态 4 态→实际 7 态（todo/in_progress/in_review/testing/done/blocked/cancelled）；优先级 P0-P3 方向歧义（前后端枚举反向）；节点类型 Script/Condition/Parallel→实际 Script/Ai/Human（无独立 Condition/Parallel，且 Script 已下线）；监控「WebSocket」→实际 Tauri EventBus；「单 Provider」→实际多 Provider；知识库「静态收集」→实际 Tier1 AI 提炼+向量检索。建议：全面重写。
P1 审查状态断层（报告说修了/todo 看不到）
5. 全局 review R-P1-16 / R-P2-113 已实施 todo 零回写（C-1.2/1.3）
全局代码review-2026-06-15.md 推进状态标「P1×6 + P2×13 全闭环，126 test pass」，代码核对坐实 R-P1-2/3/5/6、R-P2-2/3/8/9/10/13 均落地。todo.md 完全无条目（既不在待办也不在已完成）。建议：已完成区补汇总回写。
6. 架构复核报告 §5 新发现 11 项零入 todo（C-1.1）
架构与缺陷复核报告 §5 新①~⑪（5 项🟠），todo 零覆盖。复核-新②/⑨/⑩ 后被全局 review 取代，复核-新①/③/④/⑪ 待补：①useAiConversations pendingToolCalls 二次 token 比对 / ③executor NodeCancelled 事件语义双标 / ④cancel_workflow_node 终态守卫 / ⑪主窗口幽灵 watchdog。建议：4 项补 todo。
7. aichat §8 + 工作流审批 TL;DR 已修项未勾（B-3/B-4）
aichat审查报告 §8 优先级表 11 行仅 AR-3 标 ✅，实际 H1/H2/create_project/AR-5/6/7/9/10 均 ✅（todo 对齐）。工作流审批审查报告 TL;DR + §0 头号 P0（human_node.rs:41 缺 await）B-03b-R6 ✅ 已修但报告仍「待修」语气。建议：补 ✅ + commit 标注。
8. 近期改动 CR-03 未做子项埋 [x] 备注（C-1.4）
CR-260615-03 标 [x] 但备注含「未做：audit.rs Err 误报/openai source 丢失/ToolCard projectNameById find」4 子项，代码核对坐实未改。建议：拆独立 P2 todo（或合并 CR-260615-11）。
P1 架构/模块文档过期
9. df-workflow 4 处接口过期（B-A-2）
:81 NodeRegistry Default（已删，registry.rs:76 注「不实现」）；:180 ConditionEngine 默认 true→实际 false（B-260614-02）；:138 try_recv_human_approval（已删）；:155-156 set_waiting/set_skipped（已删，仅留 set_cancelled）。建议：4 处对齐。
10. df-storage V8→V13（B-A-4/C-4.1）
:3,9,26-36,114,132 反复 V1-V8/MIGRATION_VERSION=8，实际 V1-V13（V9 ai_providers/V10 knowledges.reasoning+knowledge_events/V11 projects.deleted_at/V12 path+stack/V13 app_settings）。表数 11→18，Repo 11→17。建议：版本/表数/Repo 数全改。
11. 对抗评估 idea_evaluations 设计稿未标未实施（B-A-5）
想法探索-对抗式评估 :220-310 设计 6 struct + idea_evaluations 表，全仓零命中。实际 adversarial.rs 纯启发式（AdversarialEval/Argument/AnalystAnalysis），功能决策记录已标「📐 设计未实施」但模块文档未标。建议：加「⚠️ 当前纯启发式，三路 LLM + 表为设计稿」横幅。
12. df-execute 文档 Shell/Docker/SSH/Git vs 仅 Shell（D-3.3）
ARCHITECTURE:84/PROGRESS:29/df-nodes 文档描述 df-execute Shell/Docker/SSH/Git，实际仅 shell.rs+lib.rs（docker/git_ops/ssh Sprint 19 已删）。建议：删 Docker/SSH/Git 描述。
P1 索引/计数矛盾
13. 13→8 crate 多处（A/D-3.1）
实际 workspace 8 crate。PROGRESS:13/INDEX:4,107,119/Phase1决策 ADR-003/对抗裁决报告/想法探索 多处写 13。建议：统一「原 13，2026-06-14 删 5 零引用，现 8」（ADR 加「已修正」标注保留决策史）。
14. INDEX 漏 9 文档 + 09-问题排查目录（A/D-2.3）— 本会话已补正
F-07 trait下沉/密钥迁移/工作流边界/条件引擎/generating状态机（02 区 5）/DAG引擎详解/AI对话引擎（03 区 2）/全局代码review（05 区 1）/aichat-apikey-401排查（09 目录）。已在 INDEX 补。
15. commands 数 47/57/68 三处冲突（C-5.1）
PROGRESS:72 写 47、:48 写 57、实际 68 个 #[tauri::command]。建议：统一 68。
16. URGENT.md 过时 + 未挂索引（D-5.1/2.4）
5 个 P0（AC3/FR-S7/FR-S8/B-03b-R8/FR-S1）在 todo 全 ✅，URGENT 无停用标注 + 不在任何索引。建议：顶部加「⚠️ 2026-06-14 快照，P0 全迁 todo 已完成，本文件停用」或删除。
P2 迭代/Phase 过期
17. DEVFLOW-1~4 全标待实施（C-2.1）
4 文档全「状态:待实施/实施记录待填写」，实际 Phase1 全完成（DEVFLOW-1 宏替代 trait 设计转向/DEVFLOW-2 68 commands/3-4 落地）。建议：标已完成+实施摘要，或归档。
18. Phase1 任务清单严重滞后（C-3.1）
标「进行中」，实际全完成。待实施表 #7~#11 全 [ ]（均已做）。代码规模 71 文件 4108 行 vs 实际 53/7400。已知问题 4 项 3 项已解决。建议：标完成或归档。
19. Phase2 计划部分超前/滞后（C-3.2）
Phase2.2/2.3 基础已完成（启发式）未回写；Phase2.4 并行 ✅/编辑器+条件分支未做；B 路线 conditions 默认值已改未同步。建议：标注实际状态。
P2 三层规范
20. todo 肥大违反分层（D-2.1）
todo:88-101/251-267/293-296 块是 mini 审查报告塞看板（单条 10-30 行），应压成指针进 docs。建议：每条压到「ID — [P级] 一句话 — 详见<文档>」。
21. 重复收口（D-4.1-4.3）
HumanNode 审批三处（功能决策记录未瘦身为指针，B-03 文档标真相源但功能决策记录仍全文重复）；密钥迁移两处（全局review 应仅留指针）；FR-S1 四处（todo 与 URGENT 既重复又矛盾）。建议：真相源收口，余改指针。
22. 文档记录规范未在 INDEX 突出（D-5.3）
文档记录规范-2026-06-14.md 是三层规范权威定义，INDEX 仅普通条目，README 未提。建议：INDEX/README 加「规范基准」标注。
P3 技术/工具文档
23. Tauri-IPC 全篇过时（C-4.2）
:8 「仅 greet 示例」→实际 68 commands；:16-23 待实施 5 项全落地；:35 frontend/src/→实际 src/。建议：重写或归档。
24. View 改造指南全篇过时（C-4.3）
:7-13 当前问题 4 项全解决；:80-86 页面 ProjectsView 等（实际无 View 后缀，无 WorkflowView）。建议：归档（与 DEVFLOW-3 重复）。
25. SQLite 表数 V1-V9→V1-V13（C-4.1，与 §10 同源）
26. 锚点顿号 + 路径风格（A/D）
INDEX:107-109 #四crate-结构 锚点顿号渲染器差异（低危）；功能创意池:150 链接省 ./ 风格不一。
✅ 一致性良好
- df-knowledge 模块文档：与代码吻合
- 规格契约自检机制：活契约机制描述准确
- 功能决策记录：状态标注详尽且与 todo 对齐（决策反转有留痕）
- 经验记录：落地项均标 ✅ + commit
- todo.md：项目内最准真相源，审查报告交叉对照基本可靠
- 悬空链接 0：全量 markdown 链接目标全部存在
📊 摘要
| 类别 | 数 | 代表 |
|---|---|---|
| P0 文档硬伤 | 4 | ARCHITECTURE 数据模型 / df-nodes / df-ai / 使用手册 |
| P1 审查断层 | 4 | R-P1/P2 未回写 / 复核新①③④⑪ / §8 表 / CR-03 子项 |
| P1 模块过期 | 4 | df-workflow / df-storage / 对抗评估 / df-execute |
| P1 索引计数 | 4 | 13→8 / INDEX漏 / commands冲突 / URGENT |
| P2 迭代规范 | 6 | DEVFLOW / Phase1 / Phase2 / todo肥大 / 重复 / 规范未突出 |
| P3 技术文档 | 4 | Tauri-IPC / View指南 / SQLite / 锚点 |
最优先：P0 四项（ARCHITECTURE 数据模型重写 / df-nodes 重写 / df-ai 删虚构 / 使用手册重写）—— 按文档找代码会落空，误导接手方最强。
已本会话补正：INDEX 漏列 9 文档 + 09 目录（DOC-14 部分）；ID 碰撞 B-260615-31→34。
todo 映射：DOC-260615-01~14（见 docs/todo.md「文档核对待修项」）。