修复: TaskDetail 操作按钮缺陷(推进竞态/菜单状态机过滤/工作流残留重置/子任务校验/描述编辑) + 看板销账(aichat切换缺陷 14/16 已修核对)

docs/todo.md

@@ -453,25 +453,212 @@ graph TD
 ### 🔍 2026-08-07 aichat 切换/新建对话缺陷走查(用户实测 2 bug + 双 agent 深挖)
 
 > 用户 dev 实测报 2 个 bug(队列串新会话 / 历史内容进新会话),派 2 agent(前后端)+ 主代独立抽查。**守 session-role-diagnose-only:本会话仅走查+登记,未实施代码。** 详单见走查报告(本段即清单)。
+> **✅ 2026-08-09 核对销账(2 agent 独立源码核验 + 主代抽查 useAiEvents P1-1 一致)**:16 项中 **14 项已修**(提交 9f75db5「切换/新建对话缺陷」+ 后续 6ba6daf 收尾),各 [x] 项附当前源码证据行号;**CSW-P1-4 未修**(切到生成中 conv 首响应气泡丢失,需前后端 round0 占位补回设计,单列);**CSW-P2-7 未核对**(走查自标待确认,含 d2 分离窗口失效/跨端流式)。
 
 **🔴 P0/bug1 待发送队列串到新对话(用户实测,根因已确认)**:
-- [ ] **CSW-P0-1** — `AiChat.vue:70-101` 渲染 `store.state.queue` **全部会话**,不按 `activeConversationId` 过滤 → 切/新建后显示旧会话排队消息。修复:computed 按 active 过滤 + queue 操作(cancel/edit/sendNow/clear/timeout)按 conv 收敛
+- [x] **CSW-P0-1** — ✅ 已修:`AiChat.vue:393-395` activeQueue computed 按 `activeConversationId` 过滤 + 模板 :70/:79 改用 activeQueue;queue 操作(cancel/edit/sendNow)经 `useAiSend.ts:420-431` activeQueueRealIndex 映射真实下标,clear/forceSend 均传 convId
 
 **🟡 P1(前后端合并去重,按严重度)**:
-- [ ] **CSW-P1-1** — 后台会话排队消息永不 drain:非当前 `AiCompleted` 被 isCurrent 守卫拦截(`useAiEvents.ts:883-889`)不 emit `ai-drain-queue`,切回后队列卡死。修复:守卫外补该 conv 的 drain + `drainQueue` 用目标 convId 发消息(勿用 `state.activeConversationId` 误发到 B)
-- [ ] **CSW-P1-2** — 后端 switch 回切 reload 无条件覆盖未落库内存(`conversation.rs:338-343` 只判 `is_active` 不判内存更脏)→ 熔断不 save/异步 save 未落前切走再切回,消息+工具结果永久丢失(`context/mod.rs:279-290` 置 `needs_full_rewrite=false` 固化陈旧态)
-- [ ] **CSW-P1-3** — switch 对 live 目标 conv 无条件 `finalize_pending_placeholders`+`retain` 再 extend DB 快照(`conversation.rs:386-388/400-422`)→ live pending 误终态化「会话已切换」+ 新审批丢 + 陈旧条目(`Ok(None)` 分支未根治)反复
-- [ ] **CSW-P1-4** — 切到生成中 conv 返回 DB 旧快照 + round0 首响应前端气泡丢失(`conversation.rs:278-316` + `useAiEvents.ts:209-228`):前端整体替换 `state.messages` 丢弃本地气泡,currentText 无气泡可落被清空 → 首条回复闪现/缺失
-- [ ] **CSW-P1-5** — delete 在 loop 运行中 → save 惰性重建 per_conv + `Ok(None)` 分支 INSERT 复活对话(`conversation.rs:573-587/388-420`)+ 该轮消息丢
-- [ ] **CSW-P1-6** — 点击当前活跃流式会话无同 id 短路(`useAiConversations.ts:236`)→ 清 in-flight 文本 + 全量重拉 + 重复恢复审批(P1-2)
-- [ ] **CSW-P1-7** — 切后台生成中会话丢「切换 IPC 往返窗口」的流式 token(`useAiConversations.ts:240-276` active 在 await 后置 + `useAiEvents.ts:881-890` 非当前 delta 直接 drop)→ 回复中间缺块
-- [ ] **CSW-P1-8** — switch parse 失败 active/messages 错配(`useAiConversations.ts:276,303` catch 向旧 messages push 错误气泡但 active 已置新 id)→ 视图显示旧会话
+- [x] **CSW-P1-1** — ✅ 已修:`useAiEvents.ts:101-102` 非当前会话 `AiCompleted` 仍 emit `ai-drain-queue`(带 conversationId,未被 isCurrent 吞);`useAiSend.ts:271-306` drainQueue 用目标 convId
+- [x] **CSW-P1-2** — ✅ 已修:`conversation.rs:363-368` 非 live 分支先判 `mem_has_unsaved`(len>persisted_msg_count || needs_full_rewrite),有未落库内存则跳过 restore,DB 快照不再覆盖内存
+- [x] **CSW-P1-3** — ✅ 已修:`conversation.rs:335/415-417` `already_live` 分支 pending 完全不动(不 finalize/不 retain/不从 DB 恢复),首屏用 per_conv 内存消息
+- [ ] **CSW-P1-4** — 🔴 **未修,需设计**:切到生成中 conv 首响应气泡丢失(`useAiConversations.ts:333` 仍整体替换 messages 无 round0 占位补回;后端 already_live 分支 :336-352 只返回 user 消息,assistant 占位要轮末才入;MessageList 要求末条 assistant 才渲染流式 + aiShared.ts flushCurrentText 遇 user break)。需设计 round0 assistant 占位气泡补回机制,前后端协同
+- [x] **CSW-P1-5** — ✅ 已修:`conversation.rs:613-616` 删除先登记 `deleted_convs` 再删库,save 入口 :259-265 命中直接 return + :416-426 INSERT 前二次校验,封死 Ok(None) 复活窗口
+- [x] **CSW-P1-6** — ✅ 已修:`useAiConversations.ts:255-259` `if (!force && id === state.activeConversationId) return` 同 id 短路,不清文本不重拉
+- [x] **CSW-P1-7** — ✅ 已修:`useAiConversations.ts:269/303-305` switchingConvs 集合缓冲切换往返窗口;`useAiEvents.ts:110-115` 非当前命中 switchingConvs 的 delta 累积到 per-conv 流式态而非 drop
+- [x] **CSW-P1-8** — ✅ 已修:`useAiConversations.ts:333-335` 先 messages 后 active 同一同步块,parse 失败 catch :336-348 不切走,无 active/messages 错配
 
 **🔵 P2(打磨/边缘)**:
-- [ ] **CSW-P2-1** — newConversation 漏 `clearAllApprovalTimers`(switch/delete 都有,`useAiConversations.ts:67-98` 没有)→ 旧 conv 审批超时到点误拒+气泡进新会话
-- [ ] **CSW-P2-2** — 后端 reload 清 session_trust/model_override/agent_language(`conversation.rs:343-348`)→ 切走再切回信任遗忘,重复审批
-- [ ] **CSW-P2-3** — save 并发全量重写竞态(「单线程 save 串行」不成立,`conversation.rs:427`),DELETE+INSERT 吞新行 + token 丢
-- [ ] **CSW-P2-4** — clear_session_allowed_dirs 使后台 loop 文件工具静默重挂审批(真并发下 session 授权语义错配)
-- [ ] **CSW-P2-5** — 新建无防抖/双击无短路 → 多个空会话 + 虚拟项堆积;虚拟会话切回触发 create-new 复制(P2-7/8)
-- [ ] **CSW-P2-6** — setStreaming 忽略 `opts.convId` 按键 active(`streamingGuard.ts:51-80`)→ detach/restore 生成态错乱(待确认)
-- [ ] **CSW-P2-7** — 切生成中会话快照陈旧 + 恢复双占位气泡;d2 分离窗口视图不随主窗口失效;跨端生成中会话不流式(待确认)
+- [x] **CSW-P2-1** — ✅ 已修:`useAiConversations.ts:71-73` newConversation 首行 `clearAllApprovalTimers()`
+- [x] **CSW-P2-2** — ✅ 已修:`conversation.rs:356/400-405` 仅 `!conv_was_present` 才复位 session_trust/model_override/agent_language
+- [x] **CSW-P2-3** — ✅ 已修:`conversation.rs:211-226` save_conversation_serialized 持 per-conv 锁(`mod.rs:696-701` save_locks)串行化 DELETE+INSERT,20+ 调用点无旁路
+- [x] **CSW-P2-4** — ✅ 已修:`state.rs:561-565` clear_session_allowed_dirs_if_idle 仅在 `active_convs().is_empty()` 才清,后台 loop 文件工具不丢临时授权(三调用点 create/switch/delete 均用 _if_idle)
+- [x] **CSW-P2-5** — ✅ 已修:`useAiConversations.ts:67/75-76/110` `_newConvLock` 防抖 + 300ms 释放
+- [x] **CSW-P2-6** — ✅ 已修:`streamingGuard.ts:78` 带 convId 写 per-conv 流式态,无 convId 才写全局
+- [ ] **CSW-P2-7** — 🟡 **待确认(未核对)**:切生成中会话快照陈旧 + 恢复双占位气泡;d2 分离窗口视图不随主窗口失效;跨端生成中会话不流式(走查自标待确认,需真机/分离窗口实测再判)
+---
+
+### 🔍 2026-08-09 TaskDetail 操作按钮缺陷走查(用户实测 + AI 深度审查)
+
+> 用户反馈"产出部分只有标题空白"，触发对 TaskDetail.vue 所有操作按钮的全量走查。覆盖模板/脚本/后端 advance_task / run_workflow 回调链路。共发现 10 项缺陷，按严重度 P0×2 / P1×4 / P2×4 分组。守 session-role-diagnose-only：本会话仅走查+登记，未实施代码。
+>
+> **✅ 2026-08-09 全部修复并核验销账**：主代理独立核查（vue-tsc EXIT 0 + diff 语义审）通过。补充说明：P1-4 核验当前代码已满足（advanceChild/setChildPriority 已含 `childMenuId.value = null`），仅销账未改；P1-5 实现位置优化为 watch(taskId)/refresh/handleAdvance 成功三入口调用 `resetWorkflowUi()`（load() 内不加，避免工作流推进中 df-data-changed 触发刷新误清进度面板）；P2-10 描述编辑对齐 IdeaDetail 模式（有描述/空描述均可编辑，taskApi.update 落库）。验收标准 1-9 全部满足。
+
+**涉及文件**：
+- `src/views/TaskDetail.vue`（987 行，主要改动点）
+- `src-tauri/src/commands/task.rs`（advance_task，仅参考）
+- `src-tauri/src/commands/workflow.rs`（run_workflow 回调，仅参考）
+- `crates/df-nodes/src/task_advance_node.rs`（advance_task_atomic，仅参考）
+
+---
+
+## 🔴 P0 缺陷（2 项，必须修）
+
+### P0-1 双重推进竞态：工作流推进中手动推进按钮仍可用
+- **位置**：TaskDetail.vue:48 vs :55
+- **现状**：工作流按钮 `:disabled="wfAdvancing || advancing"`（检查两者），手动按钮 `:disabled="advancing"`（只检查 advancing）
+- **问题**：`wfAdvancing=true` 时手动按钮仍可点 → 同时发起 `run_workflow`（回调 advance）+ 直调 `advance_task` 两个推进请求 → 第一个成功改 status，第二个 CAS 失败返回 Err → 前端显示红色错误，用户困惑"明明成功了为什么报错"
+- **修复**：手动推进按钮 `:disabled` 加 `|| wfAdvancing`（1 行）
+
+### P0-2 工作流推进与手动推进按钮语义重复（todo 状态双"开始"）
+- **位置**：TaskDetail.vue:45-57
+- **现状**：todo 状态同时显示「工作流推进」+「开始」两个按钮，都推进到 in_progress
+- **问题**：用户不知道该点哪个；设计意图是工作流推进会跑 AiNode 生成产出，手动"开始"只是纯改状态，但按钮文案没有区分
+- **修复**：工作流推进按钮文案改为「AI 执行推进」或「工作流推进（含 AI 产出）」
+
+---
+
+## 🟠 P1 缺陷（4 项）
+
+### P1-3 子任务快捷菜单不校验状态机合法性
+- **位置**：TaskDetail.vue:286-296
+- **现状**：`quickStatuses` 硬编码列出全部 6 态 [todo, in_progress, in_review, testing, done, blocked]，不按子任务当前 status 过滤
+- **问题**：todo 状态子任务的菜单显示 testing/done/in_review 等非法目标，点下去后端 can_transition 拒绝 → 红色错误
+- **对比**：顶部手动推进按钮用 `ADVANCE_MAP` 严格按状态机过滤，子任务菜单却无此逻辑
+- **修复**：子任务菜单复用 `ADVANCE_MAP[child.status]` 过滤合法目标
+
+### P1-4 子任务操作后快捷菜单不关闭
+- **位置**：TaskDetail.vue:326 advanceChild / :337 setChildPriority
+- **现状**：操作完成后不 `childMenuId.value = null`
+- **问题**：点了"推进到 done"或"改优先级"后菜单仍挂着悬浮
+- **修复**：两函数操作完成后 `childMenuId.value = null`（2 处）
+
+### P1-5 refresh/切任务后工作流进度/DAG 残留
+- **位置**：TaskDetail.vue:619 load() 函数
+- **现状**：load() 只重置 task/projects/ideas，不清 `wfExecId` / `wfDagJson` / `wfResult`
+- **问题**：切任务或点 refresh 后右栏仍显示旧任务的工作流进度和 DAG
+- **修复**：load() 开头加 `wfExecId.value = null; wfDagJson.value = ''; wfResult.value = null`（3 行）
+
+### P1-6 手动推进后工作流进度面板不清空
+- **位置**：TaskDetail.vue:470 handleAdvance
+- **现状**：成功后只 `task.value = updated`，不清工作流相关 ref
+- **问题**：手动推进后右栏仍显示旧工作流进度
+- **修复**：handleAdvance 成功后清空 wfExecId/wfDagJson/wfResult
+
+---
+
+## 🟡 P2 缺陷（4 项）
+
+### P2-7 子任务创建无长度/重名校验
+- **位置**：TaskDetail.vue:365-381 confirmSubtask
+- **现状**：标题只 `trim()` 判空，不校验长度上限/重名；成功路径不清 `errorMsg.value`
+- **修复**：加长度上限（如 128 字）、同父重名校验、成功路径清 errorMsg
+
+### P2-8 wfResult timer 生命周期不严谨
+- **位置**：TaskDetail.vue:424 watch 回调
+- **现状**：工作流完成后 setTimeout 3s 清 wfResult；切任务时 timer 仍在但 wfExecId 已清
+- **影响**：低风险（最多多等 3s），但 timer 引用管理不严谨
+- **修复**：load() 重置时清 `_wfResultTimer`
+
+### P2-9 子任务页无"是子任务"提示
+- **位置**：TaskDetail.vue:108（父面包屑）+ :133（子任务面板仅顶层显示）
+- **现状**：子任务详情页结构与顶层任务几乎一样，只有顶部多一行父面包屑
+- **修复**：加一行提示「该任务为子任务，隶属于：{parentTitle}」
+
+### P2-10 空描述无编辑入口
+- **位置**：TaskDetail.vue:68 `<section v-if="task.description">`
+- **现状**：无描述时描述面板整块消失，无"添加描述"入口
+- **修复**：无描述时显示空态 + "添加描述"入口
+
+---
+
+## 验收标准
+
+1. 工作流推进中手动推进按钮禁用，无双重推进竞态
+2. todo 状态两个按钮文案可区分（工作流推进 vs 纯手动开始）
+3. 子任务快捷菜单只显示状态机合法目标
+4. 子任务操作后菜单自动关闭
+5. 切任务/refresh/手动推进后右栏工作流进度正确重置
+6. 子任务创建有长度/重名校验，错误提示清晰
+7. 子任务页有"是子任务"明确提示
+8. 空描述有编辑入口
+9. vue-tsc EXIT 0
+
+---
+
+**关联**：父任务「总览页 + 项目列表 UI/UX 优化（持续更新）」（id: 0115aea6-b423-482a-8a64-b793a66a0417）—— 本走查作为该任务的子任务延伸。
+### 🔴 2026-08-09 AI 自审/工作流推进链路缺陷（task_id 断裂 + AiNode 缺 prompt + 审批无 UI）
+
+> 用户「检查 AI self-review 遇到的问题」触发对工作流推进链路的深度审查。**核心结论：工作流推进按钮从 TaskDetail 触发时，三条推进链（in_progress/testing/done）全部不可用**。守 session-role-diagnose-only：本会话仅走查+登记，未实施代码。
+
+**涉及文件**：
+- `src-tauri/src/commands/workflow.rs`（run_workflow_inner 核心）
+- `crates/df-nodes/src/task_workflow_templates.rs`（三模板）
+- `crates/df-nodes/src/ai_node.rs` / `ai_self_review_node.rs` / `ai_node_helpers.rs` / `human_node.rs`
+- `crates/df-workflow/src/executor.rs` / `dag.rs` / `registry.rs` / `dag_def.rs`
+- `src/views/TaskDetail.vue` / `src/stores/project/workflow.ts` / `src/views/ProjectDetail.vue`
+
+---
+
+## 🔴 P0 缺陷（3 项，工作流推进 100% 失败）
+
+### P0-A task_id 断裂：AiSelfReviewNode 必定失败
+- **位置**：`workflow.rs:295` `executor.run(&runtime_dag, config)` + `executor.rs:153`
+- **现状**：前端传 `config = {}`（TaskDetail.vue:590），`run_workflow_inner` 拿到 `task_id` 但**只存进 WorkflowRecord + 回调闭包 cb_task_id，从未注入传给 executor 的 config**。DagExecutor 构造 NodeContext 时 `deep_merge(config={}, node_configs[id])`，testing 模板节点 config 只含 `{"gate":true}`。最终 `ctx.config` **无 task_id**。
+- **结果**：`ai_self_review_node.rs:100` `ctx.config.get("task_id")` → None → `Err("AiSelfReviewNode 缺少必填参数: task_id")` → 节点失败 → 工作流 failed。
+- **修复**：`run_workflow_inner` 在 `executor.run` 前把 `task_id` 注入 config：`config["task_id"] = task_id`（1 行）。
+
+### P0-B AiNode 缺 prompt：in_progress 模板必定失败
+- **位置**：`task_workflow_templates.rs:45-47` `dag.add_node("ai_execute", "ai", json!({}))`
+- **现状**：in_progress 模板 AiNode config 为空对象。注释称「prompt / provider / task_id 均由 run_workflow 全局 config 注入」，但前端传空 config、后端不注入。AiNode 的 `parse_params`（ai_node_helpers.rs:189-200）取 `inputs["prompt"]` > `config.prompt`，两者皆无 → `Err("AiNode 缺少必填参数: prompt")`。
+- **结果**：todo→in_progress 推进链 AiNode 必定报错，任务原地不动，无 AI 产出。
+- **修复**：AiNode 加默认 prompt 兜底（基于 task.description 生成执行方案），或 run_workflow 注入。
+
+### P0-C TaskDetail 无审批 UI：testing/done 模板的 HumanNode 审批无法操作
+- **位置**：`TaskDetail.vue`（无 ApprovalDialog 组件）+ `ProjectDetail.vue:353-356`（唯一渲染处）
+- **现状**：工作流 store 的 `startEventListener`（workflow.ts:111-144）收到 `human_approval_request` 会设 `state.pendingApproval`。但**只有 ProjectDetail.vue 有 `watch(() => store.pendingApproval)` 打开 ApprovalDialog**（ProjectDetail.vue:838-841）。TaskDetail.vue 只调 `store.startEventListener()`（TaskDetail.vue:674），**不渲染 ApprovalDialog、不 watch pendingApproval**。
+- **结果**：用户从 TaskDetail 点「工作流推进」进入 testing（in_review→testing 模板含 ai_self_review + human_review）或 done（testing→done 模板含 human）模板，HumanNode 发出审批请求 → `state.pendingApproval` 被设但**无弹窗** → 用户无法批准/拒绝 → HumanNode 等满 30min 默认超时（human_node.rs:34 DEFAULT_TIMEOUT_SECS=1800）→ 工作流 failed。
+- **修复**：TaskDetail 渲染 ApprovalDialog + watch pendingApproval，或将审批弹窗做成全局（独立于 ProjectDetail/TaskDetail）。
+
+---
+
+## 🟠 P1 缺陷（3 项）
+
+### P1-D in_progress 失败无退回信号
+- **位置**：`task_state_machine.rs:156` `regression_target(IN_PROGRESS) => None`
+- **现状**：in_progress 模板失败（AiNode 缺 prompt，P0-B）时，`regression_target("in_progress")` 返回 None → 回调跳过推进。任务**原地留在 todo**，无错误提示、无退回态、无任何信号（回调只 `tracing::warn!`）。
+- **结果**：用户点「工作流推进」→ 后台静默失败 → 任务不动，前端 wfResult=failed 提示但无具体原因。
+- **修复**：AiNode 失败时把错误信息透出到前端（WorkflowFailed.error 已含，但前端 wfFailedHint 只显通用文案）。
+
+### P1-E done 模板失败后任务卡 testing 无退回
+- **位置**：`task_state_machine.rs` `regression_target(DONE) => None`
+- **现状**：testing→done 模板（human 节点）若用户拒绝（返回 Err）→ 工作流 failed → `regression_target("done")` → None → 任务**留在 testing**，未退回 in_review。
+- **问题**：done 是终态，无可退态合理，但用户拒绝后应停留 testing 让人工处理，当前无明确信号提示「推进未完成，任务仍在 testing」。
+
+### P1-F AiSelfReview 审查空产出
+- **位置**：`ai_self_review_node.rs:129-134`
+- **现状**：若 in_progress 阶段 AiNode 失败（P0-B），output_json 为空 → 自审节点审查占位文本 `"(无产出,仅依据需求审查)"`。
+- **结果**：即使 task_id 修好，无产出的自审也只是空洞审查，无意义。
+
+---
+
+## 🟡 P2 缺陷（3 项）
+
+### P2-G 前端注释误导：「运行时注入」实际无注入
+- **位置**：`TaskDetail.vue:590` 注释「全局 config 留空(节点级 config 由模板/运行时注入)」
+- **现状**：模板只注入 gate:true，运行时（run_workflow_inner）不注入 task_id/prompt。注释承诺与实际不符，误导后续维护者。
+
+### P2-H 三模板归一度差：in_progress 纯 AI / testing AI+Human / done 纯 Human
+- **位置**：`task_workflow_templates.rs`
+- **现状**：三模板职责不统一——in_progress 无人工确认直接改状态，testing 有 AI 自审 + 人工，done 纯人工。用户对「工作流推进」在三个状态的体验差异巨大但不透明。
+- **建议**：至少统一「推进是否有人工确认」的预期，或在按钮文案/进度提示中说明当前推进链内容。
+
+### P2-I WorkflowRecord 未存 project_id
+- **位置**：`workflow.rs:170` `project_id: None`
+- **现状**：即使 task_id 关联任务（任务有关联 project_id），执行记录 `project_id` 恒为 None。按项目过滤工作流执行记录时无法直接从 workflow 关联项目。
+- **修复**：task_id 有值时反查任务 project_id 填入。
+
+---
+
+## 验收标准
+
+1. task_id 注入 AiNode/AiSelfReviewNode config，自审节点能读到任务
+2. in_progress 模板 AiNode 有默认 prompt，能生成产出
+3. TaskDetail 触发工作流后，HumanNode 审批弹窗正常弹出可操作
+4. 工作流失败时前端显示具体错误原因（非通用文案）
+5. 老工作流（无 task_id/target_status）零行为破坏
+6. cargo check --workspace EXIT 0 + vue-tsc EXIT 0
+
+---
+
+**关联**：本走查与「2026-08-09 TaskDetail 操作按钮缺陷走查」同属 TaskDetail 交互审查线，但本段聚焦 AI 工作流推进链路（后端 + 审批 UI），按钮缺陷聚焦 TaskDetail 自身交互。修复时建议合并处理（都在 TaskDetail + workflow 链路）。