新增: 批次工作落地(推进链/评估闭环/事件总线/并发/加固) + 技术债清理 + 文档整理

后端: - 工作流推进链(D-03):advance_task/状态机/闸门走 df-nodes Node trait,conditions 条件引擎扩展 - 想法评估闭环:启发式评分+对抗评估,df-ideas/scoring + df-storage/idea_eval_repo + idea 前端打通 - 全局事件数据总线:df-ai/context+context_helpers+augmentation 跨模块解耦 - AI planner/plan_hint/intent:aichat B 路线并行多轮基础 - patch_file 加固(TD-03/04):读改写整体锁防 lost update,expected_hash 合约闭环 - 压缩超时兜底(F-15 卡死根治) - F-09 多会话并发:LlmConcurrency per-conv + streamingGuard 前端守护 + verify 脚本 - 知识注入 DRY/skills/audit 扩展清理: - aichat 技术债(误报 allow/死导入/过时注释 30 项) - URGENT.md 删除(11 项加急全解决/迁 todo) - 文档整理(todo/待决策/待审查/ARCHITECTURE/INDEX + 总线/技术债审查新文档)
2026-06-21 20:51:26 +08:00
parent 330bb7f505
commit bd6a41fe6e
111 changed files with 11932 additions and 1034 deletions
--- a/src/composables/ai/useAiEvents.ts
+++ b/src/composables/ai/useAiEvents.ts
@@ -26,7 +26,8 @@ import { useAppSettingsStore } from '@/stores/appSettings'
 import { state } from '@/stores/ai'
 import { t } from '@/i18n/i18n-helpers'
 import { nextMsgId, findToolCall, startApprovalTimer, clearApprovalTimer, clearAllApprovalTimers } from './aiShared'
-import { resetStreamWatchdog, clearStreamWatchdog } from './useAiStream'
+import { resetStreamWatchdog, clearStreamWatchdog, clearAllStreamWatchdogs } from './useAiStream'
+import { setStreaming } from './streamingGuard'
 import { loadConversations } from './useAiConversations'
 import type { AiChatEvent, AiMessage, AiToolCallInfo } from '@/api/types'

@@ -95,14 +96,22 @@ function clearAllToolSlowTimers(): void {
 // 独立事件源——AiMaxRoundsReached 与 AiApprovalRequired 不混)。用模块级 ref 导出,
 // AiChat.vue 直接 import 读;case 内 push,true 表"有挂起询问"。
 // 一次只追踪一个挂起询问(后端 AiSession 单例,达 max 后续轮次前用户必先决定),
-// 故用 boolean ref 而非数组,语义更精确。
-export const pendingMaxRounds = ref(false)
+// 故用单值 ref 而非数组,语义更精确。
+//
+// TD-260621-02 per-conv:原 ref(false)(boolean)无 convId 维度,F-09 多会话并发下 A 达 max
+// 挂起时切到 B 会话,MaxRoundsCard 守卫(仅判 isViewingGenerating)会把 A 的操作卡错显于 B。
+// 改 ref<string|null>(存挂起 convId,null=无挂起)。消费方(MaxRoundsCard)守卫改精确比对
+// pendingMaxRounds === activeConversationId。set 按事件 conversation_id 赋值;
+// clear(AiCompleted/AiError)仅当 pendingMaxRounds===该 convId 才清 null(避免清错会话的挂起)。
+export const pendingMaxRounds = ref<string | null>(null)

 // F-260619-03 Phase B: 路径授权弹窗挂起态(后端 AiDirAuthRequired 事件置,用户决策后清)。
 //
-// 同 pendingMaxRounds 模式:模块级 ref(不进 store.state),AiChat.vue 的 DirAuthDialog 组件
-// 直接 import 读。一次只追踪一个挂起询问(后端单 tool_call_id 挂起,用户决策后 try_continue),
-// 故用对象 ref 而非数组,语义更精确。null = 无挂起。
+// path_auth 审批链阶段1(解卡死):单 ref → 数组。根因——同轮多个文件工具落不同未授权目录时,
+// 后端连发多条 AiDirAuthRequired,单 ref 后到覆盖先到,先到的弹窗丢失→授权无法到达→loop 卡死。
+// 改数组 push 多条并存,各 case(AiApprovalResult/AiCompleted/AiError)按 id filter 移除。
+// 开关 df-ai-multi-pending-auth 控制多挂起并存(true,默认)vs 单 ref 覆盖(false,兜底回退)。
+// 模块级 ref(不进 store.state),AiChat.vue 的 DirAuthDialog 组件直接 import 读。
 export interface PendingDirAuth {
  id: string
  tool: string
@@ -110,7 +119,7 @@ export interface PendingDirAuth {
  dir: string
  conversationId?: string
 }
-export const pendingDirAuth = ref<PendingDirAuth | null>(null)
+export const pendingDirAuths = ref<PendingDirAuth[]>([])

 /** 通知会话列表发生变化(供 newConversation/deleteConversation/rename/archive 等触发刷新侧栏) */
 export function notifyConversationChanged() {
@@ -146,6 +155,49 @@ function isShowTokenUsage(): boolean {
  return appSettings.get<boolean>('df-show-token-usage', false)
 }

+/** path_auth 多挂起并行开关(appSettings key `df-ai-multi-pending-auth`)。
+ *  path_auth 审批链阶段1:解卡死核心——同轮多个文件工具落不同未授权目录时,后端会连发多条
+ *  AiDirAuthRequired。单 ref 会被后到的事件覆盖,先到的弹窗丢失→授权无法到达→loop 卡死。
+ *  开(true,默认):pendingDirAuths 数组,push 多条并存,按 id 定位消费。
+ *  关(false,兜底回退):退化单 ref 语义——后到覆盖先到(push 前清空数组),行为对齐旧版。
+ *  回退路径:appSettings.set('df-ai-multi-pending-auth', false) 即恢复单 ref 行为,无需改代码。 */
+function isMultiPendingAuth(): boolean {
+  return appSettings.get<boolean>('df-ai-multi-pending-auth', true)
+}
+
+/**
+ * path_auth 审批链阶段3b(统一审批模型)开关(appSettings key `df-ai-unified-approval`)。
+ *
+ * 决策(plan 阶段3b):状态层合(单 pendingApprovals + kind 字段)+ 决策层分(path 走 authorizeDir /
+ * risk 走 approve)。开关控制 path 类挂起是否归一进 pendingApprovals 带 kind='path' 字段,
+ * 由 ToolCard 内联审批(once/always/deny);关时回退 DirAuthDialog 老链路(独立弹窗)。
+ *
+ * 开(true,默认):AiDirAuthRequired case 把 path 挂起转成 pendingApprovals 项(kind='path'),
+ *   不再 push pendingDirAuths;DirAuthDialog 在 AiChat 中按开关判断不挂载。ToolCard 按 kind
+ *   显 once/always/deny 三按钮,调 aiApi.authorizeDir。
+ * 关(false,兜底回退):退回阶段1老链路——AiDirAuthRequired push pendingDirAuths,DirAuthDialog
+ *   渲染弹窗,与阶段3a 后端合(单 HashMap + kind 字段)兼容(后端语义层已合,前端 UI 不切)。
+ * 回退路径:appSettings.set('df-ai-unified-approval', false) 即恢复 DirAuthDialog 弹窗,无需改代码。
+ */
+function isUnifiedApproval(): boolean {
+  return appSettings.get<boolean>('df-ai-unified-approval', true)
+}
+
+/** 向 pendingDirAuths 追加一条(开关控制:多挂起并存 vs 单 ref 覆盖) */
+function pushPendingDirAuth(p: PendingDirAuth): void {
+  if (isMultiPendingAuth()) {
+    pendingDirAuths.value.push(p)
+  } else {
+    // 兜底单 ref 语义:后到覆盖先到(行为对齐旧版,数组只留最新一条)
+    pendingDirAuths.value = [p]
+  }
+}
+
+/** 按 id 从 pendingDirAuths 移除一条 */
+function removePendingDirAuth(id: string): void {
+  pendingDirAuths.value = pendingDirAuths.value.filter(p => p.id !== id)
+}
+
 // ─── 事件域 handler(从原 handleEvent switch 抽出,按域分组)────────────────────────────
 //
 // 拆分策略:策略 C(抽 case 体为函数)+ 按域分组(streaming/tool/lifecycle)。
@@ -216,32 +268,74 @@ function handleStreamingEvent(event: AiChatEvent): boolean {

    case 'AiMaxRoundsReached':
      // F-260616-03: 达 max_iterations 暂停态(后端仍 generating=true),前端展示操作卡询问。
-      // 后端已 save 落库,这里仅翻 pendingMaxRounds=true 驱动 UI 卡片;看门狗已由
+      // 后端已 save 落库,这里仅翻 pendingMaxRounds 驱动 UI 卡片;看门狗已由
      // NO_RESET_WATCHDOG 跳过 reset(达 max 不计整流超时)。
-      pendingMaxRounds.value = true
+      // TD-260621-02 per-conv:存挂起 convId(非 boolean),消费方按 activeConversationId 精确比对。
+      // 注:无 convId 时**不**设 null(=无挂起,达 max 操作卡丢失)——保留原值兜底。
+      // 用 activeConversationId 兜底:达 max 事件理论上必带 convId,无时默认属当前活跃会话,
+      // 优于清空挂起导致 MaxRoundsCard 守卫误判无挂起(用户达 max 操作卡凭空消失)。
+      pendingMaxRounds.value = event.conversation_id || state.activeConversationId || pendingMaxRounds.value
      return true

    case 'AiDirAuthRequired': {
      // F-260619-03 Phase B: 路径授权挂起(后端 generating 保持 true,等用户决策)。
-      // 置 pendingDirAuth 驱动 DirAuthDialog 弹窗;看门狗已由 NO_RESET_WATCHDOG 跳过 reset。
-      // 同时把工具卡置 pending_approval 态(与 AiApprovalRequired 一致,复用 ToolCard 渲染)。
-      clearStreamWatchdog()
-      const info: AiToolCallInfo = {
-        id: event.id,
-        name: event.tool,
-        args: { path: event.path },
-        status: 'pending_approval',
-      }
-      state.pendingApprovals.push(info)
-      const tc = findToolCall(event.id)
-      if (tc) tc.status = 'pending_approval'
+      // push 到 pendingDirAuths 驱动 DirAuthDialog 弹窗;看门狗已由 NO_RESET_WATCHDOG 跳过 reset。
+      // F-260620 根治(错调 ai_approve 致卡死):path_auth 挂起**不**置工具卡 pending_approval——
+      // 工具卡 pending_approval 态有审批按钮调 ai_approve(为 RiskLevel 审批设计),path_auth 错调
+      // ai_approve 会被后端拦(path_auth 回滚+Err)→ 前端转圈卡死(authz-debug.log 铁证:同 tool_call_id
+      // ai_approve+ai_authorize_dir 双调)。path_auth 只走 DirAuthDialog(ai_authorize_dir),
+      // 工具卡保持 running(等授权结果,授权后 AiToolCallCompleted 转 completed)。
+      //
+      // path_auth 审批链阶段3b(统一审批模型):开关 df-ai-unified-approval 开时,path 挂起归一进
+      // pendingApprovals 带 kind='path',由 ToolCard 内联显 once/always/deny 三按钮(调 authorizeDir),
+      // 消除独立 DirAuthDialog 弹窗(单真相源:状态层合)。开关关时回退阶段1老链路(push pendingDirAuths,
+      // DirAuthDialog 渲染)。两路共存,兜底可随时回退。
+      clearStreamWatchdog(event.conversation_id || undefined)
      clearToolSlowTimer(event.id)
-      pendingDirAuth.value = {
-        id: event.id,
-        tool: event.tool,
-        path: event.path,
-        dir: event.dir,
-        conversationId: event.conversation_id,
+      // 开关开:归一进 pendingApprovals(kind='path'),驱动 ToolCard 内联审批。
+      // 同 id 幂等:GLM anthropic_compat id 不稳或重发时,已有同 id 不重复 push(防残留重复卡)。
+      if (isUnifiedApproval()) {
+        if (!state.pendingApprovals.some(p => p.id === event.id)) {
+          state.pendingApprovals.push({
+            id: event.id,
+            name: event.tool,
+            args: { path: event.path },
+            status: 'pending_approval',
+            kind: 'path',
+            dir: event.dir,
+            path: event.path,
+            // path 类审批提示复用 aiChat.dirAuthHint(已存在 i18n,tool+path 文案);
+            // 不新增 key 避免 i18n 缺失 prod runtime 报错(memory: i18n-message-compile-blindspot)。
+            reason: t('aiChat.dirAuthHint', { tool: event.tool, path: event.path }),
+          })
+          // 同步改对应工具卡的 tc(让 ToolCard 显 path 类审批按钮 once/always/deny + status-dot pending 色)。
+          // F-260620 注释"工具卡保持 running"是为防 path_auth 错调 ai_approve 卡死——统一模式后 path 类
+          // 调 authorizeDir 不再错调,故可安全进 pending_approval(与 risk 类 AiApprovalRequired 同款流转)。
+          // 开关关(兜底)时仍保持老语义(tc 不动,走 DirAuthDialog)。
+          const tc = findToolCall(event.id)
+          if (tc) {
+            tc.status = 'pending_approval'
+            tc.kind = 'path'
+            tc.dir = event.dir
+            tc.path = event.path
+            tc.reason = t('aiChat.dirAuthHint', { tool: event.tool, path: event.path })
+          }
+          // path 类挂起同样启动审批超时计时器(5min 不处理自动拒),与 risk 类一致。
+          // 传 kind='path' → 到点回调调 authorizeDir(id,'deny')(非 ai_approve,避免后端 kind==Risk 校验拒卡死)。
+          startApprovalTimer(event.id, event.tool, 'path')
+        }
+        return true
+      }
+      // 开关关(兜底回退):push 到 pendingDirAuths 驱动 DirAuthDialog 弹窗。
+      // pushPendingDirAuth 据开关(df-ai-multi-pending-auth)决定多挂起并存(默认)还是单 ref 覆盖兜底。
+      if (!pendingDirAuths.value.some(p => p.id === event.id)) {
+        pushPendingDirAuth({
+          id: event.id,
+          tool: event.tool,
+          path: event.path,
+          dir: event.dir,
+          conversationId: event.conversation_id,
+        })
      }
      return true
    }
@@ -298,12 +392,16 @@ function handleToolEvent(event: AiChatEvent): boolean {
    }

    case 'AiApprovalRequired': {
-      clearStreamWatchdog() // 等用户审批,不计超时
+      clearStreamWatchdog(event.conversation_id || undefined) // 等用户审批,不计超时
+      // path_auth 审批链阶段3b:event.kind 缺省默认 'risk'(后端阶段3a wire 未加 kind 字段,
+      // 老后端不传即 risk 类)。event.kind 为 'path' 时理论上 path 挂起也走此事件(后端未来可统一),
+      // 当前阶段3a 后端 path 挂起仍走独立 AiDirAuthRequired 事件,故此处 kind 恒 'risk'。
      const info: AiToolCallInfo = {
        id: event.id,
        name: event.name,
        args: event.args,
        status: 'pending_approval',
+        kind: event.kind ?? 'risk',
      }
      state.pendingApprovals.push(info)
      const tc = findToolCall(event.id)
@@ -316,7 +414,8 @@ function handleToolEvent(event: AiChatEvent): boolean {
      // B-260616-12: 进入审批等待→取消该工具慢执行计时器(审批耗时由用户主导,非执行慢)
      clearToolSlowTimer(event.id)
      // AE-2025-06: 审批等待开始→启动审批超时计时器(5min 不处理自动拒绝)
-      startApprovalTimer(event.id, event.name)
+      // 传 kind='risk' → 到点回调调 aiApi.approve(id,false)(后端 ai_approve kind==Risk 链路)。
+      startApprovalTimer(event.id, event.name, 'risk')
      return true
    }

@@ -336,12 +435,16 @@ function handleToolEvent(event: AiChatEvent): boolean {
      } else {
        // B-260616-12: 审批通过→工具重新进入执行态,重启慢执行计时器
        startToolSlowTimer(event.id, findToolCall(event.id)?.name || '')
+        // path_auth 审批链:path 类(once/always 通过)与 risk 类共用此分支。
+        // 补 clearApprovalTimer 防 timer 到期错调:授权通过但超时计时器未清,5min 后仍会触发拒绝回调
+        // (path 类调 authorizeDir('deny')/risk 类调 ai_approve(false))与已通过的执行态冲突。risk 类拒绝分支(:422)已清,
+        // 此处通过分支原漏清(回归:统一审批开关开后 path 类挂起也挂 timer,通过分支须对称清)。
+        clearApprovalTimer(event.id)
      }
-      // F-260619-03 Phase B: 路径授权挂起的工具收到 ApprovalResult(once/always 通过 / deny 拒绝)
-      // → 清弹窗(后端 ai_authorize_dir 已 try_continue 续 loop)。
-      if (pendingDirAuth.value && pendingDirAuth.value.id === event.id) {
-        pendingDirAuth.value = null
-      }
+      // F-260619-03 Phase B + path_auth 审批链阶段1:路径授权挂起的工具收到 ApprovalResult
+      // (once/always 通过 / deny 拒绝)→ 按 id 从 pendingDirAuths 移除该条(后端 ai_authorize_dir
+      // 已 try_continue 续 loop)。数组化后只清这一条,不影响同轮其他未决策的挂起项。
+      removePendingDirAuth(event.id)
      return true
    }

@@ -354,15 +457,22 @@ function handleToolEvent(event: AiChatEvent): boolean {
 function handleLifecycleEvent(event: AiChatEvent): boolean {
  switch (event.type) {
    case 'AiCompleted': {
-      clearStreamWatchdog()
+      clearStreamWatchdog(event.conversation_id || undefined)
      clearAllToolSlowTimers() // B-260616-12: 整轮结束清全部工具慢执行计时器与已提示集合
      flushCurrentText()
      state.currentText = ''
-      state.streaming = false
+      setStreaming(false, { convId: event.conversation_id || null, reason: 'AiCompleted' })
      state.generatingConvs.delete(event.conversation_id || '')
      state.agentRound = 0 // AE-2025-07: agentic 结束,复位轮次(隐藏进度条)
-      pendingMaxRounds.value = false // F-260616-03: 收尾(停止/续跑后新一轮达 max 才会再 set),清操作卡
-      pendingDirAuth.value = null // F-260619-03 Phase B: 收尾清路径授权弹窗(防残留)
+      // TD-260621-02 per-conv:仅当 pendingMaxRounds===本 conv 才清 null(避免清其他会话的挂起)。
+      if (pendingMaxRounds.value && pendingMaxRounds.value === (event.conversation_id || '')) {
+        pendingMaxRounds.value = null
+      }
+      // TD-260621-03 per-conv:仅清本 conv 的 path_auth 挂起(其他会话的弹窗不连累清空)。
+      // 批2-A 刚把 pendingMaxRounds per-conv,pendingDirAuths 漏跟;此处补齐——
+      // F-09 多会话并发下全清会让 B 会话的 DirAuthDialog 凭空消失(用户报"弹窗没了我没操作")。
+      const doneConv2 = event.conversation_id || ''
+      pendingDirAuths.value = pendingDirAuths.value.filter(p => !p.conversationId || p.conversationId === doneConv2)
      // UX-2025-04 / CR-30-2 / 决策 a1: 流中途失败保文——后端 emit AiCompleted(incomplete=true),
      // 前端追加系统提示气泡(镜像后端 session.messages 的 system 提示)。
      // 注:此系统提示仅前端展示,后端已独立 push 到 session.messages 落库。
@@ -405,13 +515,13 @@ function handleLifecycleEvent(event: AiChatEvent): boolean {
    }

    case 'AiError': {
-      clearStreamWatchdog()
+      clearStreamWatchdog(event.conversation_id || undefined)
      clearAllToolSlowTimers() // B-260616-12: 错误收尾清全部工具慢执行计时器与已提示集合
      clearAllApprovalTimers() // UX-260617-10: 错误中断释放所有审批超时计时器,防回调改 state 触发已卸载/已错流程
      // UX-260619-06: 失败前先把流式累积的 currentText 回填到占位 assistant 气泡,
      // 保留"回答到一半"的部分回复(否则清 currentText 后部分内容消失)。
      flushCurrentText()
-      state.streaming = false
+      setStreaming(false, { convId: event.conversation_id || null, reason: 'AiError' })
      state.generatingConvs.delete(event.conversation_id || '')
      state.currentText = ''
      state.agentRound = 0 // AE-2025-07: agentic 异常中断,复位轮次
@@ -419,8 +529,13 @@ function handleLifecycleEvent(event: AiChatEvent): boolean {
      // UX-260617-10: 错误收尾清残留待审批项——错误发生时若有工具停在 pending_approval,
      // 残留可点击审批按钮会让用户误以为还能批(实际后端已终止),残留审批卡误导操作。
      state.pendingApprovals = []
-      pendingMaxRounds.value = false // F-260616-03: 异常中断,清操作卡
-      pendingDirAuth.value = null // F-260619-03 Phase B: 异常中断清路径授权弹窗
+      // TD-260621-02 per-conv:仅当 pendingMaxRounds===本 conv 才清 null(避免清其他会话的挂起)。
+      if (pendingMaxRounds.value && pendingMaxRounds.value === (event.conversation_id || '')) {
+        pendingMaxRounds.value = null
+      }
+      // TD-260621-03 per-conv:仅清本 conv 的 path_auth 挂起(异常中断只清本会话弹窗,不连累并发会话)。
+      const errConv2 = event.conversation_id || ''
+      pendingDirAuths.value = pendingDirAuths.value.filter(p => !p.conversationId || p.conversationId === errConv2)
      // F-09: 清理分离窗口生成态快照(per-conv key,清本会话快照;兼容旧单 key)
      const errConv = event.conversation_id || ''
      if (errConv) {
@@ -451,6 +566,8 @@ function handleLifecycleEvent(event: AiChatEvent): boolean {
 /** 后端事件分发:按 conversation_id 路由,流式累积文本,工具状态流转,看门狗联动 */
 export function handleEvent(event: AiChatEvent) {
  const convId = event.conversation_id
+  // 注:F-260620 path_auth 审批链根治卡死后,原 [AI-DIRAUTH-DIAG] 高频诊断 console.log 已删除
+  // (使命完成;热路径污染 devtools)。后续如需事件流诊断用 df-ai-event-trace 开关控制。
  // 首次收到事件时同步当前对话 id(后端自动建对话的场景)
  // 同步写 appSettings(SQLite):刷新页面后 loadConversations 据此恢复上次会话
  if (convId && !state.activeConversationId) {
@@ -472,8 +589,9 @@ export function handleEvent(event: AiChatEvent) {
    state.generatingConvs.add(convId)
  }
  // 流式看门狗:活跃事件(delta/工具/新轮/审批结果)重置;审批等待/完成/错误在 case 内 clear
+  // TD-260621-01 per-conv:传 convId 走 per-conv Map(各会话独立计时,互不顶替/连累)。
  if (!NO_RESET_WATCHDOG.has(event.type)) {
-    resetStreamWatchdog()
+    resetStreamWatchdog(convId || undefined)
  }
  // 按域分派(streaming → tool → lifecycle);未命中任一域 → 无操作(保留原 switch 无 default 的语义)
  if (handleStreamingEvent(event)) return
@@ -526,7 +644,7 @@ function stopListener() {
  // _startPromise 可能仍在 pending(未 await 完即 unmount),再 mount 若命中并发去重分支会
  // 返回这个已代表「旧注册」的过期 promise,新 listener 实际未注册。
  _startPromise = null
-  clearStreamWatchdog()
+  clearAllStreamWatchdogs() // TD-260621-01: 卸载清全部 per-conv + legacy fallback timer,防回调改已卸载组件 state
  clearAllToolSlowTimers() // B-260616-12: 卸载时释放所有工具慢执行计时器,防回调改 state 触发已卸载组件
  clearAllApprovalTimers() // AE-2025-06: 卸载时释放所有审批超时计时器,防回调 push 消息触发已卸载组件
 }