docs: 巡检简报+todo 回写(2026-06-15 第2轮)

巡检发现:
- 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行已建,旧副本待清理但非阻塞)

docs/todo.md

@@ -74,7 +74,8 @@
 - [ ] AR-8 delta 节流+滚动 — **重评（2026-06-15）**：前端 rAF 节流已被 ARC-08 覆盖（每帧 ≤1 parse）；剩后端 50ms 合批（B-260615-02 心跳已动 stream_recv.rs，合批可并入同文件）+ 滚动跟随。降优先级 — stream_recv.rs + AiChat.vue 滚动
 - [x] AR-9 ~~friendlyError 硬编码中文~~ ✅ Wave3 完成（friendlyError 全走 i18n.global.t + zh/en 双语补 4 key；TS2589 用 as any 规避 vue-i18n 深度泛型）(commit 9e2aeff)
 - [x] AR-10 ~~想法→灵感迁移残留~~ ✅ 已统一（13 文件批量：i18n zh-CN + 后端错误 + LLM 描述/提示词 + store toast；en 待定 Ideas/Idea、docs 注释低优先略）(commit 65c475b)
-- [ ] AR-11 数据变更联动刷新（推荐方案A 后端 emit + store 监听）— 跨层 — 详见 [审查第五章](./02-架构设计/aichat审查报告-2026-06-14.md) — **勘察完成(2026-06-15,wxflofhf2)**:feasible/risk 中/跨 8 文件(audit.rs/commands.rs/tool_registry.rs/stores/project.ts/useAiEvents.ts/Projects/Tasks/ProjectDetail.vue)。方案A 方向合理(emit df-data-changed+entity/action 分类+store listen)但勘察 implPlan 含伪代码错误(std::env::var/.match Rust 不存在=agent 幻觉)+碰 7 近期活跃文件含未提交 P0 改动的 commands.rs。**暂缓**:等本批提交后主代理重设计 emit 点(audit.rs 签名是否有 app_handle 待核查)再派
+- [x] AR-11 ✅(定时走查第3轮,2026-06-15,dc27e79) — ~~数据变更联动刷新~~（推荐方案A 后端 emit + store 监听）— 跨层 — 详见 [审查第五章](./02-架构设计/aichat审查报告-2026-06-14.md) — **勘察完成(2026-06-15,wxflofhf2)**:feasible/risk 中/跨 8 文件(audit.rs/commands.rs/tool_registry.rs/stores/project.ts/useAiEvents.ts/Projects/Tasks/ProjectDetail.vue)。方案A 方向合理(emit df-data-changed+entity/action 分类+store listen)但勘察 implPlan 含伪代码错误(std::env::var/.match Rust 不存在=agent 幻觉)+碰 7 近期活跃文件含未提交 P0 改动的 commands.rs。**暂缓(原)**:等本批提交后主代理重设计 emit 点 — **第2轮定时走查复核(2026-06-15):后端已实施 ✅,前端半接通 🔴** — 后端 `emit_data_changed`(audit.rs:259-270）+ 自动执行路径（audit.rs:351）+ 审批路径（commands.rs:175）三处 emit 就位且逻辑正确；前端工作区（project.ts:31-55,109-110）定义 `startDataChangedListener`/`stopDataChangedListener` + export，**但 App.vue onMounted 未挂载 → listener 永不 attach → 数据变更后列表不刷新（AR-11 功能失效，后端 emit 成死事件）**。修：App.vue onMounted 调 `startDataChangedListener()` + onUnmounted stop（对齐 workflow listener 生命周期）。详见 [定时走查-2026-06-15-第2轮.md](./05-代码审查/定时走查-2026-06-15-第2轮.md)
+  > **第3轮(2026-06-15):listener 已 attach ✅** — dc27e79 `App.vue:218` onMounted `await startDataChangedListener()` + :258 onUnmounted stop。AR-11 功能闭环（后端 emit df-data-changed + 前端 listen 按 entity 调 load）。详见 [定时走查-2026-06-15-第3轮.md](./05-代码审查/定时走查-2026-06-15-第3轮.md)
 
 ### 🔴 aichat API Key 401 排查（2026-06-15）
 
@@ -196,18 +197,65 @@
 > 4 路并行代理走查工作区 22 文件 547 行（AiChat/View/stores/composables+ToolCard），详见 [工作区多角度走查-2026-06-15.md](./05-代码审查/工作区多角度走查-2026-06-15.md)。3 P0 功能 bug + 1 P1 i18n + DRY/健壮性一组。
 
 **P0 — 功能 bug**
-- [ ] B-260615-31 — **[P0]** selectType 字段名与后端 IPC 不匹配 → 多选审批静默失效。`project.ts:273` 传 selectType(camelCase)，后端 `workflow.rs:211` 签名 select_type(snake_case)，Tauri 2 默认不转换 → 后端收 None 归一化 Single → 多选提交被拒「单选只能一个决策」。单选偶然兼容掩盖。铁证：同 invoke 的 execution_id/node_id 已 snake_case 唯独此项破坏 + grep selectType src-tauri/ 零命中。修：`selectType:`→`select_type:` + 删错误注释 — stores/project.ts:273 — 详见走查 ①
-- [ ] B-260615-32 — **[P0]** 流式 timeout/error/stop 收尾不清队列 → 队列消息静默丢失。drainQueue 仅 AiCompleted 触发(useAiEvents:218)，onStreamTimeout/AiError/stopChat 三路径不清 state.queue → 生成中输入的消息丢失无提示。approveToolCall catch 同漏。修：三路径 + approve catch 补 `state.queue=[]` + 提示。关联 B-260615-22(状态不同步，不同角度) — useAiSend.ts:36-42 + useAiStream.ts onStreamTimeout + useAiEvents.ts AiError case + useAiSend.ts:82-107 — 详见走查 ②
-- [ ] B-260615-33 — **[P0]** onStreamTimeout 不回滚 running toolCall → 审批后卡片永久骨架屏。approveToolCall 乐观置 running，后端 hang 时看门狗触发 onStreamTimeout 只复位 streaming 不碰 toolCalls[].status → running 态只渲染骨架(ToolCard:24) 审批按钮不显 → 无重审入口。**B-260615-07 残留**(B-07 加了 watchdog 但回调没回滚 status)。修：onStreamTimeout 扫一遍 running toolCall→rejected — useAiStream.ts:21-49 — 详见走查 ③
+- [x] B-260615-34 ✅(定时走查复核,2026-06-15) — ~~selectType snake_case 对齐~~ `project.ts:273` 已改 `select_type: ... ?? 'single'` + 正确注释「Tauri 2 IPC 不转 camelCase,须 snake_case 对齐后端 workflow.rs:211」;后端 `workflow.rs:211` 同 `select_type: Option<String>`,前后端契约对齐。**纠正上轮过时判断**(上轮压缩前快照仍 camelCase,之后 `80b9243`「P0 bug 修复」批已修;后端代理经 IPC 签名推断「前端已对齐」结论正确) — stores/project.ts:273 — 详见定时走查 P0复核.md
+- [x] B-260615-32 ✅(定时走查第2轮复核,2026-06-15,f93b758) — ~~流式收尾清队列~~ **[原 P0]**drainQueue 仅 AiCompleted 触发(useAiEvents:218)，onStreamTimeout/AiError/stopChat 三路径不清 state.queue → 生成中输入的消息丢失无提示。approveToolCall catch 同漏。修：三路径 + approve catch 补 `state.queue=[]` + 提示。关联 B-260615-22(状态不同步，不同角度) — useAiSend.ts:36-42 + useAiStream.ts onStreamTimeout + useAiEvents.ts AiError case + useAiSend.ts:82-107 — 详见走查 ②
+  > ⚠️ **第2轮复核更正(2026-06-15):已修 ✅** — f93b758「修复: B-32+33 流式收尾」:`useAiStream.ts:28` `state.queue=[]`(onStreamTimeout) + `useAiEvents.ts:225`(AiError) + `useAiSend.ts:152`(stopChat)/124(approveToolCall catch)四路径全清队列。上轮「仍未修」为过时快照（working tree 当时旧版，与 B-34 同）。详见 [定时走查-2026-06-15-第2轮.md](./05-代码审查/定时走查-2026-06-15-第2轮.md)
+- [x] B-260615-33 ✅(定时走查第2轮复核,2026-06-15,f93b758) — ~~回滚 running toolCall~~ **[原 P0]**approveToolCall 乐观置 running，后端 hang 时看门狗触发 onStreamTimeout 只复位 streaming 不碰 toolCalls[].status → running 态只渲染骨架(ToolCard:24) 审批按钮不显 → 无重审入口。**B-260615-07 残留**(B-07 加了 watchdog 但回调没回滚 status)。修：onStreamTimeout 扫一遍 running toolCall→rejected — useAiStream.ts:21-49 — 详见走查 ③
+  > ⚠️ **第2轮复核更正(2026-06-15):已修 ✅** — f93b758:`useAiStream.ts:43-45` onStreamTimeout 单遍反向扫描 running toolCall→rejected（合并探测 completed 为单次 O(n)）。上轮「仍未修」为过时快照。详见 [定时走查-2026-06-15-第2轮.md](./05-代码审查/定时走查-2026-06-15-第2轮.md)
+- [x] B-260615-35 ✅(定时走查第3轮复核,2026-06-15,b08adcb) — **[原 P0]** broadcast `Lagged` 兜底仅 warn → 关键终态事件丢失时前端永久卡死。`workflow.rs:90-110` forward 任务靠 `finished = matches!(event, WorkflowCompleted|WorkflowFailed)` 退出，broadcast 滑动窗口 Lagged(n) 丢 n 条最旧事件，**代码注释已识别风险但仅 warn 无兜底**；若 Lagged 恰丢终态事件，forward 永远 `rx.recv().await` 等不到 finished → 前端审批/完成弹窗永久卡死，仅靠 DB 轮询兜底（实时性差）。修：Lagged 分支后累计次数/单次 n 过大时查 `WorkflowRepo::get_by_id` 看终态，补 emit workflow-event + break；需把 `state.db.clone()` move 进 forward 任务（当前仅 executor spawn 持有）。低频但无自愈 — src-tauri/src/commands/workflow.rs:90-110 — 详见定时走查 P0复核.md（后端代理 ②）
 
 **P1 — i18n**
-- [ ] CR-260615-08 — **[P1]** i18n 硬编码一组：ProjectDetail:201 多选按钮「确认(N)」🔴 + useAiStream:39-41 onStreamTimeout 两错误文案🟡 + AiChat:675 handleSend toast⚪。英文 locale 中英混杂。修：补 `projectDetail.approvalConfirm/Count` + `ai.streamInterrupted(AfterTool)` + `aiChat.toastSendFail` 中英 key 改 `t()`。confirmClearChat 硬编码接 B-260615-20 已记技术债一并清 — ProjectDetail/useAiStream/AiChat + i18n — 详见走查 ④
+- [ ] CR-260615-08 — **[P1]** i18n 硬编码一组（定时走查第4轮扩展:原记 3 处,实际 **40+ 处**；i18n key 树本身优秀 466 key zh/en 全对齐 0 缺,问题全在 src/ 硬编码）。**P1 直接破坏 i18n（最高优先）**：①useAiEvents:182 `tc.result='用户拒绝了此操作'` 绕过已有 aiTool.rejectedHint → en locale 拒绝提示恒中文（已有 en 翻译被一行废掉），**改一行删/换 t() 最高 ROI**；②TaskDetail.vue 整页 13 处未接 i18n（无 taskDetail namespace，需新建）；③ProjectDetail 审批/导入 5 处（导入目录/确认N/取消/confirmDialog/Message）；④Dashboard:76 暂无项目；⑤AiChat:107/471/687（title清空/confirmDialog/showToast）。**P2**：⑥ToolCard:152-164 ARG_LABEL_MAP 11 审批参数标签硬编码（aiTool 无 key，需新增 argLabels.*）；⑦store error fallback 11 处全中文（knowledge/ideas/projects/tasks/workflow）；⑧useAiSend:49/65/130（队列满/审批未送达）；⑨useAiStream:52-53 看门狗两文案（原 CR-08 行号 39-41 偏差）。**P3**：⑩time.ts:46-51 相对时间中文（已有 common.justNow/minutesAgo 等 key 却没用，en locale 时间恒中文，隐蔽）；⑪router meta.title 8 处（0 消费方死代码）；⑫fallbackLocale:'en' 设计气味。修：按视图分批接入，**P1-1 改一行先做** — 全 src/ + i18n — 详见定时走查第4轮.md
 
 **P1/P2 — DRY + 健壮性**
-- [ ] CR-260615-09 — **[P1]** 四份 .ai-md 样式逐字重复 ~180 行(ProjectDetail/Ideas/Knowledge/TaskDetail) → 抽全局 `src/styles/ai-md.css` 或 `<AiMarkdown>` 组件。B-24/25 复制粘贴源头 — 详见走查 ⑤
+- [ ] CR-260615-09 — **[P1]** 五份 .ai-md 样式逐字重复 ~350 行(AiChat/ProjectDetail/Ideas/Knowledge/TaskDetail) → 抽全局 `src/styles/ai-md.css` 或 `<AiMarkdown>` 组件。TaskDetail.vue:263-333 新文件继续抄（CR-09 复发，定时走查 06-15 确认第 5 份）。B-24/25 复制粘贴源头 — 详见走查 ⑤ + 定时走查 P0复核.md
 - [ ] CR-260615-10 — **[P2]** useMarkdown 加 `useRendered(getText)` 辅助，消除 renderedDesc computed + onMounted(loadMarkdown) 三处重复(与 CR-09 同源) — 详见走查 ⑥
-- [ ] CR-260615-11 — **[P2]** composables+ToolCard 健壮性一组：⑦switchConversation JSON.parse 无逐条容错(单条坏 args 清空整对话 useAiConversations:81) ⑧args 消费 `as any` 类型逃逸(ToolCard:241,328) ⑨approveToolCall 重复查找应复用 findToolCall(useAiSend:82) ⑩useAiEvents switch 缺 AiHeartbeat case(:118) ⑪approveHumanApproval 签名 decision/decisions 歧义(project.ts:255) ⑫ToolCard formatBytes/命名判定/key 兜底 — 详见走查 ⑦~⑫
+- [x] CR-260615-11 ✅(定时走查第2轮复核,2026-06-15,fddca9d) — ~~composables+ToolCard 健壮性一组~~ **[原 P2]** ⑦⑧⑨⑩⑪⑫ fddca9d 已实施（JSON.parse 逐条容错/argString 去 as any/复用 findToolCall/AiHeartbeat 显式 case/approveHumanApproval 签名收敛/formatToolName 兜底）。原问题：⑦switchConversation JSON.parse 无逐条容错(useAiConversations:81) ⑧args 消费 `as any` 类型逃逸(ToolCard) ⑨approveToolCall 重复查找(findToolCall) ⑩useAiEvents switch 缺 AiHeartbeat case ⑪approveHumanApproval 签名歧义 ⑫ToolCard 兜底。**⚠️⑪ 实施引入死逻辑**：workflow.ts:67-68 decision 三元两分支相同（见 CR-260615-18）— 详见走查 ⑦~⑫ + 定时走查第2轮.md
 - [ ] CR-260615-12 — **[P3]** 可选一组：_toastTimer 卸载未清(AiChat:436) + markdown 外层 span→div + SVG 常量散落 + appSettings 注释 + index 空行 + 路由 icon 语义 + options shape 校验 + projectNameById 共享 + useConfirm dev 警告 + i18n `t` as any — 详见走查 ⚪ 区
+- [x] CR-260615-18 ✅(定时走查第3轮,2026-06-15,f574562) — **[原 P2]** decision 三元两分支相同死逻辑(CR-11⑪ 实施引入)：`workflow.ts:67-68` `selectType === 'multiple' ? decisions[0] ?? '' : decisions[0] ?? ''` 两分支返回值完全一致，三元判断无意义，误导维护者以为单/多选差异化。后端 workflow.rs:291-296 兜底（空 picked+非空 decision push）。修：直接 `const decision = decisions[0] ?? ''` 删三元 — src/stores/project/workflow.ts:67-68 — 详见定时走查第2轮.md
+- [x] CR-260615-19 ✅(定时走查第3轮,2026-06-15,f574562) — **[原 P3]** action 字段（保留为未来差异化刷新预留,注释已明确）定义 emit 但前端不消费：DfDataChangedPayload.action(api/types.ts:157) 后端 emit_data_changed(audit.rs:243-256) 每次计算，前端 listener(project.ts:33) 只解构 entity，action 忽略，刷新统一全量 load。契约冗余（白算白传）。修：删 action 或做差异化刷新（delete 本地移除）— src/api/types.ts:157 + project.ts:33 — 详见定时走查第2轮.md
+- [x] CR-260615-20 ✅撤销(定时走查第3轮,2026-06-15) — 走查误判:接收方核 workflow.ts:108 stopEventListener 写法一致(f574562 commit 说明),不修 — stopDataChangedListener try/catch 过度防御：project.ts:47-55 unlisten 同步数组操作正常不抛，与 workflow.ts:108 stopEventListener 写法不一致。修：核 workflow.ts:108 对齐统一去/留 — src/stores/project.ts:47-55 — 详见定时走查第2轮.md
+- [x] CR-260615-21 ✅(定时走查第4轮,2026-06-15,94cdcdc) — **[原 P3]** App.vue:218 `startDataChangedListener()` await 包 try/catch console.error（防 Tauri listen 失败 reject onMounted 致 AR-11 静默失效）。原问题：await 无 try/catch — src/App.vue:218 — 详见定时走查第3轮.md
+- [x] CR-260615-22 ✅(定时走查第6轮,2026-06-15,16aeacc) — **[原 P3]** types.ts 枚举注释对齐(Task/Idea/Project status)+ 删 AiConversationSummary.models 冗余 枚举注释与后端不符(api 垂直切片,定时走查第5轮代理 B)：①TaskRecord.status(types.ts:88)注释 review_ready/merged/abandoned 错,后端 TaskStatus(types.rs:165)= todo/in_progress/in_review/testing/done/blocked/cancelled；②IdeaRecord.status(:11)漏 archived；③ProjectRecord.status(:39)漏 testing/releasing。status 字段是 string 非 literal union 不阻断,但注释误导。④AiConversationSummary.models(:233)冗余(后端返但前端无消费点)。修：注释对齐后端枚举/删冗余字段 — src/api/types.ts — 详见定时走查第5轮.md
+- [x] CR-260615-23 ✅撤销(定时走查第6轮,2026-06-15,不适用) — B-34「Tauri 不转」注释在 ARC-05 拆分时已简化(workflow.ts:81/project.ts:58 仅风格对齐无错误说明,16aeacc 接收方核对) — project.ts:273
+- [x] CR-260615-24 ✅(定时走查第7轮,2026-06-15,ef2d033) — **[原 P1]** 分离窗口 listener 双注册+永不清理(Dashboard+AI窗口垂直切片,定时走查第6轮代理 B R1+R2,新功能首次深查)：①R1 双窗口重复消费 ai-chat-event：后端 app.emit 全局广播(stream_recv/agentic/commands/audit 多处)发给所有 webview,主窗口(AiChat.vue:790)+分离窗口(AiDetached 渲染 AiChat)各注册 listen,两窗口 handleEvent 都触发 → delta 各 += 一次/AiAgentRound 各 push 空气泡,靠 App.vue:94 v-if detach 时卸载主窗口 AiChat 间接停但 state 模块级单例 handleEvent 仍写(脆弱隐式契约);②R2 stopListener(useAiEvents.ts:258)定义但**全仓零调用**(地面 grep App/AiChat/AiDetached onUnmounted/onBeforeUnmount 都不调)→ listener+watchdog 永久泄漏。边界影响:reattach 重叠窗口期多一条空 assistant 消息。修：AiChat.vue onBeforeUnmount 补 store.stopListener()+detach 主窗口显式 stop/reattach start,或后端 emit_to(label) 定向 — src/composables/ai/useAiEvents.ts:258 + useAiWindow.ts + components/AiChat.vue:747 — 详见定时走查第6轮.md
+- [x] CR-260615-25 ✅(定时走查第8轮,2026-06-15,ac8dab3) — **[原 P2]** 分离窗口状态机缺口(代理 B R3/R4/R5)：③R3 win.once('tauri://destroyed')置 detached=false 但不恢复 panelOpen=true(只 reattachPanel 显式设)→ X 关分离窗口后面板消失需手动 Ctrl+I;④R4 resumeInDetached(useAiWindow.ts:79-95)强行重建生成态(读 df-ai-gen 置 streaming=true push 空气泡)与后端 ai_is_generating 真值可能失配 → 假气泡/130s 后 watchdog 假超时;⑤R5 分离窗口 switchConversation(useAiWindow.ts:81)+loadConversations 内自动 switch,后端 AiSession 单例 activeConversationId 被覆盖,主窗口期间发消息可能落错会话(B-22 同类延伸)。修：destroyed 补 panelOpen=true/resumeInDetached 先 await ai_is_generating 核对/分离窗口只读不切 — src/composables/ai/useAiWindow.ts — 详见定时走查第6轮.md
+- [x] CR-260615-26 ✅(定时走查第7轮,2026-06-15,7637f29) — **[原 P2]** AR-11 listener 与 B-29 筛选契约交互 + Tasks 空态(列表页垂直切片,代理 A R-1/Y-2)：①R-1 AR-11 监听器(project.ts:38)对 task 调 loadTasks() 无参 → 全量加载,破坏 B-260615-29「store.tasks 反映当前筛选」契约(filteredGroups 二次过滤兜住结果正确,但 store.tasks 变全量+性能);②Y-2 Tasks.vue:39-71 无 loading/error/empty 兜底,加载失败或无结果时空白页(store.error/loading 零引用,对比 Projects.vue:107 至少有空态)。修：listener 对 task 按 activeProject 筛选拉/Tasks 加 v-if loading/error/empty — src/stores/project.ts:38 + src/views/Tasks.vue — 详见定时走查第6轮.md
+- [x] CR-260615-27 ✅(定时走查第7轮,2026-06-15,5e6aa79) — **[原 P2]** Dashboard 一组(代理 B M1/M3/L4)：①M1 refresh(Dashboard.vue:202-204)Promise.all 无 try/catch,任一接口失败 unhandledrejection+用户无反馈(onMounted 有 try/catch 但 refresh 无);②M3 getProjectStage(:150)status→stage 映射 planning 归 coding stage(颜色紫)但 label planning,颜色语义撒谎(cancelled 归 testing 同);③L4 决策/批注两 panel(:103-120)永远空态,CSS(:504-572)完整但模板未用=死代码。修：refresh 包 try/catch+toast/补 planning CSS 类/删死代码或接数据 — src/views/Dashboard.vue — 详见定时走查第6轮.md
+- [x] CR-260615-28 ✅(定时走查第8轮,2026-06-15,40461b2) — **[原 P1]** knowledge store state.error 死字段(error 通道前端断)+create 语义矛盾(stores 垂直切片,定时走查第7轮)：①state.error(knowledge.ts:19,49,53,64,74,105)写入但**全应用零消费**(grep Knowledge.vue store.error 零命中)→ 用户遭遇加载/检索/配置失败只看到空白列表无错误提示,**CR-08「store error fallback 11 处中文」深化**:不仅中文硬编码,整个 error 通道前端断的;②create(:80-85)成功后 loadCandidates 失败把错误塞 state.error,create 已返回 record 给调用方认为成功,语义自相矛盾。修：Knowledge.vue 接 error banner/toast 或删 state.error 改 throw 由调用方 catch + create 内 loadCandidates 失败不污染 error — src/stores/knowledge.ts — 详见定时走查第7轮.md
+- [x] CR-260615-29 ✅(定时走查第9轮,2026-06-15,6116c9b) — **[原 P2]** ai.ts messages 单对话无上限 + knowledge 异步竞态/错误不一致(定时走查第7轮)：①ai.ts state.messages(useAiSend push user+ai/useAiEvents push err 审批/useAiStream push delta)单对话内线性增长,长会话+大工具结果内存可观(切换对话整体替换是减负点,同对话不轮换),建议软上限/滚动淘汰;②knowledge.ts 加载/检索/配置异步无竞态保护(messages 有 switch token,items/config 无),快速连点后返回覆盖先;③knowledge 错误处理不一致(load*/search 有 catch 兜底,create/updateStatus/archive/saveConfig/extractNow 直抛)。修：messages 软上限/items+config 加请求序号/错误处理统一 — src/stores/ai.ts + knowledge.ts — 详见定时走查第7轮.md
+- [x] CR-260615-30 ✅(定时走查第8轮,2026-06-15,b300bb7) — **[原 P3]** appSettings useSetting 对象/数组值深 mutate 不落库(定时走查第7轮边界)：useSetting 双 watch 用 Object.is 守卫防循环,但对对象/数组值深 mutate(r.value.x=1)时 Object.is(v,cache[key]) 同引用恒 true → 不触发 set 落库,静默不持久化。当前无 bug(useSetting 多绑值类型,df-ai-ui 走 set 整对象替换非 mutate),但隐式契约。修：文档注明 useSetting 仅值类型,或对象值用 JSON 序列化比较 — src/stores/appSettings.ts:88-113 — 详见定时走查第7轮.md
+- [x] CR-260615-31 ✅(定时走查第9轮,2026-06-15,2ddd294) — **[原 P2]** 小区域收尾健壮性一组(定时走查第8轮,无必修)：①useConfirm 并发 confirmDialog 覆盖 resolve(useConfirm.ts:35-47),前一个 Promise 永挂(连点两删除/confirm 交错时)→ 静默中断+轻微内存泄漏,修：进入时 resolve?.(false) 打断前一个视为取消;②ToolCardList collapseInactive(:47-51)只清 expandedCards 漏清 expandedTools,已完成卡片折叠后内容展开态残留 Set,修：对称过滤或注释明确有意保留 — src/composables/useConfirm.ts + components/ToolCardList.vue — 详见定时走查第8轮.md
+
+### 📄 文档核对待修项（2026-06-15）
+
+> 4 路并行核对 docs 全量 + 根目录文档，详见 [文档全量核对报告-2026-06-15.md](./05-代码审查/文档全量核对报告-2026-06-15.md)。悬空链接 0。
+
+**P0 — 文档硬伤（按文档找代码落空）**
+- [ ] DOC-260615-01 — **[P0]** ARCHITECTURE.md 数据模型整段重写（14 表 6 虚构 artifacts/connections/features/test_cases/test_runs/annotations/decisions + 7 遗漏 node_executions/branches/ai_conversations 等；workflow_defs/runs 合并 workflow_executions）— ARCHITECTURE.md:262-475 — 详见核对报告 §1
+- [ ] DOC-260615-02 — **[P0]** df-nodes 模块文档重写（8 节点全骨架 → 实际 3 节点 ai/script/human 均完整实现；删 Docker/Git/Notify/HTTP/Subflow 5 虚构）— 03-模块文档/df-nodes — 详见 §2
+- [ ] DOC-260615-03 — **[P0]** df-ai 模块文档删虚构 router.rs/stream.rs + 已删 supported_features trait + 12→13 工具 — 03-模块文档/df-ai — 详见 §3
+- [ ] DOC-260615-04 — **[P0]** 使用手册全面重写 7 处（运行命令 bun→npm / 任务状态 4→7 态 / 优先级方向 / 节点类型 Script/Ai/Human / EventBus 非 WebSocket / 多 Provider / 知识库 Tier1）— 08-用户指南/使用手册 — 详见 §4
+
+**P1 — 审查状态断层**
+- [ ] DOC-260615-05 — todo 补全局 review R-P1-1~6/R-P2-1~13 已完成回写（报告说全闭环 126 test pass，todo 零条目）— 已完成区补汇总 — 详见 §5
+- [ ] DOC-260615-06 — 架构复核报告 §5 新发现 11 项补 todo（复核-新①③④⑪ 待补：pendingToolCalls 二次 token / NodeCancelled 事件语义 / cancel 终态守卫 / 主窗口幽灵 watchdog；余已被全局 review 取代）— 详见 §6
+- [ ] DOC-260615-07 — aichat §8 表 9 行 + 工作流审批 TL;DR 已修项补 ✅ 勾选（H1/H2/create_project/AR-5~10 + human_node.rs:41 await B-03b-R6）— 详见 §7
+- [ ] DOC-260615-08 — 近期改动 CR-03 未做子项拆独立 todo（audit.rs 三臂 / openai Error::from / ToolCard projectNameById find）— 详见 §8
+
+**P1 — 架构/模块文档过期**
+- [ ] DOC-260615-09 — df-workflow 模块文档 4 处过期（NodeRegistry 删 Default / conditions 默认 true→false / try_recv_human_approval 已删 / set_waiting·set_skipped 已删）— 详见 §9
+- [ ] DOC-260615-10 — df-storage V8→V13（迁移版本+表数 11→18+Repo 11→17）+ 对抗评估 idea_evaluations 设计稿标未实施 + df-execute 描述删 Docker/SSH/Git — 详见 §10-12
+
+**P1 — 索引/计数矛盾**
+- [ ] DOC-260615-11 — 13→8 crate 多处统一（PROGRESS/INDEX/Phase1决策/对抗裁决/想法探索）+ commands 数 47/57/68 统一 68 + URGENT.md 停用标注或删 — 详见 §13/15/16（INDEX 漏列部分本会话已补，见 DOC-14）
+
+**P2 — 迭代/Phase/规范**
+- [ ] DOC-260615-12 — DEVFLOW-1~4 + Phase1/Phase2 标完成或归档（Phase1 已收尾文档仍全待实施）— 详见 §17-19
+- [ ] DOC-260615-13 — todo 肥大瘦身（大段详情移 docs 子目录）+ 重复收口（HumanNode 审批/密钥迁移/FR-S1）+ 文档记录规范在 INDEX 突出 — 详见 §20-22
+
+**P3 — 技术/工具文档**
+- [ ] DOC-260615-14 — Tauri-IPC/View 改造指南全篇过时重写或归档 + SQLite 表数 V1-V9→V1-V13 + 锚点顿号 — 详见 §23-26
 
 ### 🟡 B-03b 复核后续（独立深度复核，2026-06-14）
 
@@ -278,7 +326,18 @@
 - [x] B-260615-21 ✅(P0批,2026-06-15,待commit) — ~~sendMessage catch 回滚 user message~~ push user msg 前捕获 const userMsgId(原内联未生成)+catch 块 filter 改 m.id!==aiMsgId && m.id!==userMsgId 一并回滚;机制:user/ai msg 均 nextMsgId() 唯一 id+push 进 state.messages(无索引依赖,按 id 过滤最稳) — useAiSend.ts
 
 **P2 — 前后端状态同步**
-- [ ] B-260615-22 — [P2] 前后端状态不同步：前端 state.streaming 与后端 generating 各自维护，后端卡死/异常退出时前端不知情（streaming 可能已被 AiError 复位 false，预检 useAiSend.ts:36 放行撞后端 :45 拦截）。评估：发送前 IPC 查后端真实 generating，或卡死主动 emit 状态同步事件。
+- [ ] B-260615-22 — [P2] ~~前后端状态不同步~~ → **由 B-260616-01(L0 握手) + B-260616-02(L2 强制发送) 解决**，本条保留为问题记录不再独立实施
+- [ ] CR-260615-12 — **[P3]** 可选一组：_toastTimer 卸载未清(AiChat:436) + markdown 外层 span→div + SVG 常量散落 + appSettings 注释 + index 空行 + 路由 icon 语义 + options shape 校验 + projectNameById 共享 + useConfirm dev 警告 + i18n `t` as any — 详见走查 ⚪ 区
+- [ ] CR-260615-09 — **[P1]** 五份 .ai-md 样式逐字重复 ~350 行(AiChat/ProjectDetail/Ideas/Knowledge/TaskDetail) → 抽全局 `src/styles/ai-md.css` 或 `<AiMarkdown>` 组件。TaskDetail.vue:263-333 新文件继续抄（CR-09 复发，定时走查 06-15 确认第 5 份）。B-24/25 复制粘贴源头 — 详见走查 ⑤ + 定时走查 P0复核.md
+- [ ] CR-260615-10 — **[P2]** useMarkdown 加 `useRendered(getText)` 辅助，消除 renderedDesc computed + onMounted(loadMarkdown) 三处重复(与 CR-09 同源) — 详见走查 ⑥
+- [ ] CR-260615-08 — **[P1]** i18n 硬编码一组（定时走查第4轮扩展:原记 3 处,实际 **40+ 处**；i18n key 树本身优秀 466 key zh/en 全对齐 0 缺,问题全在 src/ 硬编码）。**P1 直接破坏 i18n（最高优先）**：①useAiEvents:182 `tc.result='用户拒绝了此操作'` 绕过已有 aiTool.rejectedHint → en locale 拒绝提示恒中文（已有 en 翻译被一行废掉），**改一行删/换 t() 最高 ROI**；②TaskDetail.vue 整页 13 处未接 i18n（无 taskDetail namespace，需新建）；③ProjectDetail 审批/导入 5 处（导入目录/确认N/取消/confirmDialog/Message）；④Dashboard:76 暂无项目；⑤AiChat:107/471/687（title清空/confirmDialog/showToast）。**P2**：⑥ToolCard:152-164 ARG_LABEL_MAP 11 审批参数标签硬编码（aiTool 无 key，需新增 argLabels.*）；⑦store error fallback 11 处全中文（knowledge/ideas/projects/tasks/workflow）；⑧useAiSend:49/65/130（队列满/审批未送达）；⑨useAiStream:52-53 看门狗两文案（原 CR-08 行号 39-41 偏差）。**P3**：⑩time.ts:46-51 相对时间中文（已有 common.justNow/minutesAgo 等 key 却没用，en locale 时间恒中文，隐蔽）；⑪router meta.title 8 处（0 消费方死代码）；⑫fallbackLocale:'en' 设计气味。修：按视图分批接入，**P1-1 改一行先做** — 全 src/ + i18n — 详见定时走查第4轮.md
+
+### 🔴 前后端状态分裂根治（HMR/刷新/切窗口自愈）
+
+> 用户实测(06-15)：DEV 运行中改代码触发 Vite HMR → 前端重载但后端 Tauri 进程未重启 → `generating=true` 残留 → 所有新消息被拦（`ai_chat_send` 同步检查）→ 入队死锁 10+ 分钟不恢复。**根因**：前后端独立生命周期无 reconciliation 协议。**否决超时方案**(5-10min 等死体验差)。选 L0 重接握手(零延迟自愈) + L2 发送韧性(用户可控)。
+
+- [ ] B-260616-01 [P0] — **L0 前端重连握手（状态分裂根治）**。前端每次 startListener 完成后 emit `ai-client-ready` 事件（携带 client_id + last_conv_id）；后端注册 listener 收到后：①`generating=true`? → 强制 reset + emit AiCompleted（补偿事件让前端收尾清 watchdog/续发队列）②`pending_approvals` 有残留? → 清除（审批态已无前端 UI 可操作）③记录 `last_heartbeat = now`。覆盖场景：Vite HMR / 页面 F5 / 分离窗口重建 / 切换标签页后台回收。**改动**：前端 `useAiEvents.ts:startListener()` 末尾加 emit（~3 行）；后端 `mod.rs` 或新建 `commands/ai/handshake.rs` 注册 listener + 状态清洗（~30 行）。**用户体验**：HMR 后零延迟自动恢复，无需用户干预 — src/composables/ai/useAiEvents.ts + src-tauri/src/commands/ai/mod.rs
+- [ ] B-260616-02 [P1] — **L2 发送时强制覆盖（用户可控自救）**。当前行为：`generating=true` → `ai_chat_send` 返回 Err → 前端 catch 静默入队 → 死锁无出口。改进三级降级：①正常(generating=false)→ 直接发送 ②排队(<30s, generating=true)→ 入队 + UI 显示「⚳ 排队中 N 条」+ 可取消按钮 ③异常(>30s 或 用户主动)→ 弹确认「检测到生成状态异常，是否强制发送？」→ 调用新 IPC `ai_chat_force_send` 绕过 generating 检查（后端先 reset generating 再正常走 send 流程）。**关键设计**：30s 后给用户选择权而非永远静默等。**改动**：前端 `useAiSend.ts` sendMessage 加超时分支 + confirm 弹窗；后端 `commands.rs` 新增 `ai_chat_force_send`（复用 ai_chat_send 逻辑，前置 reset generating）。关联 B-10(软复位已做 newConversation, force_send 同模式) — src/composables/ai/useAiSend.ts + src/components/AiChat.vue + src-tauri/src/commands/ai/commands.rs
 
 ### 🔴 详情描述字段 Markdown 未渲染（2026-06-15 用户报障）
 
@@ -308,6 +367,80 @@
 
 - [x] B-260615-31 ✅(2026-06-15,待commit) — ~~TaskDetail + ProjectDetail 字段同行布局~~ `.info-item` flex-direction column→row + align-items baseline + gap 12px + `.label` min-width 88px flex-shrink:0(TaskDetail `.value` 加 flex:1 min-width:0 占余);描述字段 info-item 加 `info-block` class + CSS `.info-item.info-block{flex-direction:column}` 保块状(长文本独占整行);ProjectDetail `.path-row`/`.info-tags` 已 flex-wrap 无溢出风险。vue-tsc 0 err — src/views/TaskDetail.vue + src/views/ProjectDetail.vue
 
+### 🔴 run_command stdout/stderr 恒空（2026-06-15 用户实测）
+
+> 用户实测 F-05 run_command：命令能跑（副作用如写文件发生）+ exit_code 正常，但 **stdout 始终返回空字符串**，echo/Write-Output 等均如此 → "写→跑→**看**→改"闭环断在「看」，跑测试/构建无法获取输出。**根因(铁证)**：`crates/df-execute/src/shell.rs:37-58` 构造 `tokio::process::Command` 时**漏设 `cmd.stdout(Stdio::piped()).stderr(Stdio::piped())`**。tokio 默认 `Stdio::inherit()`（输出继承父进程 Tauri app → 控制台/devnull），`wait_with_output()` 读不到 pipe → `output.stdout/stderr` 空 Vec → `from_utf8_lossy` → 空串。F-05 plan doc 也未提 Stdio 设置，实现遗漏。**PS 静默失败（.Replace()/-replace/Set-Content exit_code=0 文件未变）疑非独立 bug**：修了 piped 后 stderr/stdout 可观测，方能定位是「PS Replace 源不匹配」（AI 用法）还是「cmd /C 调 PS 引号问题」（shell.rs:38 Windows 用 cmd /C，PS 语法引号嵌套易错）。**B-38 待 B-37 修复后据观测重评**。
+
+- [ ] B-260615-37 [P0] — **shell.rs execute 补 Stdio::piped()**。`shell.rs:58` spawn 前 加 `cmd.stdout(Stdio::piped()).stderr(Stdio::piped())`（需 `use tokio::process::Stdio;`）。修后 stdout/stderr 正常捕获，run_command 闭环恢复。最小改动 1 行 + import — crates/df-execute/src/shell.rs:37-58 — source:用户实测(06-15)
+- [ ] B-260615-38 [P1] — **PS 静默失败根因**（待 B-37 修后据 stderr 观测重评）。候选：a) PS Replace/-replace 源字符串不匹配（AI 用法，非 bug）；b) shell.rs:38 Windows `cmd /C` 不适配 PS 语法（引号嵌套/管道），需支持 shell 选择（powershell -NoProfile -Command / cmd /C / sh -c）。B-37 修复前无法定位 — crates/df-execute/src/shell.rs:37-39 — source:用户实测(06-15)
+
+### 🔴 查看灵感来源跳空白页（2026-06-15 用户报障）
+
+> 用户报障：项目详情点「来源灵感」(i18n key `projectDetail.sourceIdea`) 跳转后页面空白。**根因双锁**：① `ProjectDetail.vue:71` `router-link :to="/ideas/${idea_id}"` 指向 `/ideas/:id`，但**路由表(router/index.ts:21-25)只有 `/ideas` 精确路由，无 `:id` 子路由** → hash 路由无匹配 → 渲染空白（路由表无 404 catch-all 兜底）。② 即便补路由，`Ideas.vue` 不读 route params——`:209` import 无 `useRoute` / `:221` 只 `useRouter` / `:448-450` onMounted 只 `store.loadIdeas()` 不接 params → `selectedId`(:230) 纯内部 ref，无法 deep link 选中灵感。**数据层 OK**：`Project.idea_id` 字段(models.rs:38)+晋升写入(idea.rs:124)，ProjectDetail 拿得到 idea_id。**对照**：`/projects/:id` `/tasks/:id` 路由已建(独立详情页)，Ideas 是双栏列表+详情同页故未建 `:id`，但 ProjectDetail 反向溯源需 deep link。
+
+- [ ] B-260615-36 [P1] — **查看灵感来源跳空白页**。修复两层：① `router/index.ts` 加 `/ideas/:id` 路由(name `IdeasDetail` 或复用 Ideas 组件)；② `Ideas.vue` 加 `useRoute` + `onMounted` 读 `route.params.id`→`selectedId.value=id`（loadIdeas 后校验 id 在 `store.ideas` 中，不在则提示「灵感不存在/已删」+清 selectedId）；可选 watch `route.params.id` 支持从详情再点别的灵感切换。— src/router/index.ts:21-25 + src/views/Ideas.vue:209,221,448-450 — source:用户报障(06-15)
+
+### 🟡 AiChat 气泡拷贝能力（2026-06-15 用户需求）
+
+> 用户需求：AiChat 消息气泡支持一键拷贝——**文本拷贝**(content 原文→剪贴板) + **截图拷贝**(气泡 DOM 渲染→图片→剪贴板,粘贴出图片)。**现状**：全项目零 clipboard 实现（grep `navigator.clipboard`/`copy`/`clipboard`/`拷贝`/`复制` 零命中）。气泡结构：用户消息 `.ai-msg-bubble--user`(纯文本 `{{msg.content}}`, :185)；AI 消息 `.ai-msg-bubble--ai.ai-md`(v-html 渲染 MD, :197)。**Tauri WebView2(Edge)**：Clipboard API 完整支持(`writeText`/`write([ClipboardItem])`)，无需额外 plugin（做减法，不用 `@tauri-apps/plugin-clipboard-manager`）。**安全约束**：必须在用户点击事件(手势)内调用剪贴板 API。
+
+- [ ] F-260615-13 [P2] — **AiChat 气泡文本拷贝**。每条消息气泡右上角加拷贝按钮(📋 icon,hover 显示)。点击 → `navigator.clipboard.writeText(msg.content)` → 短暂 toast「已复制」。AI 气泡拷原始 content(非 v-html 渲染后 HTML,防 HTML 标签污染);用户气泡同。按钮位置：`.ai-msg-bubble` 内右下角或 hover 时右上角浮现(不占空间,信息密度优先)。i18n 加 `aiChat.copied` / `aiChat.copyMsg`。— src/components/AiChat.vue(:185 用户/:197 AI) + src/i18n
+- [ ] F-260615-14 [P2] — **AiChat 气泡截图拷贝(图片)**。同位置第二按钮(🖼️ 或与文本拷贝合并为下拉)。技术链：`html2canvas(bubbleElement)` → canvas → `canvas.toBlob('image/png')` → `new ClipboardItem({ 'image/png': blob })` → `navigator.clipboard.write([item])`。需加依赖 `html2canvas`(~90KB,或轻量替代 `dom-to-image-more` ~3KB,待选型)。**注意**:html2canvas 对 CSS 支持有限(阴影/渐变/CSS 变量可能不全),但气泡样式简单(ai-md 基本色+圆框),风险低。粘贴目标:Word/微信/钉钉等富文本编辑器可接图片;纯文本框不行(正常行为)。— src/components/AiChat.vue + 新依赖(html2canvas/dom-to-image-more 待选)
+
+### 🟡 AI Chat 交互体验改进（2025-07-15 方案 → 待办化）
+
+> 来源：[aichat交互体验改进方案-2025-07-15.md](./02-架构设计/aichat交互体验改进方案-2025-07-15.md)。7 大类 20 个改进项，按原文优先级分 4 批。**去重**：§1.3 复制 ⊂ F-260615-13/14（已写）、§3.4 新建中断 ⊂ B-260615-10（已做软复位，本文档加 confirm 增强）、§6.2 分离窗口同步 ⊂ CR-24/25（已写）。**状态: 待讨论→看板跟踪**。
+
+**第一批 — 最高频痛点（每次对话都遇到）**
+
+- [ ] UX-2025-01 [P1] — **流式渲染中选中文字保持**（§2.1）。现象：AI 流式输出时选文字被 delta 打断丢失选区。方案 A(推荐)：`selectionchange` + 选区在消息容器内 → 暂停 rAF 流式 parse → 选区结束恢复；方案 B：已完成块独立 DOM 节点不参与 v-html 替换。关联 ARC-08 块级 memo（splitBlocks 已按块切分，末块单独更新天然支持方案 B）— src/components/AiChat.vue + src/composables/ai/useAiEvents.ts
+- [ ] UX-2025-02 [P1] — **消息操作栏（复制 / 重新生成）**（§1.2+§1.3）。AI 气泡 hover 显示操作栏：「📋 复制」+「🔄 重新生成」。复制 = F-260615-13 合并实现；重新生成：后端删最后一条 AI 消息 + 用倒数第二条 user 消息重跑 agentic loop（新增 `ai_regenerate` IPC）。代码块额外 hover 浮出「📋 复制代码」按钮（§2.2 子项）。— src/components/AiChat.vue + src-tauri/src/commands/ai/commands.rs
+- [ ] UX-2025-03 [P1] — **错误气泡操作入口**（§4.1）。错误气泡底部增加按钮区：「🔁 重试」（取上一条 user 消息重发）+「⚙ 去设置」（仅 auth/provider 错误时显示，跳 Settings→AI Tab）。后端 `AiError` 加 `error_type: Option<ErrorType>` 枚举（auth/network/timeout/provider_config/unknown），前端据此显隐按钮。— src-tauri/src/commands/ai/mod.rs(AiChatEvent) + src/api/types.ts + src/components/AiChat.vue
+- [ ] UX-2025-04 [P1] — **断线保文**（§4.2）。流式中断时已接收文本不丢弃：`stream_llm` mid-stream error 改返回 `Some(partial_text, ...)` + `incomplete: true` 标志；agentic 收到 incomplete → 正常入库 + emit AiCompleted（非 AiError）+ 追加系统提示「⚠ 响应因网络中断不完整」；前端 AI 气泡底显示「继续生成」按钮。关联 B-260615-05(流尽空内容报错)同改 stream_recv.rs。— crates/df-ai/src/stream_recv.rs + src-tauri/src/commands/ai/agentic.rs + src/components/AiChat.vue
+
+**第二批 — 显著提升日常效率**
+
+- [ ] UX-2025-05 [P2] — **代码块语法高亮 + 复制按钮**（§2.2）。集成 highlight.js（按需加载不阻塞首屏），marked renderer code 回调调 `hljs.highlightAuto`；代码块右上角 hover 浮出「📋 复制代码」。依赖 ~30KB（highlight.js core + 常用语言包）。— src/composables/useMarkdown.ts + 新依赖 highlight.js
+- [ ] UX-2025-06 [P2] — **对话搜索**（§3.1）。侧栏 header 加搜索框（实时过滤 conversations 匹配 title）；搜索时取消分组平铺展示；支持 `Ctrl+K` 快捷键聚焦。— src/views/(AiChat|Sidebar).vue
+- [ ] UX-2025-07 [P2] — **键盘快捷键**（§7.1）。Ctrl+N 新建 / Ctrl+K 搜索对话 / Ctrl+L 清空 / Ctrl+Shift+C 复制 AI 消息 / Ctrl+R 重新生成 / Esc 关闭面板 / Ctrl+B 切侧栏。全局监听 AiChat 聚焦时生效。— src/components/AiChat.vue
+- [ ] UX-2025-08 [P2] — **新建对话 confirm 弹窗**（§3.4 增强）。生成中点新建对话时弹 ConfirmDialog（「当前正在生成，确定中断并新建？」），确认后才执行 B-260615-10 的软复位逻辑。防误触中断。— src/components/AiChat.vue + src-tauri/src/commands/ai/commands.rs
+
+**第三批 — 锦上添花**
+
+- [ ] UX-2025-09 [P2] — **编辑已发送消息并重新生成**（§1.1）。用户气泡 hover 显示"✏️ 编辑"，点击回填输入框；发送时后端：①替换目标 message content ②后续所有消息标记 `status='truncated'`（软删除，保留历史可追溯，与 WF-A soft_delete 模式一致）③用 status='active' 的历史重跑 agentic loop。约束：只允许编辑最后一条 user 消息（中间编辑语义复杂+易乱上下文）；generating 中拦住。前端：截断消息从视图移除，loading 等新回复。后端新增 `ai_chat_edit(message_id, new_content)` IPC。— src/components/AiChat.vue + src-tauri/src/commands/ai/(commands.rs|conversation.rs) + df-storage(messages 表加 status 列)
+- [ ] UX-2025-10 [P2] — **@ 实体引用**（§1.4）。输入框支持 `@` 触发实体联想浮层（复用 `/` 技能联想 popover 架构）；联想源：项目列表/任务列表/最近文件；选中展开为 `[项目: xxx]` 标记文本，后端 system prompt 注入上下文摘要。关联 F-260614-02(技能联想)。— src/components/AiChat.vue + src-tauri/src/commands/ai/prompt.rs
+- [ ] UX-2025-11 [P2] — **输入框高度提升**（§1.5）。textarea 最大高度 120px→200px（~10 行），超过后再内部滚动。或可拖拽 resize handle。— src/components/AiChat.vue
+- [ ] UX-2025-12 [P2] — **历史消息分页懒加载**（§2.3）。⏸️ **暂缓**：当前典型对话 <100 条消息，v-for 全量渲染无卡顿；等用户反馈长对话卡顿再做。switchConversation 首次加载最近 50 条，滚顶加载更多（需后端 offset/limit 支持 messages 查询）。或前端虚拟滚动替代。关联 B-260629(messages 无上限)。— src/stores/ai.ts + src/composables/ai/useAiConversations.ts + 后端 conversation.rs
+- [ ] UX-2025-13 [P2] — **消息时间戳**（§2.4）。气泡下方极小字号(dim 色)展示相对时间（复用 time.ts 已有 common.justNow 等 key）；hover tooltip 展示完整时间。— src/components/AiChat.vue
+- [ ] UX-2025-14 [P2] — **Provider 切换反馈**（§5.1）。cycleProvider 切换后 toast 提示 + 0.15s 淡入动画 + bar 展示 model 名称小字。— src/stores/ai.ts + src/components/AiChat.vue
+- [ ] UX-2025-15 [P2] — **技能参数用法展示**（§5.2）。联想浮层每项增加 argument_hint 等宽小字提示；选中技能后输入框上方 chip 展示完整参数格式说明。关联 F-260614-02(技能联想)。— src/components/AiChat.vue
+- [ ] UX-2025-16 [P2] — **侧栏宽度可拖拽**（§6.1）。侧栏右边缘 2px 拖拽条(cursor: col-resize)，范围 120~280px，宽度持久化 df-ai-ui 设置。— src/components/AiChat.vue (sidebar CSS)
+- [ ] UX-2025-17 [P3] — **对话置顶**（§3.2）。ai_conversations 表加 pinned 字段；排序改为 pinned DESC, updated_at DESC；侧栏 hover 图钉按钮。— df-storage + src/views/Sidebar.vue + src/stores/ai.ts
+- [ ] UX-2025-18 [P3] — **对话导出**（§3.3）。后端新增 ai_conversation_export(conv_id, format) 支持 markdown/json/txt；前端侧栏 hover 导出按钮。Markdown 格式：## 用户 / ## 助手交替 + 代码块保留围栏。— src-tauri/src/commands/ai/conversation.rs + src/views/Sidebar.vue
+- [ ] UX-2025-19 [P3] — **消息列表虚拟滚动**（§7.2）。⏸️ **暂缓**：同 UX-12，当前数据量无需虚拟滚动；与 UX-12 合并为一条观察项，等用户反馈长对话卡顿再启动。长对话几百条消息全量渲染卡顿；集成 vue-virtual-scroller 或自研 IntersectionObserver 懒渲染；流式最后一条始终保持挂载。— src/components/AiChat.vue + 新依赖
+- [ ] UX-2025-20 [P3] — **空状态引导 + 标题过渡**（§7.3+§7.4）。空态展示 3-4 示例问题卡片（点击自动填入发送）；无 provider 时引导配置；标题生成后 0.3s 淡入动画 + AI 生成标识图标。— src/components/AiChat.vue
+
+### 🟡 AI Chat 授权体验改进（2025-07-15 方案 → 待办化）
+
+> 来源：[aichat授权体验改进方案-2025-07-15.md](./02-架构设计/aichat授权体验改进方案-2025-07-15.md)。6 痛点 + 8 改进项，按原文优先级转待办。**状态: 待讨论→看板跟踪**。
+
+**P0 — 快速改善体感（第一批建议落地，~2 天工作量）**
+
+- [ ] AE-2025-01 [P0] — **批量审批**。同一轮多 pending 时，ToolCardList 顶部显示「全部批准(N) / 全部拒绝」按钮。改动：①`ToolCardList.vue` 加批量操作栏（监听 pending_approval 数量）②`useAiSend.ts` 新增 `approveAll(rejectAll)` 循环调 `ai_approve`。预估 0.5 天 — src/components/ToolCardList.vue + src/composables/ai/useAiSend.ts
+- [ ] AE-2025-02 [P0] — **审批计数器 + 跳转**。输入框上方/header 显示 `⏳ N 项待审批` 徽标，点击跳转到第一个 pending 卡片。改动：①`AiChat.vue` header 区域加审批徽标 ②`ToolCardList.vue` 暴露 `scrollToFirstPending` 方法。预估 0.5 天 — src/components/AiChat.vue + src/components/ToolCardList.vue
+- [ ] AE-2025-03 [P0] — **write_file diff 预览**。write_file 审批时若文件已存在，展示前后对比 diff 而非裸 content（content 可能几百行代码截断到 300 字符）。改动：①后端 `tool_registry.rs` write_file handler 执行前读旧文件返回 diff ②`ToolCard.vue` pending_approval + name=write_file 时渲染 diff 视图（红删绿增）。关联 F-260615-10(diff 工具)可复用。预估 1 天 — src-tauri/src/commands/ai/tool_registry.rs + src/components/ToolCard.vue
+
+**P1 — 增强控制力**
+
+- [ ] AE-2025-04 [P1] — **会话级授权（Session Trust）**。替代原"全局宽松模式"。核心：信任是上下文相关的——同一会话内用户批准过某类操作后，后续同类操作自动放行；换会话清空重审。模型：AiSession 加 `session_trust: HashSet<TrustKey>`（内存态，随会话销毁）；TrustKey 按操作+目标范围粒度（如 `Write { dir: "src/" }`、`Execute { dir: workspace }`）。流程：首次操作→pending_approval 用户批准→记录 TrustKey → 同会话后续同类操作命中则自动放行（消息流显示轻量提示 `🔓 自动放行: write_file(xxx)`）。**白名单收紧决策**：纯读取(list_*/read_*/list_directory)始终自动放行；创建/修改/绑定/覆盖写入/高危全部需审批或会话级授权放行（bind_directory 归类为修改操作；write_file 覆盖写入已出事故不放行）。**首批实现**：write_file + run_command（写→跑→看→改闭环最高频连续操作）；create/update 后续按需加。改动：①`mod.rs` AiSession 加 session_trust 字段 + TrustKey enum ②`audit.rs` process_tool_calls 审批前查 session_trust 命中则跳过 pending ③审批通过时写 session_trust ④前端自动放行操作显示轻量 toast 提示。关联 AE-05(High 二次确认: 会话级授权的操作是否也需二次确认? 建议: 首次审批走二次确认,后续自动放行跳过)。预估 1.5 天 — src-tauri/src/commands/ai/(mod.rs|audit.rs) + src/components/AiChat.vue — **设计决策(2026-06-15)**: 目录级粒度(非文件级)、仅写+执行首批、Webhook 未来走独立 execution_token 链路不影响本设计
+- [ ] AE-2025-05 [P1] — **High 二次确认**。delete/purge/run_command 等 High 风险操作，批准后弹 inline 确认（"确定要永久删除？此操作不可恢复"），二次确认才真正执行 ai_approve。可用现有 ConfirmDialog 组件。预估 0.5 天 — src/components/ToolCard.vue
+- [ ] AE-2025-06 [P1] — **审批超时（人工审批场景）**。pending_approval 超时自动 reject（默认 5 分钟），防对话永久卡死。**决策：纯前端定时器**（审批依赖页面交互，页面关闭 auto-reject 合理；不改后端）。超时后 toast 提示「⚰ 审批超时,已自动拒绝: {tool_name}({reason})」+ 调 ai_approve(id, false)。Settings 可配超时常量(3/5/10min)。**范围限定**：仅覆盖人工审批场景。未来 Webhook/外部集成走独立 `execution_token` 预鉴权链路（不经过 pending_approvals），不影响本设计。预估 0.5 天 — src/composables/ai/useAiSend.ts + src/views/Settings.vue
+
+**P2 — 信息透明度**
+
+- [ ] AE-2025-07 [P2] — **Agentic 进度条**。消息区域底部显示循环进度（`🔄 循环 3/10 · ⏳2待审批 · ✅5完成`）。改动：①`AiChat.vue` 底部加进度指示条 ②`useAiEvents.ts` 处理 AiAgentRound 时更新进度。预估 0.5 天 — src/components/AiChat.vue + src/composables/ai/useAiEvents.ts
+- [ ] AE-2025-08 [P2] — **审批历史面板**。独立页面展示 `ai_tool_executions` 表审计记录（时间/工具/风险/状态/决策者/参数摘要/结果摘要）。改动：①后端新增 `list_tool_executions` IPC ②前端新建 AuditLog.vue 表格视图。预估 1 天 — src-tauri/src/commands/ai/(commands|audit).rs + 新建 src/views/AuditLog.vue
+
 ### 待澄清 / A-B 待定
 
 - [ ] S-260614-01 — 「显示多开」需求待澄清 — 用户报"设置勾选显示多开但 AiChat 未显示"，全 src grep 零命中，疑似旧版本/指分离窗口/想新增开关，待用户截图确认 (06-14)
@@ -333,8 +466,64 @@
 - [x] T-260614-12 — ~~df-ideas 死代码~~ ✅ WF-E 部分完成（capture.rs 删 CaptureInput/IdeaCapture 死码，保留 Idea/IdeaScores 共享实体；promotion/scoring/adversarial 内"两套 Recommendation/PromotionPolicy 死枚举"嫌疑 agent 未确认存在/保留为对外契约，本次未动，待复查）(06-14, commit 89da9fa)
 - [ ] F-260615-01 — **[P1 功能增强]** HumanNode 审批节点支持自定义选项 + 单选/多选类型。现状：config `options: Vec<String>` 已支持任意数量（2/3/…数量扩展已通），但 `decision` 是单 `String` 仅单选语义，`options` 空=自由文本。增强目标：不止「同意/拒绝」二选一，可配置 N 个候选项 + 单选(single)/多选(multiple)两种类型。**改动面**：①`df-core/events.rs` `WorkflowEvent::HumanApprovalRequest` 加 `select_type`、`HumanApprovalResponse` decision 单值→多值（`decisions: Vec<String>` 或保留 decision 兼容 + 加 decisions）②`human_node.rs` config 解析 `select_type` + 校验（多选时每项 ∈ options，可加 min/max 选中数约束）③IPC `approve_human_approval` 签名 ④前端 `stores/project.ts` approve + `api/types.ts` 事件类型 + 审批弹窗 UI（单选 radio / 多选 checkbox）⑤单测改断言 + 新增多选/超限测。**注意**：向后兼容现 single 调用方，`select_type` 缺省 = single — source:用户需求(06-15)，crates/df-nodes/src/human_node.rs + src-tauri/src/commands/workflow.rs + src/stores/project.ts — **✅已实施(a3cccb070fe9c8821,2026-06-15,待commit)**:6 文件契约向后兼容(events.rs SelectType 枚举 Single/Multiple 缺省 Single+HumanApprovalResponse decision+decisions 双字段/human_node.rs 校验 single len==1·multiple len≥1·∈options/workflow.rs IPC 加 decisions+select_type Option 缺省兼容/types.ts/project.ts approve/ProjectDetail.vue checkbox 多选 UI)。cargo check 0 err/df-nodes 21 test(含 4 新增多选)/vue-tsc 0 err。主代理核查契约向后兼容 + 6 文件边界
 - [x] F-260615-02 ✅(2026-06-15,待commit) — **[P1 功能]** task 详情查看。✅已实施:get_task_by_id IPC(复用 TaskRepo::get_by_id ok_or_else 转 Result)+lib.rs 注册+taskApi.get+/tasks/:id 路由+TaskDetail.vue(11 字段:标题/描述/状态/优先级/关联项目 router-link 解析名/分支标签/负责人/基础分支/工作流定义/创建更新时间;复用 constants/project 标签+formatDate+watch route.params.id 重载)+Tasks.vue 列表项 @click router.push;TaskRecord TS 类型已存在无需新增;主代理核查 cargo check 0 err/vue-tsc 0 err/git diff 6 文件边界干净。现状：`src/views/Tasks.vue` 仅列表，无独立 TaskDetail 视图/路由（grep 仅 `ProjectDetail.vue` 嵌套任务命中，无独立详情页）。需求：点击 task 查看详情。**数据模型已就绪**（`df-storage/src/models.rs:53` `TaskRecord` 12 字段：id / project_id / title / description / status / priority / branch_name / assignee / workflow_def_id / base_branch / created_at / updated_at）。**改动面**：①新建 `src/views/TaskDetail.vue` 视图 + 路由（`router/index.ts` `/tasks/:id`）②task 详情 IPC（`get_task_by_id`，核对 `commands/task.rs` 现有 IPC 是否已有，无则补）③`Tasks.vue` 列表项点击 → 跳详情 ④详情页字段展示（title/description 渲染、status/priority 标签、关联项目名解析 project_id→name、branch/assignee 信息、时间戳）⑤可选：详情页内编辑（`update_task` IPC 已存在，FR-D6）。— source:用户需求(06-15)，src/views/Tasks.vue + src/router/index.ts + src-tauri/src/commands/task.rs
-- [ ] F-260615-03 — **[P1 功能]** list 工具分页能力（list_projects / list_tasks / list_ideas + list_deleted 回收站）。现状：4 工具 `truncate(50)` 硬截断，无 offset/limit 参数，返回纯数组无 total/has_more 提示——超 50 条数据 AI 看不到**且不知被截断**。**已核对**（tool_registry.rs:134 / :151 / :164 / :378）。**后果**：80 项目找第 50+ 名后的 X → AI 回复「不存在」；100 任务总结只覆盖前 50；60 灵感评估静默漏 10。**方案（用户定）**：①schema 加 `offset`（默认 0）/ `limit`（默认 50，最大 100）参数 ②返回改 `{ items, total, returned, has_more }` ③AI 见 `has_more: true` 可再调 `offset=50` 翻页。**改动面**：`tool_registry.rs` 4 工具 handler（list_projects:127 / list_tasks:139 / list_ideas:156 / list_deleted:377）schema 加参数 + 截断改 offset/limit slice + 返回结构包对象；total 用截断前 `items.len()`（无需 repo 加 count）。**⚠️ breaking change**：返回 Array→Object，4 工具的 tool 描述（register 第 2 参）须同步更新告知新结构，否则 AI 仍按数组解析。— source:用户需求(06-15)，src-tauri/src/commands/ai/tool_registry.rs:127-165,377-379
+- [ ] F-260615-03 — **[P2 最小修]** list 工具截断标志（原完整分页方案，对抗分析降级）。现状：4 工具 `truncate(50)` 硬截断，AI 不知被截断会回复「不存在」。**对抗分析裁决**:数据量未到 50 条线(projects=5, tasks=61)，完整分页 breaking change 风险 > 收益 → **降级为最小修**:不改返回结构(non breaking),只在 truncate 时加 `truncated: true` 标志 + 工具描述注明"最多返回 N 条"。未来数据量到时再升完整分页(F-03-full)。**改动面**:tool_registry.rs 4 handler 截断处加 truncated bool 返回 — src-tauri/src/commands/ai/tool_registry.rs:127-165,377-379 — source:用户需求(06-15)+对抗分析裁决(06-15)
 - [ ] F-260615-04 — **[P1 UX]** read_dir / read_file 工具卡片连续时折叠/收起，提高信息密度。现状：AI 探查目录常连续调多个 read_dir + read_file（先列目录再读多个文件），每个结果独立卡片平铺，长列表/大文件内容占满屏幕，信息密度低。需求：相邻同类读取卡片支持折叠——默认收起只显摘要（如「read_dir: 12 项」「read_file: src/main.rs (234 行)」），点击展开看详情；或连续 N 个同类卡片归组折叠。**改动面**：①`ToolCard.vue` 加折叠态（`collapsed` ref + 摘要/详情双视图 + chevron 图标 + 高度过渡）②连续同类检测/归组（`ToolCardList.vue` 按 `tool.name` 分组，已有列表容器适合放分组逻辑）③摘要提取（read_dir 数项数 / read_file 文件名 + 行数，解析 result）④折叠态持久化（可选，localStorage 按 conv）。关联信息密度构想（memory: devflow-info-density-concept，卡片折叠是其中一环）。— source:用户需求(06-15)，src/components/ToolCard.vue + src/components/ToolCardList.vue — **勘察完成(2026-06-15,wxflofhf2)**:feasible/plan 11 步跨 5 文件(ToolCardList/ToolCard/useAiSend/stores/ai/global.css)。risk 标低但实为 UX 新行为+改核心 ai 状态文件(useAiSend.ts/stores/ai.ts)+plan 细节有误(useAiSend composable 无 emit 方法)。**拆小或留待**:先做 ToolCardList 分组+单卡折叠摘要(限定不碰 useAiSend/stores),完整折叠交互归信息密度构想单独立项
+- [ ] F-260615-07 — **[P2 功能]** read_file 加 search 参数（单文件内关键词定位）。现状：read_file 仅 offset/limit 分页（tool_registry.rs:458-501），无原生搜索——AI 找关键词需多次分页扫描定位，token 浪费 + 多次 IPC。用户实测确认 offset 0基 + limit=1 单行精确读取可用，但定位靠 AI 多轮分页。**方案**：① schema 加 `search`（string，可选）参数 ② handler 内若有 search：读全文（1MB 限内）→ 按行过滤含 search 的 → 返回 `matches: [{line, content}]`（line 为 1基行号，须在描述注明与 offset 0基的差异）③ 匹配超量：默认返前 50 匹配 + total + has_more。**改动面**：tool_registry.rs read_file handler（:458-501）schema 加参数 + 返回结构扩展（有 search 返 matches，无 search 走原 content 路径，两路径并存）。**权衡**：vs 独立 grep 工具——read_file search 满足单文件定位主场景（最小改动，复用现有工具）；跨文件搜索待 B-260615-37（run_command stdout）修后用 grep/findstr 验证够不够用，不够再立 grep 工具（对标 Claude Code Grep）。**大小写**：默认区分（确定性优先），case_sensitive 参数先不加（做减法）。— source:用户建议(06-15)，src-tauri/src/commands/ai/tool_registry.rs:458-501
+
+### 🟡 文件操作工具集补全（2026-06-15 能力梳理·设计定稿 V2）
+
+> 用户给出 5 个工具具体 API 设计。**核心原则不变**：专用工具补 run_command 做不好/不安全的；系统命令类交给 run_command（B-37 修后）。**修正**:search_files 从"run_command 覆盖"升级为"值得做"(结构化 JSON > parse find 输出)。
+
+**5 工具设计(用户方案)**:
+
+- [ ] F-260615-06 [P0] **patch_file(edit_file)** — → 见下方对抗分析区 :503 完整条目（含设计文档指针）
+- [ ] F-260615-07 — **[P1] search_in_file**（内容搜索）— `path, keyword, (可选)regex, case_sensitive` → `[{line, content, column}]`。纯子串搜索先做(regex/case 后加,做减法)。替代 AI 多轮分页扫描 — tool_registry.rs read_file handler 扩展
+- [ ] F-260615-08 [P1] **file_info**（元信息）— `path` → `{exists, size, lines?, modified, is_binary, is_dir}`。**不读内容**,快速元数据。lines 用 `\n` 计数(不全文读);二进制不报 lines — tool_registry.rs 新增
+- [ ] F-260615-09 [P1] **append_file**（追加写入）— `path, content` → `{bytes_written, new_size}`。日志追加/增量写入,避 read-merge-write 竞态 — tool_registry.rs 新增
+- [ ] F-260615-12 [P1] **search_files**（文件名/glob 搜索）— `path, pattern: "*.ts", recursive?` → `[{path, size}]`。结构化 JSON > parse find 输出(AI token 效率+可靠)。从"run_command 覆盖"升级(原归类为不做的系统命令类) — tool_registry.rs 新增
+
+**后续(P3/合并)**:
+
+- [ ] F-260615-10 [P2] **diff**（修改前对比,防误覆盖）— 并入 patch_file 增强(edit 前 return diff 给审批卡看清改动),或独立工具 — 关联 F-06
+- [ ] F-260615-11 [P3] **write_file base64**（二进制写入）— 图片/PDF/Excel,场景窄 — tool_registry.rs:519
+
+**run_command 覆盖(不单独做)**:压缩/权限/软链/校验/批量
+**不做**:文件监听(app 层)/文件锁定(并入 F-06 Mutex)
+
+— source:用户 API 设计 V2(06-15),F-06 设计已定稿见 [patch_file工具设计-2026-06-15.md](./02-架构设计/patch_file工具设计-2026-06-15.md)
+
+### 🟡 对抗分析裁决（2026-06-15 十域十八项交叉验证）
+
+> 来源：用户对抗分析报告（10 域聚类 + 正反双向验证 + 依赖链提取）。**核心价值：6 个否决/暂缓裁决**（"不做"比"做什么"更值钱，避免浪费投入）。完整报告见 docs/02-架构设计/对抗分析裁决-2026-06-15.md（若已落盘）。
+
+**✅ 推进（第一批独立可并行）**：
+
+- [ ] F-07 trait 下沉 df-ai-core — 设计完备 4 项决策全定稿，退路可放 df-core，解锁 F-03/F-01
+- [ ] R-PD-2 ScriptNode 不注册 script — 3 行删除封死攻击面，工作流当前纯演示无真实脚本需求
+- [ ] F-260615-06 [P0] **patch_file(edit_file)** — 局部文件更新工具，补齐 AI 文件操作闭环。完整设计见 [patch_file工具设计-2026-06-15.md](./02-架构设计/patch_file工具设计-2026-06-15.md)（API/三层防御/边界情况/替代方案否决/实施步骤）。**核心**: old_text 精确匹配为主+line 辅助+Mutex 并发安全+expected_hash 指纹防脏写。第一批实现核心三件套(~50行)。— src-tauri/src/commands/ai/tool_registry.rs 新增 handler
+- [ ] ARC-06 composable 循环依赖 — 提 aiShared.ts 破环最小改动（或合回 stores/ai.ts 备选）
+- [ ] CR-09 .ai-md 样式 5 份→全局 css 抽取 — 零风险减法
+- [ ] F-09 status 对齐前后端 — 删从未产生的 planning/in_progress 等，前端 map 改 {active/archived}
+- [ ] F-260615-03 最小修（截断标志）— **从完整分页降级**:不改返回结构(non breaking)，truncate 时加 `truncated: true`（→ 见上方 :469 完整条目，本条为对抗分析区引用，勿重复实施）
+- [ ] R-PD-9 display_hint 轻量抽取 — audit 工具名→文案映射作 display_hint，消除双份映射
+
+**🟡 暂缓 / 需重设计**：
+
+- [x] T-11 条件引擎 Phase1+2 🟡 **暂缓** — 引擎设计好但**无前端 UI 消费方**(demoDag edges 无 condition 字段,用户无法配置条件)。等工作流有真实使用场景(BuildNode 落地后跑构建→测试→部署)再推进。决策点 A/B/C(手写求值器/复活 set_skipped/default false+warn)均认可
+- [x] F-260615-03 完整分页 🟡 **暂缓** → 降为最小修(truncated 标志)，见上方
+- [x] ARC-05 project.ts 上帝 store 拆分 🟡 **需重设计拆分策略** — 不能简单按领域拆(会重蹈 ai.ts 循环依赖覆辙)，需先把越层 invoke 沉到 api/workflow.ts。ARC-06 先做
+
+**❌ 否决（人定"不做",不进路线）**：
+
+- [x] ~~R-PD-9 agentic loop 下沉 df-ai~~ ❌ **否决** — 与 ai.rs 子 module 拆分决策冲突("下沉需动 crate 依赖图引入循环依赖")。保留 display_hint 轻量部分
+- [x] ~~R-PD-8 DTO 映射层~~ ❌ **否决** — 过度设计,5 个 IPC 手动对齐可接受。替代:types.ts 头部文档约定"后端改 schema 必须同步改此文件"
+- [x] ~~F-09 拆双字段(status 生命周期 + stage 开发阶段)~~ ❌ **否决** — 阶段概念已被弱化(df-stages 砍了阶段插件),DB 实际只有 active/archived/deleted,双字段过度设计
+- [x] ~~R-PD-12 做实 run_workflow AI 工具~~ ❌ **否决(当前)** — 工作流是内部基础设施,无真实 CI/CD 需求。删假能力(no-op 桩返 note)更诚实
+
+**⚡ 推荐推进顺序**:
+1. 第一批(独立并行): F-07 / R-PD-2 / F-15-06 edit_file / ARC-06 / CR-09 / F-09对齐 / F-03最小修 / R-PD-9 display_hint
+2. 第二批(依赖第一批): F-03 对抗评估接 LLM(F-07后) / F-01 模型能力Phase1(F-07后) / R-PD-12 删假能力(R-PD-2后)
+3. 第三批(需用户输入): S-01 API Key 401 / 显示多开 / 审批可见性
 
 ## 已完成