# 文档全量核对报告（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-1~6 / R-P2-1~13 已实施 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「文档核对待修项」）。
