DevFlow/URGENT.md

🔴 加急待办清单

⚠️ 2026-06-14 快照，已停用（仅留历史） 下述 5 个 P0（AC3 / FR-S7 / FR-S8 / B-03b-R8 / FR-S1）已全部迁入 docs/todo.md 并完成（均标记 - [x] ✅），后续跟踪请看 docs/todo.md。本文件不再维护，原文保留以备决策史追溯。

来源：DevFlow 任务系统核对 + docs/todo.md，2026-06-14 汇总 说明：仅收录 P0（用户可感硬伤 / 数据安全 / 功能不可用）+ 关键 P1 项

---

P0 — 必须优先修复

1. B-260614-AC3 历史中毒无自愈（对话永久卡死）

• 现象：畸形 tool_use/tool_result 一旦入历史，用户重发 → build_for_request 带毒 → 服务端 500 → 永久死循环，用户「再也对话不了」
• 根因：stream_recv.rs 收 500 时只 emit AiError + return None，不清理毒历史；agentic.rs 直接 return，ContextManager 中毒消息原封不动
• 修法：stream_llm 收 500/格式错时，检测 ContextManager 最后一轮未闭合 tool 配对（assistant 有 tool_call 但无对应 tool_result），剔除该对；或提供「修复当前对话」IPC 操作
• 涉及文件：src-tauri/src/commands/ai/{stream_recv.rs, agentic.rs}、crates/df-ai/src/context.rs

2. FR-S7 write_file 覆盖已有非空文件无确认/备份

• 现象：2026-06-14 实测事故——AI 误把 write_file 当 edit 用，只传头部 3 行把 PROGRESS.md 762 行/72KB 覆盖成 248 字节
• 根因：tool_registry.rs write_file handler 无目标文件存在性检测，直接覆盖
• 修法：覆盖非空文件前自动备份 .bak 或检测目标存在强制走 edit_file；写入后返回新旧大小对比，差异巨大时 warn
• 涉及文件：src-tauri/src/commands/ai/tool_registry.rs

3. FR-S8 路径 sandbox 系统性逃逸

• 现象：validate_path 三处缺陷可被绕过，AI 工具能读写 workspace 外文件
• 根因：① 子串 .. 检测对绝对路径无效 ② canonicalize 仅覆盖已存在路径（write_file 新建漏） ③ Windows starts_with 大小写敏感
• 修法：统一 canonicalize（不存在取最长存在前缀）+ 大小写不敏感 prefix 比较 + parent 校验 + symlink 不跟随
• 涉及文件：src-tauri/src/commands/ai/tool_registry.rs:19-21,53-69

4. B-03b-R8 缺 human 节点端到端集成测试

• 现象：前端无 human DAG 入口，demoDag 仅 script，单测绿但不覆盖 human→弹窗→审批→返回链路
• 影响：审批闭环的 R6/R7 类 bug 存活土壤，无测试兜底
• 修法：前端加 human DAG 入口（测试用 DAG），端到端验证 审批弹窗→通过/拒绝→工作流继续/取消
• 涉及文件：src/views/ProjectDetail.vue、crates/df-nodes/src/human_node.rs

5. FR-S1 api_key 明文落盘（剩余项）

• 现状：IPC mask 已修（commit 49ac060），前端不持明文。剩余：DB migrations.rs:446 api_key TEXT NOT NULL 明文落盘
• 修法：迁移 keyring 单列存储（keyring crate），DB 不存原始 key
• 涉及文件：crates/df-storage/src/migrations.rs、src-tauri/src/commands/ai/commands.rs

---

P1 — 重要，尽快处理

6. B-260614-AC1 anthropic_compat tool_use_id None 发 null

• 现象：tool_call_id 为 None 时序列化为 "tool_use_id": null，触发服务端 500
• 修法：None 时 skip 该 tool_result 块或填占位 id + warn
• 涉及文件：crates/df-ai/src/anthropic_compat.rs:297

7. AR-6 Low 工具失败语义冲突

• 现象：工具执行失败时 emit AiError 置 streaming=false 但 agentic loop 续跑，残留文本 flush 又"完成"，状态紊乱
• 涉及文件：src-tauri/src/commands/ai/{audit.rs, agentic.rs:195}

8. F-260614-01 模型能力系统 Phase 1

• 说明：设计已完成。ModelCapability 数据模型 + ModelRouter 重写 + 7 调用点接入 + Settings 模型池编辑 UI + AiChat 模型下拉
• 涉及文件：crates/df-ai/、src-tauri/src/commands/ai/、src/views/Settings.vue、src/components/AiChat.vue

9. F-260614-07 df-ai-core trait 下沉拆 crate（架构前置）

• 说明：解锁 F-03（灵感对抗评估接 LLM）。统一为全局 AI trait 下沉独立 crate，df-ideas/df-nodes 依赖 trait 而非 df-ai 具体 impl
• 设计文档：docs/02-架构设计/F-07-df-ai-core-trait下沉设计-2026-06-14.md

10. T-260614-01 多项未 tauri dev 实测

• 说明：Sprint 9-18 积累的未实测项——评分 IPC / promote_idea / token 落库 / 知识库 Tier 1 全栈 / LLM 并发 Semaphore / 知识生命线
• 风险：编译通过 ≠ 运行正确，多轮未实测积压隐患

11. T-260614-02 切对话不中断路由运行时实测

• 说明：Sprint 8 A 路线场景 2/3 部分场景未运行时验证

---

速查矩阵

#	编号	优先级	类型	一句话
1	AC3	P0	Bug	对话永久卡死，无自愈
2	FR-S7	P0	安全	write_file 覆盖无备份
3	FR-S8	P0	安全	路径 sandbox 可逃逸
4	B-03b-R8	P0	测试	审批闭环无端到端测试
5	FR-S1	P0	安全	api_key DB 明文落盘
6	AC1	P1	Bug	tool_use_id null 触发 500
7	AR-6	P1	Bug	工具失败状态紊乱
8	F-01	P1	功能	模型能力系统 Phase 1
9	F-07	P1	架构	df-ai-core trait 下沉
10	T-01	P1	验收	多项未 tauri dev 实测
11	T-02	P1	验收	切对话不中断实测