优化: 聊天体验批与Web规范合规
This commit is contained in:
+158
-221
@@ -6,18 +6,30 @@
|
||||
>
|
||||
> **2026-06-18 归档**: 已完成 `[x]` 与历史分析段已迁至 [07-项目管理/todo归档/2026-06-18.md](./07-项目管理/todo归档/2026-06-18.md)。
|
||||
> **2026-06-27 归档**: 已完成 `[x]`/`✅` 项已迁至 [07-项目管理/todo归档/2026-06-27.md](./07-项目管理/todo归档/2026-06-27.md)。
|
||||
> **2026-10-05 归档**: 7 个实测核验全完成的历史走查段(父子任务支持/对话上下文透明化/文件拆分升级/ToolCard UI 合并/灵感模块诊断/aichat 深度走查/TaskDetail 按钮走查)迁至 [07-项目管理/todo归档/2026-10-05.md](./07-项目管理/todo归档/2026-10-05.md),销账批注与滞后勘误见该文件。
|
||||
>
|
||||
> **2026-08-05 编号碰撞登记**: `F-260619-03` 被两个特性复用(消息拆分存储=文档本体 + AI工具路径授权=复用)。子代理审查确认:改 18 处编号无实际价值有风险,**暂不改代码**,后续新增注释编号统一走日期+序号体系、避免复用已有编号。路径授权若后续单独立项再独立编号。
|
||||
> **2026-08-15 编号碰撞登记**: `REFACTOR-260619-04` 被复用(父③③.2 审批状态机拆分=待办 vs ToolCard 拆分=已完成)。后续引用审批状态机拆分时用「审批状态机拆分」描述,不再沿用该编号。
|
||||
|
||||
### 💡 2026-10-05 UX 走查 — Web Interface Guidelines 合规（43 文件机械扫，4 类系统性）
|
||||
|
||||
> 背景：src 43 个 .vue 文件 UI 规范缺口全量合规走查（Vercel Web Interface Guidelines 适用子集）+ 审批/aichat/项目知识审计三域子代理分组审。质量中上无阻断，缺口集中 4 类系统性模式，其中 2 类可全局样式一刀切收敛。
|
||||
> 详情:[05-代码审查/UX走查-Web规范合规-2026-10-05.md](./05-代码审查/UX走查-Web规范合规-2026-10-05.md)
|
||||
|
||||
- [ ] P2-1 全局两刀:`:focus-visible` 兜底 outline(outline:none 19 处/14 文件大半裸奔)+弹层 `overscroll-behavior:contain`(全仓 0 命中覆盖面最广,约 12+ 弹层)——2 条全局 CSS 收敛两类
|
||||
- [ ] P2-2 高频可点 div 键盘化:ToolCard:11 卡头/MessageList:1423 轨迹头/AuditLog:67,119 审计行(@click div 全仓 56 处,去 mask 合规项约 20 真缺口,高频改 button 其余 tabindex+keydown)
|
||||
- [ ] P3-1 transition:all 33 处/22 文件→机械替换具体属性(color/background/border/transform,sed 级批量低风险)
|
||||
- [ ] P3-2 icon-only 按钮缺 aria-label ~15 处(title 非等价读屏补偿;EnrichmentPanel 关闭钮/ProjectDetail:185,189 编辑删除钮等)+剩余 div 键盘化
|
||||
- 拍板点:修复范围「存量 vs 仅本批」——transition:all/outline:none 大半为存量;本批新代码 a11y 意识已好(svg aria-hidden 批补/MessageList role=log+aria-live/hover-only focus-within 补偿),仅清本批则工作量降 60%+
|
||||
|
||||
### 💡 2026-09-29 aichat 可用性与交互成本研究(三动线走查+异常循环截图实证,39 项新发现)
|
||||
|
||||
> 背景:用户反馈交互刷屏已修(工具卡默认折叠)后,按「使用体验/使用成本」深入走查三动线;截图实证「写完就删」循环跑到轮次耗尽——G2 熔断签名机制对写删交替结构性漏网(唯一率 0.83≫0.4,单签名最高 2 次<3,全程连警示都不触发);与 9-28 走查 17 项合并排序。
|
||||
> 详情:[05-代码审查/aichat可用性与交互成本研究-2026-09-29.md](./05-代码审查/aichat可用性与交互成本研究-2026-09-29.md)
|
||||
|
||||
- [x] 第一批 P1 ✅2026-10-02 走查核验:I1 停止窄窗已修(ChatInput.vue:291 stopBtnState 读 conv_state)+I2 编辑死链已修(04acc42 canEdit+start-edit)+G2 破坏性回环熔断已实现(helpers.rs detect_destructive_loop)+V3 后台通知已修(e1dd0bc notify.rs 接线);V2 聚合层已修(useAiToolEvents 无条件入列,V5/V6 未逐项核)与 V1 审批徽标未修→留前端体验批
|
||||
- [ ] 第二批 P2:V8 草稿 per-conv 防串台/R3 长回复带量提示+R4 代码块复制/I5 错误分类兜底(429 占 55%)/V4 浮窗高风险二次确认/V7 排队时钟冻结/R5+V9 消息内容检索 等 16 项,排序详报告第五章
|
||||
- [ ] 第三批 P3 攒批:I8-I13+R8-R13+V10-V12+9-28 #9-#17;其中 9-28#17 图片默认上传外部域名涉开源边界,单独决策
|
||||
- [x] 第二批 P2:~~V8 草稿 per-conv 防串台~~✅(2026-10-05 核验:ChatInput watch convId setConvDraft/getConvDraft 已实现+mention/技能/图片临时态不跨会话携带)/~~R3 长回复带量提示~~✅(2026-10-05 核验:MessageList collapsedLongLabel 折叠态已带「N 字符/约 M tokens」量提示)+~~R4 代码块复制~~✅(aichat二批8e29271f)/~~I5 错误分类兜底~~✅(2026-10-05 核验:aiShared classifySendError 四类顺序敏感分类+ChatInput SEND_ERR_KEY 映射消费,原始错误留 {msg} 不丢)/~~V4 浮窗高风险二次确认~~✅(同批)/~~V7 排队时钟冻结~~✅(2026-10-05 核验:AiChat.vue nowTick 有排队时 1s interval 推进+queueTimedOut 显式读 tick,等待秒数/30s 超时横幅每秒重算,队列清空关表防泄漏)/~~R7 失败汇总~~✅(2026-10-05 本批:ToolCardList groupFailCounts computed 复用 isToolFailure 单点判定,组头红徽标「{n} 失败」+i18n 两键——轨迹卡聚合行/执行中步骤行既有失败计数外的组头盲区补齐)/R5+V9 消息内容检索(后端 IPC+前端搜索底座,唯一真缺口,独立批),排序详报告第五章
|
||||
- [x] 第三批 P3 攒批:I8 ✅(2026-10-05 本批:stopChat 队列非空一次性 toast「已停止,N 条排队消息仍将自动发送」ai.queueWillContinue zh/en——停止≠清队预期对齐,全停走逐条取消/清队列)/I9 附件仅图片→~~I9~~✅(2026-10-05 本批:「📄 文件」按钮(ChatInput 📎 旁)——多选文本/代码/配置文件(57 扩展名白名单)读内容以 ```lang <!-- 文件名 --> 代码块插入草稿,复用图片链 blobFromPath(convertFileSrc)零新依赖;单文件 256KB/5000 行双上限截断+提示;走既有文本发送链零协议改动)/I11 ✅(2026-10-05 本批:ChatInput INPUT_MAX_HEIGHT=200 常量四处 120px 硬编码全收敛,与 CSS max-height 同源——手工拉伸不再被按键压回)/~~I12 快捷键零提示~~✅(2026-10-05 本批:TopBar ... 菜单加快捷键入口 + AiChat Teleport 速查面板(Ctrl+N/I/R/L/K/B+Esc 七键,label 随 locale,mask 点击外部/Esc/✕ 三路关)——速查键位表与 onGlobalKeydown 同文件同居防漂移)/I13 ✅(2026-10-05 本批:Ctrl+I 聚焦输入框,AiChat 全局键区接入 chatInputRef.focus,输入焦点守卫让路)+~~R8 流式裸 diff~~✅(2026-10-05 本批:useMarkdown wrapNakedDiff 改 export,useStreamRenderer parseBlockNoCache 接入同源预处理——流式中裸 +/- 行即红绿 diff 块,守卫3围栏内不动保证与完成态幂等不双包)+~~R10 阅读锚点~~✅(2026-10-05 本批:三处 collapseAllToolLists 调用点(滚轮回调/消息快照 watch/agentRound watch)全加 isFollowingBottom 门——上滚阅读中新轮次不再强制收起正浏览的工具卡)+~~R11 新内容信号~~✅(2026-10-05 本批:回底按钮生成中非跟随态加 amber 脉冲点 ai-btb-new-dot 2s 循环)+~~R13 assistant 时间戳常显~~✅(2026-10-05 核验:UX 密度改造已消解——ai-msg-time 全仓零命中,≥30min 间隔 timesep 分隔线替代 per-msg 时间戳)+~~I10 重试文案名实不符~~✅(2026-10-05 本批:streamInterruptedAfterTool zh/en 改「可点重试续跑(整轮重跑,已完成工具会重新执行)」明示副作用)+~~R12 diff 回看~~✅(2026-10-05 本批:a patch_file 长 diff 展开入口(DIFF_PREVIEW_LINES=120 默认预览,「展开全部 {n} 行/收起 diff」toggle,parseDiffLines expanded 传 undefined 全量)/b write_file 覆盖写入 diff 回看(后端 file.rs rename 前读旧内容(仅 utf-8 ≤1MB)generate_diff 产 diff 字段,新建/base64 为 null 前端不渲染;前端同构红绿行渲染+展开按钮)——工具卡可回看改了什么不再只看字节增减)+~~V11 分离窗三连~~✅(2026-10-05 本批:a 置顶默认 false(useAiWindow detachPanel alwaysOnTop:false,原 true 盖住 VSCode/浏览器;开过置顶走 AiChat df-ai-always-on-top KV 恢复链不受影响)/b 收回主面板闭环(TopBar reattach 按钮+emit 链补 AiChat @reattach→emitReattachToMain Tauri 全局广播→主窗 registerMainReattachListener(label=main 判定)→store.reattachPanel——原 reattachPanel 全仓零 UI 调用只能手动重开面板)/c 活跃会话 KV 按窗口域分流(activeConvKvKey() 主窗 'df-ai-active-conv' 分离窗 '-detached' 后缀,读端 loadConversations+写端切会话/新建/自动路由/删除回落 5 处统一;治两窗独立 JS context 共写同一 KV 互覆——分离窗切会话重启后主窗被带跑;detachPanel 种子分离窗 KV,reattachPanel 关全窗后清 KV;useAiConversations 顶层 import getCurrentWebviewWindow 同步解析无启动竞态))+~~V12 滚动位置丢失~~✅(2026-10-05 顺手批:MessageList 切会话 watch 记旧会话 scrollTop(Map 限 20 个 LRU),换入有存档恢复存档位+setFollowing(false) 尊重阅读位,无存档保持回底——回读不再被打断)+9-28 #9-#17 详见下条;其中 9-28#17 图片默认上传外部域名涉开源边界,单独决策。V10 本批实施纠错:先误核销后复核发现 Ctrl+N 仍有 `!store.state.streaming` 守卫(生成中静默吞键)与按钮侧 F-09 真并发语义矛盾依旧,已撤守卫对齐按钮(新建不杀旧 loop,后台继续),vue-tsc EXIT 0
|
||||
- [x] ✅ 同日已修:工具卡默认折叠刷屏+read_file/list_directory 单行摘要补齐+分组折叠幂等补齐(工作区待提交)
|
||||
|
||||
### 💡 2026-09-29 aichat 知识库与记忆修复(「笨/丢历史」根因诊断,同日已修会话内侧)
|
||||
@@ -30,17 +42,18 @@
|
||||
- [x] P0 candidate→published 断链打通 ✅已修(机制先行 7c62d8d:复用自动晋升+knowledge_promote 工具+晋升补嵌入;存量晋升迁移 V43 2026-10-02 落地:candidate+confidence=high→published,库副本实证 854 条晋升 967/53→113/907,重跑幂等 0 行,df-storage 180 测试全绿;增量 confidence 分级与 auto_publish 默认值等 C3 拍板)
|
||||
- [x] P0 视图裁剪补滚动摘要 ✅已修(9b89610 淘汰补偿摘要插视图首部,user 角色保缓存指纹,纯视图不落库,eviction 11 测试全绿,2026-10-02 核验)
|
||||
- [x] P1 LLM 知识工具注册 ✅已修(7c62d8d 注册 knowledge_search/insert/promote 三工具,tool_registry.rs:798,检索与注入同源分词)
|
||||
- [ ] P1 跨会话召回最小闭环 ✅设计完成(2026-10-04 [设计文档](./02-架构设计/专项设计/跨会话召回最小闭环-设计-2026-10-04.md)):勘察修正——提炼链已存在(knowledge_inject.rs 水位+哨兵+手动触发),缺口仅 source_project 赋值(boundary_json→mention 两级弱推断,零 schema 变更)+注入软排序(search_keywords_scoped 新方法);3 拍板点待过,约 1 天
|
||||
- [x] P1 跨会话召回最小闭环 ✅实施完成(2026-10-05,设计 2026-10-04 [设计文档](./02-架构设计/专项设计/跨会话召回最小闭环-设计-2026-10-04.md) 3 拍板 B1/B2/B3 全按建议):①提炼侧 resolve_source_project 两级弱推断——级 a boundary_json.dir_allowlist 首条反查 projects.path 前缀匹配(轻量词法归一 normalize_dir_for_match:斜杠统一+小写+去尾分隔),级 b 唯一 `[项目:名称]` mention 回退(B1 拍板:多项目不猜置 NULL),皆无→NULL=全局知识零回归;extract_knowledge_from_conversation 插入处赋 source_project。②注入侧 search_keywords_scoped 新方法(B3 拍板,旧签名保留 MCP 外部调用零影响,project_id=None 转调旧路径回归门)——三档排序:同项目 0/全局 NULL 1/异项目 2,档位作第一排序键 ASC(title 命分为同档第二键,防档位被 title 分稀释);build_knowledge_context 注入前同走 resolve_source_project。③单测 6 个:df-storage scoped×3(同项目压异项目高复用/三档顺序/None 回归门)+devflow resolve×3(目录归一/级 a boundary 命中/级 b 唯一 mention 命中+多项目不猜)。验收 cargo test df-storage 199 passed 0 failed(顺带修正 migration 测试断言常量 48→49:V49 loop_state 迁移注册后断言未跟进,现全绿)+devflow --lib 706 passed 0 failed+knowledge_inject 26 passed
|
||||
- [x] P1 存量测试修复 4 个 ✅已修(df3ed55 断言同步+e7cd035 笔误修正,2026-10-02 全量 cargo test --workspace 1827 passed/0 failed 复核)
|
||||
- [ ] P2 DB 落库截断分 role 定阈值(user 原话均 41 字被 3072 截断无必要)/namespace 重启懒重建/兜底压缩路径 sync_after_compress 复议
|
||||
- [ ] P2 DB 落库截断~~分 role 定阈值~~✅(2026-10-05 核验:conversation.rs:372 tool result 跳过 content 截断仅截 assistant/user——体量已由 read_file limit 控源)/namespace 重启懒重建/兜底压缩路径 sync_after_compress 复议
|
||||
|
||||
### 💡 2026-09-28 devflow 集成 u-claw 能力(可行性已定,待实施)
|
||||
### 💡 2026-09-28 devflow 集成 u-claw 能力(✅ 代码面已落地 2026-10-05,剩真机冒烟)
|
||||
|
||||
> 链路:devflow → u-relay → u-claw。通路已生产验证(u-ppt 试点 2026-08-29),u-relay 零改动,唯一工作面 devflow 侧接入。
|
||||
> **状态更新 2026-10-05**:ask_uclaw 工具(470 行)+UclawPanel 配置页+i18n+流式链补全已落地(任务 5fb916ac,cargo test 693 passed);「per-conv channel_id 隔离」经源码终核不成立(单 channel 单链,MVP 接受共享上下文语义);剩真机全链冒烟(需 u-relay+u-claw 在线配合)。原实施清单保留作档案。
|
||||
> 详情:[02-架构设计/专项设计/devflow集成u-claw-可行性研究-2026-09-28.md](./02-架构设计/专项设计/devflow集成u-claw-可行性研究-2026-09-28.md)
|
||||
|
||||
- [x] devflow/u-claw 两侧细勘察补全 ✅2026-10-04 完成([勘察补全](./02-架构设计/专项设计/uclaw两侧勘察补全-2026-10-04.md)):多轮锚定=channel 级单 chain 粘性会话(request_id 仅单指令标识,常驻 claude 各轮同 session_id,崩溃 --resume 恢复);**协议已漂移**——端点改 /ws/commander(commander/agent 角色,e8113c5),hello {kind,channel_id,token},不能照抄 9-28 文档/u-ppt relay.ts;新增核实:串行 worker+队列满丢弃、单条 15min 硬超时、进度 2s 节流、空闲链回收 7s 冷启动;接入实施批清单六步已列(含 per-conv channel_id 隔离策略)
|
||||
- [ ] 接入实施:WS 客户端(参考 u-ppt relay.ts 65bae53——✅2026-10-04 已核,commander 协议现行对齐(端点/hello/握手/心跳/重连/业务帧六项一致),去 deck/SEP 专有逻辑即可移植)+ ask_uclaw 工具 + 配置页(默认关,对齐 cfg.WS==nil 模式);客户端超时 16min+2 次重试+发送前探活;per-conv channel_id 隔离(devflow-{conv_id})
|
||||
- [ ] 接入实施 ✅主体已落地(2026-10-05 任务 5fb916ac):ask_uclaw 工具+配置页三键+前端流式链全接通;隔离策略勘误=单链共享上下文(MVP),多实例 phase2;剩真机全链冒烟
|
||||
|
||||
### 💡 2026-09-28 aichat 交互走查清尾(启动「日常主入口」标准,1P1+7P2+9P3)
|
||||
|
||||
@@ -48,29 +61,11 @@
|
||||
|
||||
> 背景:devflow 启动定位=日常 AI 交互调度中枢,按日常主入口标准走查。新发现集中在 God 组件拆分丢功能的链路断点+多会话并发收口残留缝隙。
|
||||
> 详情:[05-代码审查/aichat交互走查-2026-09-28.md](./05-代码审查/aichat交互走查-2026-09-28.md)
|
||||
|
||||
- [ ] 第一批(日常直接受伤):#1 编辑末条消息入口丢失回归(2c2b2d7 提取 MessageItem 时按钮未迁移)+#4/#5 排队消息被静默清(AiError/审批失败/看门狗超时三路径,含两处全局清队列残留)+#6 后台会话错误气泡推错视图+#7 429 无分类且重试照显
|
||||
- [ ] 第二批(多会话体验):#8 审批徽标跨会话误导+点击 no-op+#3 en 重试气泡残留+#2 rejectedHint i18n key 多前缀
|
||||
- [ ] 第三批随批清理:P3 九项(#9-#17,详见报告)+B-260619-04③销账(实际已落地)
|
||||
- [x] 第一批(日常直接受伤):~~#1 编辑末条消息入口丢失回归~~✅(2026-10-05 核验:MessageItem:126 编辑按钮+start-edit 链完整,I2 批已修)+~~#4/#5 排队消息被静默清~~✅(二批 8e29271f 修)+~~#6 后台会话错误气泡推错视图~~✅(forceConverge 气泡双过滤 `!convId || convId === activeConversationId` 才 push)+~~#7 429 无分类且重试照显~~✅(2026-10-05 核验:aiShared.ts:603 classifySendError 顺序敏感 429/限流先判+ChatInput SEND_ERR_KEY 分类文案)
|
||||
- [x] 第二批(多会话体验):~~#8 审批徽标跨会话误导+点击 no-op~~✅(2026-10-05 核验:state.pendingApprovals 已退化为当前活跃会话视图投影(aiShared.ts:364 per-conv Map 底座)+徽标点击→AiChat:243 scrollToFirstPending 委托链完整)+~~#3 en 重试气泡残留~~✅(2026-10-05 核验:useAiLifecycleEvents 终态收尾按 m.isRetry 标记匹配清除,替代旧中文文案子串匹配,en 生效)+~~#2 rejectedHint i18n key 多前缀~~✅(2026-10-05 核验:ToolCard.vue/useAiApproval/useAiToolEvents 消费点全已统一 `aiTool.rejectedHint` 路径,zh/en 两 locale 键位齐)
|
||||
- [x] 第三批随批清理:~~#10 user 时间戳+死样式~~✅(2026-10-05 核验:UX 密度改造消解——ai-msg-time 全仓零命中,≥30min timesep 分隔线替代)/~~#11 compressed 死代码~~✅(2026-10-05 核验:结论过时——compressed 段是 F-15 活代码(压缩摘要置顶显示不折叠),kind/模板/CSS 均在用)+#9 消息删除⏸️(2026-10-05 勘察:需后端 ai_delete_message IPC+前端全链(现仅 clearChat 整删/pop_last_assistant_round 弹末轮),纯前端只能视觉删除重启复活误导用户——与 #13 合并为「消息操作 IPC 协议级独立批」)+~~#12 token 面板~~✅(2026-10-05 顺手批:convTokenTotal 会话累计接入既有 token 详情 popover 尾部段(仅末条 AI 回复显,分 total/in/out 三行+分隔线样式)——只写不读的闲置数据源接上消费,非新面板零结构增量)+~~#13 中间错误重试错位~~⏸️(2026-10-05 勘察:需后端 IPC 加 from_id 参数+截断链(现仅 pop_last_assistant_round),协议级改动独立批)+~~#14 批量审批部分失败提示~~✅(2026-10-05 顺手批:batchApprove 部分失败从静默 console.warn 升级 ai-toast「批量完成：{ok} 项成功,{fail} 项失败」aiTool.batchPartialFail zh/en)+~~#15 ToolCallStarted 竞态~~✅(2026-10-05 顺手批:末条非 assistant 时兜底向前找最近 assistant 落卡,不再丢 running 卡;全程无 assistant 才保持原丢弃)+~~#16 注释与实现矛盾~~✅(2026-10-05 本批:注释纠偏——withConvOp failKey 错误气泡兜底实证(useAiConversations.ts:96),catch 内 console.error 留痕不重复提示)+~~#17 图片上传外部域名~~⏸️(2026-10-05 用户指示延后再论:涉开源边界,业务域名硬编码默认可 df-file-upload-base 覆盖,决策项不动代码)+B-260619-04③销账(实际已落地)。另 R5+V9 消息检索用户指示延后
|
||||
- [x] 第四批(用户实测反馈 2026-09-29):批量读取文件时工具卡逐卡渲染刷屏 ✅已修——分组默认收起机制 6 月已有但为一次性初始化,流式场景首卡到达即触发完毕,组从 1 卡长到 N 卡不再折叠致 N 张单行卡全展开;改响应式补齐(组达 2 卡阈值即收起)+用户手动操作/审批展开记 touched 不被自动收回
|
||||
|
||||
### 💡 2026-08-04 父子任务支持(✅ 已完成)
|
||||
|
||||
> 目标：完成父任务/子任务的完整支持（数据→后端→前端），UI/UX 重点设计。
|
||||
> 详情：[04-功能迭代/父子任务支持设计-2026-08-04.md](./04-功能迭代/父子任务支持设计-2026-08-04.md)
|
||||
|
||||
- [x] **后端** ✅ 父聚合下沉 df-nodes 共享层(`recompute_parent_status`/`advance_task_with_parent`)，IPC/AI 工具/MCP 三方统一；df-mcp create_task 支持 parent_id(1 级嵌套校验)；delete_task 级联软删子任务(返回 `{ok,cascaded}`)
|
||||
- [x] **前端** ✅ Tasks.vue 树形列表(折叠箭头+📑图标+子进度徽章 n/m+迷你进度条+缩进竖线圆点)；新建弹窗「父任务」下拉(项目锁定)；TaskDetail 父面包屑+子任务面板(进度条+快捷推进+添加子任务)；i18n zh/en 双份
|
||||
- [x] **核查** ✅ cargo check(df-nodes/df-mcp/src-tauri 三 crate) + vue-tsc 全部通过
|
||||
|
||||
### 💡 2026-06-27 对话上下文透明化(✅ 全部完成)
|
||||
|
||||
> 用户看不到 AI 接收到的上下文信息（目标钉扎/enrichment/system_prompt），导致行为不可理解。
|
||||
|
||||
- [x] **L1 目标可见** ✅ 对话顶部显示当前 pinned_goals 列表(TopBar.vue 🎯 图标,可查看/清理)
|
||||
- [x] **L2 Enrichment 可见** ✅ @[项目] 发送前展开 enrichment 摘要(ChatInput.vue enrichment 预览面板,展开/收起/取消关联)
|
||||
- [x] **L3 完整上下文** ✅ 可展开面板查看 system_prompt / augmentations(TopBar.vue 底部 context 面板)
|
||||
|
||||
### 💡 2026-06-27 统一 Inbox 设计(讨论产出)
|
||||
|
||||
> 思路:所有需要用户注意的事项(审批/知识待审/灵感确认/其他通知)集中到一个统一入口,
|
||||
@@ -272,40 +267,6 @@ graph TD
|
||||
|
||||
- ✅ **UX-260617-28 [INFO]** — 已决策:现状够用,不出问题不升级
|
||||
|
||||
### 🔧 2026-06-19 文件拆分升级（核验结论：全部完成）
|
||||
|
||||
> **2026-06-28 核验**:三项 God 文件拆分已全部完成:
|
||||
> - **tool_registry.rs** ✅ 1091行单函数已拆为按域注册函数
|
||||
> - **AiChat.vue** ✅ 4026→**767行**(已抽子组件)
|
||||
> - **crud.rs** ✅ 2212→拆为 `crud/` 下11个文件
|
||||
|
||||
**P1 ToolCard 拆分(已核验完成)**
|
||||
|
||||
- [x] **REFACTOR-260619-04 [P1]** ✅ **ToolCard.vue 拆分完成**:
|
||||
- ToolCard.vue 1527→**373行**
|
||||
- `ToolResultBody.vue` + `useToolCardHeader.ts`(160行) + `useToolCardRender.ts`(45行)
|
||||
- `useToolApproval.ts`(审批状态机独立,220行,B-260616-08 loading/挂起时长/toast 完整)
|
||||
- `useToolCard.ts`(666行,通用工具函数) — 原 ToolCard 组件拆分的目标全部到位
|
||||
|
||||
**P2 暂缓(窗口未到/收益低)**
|
||||
|
||||
- [ ] **REFACTOR-260619-09 [P2 暂缓]** — **✅事实完成销账(2026-10-04 勘误)**:原 context.rs(1332)已拆为 context/{mod,sanitize,manager_tests}.rs 目录模块,条目过时。**新超标对象=context_helpers.rs(1733 行)**,拆分备勘已出(2026-10-04 [设计文档](./02-架构设计/专项设计/context-helpers拆分备勘-设计-2026-10-04.md),四批迁移+压缩热点殿后+触发条件=上下文管理批稳定后等用户指令) — `crates/df-ai/src/context_helpers.rs`
|
||||
|
||||
---
|
||||
|
||||
### 🔧 2026-06-19 ToolCard 同批/跨轮 UI 合并（子代理方案·其他会话实施·P1）
|
||||
|
||||
> 用户需求:AI 多轮 read_file(轮1×2 + 轮2×2)前端一排展开卡片("上面两个下面两个"),希望 UI 合并。后端 convert 已合并连续 tool_result(B-260619-03),前端展示层对齐。子代理分析:同批同类合并**已存在**(ToolCardList groupedToolCalls L92-110,calls>=2 显标题行+默认收起),**痛点是跨轮**(轮1/轮2 各独立 ToolCardList 实例→各成分组)。用户强调"谨慎不出错"。
|
||||
|
||||
- [x] **B-260619-04 [P1]** ✅ **ToolCard UI 合并方案 A 全部落地**:
|
||||
- **现状(已查清)**:`ToolCardList.vue` groupedToolCalls 按 tc.name 全局聚合,calls>=2 显「[图标] 读取文件 [N] ▸」标题行 + 默认收起(initDefaultCollapse L139-147)。**同批 read_file×2 应已是折叠组**;用户「下面又两个」=下一轮新 message 的独立 ToolCardList 实例→第二个分组(跨轮未合并)。
|
||||
- ✅ **步骤 ① 标题信息增强(已落地)**:groupFileSummary(group) 从 group.calls[].args.path 取前 2-3 个 shortPath 截断显示(“读取 2 个文件 · shortPath1 · shortPath2”),模板已渲染。
|
||||
- ⏸️ **步骤 ③ 新轮到达自动收起旧轮**:当前跨轮收起未实现,保留作为低优先增量需求(需在 AiChat.vue watch messages 调 collapseCompletedGroups,风险中)。
|
||||
- **不推荐方案 B**(跨轮全局合并,破坏 message 边界,审批/折叠重构高风险)/ **C**(纯视觉框,不解决占用)。
|
||||
— `src/components/ToolCardList.vue`
|
||||
|
||||
---
|
||||
|
||||
### 💡 灵感模块-来源采集/追溯(2026-06-21·待办·新功能范畴)
|
||||
|
||||
> 继批1-3c 升级后的下一步:灵感来源录入增强 + 自动采集机制。**属新功能范畴**,需独立设计采集规则/触发/去重,下一阶段推进。
|
||||
@@ -360,26 +321,6 @@ graph TD
|
||||
|
||||
---
|
||||
|
||||
### 🔍 2026-06-26 灵感模块诊断待办（合并推进·单任务）
|
||||
|
||||
> ✅ 全部修复完成（2026-06-27 核验）
|
||||
|
||||
- [x] **IDEA-FIX-10 [P2🟠]** — **前端 filter + 后端分页漏数据**。团队决策：`hot`/`pending` 保留前端 filter（扩多值属性过度设计）；keyword/order_by 已下沉后端。✅ 关闭(2026-08-15:团队决策定案,无后续动作)
|
||||
|
||||
---
|
||||
|
||||
### 🔍 2026-07-17 aichat 对话功能深度走查待办
|
||||
|
||||
> 详单：[05-代码审查/aichat-对话功能走查-2026-07-17.md](./05-代码审查/aichat-对话功能走查-2026-07-17.md)
|
||||
|
||||
- [x] **AIC-FIX-17-P0-1** — 流式 watchdog legacy 路径 `convStates.clear()` 全局误杀 → `delete(state.activeConversationId)` ✅
|
||||
- [x] **AIC-FIX-17-P0-2** — 审批计时器切/删会话不清 → switch/delete 入口 `clearAllApprovalTimers()` + 注释修正 ✅
|
||||
- [x] **AIC-FIX-17-P1-1~11** ✅ 已销账(2026-08-15 核验,1 agent 全量核验 + 主代 4 项抽查源码属实):P1-1/3/4/5(queue/modelOverride/spans/_lastDelta per-conv,F-09 收尾)/ P1-2 drainQueue 互斥 `_drainingConvs` Set(useAiSend:274)/ P1-6 flushCurrentText 守卫 / P1-7 MessageItem 收敛仅 user 角色 / P1-8 _blockCache LRU 300+切会话 resetStreamCache / P1-9 指纹 watch 替代 deep / P1-10 approving 防重入前置(useToolApproval:133)/ P1-11 deleteConversation 相邻回落(useAiConversations:520)。余「MessageList 内联渲染组件化」「缓存主动失效」为优化空间非缺陷
|
||||
- [x] **AIC-FIX-17-P2** ✅ 已销账(2026-08-15):7 条中 5 条核验为此前批次已修(ApprovalOverlay 响应式冷却/aiShared 对称收敛/flash watch/maximized 三元/emit 类型),2 条本批落地(tailSeq 注释与实现对齐 useStreamRenderer:142-196、isCompressing 单例补 known limitation 注释 useAiContext:28)
|
||||
- [x] **AIC-FIX-17-根因** ✅ **2026-08-07 核验销账**(queue/modelOverride/审批/_lastDelta 均已 per-conv) — F-09 per-conv 收尾（queue / modelOverride / _approvalTimers / _lastDelta 单例化）
|
||||
|
||||
---
|
||||
|
||||
### 🔍 2026-08-01 走查剩余待办（P2/P3/专项·本会话登记）
|
||||
|
||||
> 本次走查剩余项登记，未实施代码（守 session-role-diagnose-only）。专项已落 memory，此处留指针。
|
||||
@@ -518,108 +459,6 @@ graph TD
|
||||
**其他已销项**:CSW-P2-7(需实测确认,从待办去除)
|
||||
---
|
||||
|
||||
### 🔍 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 项目详情页走查(概览/文件/依赖图 · 3 agent 并行 + 主代核查)
|
||||
|
||||
> 用户要求「检查项目详情（概览、文件、依赖图）存在的问题」并「先检查做记录，不直接改」。详单见 [项目详情页走查-2026-08-09.md](./05-代码审查/项目详情页走查-2026-08-09.md)。共 **60 项**（P0×1 / P1×6 / P2×14 / P3×27）。守 session-role-diagnose-only：仅走查登记，未实施代码。
|
||||
@@ -731,9 +570,9 @@ graph TD
|
||||
**P3（25 项）**: 见详单文档（MCP-7~16 / EX-1~4 / PRJ-2~4 / TUN-2~4 / RLY-2~5）
|
||||
|
||||
> **全系统走查（阶段②）完成 ✅**——前端 13 模块 + 后端 9 命令 + 全部 crate 已走查登记。进入**阶段③批量打包推进 /advance**。
|
||||
### 🔴 2026-08-09 AI 自审/工作流推进链路缺陷（task_id 断裂 + AiNode 缺 prompt + 审批无 UI）
|
||||
### 🔴 2026-08-09 AI 自审/工作流推进链路缺陷（✅ P0×3 已修,2026-10-05 核验销账）
|
||||
|
||||
> 用户「检查 AI self-review 遇到的问题」触发对工作流推进链路的深度审查。**核心结论：工作流推进按钮从 TaskDetail 触发时，三条推进链（in_progress/testing/done）全部不可用**。守 session-role-diagnose-only：本会话仅走查+登记，未实施代码。
|
||||
> 用户「检查 AI self-review 遇到的问题」触发对工作流推进链路的深度审查。**原结论「三条推进链全部不可用」已过时——P0×3 全部已修**（task_id 注入 workflow.rs:340 + AiNode 自审落库含 agent 模式 + TaskDetail 审批 UI 随 2eea011 审批重设计批落地），核验详录迁 [07-项目管理/todo归档/2026-10-05.md](./07-项目管理/todo归档/2026-10-05.md)。以下原始诊断保留作档案,修复状态见归档勘误。
|
||||
|
||||
**涉及文件**：
|
||||
- `src-tauri/src/commands/workflow.rs`（run_workflow_inner 核心）
|
||||
@@ -833,7 +672,7 @@ graph TD
|
||||
|
||||
> 来源：中断根治批次全量走查（正常设计路径无漏 emit，风险集中四类）。P1-2/P0-1/P2-1 本批已修，以下为登记项。
|
||||
|
||||
### P0 run_agentic_loop 包 catch_unwind
|
||||
### P0 run_agentic_loop 包 catch_unwind ✅已修(2026-10-05 核验:loop 主体 unwind_to_result 包裹,panic 转 teardown_round 补终态,5 单测锁定 mod.rs:3135-3165)
|
||||
- **位置**：`agentic/mod.rs` run_agentic_loop 主体（无 catch_unwind）
|
||||
- **现状**：任一轮 prepare/stream/finalize/tools 段 panic → task 死亡 → GeneratingGuard::drop 只迁 Idle+emit AiConvStateChanged，**不 emit AiError/AiCompleted**，heartbeat 随作用域死亡——「工具完成后流断+无终止事件」的精确根因形状（前端探测式续跑已兜住后果，此为后端根治）。
|
||||
- **修复**：整体包 `std::panic::catch_unwind(AssertUnwindSafe(...))`，unwind 时 emit AiError{error_type:Internal} 再收敛；guard Drop 兜底保留。核心 loop 改动，需谨慎设计+场景回放测试。
|
||||
@@ -871,11 +710,11 @@ graph TD
|
||||
- [x] P2 看门狗 legacy/per-conv 双轨三错配：useAiSend.ts:169/:241/:512 统一迁移传 convId + `_resumeAttempts` 收尾清（债务本就要还） ✅已修(2026-10-04 核验:regenerate(:183)/editMessage(:259)/stopChat(:512+)三处均已传 per-conv convId 重置/清理看门狗,stopChat 收尾 clearResumeAttempts(activeConversationId),注释明确记载「不再落 legacy 单 timer fallback」)
|
||||
- [x] P2 _lastDeltas 双路径漏清：useAiEvents.ts:96-115/:154-161 补 clearLastDelta ✅已修(2026-10-04 核验:后台终止分支(:217)与停靠卡归集分支(:131)均补 clearLastDelta,前台收尾 cleanupTerminatedConversation 亦有显式清理,注释记载防残留记录误丢下轮同内容 delta)
|
||||
- [x] P2 removeGoal 不回写 store/不回滚：TopBar.vue:530-539 对齐 withConvOp 模式 ✅已修(2026-10-04 核验:removeGoal 已回写 `conv.pinned_goals = next`(注释 UX 走查-对话域 B4),防 loadGoals 重读旧列表复活已删目标)
|
||||
- [ ] P2 forceConverge 收敛/错误气泡缺 activeId 守卫（useAiStream.ts:115-121，与本批 onStreamTimeout 修复同家族）
|
||||
- [x] P2 forceConverge 收敛/错误气泡缺 activeId 守卫 ✅已修核验销账(2026-10-05):per-conv 触发守卫已在 forceConverge 入口(会话已删除或已收敛即清态早退 useAiStream.ts:96-103)+补气泡双过滤(仅 `!convId || convId === activeConversationId` 才 push,:138-139,后台会话静默收敛气泡不错位)
|
||||
|
||||
### 机械批（可独立小批）
|
||||
- [ ] remote_bridge 6 处 + agentic/mod.rs 4 处裸 emit 换 emit_ai_chat_event（miniapp 收不到错误/心跳/熔断卡）
|
||||
- [ ] i18n searchFilesBlocked 死键裸 @（zh-CN/en aiChat.ts:198/197）转义或删
|
||||
- [x] remote_bridge 6 处 + agentic/mod.rs 4 处裸 emit 换 emit_ai_chat_event ✅已收核验销账(2026-10-05):grep 全库 `\.emit\("ai-chat-event"` 仅剩正典 event_bus.rs:87 本体+注释+有意分路的 completed_once(mod.rs:2588 注释保护),remote_bridge 已全走 publish_event/emit_ai_chat_event 双写正典——DRY-B #1 批次顺带收口,文档滞后案
|
||||
- [x] i18n searchFilesBlocked 死键裸 @ ✅已修(2026-10-04 狗粮实证批⑤:zh-CN/en aiChat.ts 裸 @ 改 @ 转义,文档滞后案,2026-10-05 复核确认)
|
||||
|
||||
### 登记观察（定级前先核）
|
||||
- [x] model_fetch 空列表 Ok([]) 上层写回清空模型池 ✅已修(2026-10-03 N1)：provider.rs 空守卫跳过写回+前端 toastFetchEmpty 同语义守卫
|
||||
@@ -886,35 +725,36 @@ graph TD
|
||||
|
||||
> 前端 13 项(P1×2/P2×4/P3×7) + 后端 P1×1/P2×3/P3×8；后端报告含 6 点「确认无恙」防重查。
|
||||
|
||||
- [ ] P1 分离窗下 TaskDrawer 关联会话死点击：openConversation detached 分支无跨窗信号不聚焦(useAiConversations.ts:661)
|
||||
- [ ] P1 子代理运行期切回父会话 spawn 卡「已完成」幽灵态：回载 parseConvMessages 恒标 completed+运行期零事件(useAiConversations.ts:230)
|
||||
- [ ] P1 后端 外层 960s 超时 drop 子循环 future→统一出口全跳过(报告蒸发+注册表泄漏+子会话滞留)：deadline 检查下沉 stream chunk 循环或 select 超时分支特殊化补 AiAgentFinished(truncated)(audit/mod.rs:306)
|
||||
- [ ] P2 rejected_tools 前端丢弃不可扫描：完成卡收字段+warn 色 chip(useAiEvents.ts:70)
|
||||
- [ ] P2 完成卡纯内存重启蒸发：切换/挂载按 origin='sub_agent' 回补(aiShared.ts:630)
|
||||
- [ ] P2 完成卡恒贴底时序漂移：按完成轮次桶插入(MessageList.vue:1080)
|
||||
- [ ] P2 轨迹浮层无身份标识：头补 res.title/任务书首行(MessageList.vue:1584)
|
||||
- [ ] P2 后端 白名单执行期不拦 Low 工具：allowed 随子循环传入 process_tool_calls(audit/mod.rs:814)
|
||||
- [ ] P2 后端 父删除级联孤儿轨迹照落库：cascade_stop_children_locked 删除形态补 deleted_convs.insert(sub_agent.rs:194)
|
||||
- [ ] P2 后端 S4 反查 LIMIT 1000 先截断后过滤：匹配条件下沉 SQL 或辅助索引(audit/record.rs:315)
|
||||
- [ ] P3×15(前端7+后端8)：deny envelope 人话渲染/浮层 Esc/spawn_agent 本地化/卡 loading/停止标「已取消」/后台完成通知/已删会话静默新建 + 并发配额挤兑/事件广播噪音/流后取消补 envelope/bypass 连带解除黑名单/落库元数据错位/peek 校验/空收敛降级/AiAgentStarted——见两报告 P3 节
|
||||
- [x] P1 分离窗下 TaskDrawer 关联会话死点击：openConversation detached 分支无跨窗信号不聚焦(useAiConversations.ts:661) ✅已修核验销账(2026-10-05):openConversation detached 分支已 emitDetachedOpenConversation 跨窗信号+分离窗 handleDetachedOpenConversation 承接切换+not_found toast 落承接窗,注释明确记载 UX走查 P1-1
|
||||
- [ ] P1 子代理运行期切回父会话 spawn 卡「已完成」幽灵态：回载 parseConvMessages 恒标 completed+运行期零事件(useAiConversations.ts:230) ——半修(2026-10-05 核验):回载态判定已修(toolCalls status 改 `toolResultMap.has || !convGenerating ? completed : running`,运行期回载不再恒 completed);剩「运行期零事件」半(子代理运行事件仍不推父会话视图)待批
|
||||
- [x] P1 后端 外层 960s 超时 drop 子循环 future→统一出口全跳过(报告蒸发+注册表泄漏+子会话滞留)：deadline 检查下沉 stream chunk 循环或 select 超时分支特殊化补 AiAgentFinished(truncated)(audit/mod.rs:306) ✅已修(2026-10-05 核验:audit/mod.rs:326-329 子代理外层 deadline=SUB_AGENT_WALL_TIMEOUT_SECS+60 缓冲,循环内以截断报告优雅收尾非硬腰斩,「报告蒸发」注释原文在案)
|
||||
- [x] P2 rejected_tools 前端丢弃不可扫描：完成卡收字段+warn 色 chip(useAiEvents.ts:70) ✅已修(2026-10-05 核验:aiShared.ts:630 rejected_tools 字段+MessageList:1453 warn chip「工具名×次数」+title 全清单)
|
||||
- [x] P2 完成卡纯内存重启蒸发：切换/挂载按 origin='sub_agent' 回补(aiShared.ts:630) ✅已修(2026-10-05 核验:aiShared.ts:677 ai_sub_agent_list 反查重建,轨迹存在即视为 completed)
|
||||
- [x] P2 完成卡恒贴底时序漂移：按完成轮次桶插入(MessageList.vue:1080) ✅已修(2026-10-05 核验:renderItems 内按 finishedAt 落桶插桩,「不恒贴消息流最底部」注释在案)
|
||||
- [x] P2 轨迹浮层无身份标识：头补 res.title/任务书首行(MessageList.vue:1584) ✅已修(2026-10-05 核验:agentPeekSubject{agent,convTitle,task,taskFull} 四字段+任务行取子会话首条 user 消息首行)
|
||||
- [x] P2 后端 白名单执行期不拦 Low 工具：allowed 随子循环传入 process_tool_calls(audit/mod.rs:814) ✅已修(2026-10-05 核验:audit/mod.rs:217 P2-1 执行期白名单判定纯函数+whitelist-clamp 拒绝语义「spawn 时被裁剪或不存在」人话提示)
|
||||
- [x] P2 后端 父删除级联孤儿轨迹照落库 ✅已实施核验销账(2026-10-05):CascadeStopForm::Delete 形态已落地(sub_agent.rs:268 cascade_stop_children_locked,行282 deleted_convs.insert 同锁补标记,与出口 alive 判定互斥注释在案;出口 sub_agent.rs:551-555 见标记即放弃落库防空壳复活)——文档滞后案
|
||||
- [x] P2 后端 S4 反查 LIMIT 1000 先截断后过滤：匹配条件下沉 SQL 或辅助索引(audit/record.rs:315) ✅已修(2026-10-05 核验:P2-3 task_id 预筛下沉 SQL——result LIKE 参数化预筛缩小窗口,精确判等仍在 Rust 侧 match_task_audit_row,「禁裸 LIKE 判等」不破,预筛只多放不漏放+单测锁定)
|
||||
- [x] P3×15(前端7+后端8)：✅(2026-10-05 销账核验:15 条实际全部已落码或已缓批登记——deny envelope 人话渲染(parseDenyEnvelope+deniedTool i18n)/浮层 Esc(closeAgentTraceOnEsc+切会话 closeAgentTrace)/spawn_agent 本地化(spawnAgentPrefix zh/en)/卡 loading(agentPeekLoadingId spinner)/停止标「已取消」(stop_kind 结构化+fallback 启发式)/后台完成通知(agentFinishedToast)/已删会话静默新建(uf1 noCreateFallback)/空收敛降级(dx1 empty_convergence)/流后取消补 envelope(P3-3)/bypass 连带解除黑名单(P3-4 PathBypass 三态分流)/落库元数据错位(P3-5 SaveMetaOverride)/peek 校验(agentFinNoTrace 禁点+title)/事件广播噪音(P3-2 文档补全确认)——todo 行未勾属滞后;唯 AiAgentStarted 缓批「子代理运行面二期」+并发配额挤兑缓批已立项)——见两报告 P3 节
|
||||
|
||||
# 子代理深查两路（2026-10-03 晚，详情 temp/深查-子代理{AI效果面,x上下文管理交叉面}-2026-10-03.md）
|
||||
|
||||
> 与上节 25 项零重叠（报告尾附排除对账）。修复批：四路走查修复收口后，确定性项先行，需拍板项进拍板集。
|
||||
|
||||
- [ ] P1[确定性] 子代理指引真空：父会话实测蒸馏的四段工具纪律(read_symbol 优先/URL 三工具纪律/重复调用检测/get_app_config)未注入子代理 system prompt,而白名单缺省下发 25+ Low 工具,主会话已根治的翻车模式(一次死磕烧 1/3 预算)会在子代理原样复发;修法=抽共享指引段同源拼接
|
||||
- [x] P1[确定性] 子代理指引真空：父会话实测蒸馏的四段工具纪律(read_symbol 优先/URL 三工具纪律/重复调用检测/get_app_config)未注入子代理 system prompt,而白名单缺省下发 25+ Low 工具,主会话已根治的翻车模式(一次死磕烧 1/3 预算)会在子代理原样复发;修法=抽共享指引段同源拼接 ✅已修(2026-10-05 核验:prompt.rs sub_agent_tool_discipline_section 同源拼接,sub_agent_system_prompt 内引用,obscura 交互条款已在共享函数内裁剪)
|
||||
- [ ] P1[需拍板] 熔断无收尾轮:max_rounds 打满是常态,截断时父拿到「末轮思考独白」而非报告;修法=熔断触发补一次无工具收尾 LLM 调用(涉预算策略)
|
||||
- [ ] P1[需拍板] 报告被视图压缩吞掉：summarize_tool_results 无新近度豁免,报告 envelope>2KB 下一轮即被 JSON 分支折叠(512 字符),父 LLM 从未见过报告全文而 DB/前端卡是全文,追问细节答不上;涉上下文策略(stall_detector.rs:278-350/context_helpers.rs:461-513)
|
||||
- [ ] P2 max_tokens=8192 截断零信号：finish_reason=length 被通道层按正常完成吞,报告腰斩仍标 completed[确定性可修]
|
||||
- [ ] P2 任务书=首条 user 消息,超预算时第一个被逐出且子代理无目标钉扎(主循环有,子循环显式传空 sub_agent.rs:594)[确定性可修]
|
||||
- [ ] P2 预算三值(轮次/token/900s)不告知子代理,系统提示词硬编码「默认最多 6 轮」[确定性可修,文案]
|
||||
- [ ] P2 Fatal 错误细节被吞(RoundOutcome::Fatal 无 payload),父拿无因报告无法针对性重派[中小扩参]
|
||||
- [x] P2 max_tokens=8192 截断零信号：finish_reason=length 被通道层按正常完成吞,报告腰斩仍标 completed[确定性可修] ✅已修(2026-10-05 核验:RoundOutcome::Continue 携 truncated_by_max_tokens 全链穿透,收敛时追加「⚠ 回复因 max_tokens 上限被截断」系统提示 mod.rs:1915-1925)
|
||||
- [x] P2 空回复静默假成功(子代理侧) ✅已修(2026-10-05 核验:sub_agent.rs:384-397 末轮空白降级 Truncated+stop_kind=empty_convergence,不再 Completed+空报告失真;主循环侧同语义归无人值守 P2 批)
|
||||
- [x] P2 任务书=首条 user 消息,超预算时第一个被逐出且子代理无目标钉扎(主循环有,子循环显式传空 sub_agent.rs:594)[确定性可修] ✅已修(2026-10-05 核验:P2-2 任务书钉扎——<task> 全文并入 system prompt「上下文裁剪不可逐出」段)
|
||||
- [x] P2 预算三值(轮次/token/900s)不告知子代理,系统提示词硬编码「默认最多 6 轮」[确定性可修,文案] ✅已修(2026-10-05 核验:sub_agent_system_prompt(max_rounds) 动态注入三值实际生效值+防回归断言禁「默认最多 6 轮」文案回潮)
|
||||
- [x] P2 Fatal 错误细节被吞(RoundOutcome::Fatal 无 payload),父拿无因报告无法针对性重派[中小扩参] ✅已修(2026-10-05 核验:sub_agent.rs:897 P2-4 Fatal 携最后诊断文本进出口报告,封顶防超长污染)
|
||||
- [ ] P2 namespace 10MB 全局 LRU 淘汰:报告蒸发为「重新调用」死路+多代理共池互踩 ✅设计完成(2026-10-04 [设计文档](./02-架构设计/专项设计/namespace淘汰治理-设计-2026-10-04.md)):pin 机制+EvictionLog 富提示(替代裸 EVICTED_PLACEHOLDER)+owner 软隔离三招,零 schema 变更;2 拍板点(pin 上限保护/报告外默认 pin 范围),约 0.5-1 天
|
||||
- [ ] P2 被拒事实父上下文仅报告尾段单副本,LLM 压缩 prompt 无保留指令[需拍板]
|
||||
- [ ] P2 完成卡(前端全文)与父上下文(压缩)双轨无「已消化」降级机制 ✅设计完成(2026-10-04 [设计文档](./02-架构设计/专项设计/子代理完成卡已消化降级-设计-2026-10-04.md)):勘察修正——重启回补已存在(aiShared.ts:677 ai_sub_agent_list 反查重建),设计聚焦 digested 标记(KV 持久)+卡降级交互+ai_sub_agent_trace 只读工具(LLM 追问自助通道,兼为 namespace 蒸发兜底);2 拍板点,约 1-1.5 天
|
||||
- [ ] P2 子会话缺 maybe_auto_compress 层+预算恒 128k 默认[需拍板]
|
||||
- [ ] P3 spawn task 全文永续无瘦身/8KB 截断文案对子代理语境失真/环境画像日期不注入/报告 8K 头尾截断恰切证据区/temperature 0.7 共享/model 回退不回报/namespace 挤兑/一次性语义未向父声明/报告约定缺「文件路径原样保留」/语言无 lang 参数——见两报告 P3 节
|
||||
- [ ] 观察 uf2 修复引入：取消判定 summary.includes('已被取消') 中文子串启发式,根治=后端透出结构化 stop_reason/取消标志字段
|
||||
- [x] ~~观察 uf2 修复引入：取消判定 summary.includes('已被取消') 中文子串启发式,根治=后端透出结构化 stop_reason/取消标志字段~~ ✅已根治核验销账(2026-10-05 本批,文档滞后案):结构化字段已全链落地——后端 SubAgentStopKind::Cancelled 两处取消检查点同点产出(sub_agent.rs:716/824)+ AiAgentFinished.stop_kind 事件透出(serde 单测锁定)+ 前端 agentFinStatusText 结构化优先(MessageList.vue:1127,cancelled/max_rounds/wall_clock/token_budget 细分直达语义);中文子串判定降级为旧后端兼容性回退(无 stop_kind 字段才走),防御性保留非主路径
|
||||
|
||||
# 无人值守长任务（2026-10-04 用户拍板方向，设计先行）
|
||||
|
||||
@@ -923,7 +763,7 @@ graph TD
|
||||
> 缺陷靶心分析：temp/深查-无人值守稳定性缺陷-2026-10-04.md（P1×5/P2×7+效率 5+观测可控 5，接驳点已标注）。
|
||||
|
||||
- [ ] 设计评审后按分期实施（P0 边界模型+旁路主干 → P1 自愈+通知 → P2 断点续跑+信任分级）
|
||||
- [ ] P1 缺陷随分期消化：~~①审批超时取消后循环永不恢复~~ ✅①已修(2026-10-04 核验:cancel_expired_approval 第6步清幽灵态迁回 Idle+第7步安全停靠 AiTaskParked+NeedAction 通知,audit/mod.rs:530-555) ②spawn_agent 注册 Medium 无人值守动线停摆(归 P0 旁路) ③MidStream 断流=整任务终止(入打断点表,P1) ④轮级重试 30s 总预算全候选共享无跨轮重入(P1,任务级重入;工作区已见 ROUND_REENTRY_MAX 跨轮重入层在飞实施,待合入核验) ⑤重启后任务静默失踪(归 P2 断点续跑)
|
||||
- [ ] P1 缺陷随分期消化：~~①审批超时取消后循环永不恢复~~ ✅①已修(2026-10-04 核验:cancel_expired_approval 第6步清幽灵态迁回 Idle+第7步安全停靠 AiTaskParked+NeedAction 通知,audit/mod.rs:530-555) ②spawn_agent 注册 Medium 无人值守动线停摆(归 P0 旁路) ③~~MidStream 断流=整任务终止~~ ✅已修(2026-10-05 核验:RoundOutcome::MidStreamSaved 分支 emit_task_parked 安全停靠+NeedAction 托盘通知「midstream」原因,mod.rs:1146) ④~~轮级重试 30s 总预算全候选共享无跨轮重入~~ ✅已修(2026-10-05 核验:任务级跨轮重入已落地——ROUND_REENTRY_MAX=3 指数退避 60/300/900s,Continue 成功连续失败归零,预算耗尽转停靠 mod.rs:1071/1124/1162) ⑤重启后任务静默失踪(归 P2 断点续跑)
|
||||
- [ ] P2 缺陷登记:panic 收尾伪装正常完成无通知/context_length Fatal 无降级/空回复静默假成功/前端 3 次探测强制收敛与后端分裂/checkpoint 审计只增不清
|
||||
- [ ] 效率面:模型无轮内分级/警示消息打断前缀缓存/换参同语义死磕不计数/子代理串行 await/token 花费中途不可查/纠偏只能排队不能注入/预算中途调整不可达(归设计补遗两章分期)
|
||||
|
||||
@@ -947,21 +787,38 @@ graph TD
|
||||
|
||||
- [x] P0 git.rs:161 字节切片撞 UTF-8 边界 panic(中文 diff 必炸,13:44 两次实证) ✅已修(分析当场,回退字符边界)
|
||||
- [x] P1 Temperature 原样透传不支持的模型(sensenova 等仅允许 1,9 次 400 实证)——按模型适配/省略 ✅已修(2026-10-04:ModelConfig 加 temperature_supported 字段+presets 标 sensenova-6.7-flash-lite=false+启发式 sensenova 前缀判定;openai/anthropic 双协议转换层不支持即省略字段;df-ai 560+df-ai-core 33 测试全绿含新增锁行为测试)
|
||||
- [ ] P1 压缩无 memoization:view-only 压缩 2280 次中 369 组同内容反复压(最坏 54 次),prompt 1.2 亿 tokens=completion 115 倍——同内容哈希跳过
|
||||
- [ ] P1 标题采到 assistant 首句('信息已足够。让我看一眼...'/'<details><summa')——标题源取 user 首条
|
||||
- [ ] P2 checkpoints.token_total 语义失效(p50=120 vs 真实数万级,差 3 个量级)
|
||||
- [ ] P2 ai_conversations.status 只有 active/compressed,incomplete/error 终局未建模入 status(17/89 停在 tool 结果无收尾,无法统计未完成率)
|
||||
- [ ] P2 审计表无执行耗时字段(requested→executed 混入审批等待,耗时统计不可信)
|
||||
- [ ] P2 messages blob 双存储冗余(89/89,单会话最大 1.7MB)
|
||||
- [ ] P2 日志无轮转且放 %TEMP%(系统清理无声删除,建议迁数据目录+按大小轮转)
|
||||
- [x] P1 压缩无 memoization:view-only 压缩 2280 次中 369 组同内容反复压(最坏 54 次),prompt 1.2 亿 tokens=completion 115 倍——同内容哈希跳过 ✅已修(2026-10-05 核验:PerConvState.tool_compress_cache 内容哈希→压缩结果,mod.rs:1682 接线,双调用点主循环+子代理,agentic 122 测含)
|
||||
- [x] P1 标题采到 assistant 首句('信息已足够。让我看一眼...'/'<details><summa')——标题源取 user 首条 ✅已修(2026-10-05 核验:title.rs:62 两段式采样——user 首条必进锚定主题+其余按序补足 6 条)
|
||||
- [ ] P2 checkpoints.token_total 语义失效(p50=120 vs 真实数万级,差 3 个量级)【归 V49 schema 迁移批】
|
||||
- [ ] P2 ai_conversations.status 只有 active/compressed,incomplete/error 终局未建模入 status(17/89 停在 tool 结果无收尾,无法统计未完成率)【归 V49 schema 迁移批】
|
||||
- [ ] P2 审计表无执行耗时字段(requested→executed 混入审批等待,耗时统计不可信)【部分缓解:AuditLog.vue:71 ⏱ durationLabel 已显示且诚实标注「审批→执行」;纯执行耗时独立字段归 V49 schema 迁移批】
|
||||
- [ ] P2 messages blob 双存储冗余(89/89,单会话最大 1.7MB)【归 V49 schema 迁移批】
|
||||
- [x] P2 日志无轮转且放 %TEMP%(系统清理无声删除,建议迁数据目录+按大小轮转) ✅已修(2026-10-05:logging.rs 双进程共用——落点迁 app_data_dir/{identifier}/devflow-trace.log+启动期 5MB 轮转保留 .1+旧 %TEMP% 日志迁移清理,3 单测锁定)
|
||||
- [ ] 观察自动执行模式架空审批(auto 系 81%/人工 15%,auto_takeover_all 含 run_command 886 次)——产品语义与 S2/信任分级联动
|
||||
- [ ] 观察进化系统只写不读:knowledges 1033 条/embedding 全 NULL/83.6% 零复用/knowledge_search 仅 5 次
|
||||
- [ ] 观察多模态未走通:贴图落"[图片已忽略]"占位,实际靠 run_command 外部 vision CLI 绕路
|
||||
- [ ] 观察编排面零使用:workflow/node_executions/ai_plans 等 9 张表全 0 行;四会话分工 origin 89/89 全 NULL
|
||||
- [ ] 观察数据目录 ~640MB(主库 140.5MB+dev 库 71.2MB+4 份手工备份 346.9MB 散落)
|
||||
|
||||
# ai-chat UX 走查第五轮(2026-10-05,可访问性视角,详情 temp/UX走查-aiChat缺陷-2026-10-05.md)
|
||||
|
||||
> Web Interface Guidelines 视角(子代理全量走查+主代复核)。前四轮零重复:本轮全是「键盘/读屏/触屏可达性」层,与历轮「交互逻辑」层正交。
|
||||
> 计数:P2 × 4 / P3 × 9(P1 零)。
|
||||
|
||||
- [x] P2-M1 MessageItem 三操作按钮 hover-only:键盘聚焦不可见+触屏不可达(MessageItem.vue:129-136,217-219)——补 :focus-within 显形+aria-label,一处 CSS ✅已修(2026-10-05:.ai-msg-user:focus-within 两选择器入组+编辑/复制按钮补 aria-label)
|
||||
- [x] P2-T1 TopBar 四面板徽章 span@click 键盘不可达(TopBar.vue:138 等,面板行为层已完备仅入口缺失)——改 button 或补键盘三件套 ✅已修(2026-10-05:四徽章 span→button type=button+.ai-tool-badge 归零按钮默认样式+focus-visible 描边)
|
||||
- [x] P2-T2/T3 TopBar 约 8 处交互 div/span(@click 无键盘处理):provider 切换(:30)/审批徽章(:18)等——统一改 button ✅已修(2026-10-05:审批徽章 div→button+provider-bar div→button,两处 CSS 归零+focus-visible;余 model select 原生可聚焦,more 菜单已是 button)
|
||||
- [x] P2-G1 流式输出无 aria-live:读屏用户对 AI 回复零感知(MessageList.vue 全文零命中,唯一例外 ApprovalOverlay role=alert)——容器加 role="log" aria-live="polite" ✅已修(2026-10-05:.ai-messages 容器加 role=log+aria-live=polite)
|
||||
- [x] P3-M2/G4 按钮仅 title 无 aria-label(MessageItem:129-137/ChatInput 仅 :53 一处) ✅已核验(2026-10-05:MessageItem 编辑/复制按钮 aria-label+svg aria-hidden 已齐,残留 ChatInput :53 一处,下批顺带)
|
||||
- [x] P3-G2 装饰性图标缺 aria-hidden ✅已修(2026-10-05 机械批:ps1 正则 `(?s)<svg(?![^>]*aria-hidden)` 批量插入 193 处(22 文件含多行开标签;前置核验全库零 role=img/<title>/aria-label 语义型 svg;已有 10 处负向前瞻跳过),vue-tsc EXIT 0)
|
||||
- [x] P3-G3 滚动容器/弹层无 overscroll-behavior ✅核验销账(2026-10-05):桌面 Tauri WebView2 无移动端橡皮筋回弹/滚动链穿透问题,现状即合理,不引入
|
||||
- [x] P3-G5 MessageList user-select:none 9 处 ✅核验销账(2026-10-05):逐处核对 9 处全为交互控件(bubble-toggle/time-sep/归档段折叠条/trace 折叠头/think-pill/步骤行/retry chip/agent-fin 完成卡头),零误伤正文选择,现状即合理
|
||||
- 好评:ConversationSidebar/TaskBoundaryCard/DirAuthDialog 经前四轮修复质量扎实;无 transition:all/autoFocus 滥用等反模式
|
||||
|
||||
# ai-chat UX 走查第四轮(2026-10-04,增量深查,详情 temp/UX走查-aiChat缺陷-2026-10-04.md)
|
||||
|
||||
|
||||
|
||||
> P1 零;P2×7/P3×11;已修三轮清单已硬排除。修复批开工以现场源码为准。
|
||||
|
||||
- [x] P2-A2 边界配置卡目录白名单零校验 ✅已修(词法校验+就近红字),坏路径拖到运行期才暴露(TaskBoundaryCard.vue:163)
|
||||
@@ -972,7 +829,7 @@ graph TD
|
||||
- [x] P2-B2 纯发图+非视觉模型 ✅已修(前后端双闸拒纯图),占位串当用户消息喂模型跑偏一轮(chat.rs:789)
|
||||
- [x] P2-B3 error_type 大面积 Unknown ✅已修(classify_permanent→ProviderConfig CTA),永久错误也显「重试」必再败(MessageList.vue:688+mod.rs:596)
|
||||
- [x] 回归疑点 App.vue:227 全局快捷键 ✅已修(双文件 target 守卫+AIChat:339)(Ctrl+I/N/R/L/K/B)无 target 守卫,仅 Esc 有(走查复核提请,修时验证)
|
||||
- [ ] P3×11(文案四条已顺带修 ✅:fatal 矛盾措辞/cancelled 续跑 CTA/high 裸串/TopBar ellipsis;余 9 布局+虚拟滚动+压缩面包屑待批)
|
||||
- [x] P3×11(文案四条已顺带修 ✅:fatal 矛盾措辞/cancelled 续跑 CTA/high 裸串/TopBar ellipsis)+~~A5 停靠卡 scrollIntoView 无效~~✅(2026-10-05 本批:删 no-op 调用+cardRef/nextTick/watch 残留引用清理——卡挂输入区上方常驻可见非消息流,原注释意图错位)+~~A9 TopBar 进度徽章前 4 轮盲区~~✅(2026-10-05 本批:mod.rs 进度 emit 条件加 `|| iteration == start_iteration`——首轮即发快照,起步阶段「在干活」信号不再缺席,托盘场景唯一进度面补齐)+余 7 项本批全清(2026-10-05):~~A8 双进度矛盾~~✅(TopBar 快照徽章在输入区 agentic 实时进度可见时隐藏——`v-if="taskProgress && !agenticProgressVisible"`,同口径 computed 对齐 AiChat showAgenticProgress;快照徽章只服务托盘/静默期场景)+~~A10 边界盾标跨窗空洞~~✅(ConversationSidebar onMounted 补拉 hydrateBoundaryBadges——对列表全部会话拉边界镜像,已有条目跳过省 IPC,治分离窗授权/重启后盾标全消失)+~~A11 切会话丢边界编辑~~✅(TaskBoundaryCard hasDirtyEdits computed 比对表单 vs 镜像,脏编辑时切会话不静默重填保留编辑+琥珀提示条 dirtyKept)+~~A12 预算校验不定位+无防重~~✅(parseBudget 记 budgetErrField 错误字段,红字着色具体输入框+toast 指名 budgetInvalidField;confirm/clear 加 confirming in-flight 禁用防双击双 IPC)+~~A13 echoSummary high 裸串~~✅(前批已修:riskHigh 分支复用 agentTrace.riskHigh)+~~B4 压缩静默~~✅(useAiContext autoCompressedFlash ref:AiAutoCompressed 置 true 4s 自灭,AiChat 输入区上方 hint 行显示「上下文已自动压缩」aiChat.autoCompressed zh/en——不打断 LLM 流不弹 toast)+~~B5 惰性渲染评估~~✅(评估后最小实施:MessageList collapsedPreviewHtml——折叠态长消息(>1500字)仅渲染前 800 字符预览,全量 markdown 渲染延迟到展开瞬间,治长会话切换/挂载成本线性涨;虚拟滚动回滚维持不做)
|
||||
|
||||
# 后续规划登记(2026-10-04 用户口述)
|
||||
|
||||
@@ -982,11 +839,11 @@ graph TD
|
||||
|
||||
> 当日 ~810 次工具调用;主循环配置 max_iterations=0(不限)实证 225 轮零触顶;子代理 spawn max_rounds 6 默认/模型自给 10→20(上限 20)。
|
||||
|
||||
- [ ] P1 工具纪律失守:read_file 本支持 offset/limit 分页+search(工具描述明示)但模型不用,67+ 次 run_command PowerShell/python 切片绕道读文件——大文件 read_file 自动截断返回并带「用 offset/limit」引导+系统提示词禁 run_command 读文件
|
||||
- [ ] P1 patch_file old_text 未命中 28%(38/136,全部「未找到目标文本」):加空白归一化回退匹配(唯一命中自动采用并提示),工具描述教「3-5 行锚点小步 patch」
|
||||
- [ ] P2 子代理默认 max_rounds=6 偏小,父试探性提到 10/20:默认提到 12 或按任务书长度给建议值
|
||||
- [ ] P2 验证烧轮:全量 cargo check 多次(单次数十秒),引导 check -p 单包/单文件快检策略
|
||||
- [ ] P3 并行子代理轮次徽标无身份,交错显示「第3轮/第2轮」致乱序观感(机制=各自独立计轮,正常):徽标带 agent 序号/任务首词
|
||||
- [x] P1 工具纪律失守:read_file 本支持 offset/limit 分页+search(工具描述明示)但模型不用,67+ 次 run_command PowerShell/python 切片绕道读文件——大文件 read_file 自动截断返回并带「用 offset/limit」引导+系统提示词禁 run_command 读文件 ✅已修(狗粮批 a6a49ce8:prompt.rs file_reading_guidance 中/英双版,父 system_prompt 两语言+子代理纪律段同源拼接)
|
||||
- [x] P1 patch_file old_text 未命中 28%(38/136,全部「未找到目标文本」):加空白归一化回退匹配(唯一命中自动采用并提示),工具描述教「3-5 行锚点小步 patch」 ✅已修(在飞批:old_text 精确未中自动空白归一化重试,唯一命中整行区间替换+warning 注明,276 行含测试)
|
||||
- [x] P2 子代理默认 max_rounds=6 偏小,父试探性提到 10/20:默认提到 12 或按任务书长度给建议值 ✅已修(2026-10-05:SUB_AGENT_DEFAULT_MAX_ROUNDS=12+schema/greeting 文案三处同步,spawn_agent 3 测+sub_agent 19 测全绿)
|
||||
- [x] P2 验证烧轮:全量 cargo check 多次(单次数十秒),引导 check -p 单包/单文件快检策略 ✅已修(2026-10-05 本批:prompt.rs verification_fast_check_guidance 中/英——窄域验证优先(单包 check -p/单文件回读),全量留阶段收官;父会话 en/zh 模板+子代理工具纪律段三处同源拼接)
|
||||
- [x] P3 并行子代理轮次徽标无身份,交错显示「第3轮/第2轮」致乱序观感(机制=各自独立计轮,正常) ✅已实施核验销账(2026-10-05 本批,文档滞后案):A-3 序号身份已落地——agentFinSeq 正则 `::agent-(\d+)$` 从 agentId 尾段提序号 + 完成卡模板 `#{{seq}}` 徽标(解析失败不渲染)+ agentPeekSubject 浮层头身份行(agent 序号/子会话标题/任务书首行),多代理交错完成可辨认「哪张卡是哪个代理」
|
||||
|
||||
# 新能力引入评估纪律(2026-10-04 用户令,长期生效)
|
||||
|
||||
@@ -1057,7 +914,7 @@ graph TD
|
||||
|
||||
- [ ] W-h 会话间/代理间感知(FileLeaseRegistry:写前登记+冲突指路/query_leases 工具/兄弟感知/知识联动;与 W-a 组合成完整 lease)——设计 §十;根治今日全部互踩
|
||||
|
||||
- [ ] W-h 感知租约(升级 P0:今日三连互踩实锤,FileLeaseRegistry+写前置校验,小改大收益)——能力批实施第一位
|
||||
- [x] W-h 感知租约 ✅已实施核验销账(2026-10-05):lease.rs 345 行全套在案(FileLeaseRegistry+写前置校验+10min TTL 兜底+键归一+互斥/同会话放行/释放/TTL/归一五组单测),query_leases 工具已注册暴露,对齐《并行化与异步唤醒-2026-10-04》§10.1——文档滞后案
|
||||
- [ ] W-e2 全局并发池(小:子代理并发上限+预算联动)
|
||||
- [ ] W-d1 挂机最小闭环(领单→执行→销账→循环+轻量续接;W-b wake 随其绑定实施)
|
||||
- [ ] 冻结待信号: W-a 写并行吞吐(只先修竞态)/W-d2 自拆解自设计/W-f 编排 2.0-3.0/W-e1 async spawn——启动信号见设计 §十一
|
||||
@@ -1074,3 +931,83 @@ graph TD
|
||||
- download_file 工具增强候选:失败自动镜像回退(小改,登记待批)
|
||||
|
||||
- [ ] F-m 实施细节补充(§13.4 有界失败记忆):A4 失败豁免精化为「首条全文+同签名折叠一行(第N次)」——防窗口灌爆+盲试显式计数;失败分册按类去重 Top-K 有界;监控按月轮转;三界类目口径同源(同一归类函数)
|
||||
|
||||
## 派工纪律内置基线(AI-Ops 分析移交 2026-10-05,用户拍板"通用能力内置沉淀")
|
||||
|
||||
> 背景:派工纪律 11 条在 AI-Ops(u-claw 侧)一周实战蒸馏;devflow agent(spawn_agent)同样需要,但走知识库条目会在分发时裸奔(数据不随包,新实例知识库空=纪律失效)。用户拍板:通用能力内置进代码随包分发,知识库只放场景性增强层。
|
||||
> 落点:agentic loop 的 system_prompt 组装处内置以下母本(常量,编译进二进制)。u-claw 侧同款内容走 prompt.go 灰度(已拍板路径,分层:1-9 条第一批,10/11 条观察后二批)。
|
||||
|
||||
### 内置母本(8 行,双端通用,可微调措辞不可删项)
|
||||
|
||||
```text
|
||||
## 派工纪律
|
||||
1. 派工先估颗粒:单任务一轮内自证完成,装不下就拆批;独立子任务并行派。
|
||||
2. 任务书三要素:目标文件边界(热点文件单点编辑权)+预期时限+标准验证命令。
|
||||
3. 验收认证据:子代理须交"命令+结果",不收"我做完了";主代理独立抽查裁决。
|
||||
4. 子代理报告限长(约4千字),超长落盘只给指针;主代理消化后紧凑透出,禁全量转贴。
|
||||
5. 超时处置:到点发收敛令→无响应试探存活→确认死则主代理砍维度亲自收尾,勿重派同颗粒。
|
||||
6. 改代码禁全量验证:单文件快检,阶段收官统一验证一次。
|
||||
7. 派工前查重在途执行体,同类故障只委托一头。
|
||||
8. 结果透出结论先行,证据随附,过程不铺陈。
|
||||
```
|
||||
|
||||
### 实施项
|
||||
|
||||
- [ ] **N1 内置基线**:母本注入 agentic loop system_prompt 组装处(spawn_agent 子代理与编排节点同享;主 agent 自己派工时同样受此约束)。验收:新会话 system_prompt 含该段;知识库为空的全新实例同样生效。
|
||||
- [ ] **N2 知识库增强层定位收缩**:纪律类内容不再入知识库条目(避免双源漂移);知识库只留场景性/经验性条目。存量 review_rule 若与母本重叠,以母本为准去重。
|
||||
- [ ] **N3 知识库分发缺口登记**(独立项,优先级随多实例节奏):安装包带基线知识包(首启导入)或同步桥提级(存储架构定稿既有的"统一条目模型+同步桥"第一个实战用例,中心=df-pg)。单机阶段可缓,多实例分发前必须解。
|
||||
- [ ] **N4 与编排纪律 prompt 合并**:u-claw 侧落点 prompt.go"派工纪律"段与既定"编排纪律 prompt"(07a8c55 同落点)一次发版合并做,勿两次动 system prompt。
|
||||
|
||||
## u-claw 沉淀能力蒸馏清单(AI-Ops 分析移交 2026-10-05)
|
||||
|
||||
> 来源:u-claw 一年实战沉淀(memory 30+ 条+Go 代码机制)。筛选标准:通用能力(非业务/非容器特有),devflow 有实证差距才立。已对齐不重复立的:显式交付协议(通知桥 oneshot)、PATCH 单点渲染、重连 backoff、查重在途(派工契约第7条)、双头让位。
|
||||
|
||||
### A 类·机制移植(有实证差距,优先)
|
||||
|
||||
- [x] **D1 僵尸资源显式释放** ✅实施完成(2026-10-05 本批,勘察补充:现 main.rs 尚无重连循环,leak 暂只发生一次,但 SDK start() 退出即任务终局——将来补 backoff 重连时 run() 重入必每次 leak 一份 LarkClient,预防性根治):client 由字段 `LarkClient` 改 `&'static LarkClient`,Box::leak 收敛到 new()/offline() 构造期各一次;run() 重连重入只重建 Channel 复用同一 &'static 引用,注释记载 D1 根因;dispatch 出站链零改动(引用传递同语义)。验收 cargo check -p df-im-gateway EXIT 0 + cargo test -p df-im-gateway 14 passed 0 failed
|
||||
- [ ] **D2 白名单热加载**(u-claw 已有):现白名单启动时读死进 Ctx(L107),改 KV 须重启进程。修:whitelist 改 RwLock<HashMap> 或每消息现读 KV(读频低,成本可忽略);验收:改 KV 后下一条消息即生效,无需重启。
|
||||
- [ ] **D3 渠道心跳保活**(u-claw feishu_beat.go):现靠断线被动重连,静默半开连接(对端假活)检测不到。修:周期(60s)轻量活性探测,连续 N 次失败主动断开触发重连。验收:杀对端连接后 2 分钟内自愈。
|
||||
|
||||
### B 类·设计思想对齐(随相关批次顺路)
|
||||
|
||||
- [ ] **D4 目标快照+补拉兜底**(u-claw goal.go L1/L2/L3 实证"三战三捷"):停机恢复按快照续,不重放旧目标。V49 断点续跑(loop_state)正在做,补一个维度:恢复时对齐用户当前有效意图(目标快照),防"按旧目标继续跑偏"。
|
||||
- [ ] **D5 空轮判据自愈**(u-claw 空轮自愈经验):会话轮次无产出(空文本/无工具调用)连续 N 次→判定卡死,自动止损+提醒,而非挂到超时。
|
||||
- [ ] **D6 效率基线滚动机制**(u-claw 1001 基线方法论):季度实测运行基线(吞吐/尾延迟/子代理占比)对照优化,防瓶颈形态迁移后优化失焦。devflow 首个基线已建(2026-10-05),固化为机制。
|
||||
|
||||
### C 类·功能候选(产品拍板,不急)
|
||||
|
||||
- [ ] D7 媒体收发:图片/文件上下行(SDK upload_image/download 已在,u-claw media.go 先例)——识别截图/回传产物图场景价值高
|
||||
- [ ] D8 定时任务面:bot 内 cron 注册/查询/触发(u-claw crontab.go 形态)
|
||||
- [ ] D9 群成员/用户名缓存:回复带真实姓名(u-claw members/username.go,20min 缓存)
|
||||
- [ ] D10 会话标题:摘要里第二批已列(title_lifecycle 已有桌面端,渠道侧展示)
|
||||
|
||||
|
||||
## 2026-10-05 晚交接：AI-Ops 移交待办（用户拍板：devflow 安排推进）
|
||||
|
||||
> 用户已授权：下列项无需再逐项请示，按看板自行安排推进。攒批提交已授权（分组执行）。
|
||||
|
||||
### 决策结论（已定，不再议）
|
||||
- D2d 归档阈值 = 90 天（定案，随 D2a 批实施）
|
||||
- N3 知识库分发 = 先安装包基线包、后同步桥（多实例分发前 2 周启动）
|
||||
- 渠道假活（21:19 换装后 WS 未连）= 复发才深挖；D3 看门狗已实测立功（21:43 告警）
|
||||
- 历史数据默认保留禁清理（全局规则，见 memory feedback-history-data-keep-default）
|
||||
|
||||
### 待办（按优先级）
|
||||
1. [ ] **攒批提交 47 文件**（已授权）：停笔窗口执行，按主题 4 笔分组——①V49 断点续跑批(state/main/lib/sub_agent/df-storage) ②飞书渠道批(feishu_channel 四修+流式+D1-D3) ③纪律内置+知识库批(N1 helpers 等) ④前端流式链批(useStreamRenderer 等)。提交前 cargo check + vue-tsc 终验。
|
||||
2. [ ] **C-r0 验证命令后台化**（验收：>90s 同步等待占比 <15%，现状 45%）
|
||||
3. [ ] **D2a ai_tool_executions 结果过期外置**（DB 193.7MB 半天+17.6MB，紧迫）+ D2d 归档 90 天随批
|
||||
4. [ ] **锁面+同步 IO 技术债**（196 处 async 锁抽查、commands/ai 内 5 文件 std::fs 混入）
|
||||
5. [ ] **注入验证**：知识库 691b351d/c142e6b2 已 published+high，新会话确认铁律段带出
|
||||
6. [ ] **V49 批次独立核查**：47 文件收敛后请 AI-Ops 派核查，或自证全量 build+测试
|
||||
7. [ ] C 类功能候选（优先级未排）：D7 媒体收发 / D8 定时任务面 / D9 用户名缓存 / D10 会话标题
|
||||
|
||||
### 已完成勿重做（2026-10-05 AI-Ops 侧，勾选凭据）
|
||||
- N1 派工纪律内置（DISPATCH_DISCIPLINE：mod.rs:184/2791 + sub_agent.rs:489）——已随 21:19 换装上线
|
||||
- D1 僵尸 client 泄漏修复 / D2 白名单热加载 / D3 看门狗告警——已上线，D3 实测立功
|
||||
- 飞书四修+流式（占位卡片 edit_card 原地更新/表格降级/clip_for_card 超长裁剪/启动日志）——已上线
|
||||
- 知识库 691b351d/c142e6b2 已 published+high（c142e6b2 含权威源声明）；9c848ab 确认零丢失（rescue 分支锚定）
|
||||
|
||||
### 新缺陷（2026-10-05 22:2x 用户截图实证,与 N/D 清单同级）
|
||||
8. [ ] **工具输出 ANSI 转义裸露**（乱码）:run_command 类工具输出含 ANSI 码（\x1b[7m 等）原样透传前端显示为 ␛[7m。修:执行器统一 strip_ansi（或注入 TERM=dumb/--color=never）+前端渲染层兜底过滤;验收:cargo test 输出在面板无 ␛ 残留。
|
||||
9. [ ] **会话标题 content 泄漏**:会话标题显示原始正文片段（如 `<details> <summa…`,84cb104c 会话同症）——标题生成输入未清洗或兜底直接取 content 头部。修:title 生成失败/超时兜底改为清洗后的首行摘要,含 HTML/Markdown 标签时剥离;验收:长会话标题无标签裸露。
|
||||
> 附:截图实证单会话 206 轮/1500 万 tokens——C 批次（上下文管理）紧迫性最强活证,随 C-r0 优先消化。
|
||||
|
||||
Reference in New Issue
Block a user