DevFlow/docs/todo.md

DevFlow 工作看板

⚠️ 挂机必读（2026-10-06 10:50 仓库状态变更）：今早 10:13 的三笔提交（cec4d11/84df9b5/622507c）已被外部退回（G2 🔴门禁/G3 描述不达标），当前 HEAD=03dc27b，全部改动在工作区未提交。11:23 汇报中「已提交」的说法与事实不符。重做要求见文末退回段；每次汇报前先跑 git log -1 实测再报。 🔒 提交冻结（2026-10-06 深夜用户令）：后续一切改动攒批等「攒批提交通知」才可提交，期间只改不提；通知由用户逐批下达。 📦 2026-10-07 攒批状态：工作区 20 文件验证全绿（cargo test --workspace 1941 passed 0 failed + vue-tsc EXIT 0 + cargo check -p devflow EXIT 0）。本批新增/修复：① parked 断点续跑分流——ai_continue_loop 非活跃时查 DB loop_state=parked → recover_parked_inner 正典恢复链（chat.rs:2690+conversation.rs:328，与 ai_recover_parked IPC/unattended B5 三路同源，停靠卡「继续」伪失败闭环）；② 3 处在途编译错顺手修（feishu_channel.rs async async fn 语法错 + send_markdown_card pub(crate)、tool_failure_memory.rs 测试 serde_json::from_str）。待提交通知后随批入库。 📤 2026-10-07 推送：14 笔已入库提交已推送 origin/main（03dc27b..e36b55a，含冻结令 e36b55a）。工作区 20 文件攒批原样保留，零 commit 零推送，冻结令纪律不违。推送时遇 DNS 解析失败（代理工具隔离 env），用 --resolve gitea.1216.top:443:39.99.243.191 临时直连绕过，未污染 gitconfig。

来源：docs/02-架构设计/滚动规范/功能决策记录-2026-06-14.md「需求与待办」+ PROGRESS.md 各 Sprint 遗留，2026-06-14 汇总去重 + 代码核对修正。 互操作：执行走 mission-control，回写 mission_id；审查走 cr；发布走 publish-*。 核对说明：2026-06-14 经代码勘察后修正——detached 卡死已部分修复降 P2、Sprint 19 遗留 3 项补入、依赖关系标注。

2026-06-18 归档: 已完成 [x] 与历史分析段已迁至 07-项目管理/todo归档/2026-06-18.md。 2026-06-27 归档: 已完成 [x]/✅ 项已迁至 07-项目管理/todo归档/2026-06-27.md。 2026-10-05 归档: 7 个实测核验全完成的历史走查段(父子任务支持/对话上下文透明化/文件拆分升级/ToolCard UI 合并/灵感模块诊断/aichat 深度走查/TaskDetail 按钮走查)迁至 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

• P2-2 高频可点 div 键盘化:ToolCard:11 卡头/MessageList:1423 轨迹头/AuditLog:67,119 审计行(@click div 全仓 56 处,去 mask 合规项约 20 真缺口,高频改 button 其余 tabindex+keydown)
• 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

💡 2026-09-29 aichat 知识库与记忆修复(「笨/丢历史」根因诊断,同日已修会话内侧)

背景:用户反馈「明显感觉丢历史会话特别严重」「感觉很笨」。DB 实证:44.7% 消息 compressed,最大会话 828 条仅 5% 可见(26 条用户消息 0 条可见),存储原文都在、丢的是发送视图;知识库四重收口(整句 LIKE 命中≈0/candidate 不参与检索/向量默认关/LLM 零知识工具,962 条知识存量近乎零生效);跨会话零召回。 详情:05-代码审查/aichat知识库与记忆走查-2026-09-29.md ✅ 同日已修:上下文管理演进 T4/T5 生产侧空壳补齐(WorkingContext begin_turn/sync_after_compress 写入链 + 工作流 DAG 摘要注入链),编译门禁过,详见诊断文档第四章。

• 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-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

• 接入实施 ✅主体已落地(2026-10-05 任务 5fb916ac):ask_uclaw 工具+配置页三键+前端流式链全接通;隔离策略勘误=单链共享上下文(MVP),多实例 phase2;剩真机全链冒烟

💡 2026-09-28 aichat 交互走查清尾(启动「日常主入口」标准,1P1+7P2+9P3)

⚠️ 2026-09-29:17 项经核验全部未修,已并入《aichat 可用性与交互成本研究-2026-09-29》合并排序,修复排序以新报告第五章为准(本条目保留作原始详单指针)。

背景:devflow 启动定位=日常 AI 交互调度中枢,按日常主入口标准走查。新发现集中在 God 组件拆分丢功能的链路断点+多会话并发收口残留缝隙。 详情:05-代码审查/aichat交互走查-2026-09-28.md

💡 2026-06-27 统一 Inbox 设计(讨论产出)

思路:所有需要用户注意的事项(审批/知识待审/灵感确认/其他通知)集中到一个统一入口, 不阻塞对话。

审批留在对话内(需要即时上下文),知识/灵感/通知放 Inbox。 后续做详细设计方案。

🎯 统一规划（2026-06-26 全景）

整合知识图谱设计 + 22 条未完成项 + G1 目标钉扎(✅已落地) + 多工程方案。 核心主线：AI Working — AI 拥有项目知识图谱，自主分解/编排/执行/自检，人只决策。 执行策略（两阶段）：① 先攒批无冲突小 bug/小调整 → 提交；② workflow 编排相关任务批量推进大重构（减少文件读取/LLM 交互，提高上下文效率）。

主线脉络

G1目标钉扎(✅已落地) → 知识图谱Phase1(任务网络,AI编排地基)
   ↓                              ↓
实测验证
   ↓                              ↑
F-09多会话B(立项) ────────────────┘ (Phase4前置:多会话各自注入)

任务图谱（DAG · 有方向有状态）

节点=任务（着色=状态），边=依赖方向（前置 → 后继）。推进时更新状态（CLI/edit 同步此表 + Mermaid）。 图例：✅完成 / 🔨进行中 / 📋待办 / 🚫阻塞

graph TD
  classDef done fill:#bfb,stroke:#393,stroke-width:2px
  classDef doing fill:#ffd,stroke:#993,stroke-width:2px
  classDef todo fill:#eef,stroke:#99c
  classDef blocked fill:#fcc,stroke:#c33

  G1["G1 目标钉扎<br/>✅代码 8ce18cb"]:::done
  P1["父① 小bug攒批<br/>✅①.2/①.3(①.1过时·①.4归⑤)"]:::done
  P2["父② 知识图谱Phase1<br/>✅Phase1(数据层+业务层)"]:::done
  P3["父③ AI对话体验<br/>📋待办"]:::todo
  P4["父④ F-09 per-conv<br/>✅前端per-conv(accessor)"]:::done
  P5["父⑤ 灵感模块<br/>✅完成(⑤.1/①.4/⑤.2)"]:::done
  P6["父⑥ Phase2-5<br/>🔨Phase2-3✅·4-5待办"]:::doing
  P7["父⑦ 技术债<br/>📋待办"]:::todo

  P1 -.先行.-> P2
  G1 ==基建==> P6
  P2 ==> P6
  P4 ==> P6
  P2 -.task_links.-> P5

任务	状态	子项	依赖（前置）
G1 目标钉扎	✅ 代码已落地	G1/G2/G4 落地	—
父① 小bug攒批	✅ 完成	①.2 白名单✅(settings.rs) / ①.3 priority✅(idea.rs) / ①.1 BUG层1❌过时(F-260619-03 方案①取代,层2待决策) / ①.4 雷达图→归父⑤	—
父② 知识图谱Phase1	✅ Phase1完成	②.1 V29迁移✅ / ②.2 TaskRecord+TaskLinkRepo✅ / ②.3 IPC(create_task扩展+task_link CRUD+move_queue+get_tree)✅ / ②.4 父聚合✅(set_status_for_aggregation绕status收口) / ②.5 AI工具6✅(基线38)	G1(弱)
父③ AI对话体验	🔨 ③.1✅ / ③.2待办	③.1 B-260619-04 ToolCard✅(跨轮收起已有+标题增强) / ③.2 REFACTOR-260619-04 审批状态机拆分 / 对话透明化 L1🟡待定	—
父④ F-09 per-conv	✅ 全部落地(2026-08-07 核验)	④.1 streaming/currentText per-conv Map(accessor委派,单会话回归零变化,BUG-260624-01根因清除,vue-tsc 0)	—
父⑤ 灵感模块	✅ 完成	⑤.1 软删除✅ / ①.4 雷达图✅ / ⑤.2 #05✅/#06拆const✅/#09/#10表单(逗号tags)✅ / #07 DEC-02保留purge(不改) / 附:priority_from_i32跨层映射修复(对齐前端0=critical)	#07→②.1
父⑥ Phase2-5	🔨 Phase4 注入进行中	⑥.1事件流✅(V30) / ⑥.2基础设施✅(V31) / ⑥.3注入✅(resolver 增强+extra 渲染) / ⑥.4前端(C 方案展开摘要✅已决待实施)
父⑦ 技术债	📋 待办	SMELL-P1-6 / conditions / CR缓存 / UX分页 / 审批超时 / miniapp / 双监听器	— (穿插)

推进路径：父①先行（攒批提交）→ 父②主线 workflow → 父③/④并行 → 父⑤/⑥/⑦穿插。每父任务一个 workflow 批，子任务相关文件批量读改减少交互。状态更新约定：子项完成→父状态 🔨；全子完成→父 ✅；每批提交后同步此表。

协同点（跨主题复用）

1. IDEA-FIX-07 关联单向 ↔ 知识图谱 task_links：并入 Phase 1 用独立表（§2.2 论证 JSON 缺陷），别补 JSON 双向同步
2. G1 system_prompt 注入基建 ↔ Phase 4 L0 注入：复用 pinned_goal 拼接链路
3. F-09 per-conv ↔ Phase 4 多会话注入：F-09 前置
4. REFACTOR-260619-04 审批状态机 ↔ queue=decision 待决策池：审批对齐

交接状态（2026-06-14）

代码健康度：cargo test --workspace 全过、npx vue-tsc --noEmit 0 error（主代理独立验证，非 mission 自报）。

工作区状态（重要）：git diff 104 文件（8066+/6941-）是三层混合——①会话前未提交基线（Sprint 19 等大量工作：i18n 拆目录、knowledge 全栈、Settings 拆分、appSettings 迁移…）②本次会话重构 ③代理越权修复。接手前务必 git diff 通览区分，勿整体当作单一改动提交。

本次会话完成：

• 重构（用户授权）：删 5 僵尸 crate（df-evolve/plugin/stages/task/traceability）、清 7 死模块（df-execute docker/git_ops/ssh + df-project scheduler/timeline/context + df-ideas graph）、拆 ai.rs→commands/ai/ 11 文件、拆 ai.ts→6 composable、models 字段 bug 修复、coordinator B 路线标注
• 代理越权追加修复 6 处（已标✅，主代理验证编译+测试通过；逐行正确性建议接手方 git diff 复核）：B-01 审批持久化 / B-02 ConditionEngine 默认 false / B-04 删 NodeRegistry Default impl / T-05 工具结果截断 50KB / B-08 promote 补偿删除 / T-07 诊断日志清理

待设计交其他会话（核心）：df-workflow 审批闭环三连 B-06/B-07/B-03。✅ B-03 设计已完成（接手会话，2026-06-14）：见 B-03-人工审批响应机制-2026-06-14.md，通道选型定为 工作流独立审批通道（复用 EventBus broadcast + HumanApprovalResponse 事件 + approve_human_approval IPC，非 ai.rs AiApprovalRequired——后者是 AI Chat 工具审批路径，与工作流节点审批是两条独立链路）。拆 B-03a（响应等待 + 超时，不依赖 B-07）/ B-03b（取消机制）。B-06 / B-07 仍待实施（B-06 = execution_id 下沉并发隔离；B-07 = 共享 StateMachine 取消前置），是 B-03a 并发安全 / B-03b 的前置。

失控代理教训：本次会话派的后台拆分代理在 stop hook 循环里失控，越权改代码/文档（先斩后奏）。接手方若再派 agent，注意约束其不碰决策记录（用户已要求手动触发）+ 限定单任务不自主续推。

---

待办

🔍 2026-06-21 AI Chat 技术债审查(workflow wf_92b61c35-4d2 · 10 模块串行 grep 核验)

详单见 aichat-技术债审查-2026-06-21.md。0 P0 / 7 P1 / 25 P2 / 40 P3 / 已登记 8 / 新债 64。P1#5/#6 已即时修并自验过。

[2026-06-24 核验销账]: try_continue pending_conv_id 🟡语义复杂(R-PD-6 优先审批 conv_id 设计+try_continue 回退,非确定性低风险)/ MidStream chunk.error 🟡UX 结构变更(Partial 保文加 err 字段+前端渲染,非 bug)/ auto-compress save 🟡需理解 loop save 时机判真缺口。

销账核对(已登记 8 复核):SMELL-P1-6(line221·#5 覆盖 executed/completed 双轨)/ MED-1(tool_registry:546 bind_directory)/ REFACTOR-260619-08(tool_registry:881 拆)/ REFACTOR-260619-09(context.rs:1 God 1552行)/ ARC-260619-05(agentic:318 超长)/ UX-260617-28(双监听器 INFO)。均仍在未完成,审查复核确认,保留。

残留诊断代码(待清):chat.rs authz_debug/authz-debug.log(L2 调试遗留,P2 报 chat.rs:548 硬编码绝对路径),L2 完成后可清。

---

🔍 2026-06-21 查询能力缺口 + run_workflow 缺陷(本轮排查登记·未实施)

用户排查任务/项目/灵感查询能力现状,登记缺口为待办/缺陷,本轮不实施代码。详单见 查询能力补全方案-2026-06-21.md。

---

📋 编排推进总览（2026-06-18 更新）

未完成待办按可执行性分 8 组（详细条目见下方各分类，勿重复记录）：

组	说明	代表项
A todo 卫生	矛盾清理/被取代退役标注	✅ 本批已完成
B 零风险减法	死链清/空壳合并	✅ 本批已完成
C 需用户输入	阻塞，无法代办	—（已归档）
D 功能增强	设计清晰可推进（P1）	F-15-01 审批选项 / F-15-02 task 详情 / F-15-03 分页⚠️breaking / F-15-04 卡片折叠
E 架构重投入	需设计，非小改	F-14-01 模型能力 / F-14-07 trait 下沉 / ARC-05·06 store 拆·循环依赖
F 全局 review P2 需设计	安全/竞态收口	R-PD-4/5/6/8/9/12/13 + R-PD-10 .map_err 85 处
H 长期功能池	不进主线	F-14-02~10 / T-14-06 Settings 拆 / T-14-11 条件引擎 / B-14-05 / B-03b-R9

推进原则：能并行不串行（独立子任务 8-12 并发）；每批重汇总+全优先级重排+销账核对 ✅；C 组阻塞项不代办等用户。本会话首批：A 卫生 + B 清死链。

③④C类已迁（2026-06-16）：需人工决策项(③产品取舍 7 / ④设计方向 7 / 重投入排期 9 / C用户实测 5)见 待决策.md,从本文件抽离职责分离。batch54 可自主批进展(2026-06-16·workflow wsfz7zl8i + 主代核查):复核-新⑪ 看门狗幽灵 ✅ 销账(清主窗口 state 视觉残留;核验更正:原 watchdog 幽灵已被 CR-260615-24 stopListener:371 clearStreamWatchdog 兜底);AE-03 diff预览 ⚠️ 降级阻塞(后端 write_file 未返 diff,待后端补,见 line 538);UX-04 断线保文 待 DEC-260616-03 授权(见待决策.md 🟡,本批不含)。

📦 已完成项归档: 07-项目管理/todo归档/2026-06.md — 2026-06-18 拆分, 已完成 [x] 与历史分析段迁此。另有 2026-06-18.md / 2026-06-27.md — 本次归档。

🔴 2026-06-20 BUG-260620-05 F-260619-03 工程内路径误弹窗(reload_allowed_dirs 丢 workspace_root·b22e9ae 回归)

现象:AI Chat file_info 等文件工具访问工程内路径(如 docs/02-架构设计/单对话并行多轮-设计-2026-06-20.md)触发授权弹窗,用户称"本来就有访问权限,为什么还来申请"。

根因:state.rs:586-619 reload_allowed_dirs 合并 kv_dirs(KV allowed_dirs)+ project_dirs(projects.bind_directory) 为 all_dirs,仅当 all_dirs.is_empty() 时(:618)才插入 workspace_root。KV 配过 allowed_dirs 或有绑定项目 → all_dirs 非空 → workspace_root 不入 persistent → 工程内路径(在 workspace_root 下)is_authorized(:356 starts_with)失败 → check_path_authorization 返 NeedsAuthorization → 弹窗。

注释承诺失配::346-348 / :583 / :617 注释均称"KV 未配时保持 workspace_root 免授权(向后兼容)",但 :618 条件用 all_dirs(含 project_dirs),project_dirs 非空也丢 root。b22e9ae "reload 尊重用户 persistent" 引入的回归。

用户政策指令(2026-06-20):"默认直接访问,明确知道无权限才申请"。指向工程内(workspace_root 下)默认免授权,仅 workspace_root 外非白名单路径才弹窗。

修法(层1·1 行确定性 bug):state.rs:618 去掉 if all_dirs.is_empty() 条件包裹,无条件 set.insert(workspace_root_path())(工程内始终免授权,对齐用户政策 + 注释承诺)。不破坏现有能力:workspace_root 经 set/get_allowed_dirs(:664/680 filter root)本就不可见不可删,"用户删 root"语义未落地,保 root 无冲突。

层2 待决策(政策范围):用户"默认直接访问"是否要求更宽语义——workspace_root 外的非黑名单路径也默认放行(翻转 is_authorized 为黑名单制,实质去白名单)?涉 P0 去固定根决策方向,见待决策.md。dev 自用场景层1 即满足。

关联:F-260619-03(todo :528 b22e9ae 回归源)/ 待决策 workspace_root 分发适配(方案b 用户项目绑定)/ memory devflow-project-path-binding 状态:✅ 已实施(层1 无条件插入 workspace_root + 层2 白名单制 persistent/session/once + 黑名单兼底,对齐 2026-06-28 用户决策)

---

💡 2026-06-16 新需求（已分析·待实施）

功能需求，已走查定位链路 + 方案记录，待用户确认后实施。

✅ 2026-08-07 核验销账(F-09 B 阶段全部落地):三方独立核验(2 agent + 主代 grep 抽查)确认 06-19 草案所有改造点(§4.1-4.7)已落地,且代码超出草案:① AiSession 去单例 → per_conv: HashMap<String, PerConvState>(mod.rs:593,顶层会话级字段全删)② ConvStateStore DashMap 无锁(治 guard.reset 锁竞争卡死连环)③ 三处退出校验改 conv 存在性(agentic/mod.rs 7 处,零旧 active_conversation_id != conv_id 残留)④ GeneratingGuard per-conv + loop_epoch owner token(F1 治同 conv 双 loop 竞态)⑤ last_heartbeat 心跳(F2 治卡死兜底误判)⑥ IPC 全加 conv_id + ConvStateStore 零锁读(switch 删 readonly / create 不杀旧 loop)⑦ 前端 convStates Map(enum 轨替代 bool Set)+ d2 多窗口(useAiWindow.ts ai-detached-${convId})已落地。剩余仅 B 路线 Phase3 单对话并行多轮(per_sub_flow 占位未接,另线 aichat-b-route-parallel-multiround)。c-1 决策已被用户「不设并发会话上限」推翻作废。

🔴 aichat API Key 401 排查（2026-06-16）

用户报对话失败「调用失败: API Key 无效或无权限」+ 重设 key 无效。排查结论:代码链路全对(保存 keyring✓ / 读取 resolve_provider_secret✓ / 鉴权头 openai=Bearer·anthropic=x-api-key✓ / URL 智能拼接✓),401 来自服务端,非 devflow bug。根因四选一(key 无效 / provider_type 不匹配 / base_url 错 / model 名错)。详见 aichat-apikey-401排查-2026-06-15.md。

🟦 架构审查待修项（2026-06-16）

纯架构层评估（边界/依赖/抽象/扩展性/状态管理），详见 架构审查-2026-06-15.md。共 🔴6 🟡6 ⚪4 + 亮点 6。与 06-14 三份报告去重（不重复 bug/性能 FR-、aichat AR-）。

中期（技术债） ✅ ARC-260615-07 已决策:缓做(d归F-09B,其余ROI低不实施)

P1 — 重要缺陷

🔴 架构坏味道全面扫描（2026-06-18·6路并行 Explore agent·57K行代码）

来源: God文件/长函数 + 循环依赖/耦合 + DRY违反 + 错误处理不一致 + 命名API/类型安全 + 测试覆盖/死代码。6 维度全覆盖。

🟡 P1 应该改进 (9项):

✅ SMELL-P1-6 — [P1🟢 已决·待推进] String 类型滥用替 newtype/enum —— execution_id/status/tool_type 等 5+ 处改强类型(b 路线:仅 Rust 内部 newtype)

🆕 sweep 派生登记（2026-06-18·workflow w2xkw4ybh data 抽出 + wo7d6zdqm 多维度 sweep）:

• ✅ conditions 条件引擎 — ✅ 全部完成:引擎完备+feature flag 默认开+executor 集成+前端 UI(WorkflowDagDisplay.vue 可编辑)+i18n 补齐

🟡 AI Chat 交互体验改进（2026-06-14 方案 → 待办化）

来源：aichat交互体验改进方案-2026-06-14.md。7 大类 20 个改进项，按原文优先级分 4 批。去重：§1.3 复制 ⊂ F-260615-13/14（已写）、§3.4 新建中断 ⊂ B-260615-10（已做软复位，本文档加 confirm 增强）、§6.2 分离窗口同步 ⊂ CR-24/25（已写）。状态: 待讨论→看板跟踪。

第三批 — 锦上添花

待澄清 / A-B 待定

ℹ️ 架构观察（INFO · 2 项·不进修复队列）

• ✅ UX-260617-28 [INFO] — 已决策:现状够用,不出问题不升级

💡 灵感模块-来源采集/追溯(2026-06-21·待办·新功能范畴)

继批1-3c 升级后的下一步:灵感来源录入增强 + 自动采集机制。属新功能范畴,需独立设计采集规则/触发/去重,下一阶段推进。

1. ✅ source 录入增强:灵感捕捉模态框已加 source / tags / priority 输入,录入即结构化
2. ⏸️ 自动采集机制:从对话/任务/代码中自动提炼灵感 —— 需独立设计采集规则/触发/去重,属下一阶段新功能

• 需设计:采集规则(什么信号算灵感 — 关键词/意图/重复模式)/ 触发时机(对话结束/任务完成/手动触发)/ 去重(相似灵感合并避免洪水)/ 用户确认流(自动采集不污染灵感池,需用户确认入库)
• 依赖:批1-3c 升级完成(已有 source/tags 字段基础 ✅) + 对话历史可读(F-15 archived_segment 状态 ✅) + 任务可读 ✅
• 关联:memory devflow-idea-module / [aichat-skill-slash-autocomplete]

---

F-260620-01 跨端 AI Chat:微信小程序 ↔ Rust 云后端 ↔ DevFlow 桌面端

背景:微信小程序远程用 DevFlow AI Chat,桌面端与小程序双向实时同步(微信电脑+手机同时在线模式)。 设计:F-260620-01-跨端AIChat-微信小程序-2026-06-20.md(三层架构 df-tunnel/df-relay/df-miniapp + Rust 云后端选型) 关系:灵感 4495fbcd(选型论证,pending_review)+ 任务 6c816709(todo)

实施分阶段:

• P1 df-relay 云后端(axum WS Server + 广播中继 + 鉴权)— 无依赖
• P2 df-tunnel 桌面端(WS client + 事件桥接 ai-chat-event 透传 + 指令路由 + 配对绑定)— 依赖 P1
• P3 df-miniapp 小程序(前端 UI 复用 + WSS 连云)— 依赖 P1/P2
• P4 双向同步完善(冲突处理 + 安全 + 离线降级 + 部署)— 依赖 P1/P2/P3

Phase3 联调待办(D1-D6 决策点推荐:A纯透传 / 全19变体透传 / EventBus汇聚 / switch不处理 / 强类型保留 / 桥接层R1兜底):

🔍 2026-06-22 miniapp 功能走查(workflow wf_ddd49ac8 · 5 域并行核验 + 主代终态抽查)

用户 /review miniapp + workflow 汇总安排。5 agent 独立 grep/read 核验源码(不信注释/文档) + 主代终态核验(ws.ts 真路径 src/api/ws.ts、relay.rs:255/355、remote_bridge 命令数 10 非 11)。18 findings → 去重 P1×5 / P2×3 / P3×1,2 项 refuted。关联 F-260620-01 阶段4(真机联调前置)。守 session-role-diagnose-only:本会话仅走查 + 登记,未实施代码。

P1(阻塞真机/可靠性·5 项):

用户补充核验(2026-06-22 用户详读源码+设计文档,主代逐项核源码判真伪):

⚠️ 用户分析 P0 三项(协议三重不匹配 / EventBus 未接 / 桥接层占位)经源码核验全部失实,系基于 Phase3 阶段1-3 落地前的设计文档「计划态」描述,未核当前代码。证据:

• P0-1 协议:crates/df-tunnel/src/tunnel.rs:457/327/424 tunnel 纯透传 payload Value 上抛 on_command,不做 from_value::<TunnelCommand> 强类型反序列化(方案A 阶段1 已落地 commit 0fb5af5)→ miniapp {cmd,args} 反序列化在桥接层 remote_bridge.rs:96 from_payload 成功,非阻断。tunnel.rs:457 注释自证「不反序列化为 TunnelCommand 强类型」。
• P0-2 EventBus:src-tauri/src/lib.rs:128 state.ai_event_bus.subscribe()(tunnel subscriber 已接)+ remote_bridge.rs:303/332/358/388 + commands/ai/mod.rs:209/225 publish_event 跨端透传。已双写接入(todo line 760 commit 0fb5af5/612de4c emit 双写 chat19/audit12/guard3/stream_recv2/agentic18)。event_bus.rs:53/115 的 #![allow(dead_code)]+「骨架阶段」注释是过时历史标注(publish_event 现有调用方 remote_bridge/mod),非未接入。
• P0-3 桥接层:remote_bridge.rs 完整实装(handle_remote_command:121 + MiniCommand:83 + from_payload:96 + match 路由 10 条 + route_list/load_messages publish_event)+ 已 wire lib.rs:150-154 on_command = Arc::new(...handle_remote_command...) + :171 .connect(&relay_url,&device_id,&token,on_command.clone())。非占位/设计态。remote_bridge.rs:40-42 的 #![allow(dead_code)]+「零调用方」注释写于联调前,现 lib.rs 已调(过时标注,待清)。

剩余开放项:P3-B-260622 [P3·真机前置] — manifest appid 占位。PLACEHOLDER 无法真机调试,需微信公众平台注册的真 appid。— apps/df-miniapp/src/manifest.json

✅ 2026-06-24 aichat 可靠性修复(消息重叠×5 + 授权弹窗卡死 + 工具执行心跳误报 · 诊断workflow→论证workflow)

剩余低优 :

• BUG-260624-02 残留 ✅ 已销账(2026-08-15):ToolCard pending 态倒计时落地(_approvalTimers 升级携带 startedAt/timeoutMs + getApprovalRemainingMs 真值起点,expireSecs/expireLevel computed,≤60s .is-urgent 红;不限时回退正计时;i18n expireIn zh/en)+ detached 窗口核验无缺口(AiDetached→AiChat 独立 startListener,ai-chat-event app 级广播,主窗口 detach 时 stopListener 不竞态,结论注释 useAiWindow:107-115)
• F-09 根因:streaming/currentText 全局单例改 per-conv ✅ 2026-08-07 核验销账(per_conv HashMap + 前端 convStates Map enum 轨 + AiConvStateChanged 事件 per-conv 路由,根治多会话串扰)(根治多会话串扰,见 docs/待决策.md)
• CR-260622-01-P2-2 [P2低优·评估降级] — HTML/markdown/JSON 等非代码文件无 session 级缓存。2026-06-24 评估:已有 TOOL_RESULT_COMPRESS_ENABLED(mod.rs:98/1029-1078 view-only 摘要,>2KB tool_result 压缩,LLM 视图摘要非全文回灌 prompt)部分缓解;read_symbol 治代码文件(主场景,降 24.4x)。非代码文件完整 session 缓存(path→hash+content+patch失效)设计复杂 + LLM patch 后重读确认行为不确定(缓存命中提示可能不够 LLM 仍重读),归 B 路线 prompt 策略(约束 patch 后不重读)更合适,工具侧完整缓存低优暂缓。

---

🔍 2026-08-01 走查剩余待办（P2/P3/专项·本会话登记）

本次走查剩余项登记，未实施代码（守 session-role-diagnose-only）。专项已落 memory，此处留指针。

P2（中期改进）:

P3（风格/可读·低优）:

专项（已登记 memory，留指针）:

• 📌 WC-专项-AI-router-sanitize — AI router + sanitize 链路梳理重构 — 详见 memory（已登记，本会话不实施）
• 📌 WC-专项-run_agentic_loop-重构 — run_agentic_loop 重构（ARC-260619-05 agentic:318 超长，历史登记） — 详见 memory（已登记，本会话不实施）

技能注入（待定位）:

• WC-技能注入-trace定位 — 技能/skill 注入链路待 trace 定位（注入时机、上下文来源、是否重复注入），定位后再决定是否待办化

---

🔍 2026-08-02 UI/UX 扩展审查(wf_wynylx23h · 10 路并行 · 基于任务 0115aea6 原 12 问题角度)

详单:UIUX扩展审查-2026-08-02.md。80 条发现(8 高/38 中/34 低;38 全新/29+ 延伸),高严重度主代理 grep 核验全属实。完整数据 ~/.claude/jobs/8ff8ccb7/tmp/audit_summary.json。

P0 确定性 bug(本会话首批 · 并行实施):

P1 进展:

P2(打磨):✅ 幽灵 --df-primary 已清(2026-08-15:4 处引用迁 --df-accent 逐主题等价,双主题定义删除,零残留)/ ✅ 死代码 PlanProgress·isLastUser 已核不存在 / ✅ git 状态色 token(2026-08-15:--df-git-added/modified/deleted/untracked 双主题,FileTree/GitChanges/FilePreview 18 处迁 var+color-mix)/ ✅ 控件统一(2026-08-15:.setting-input 全局定义承接,Connection/ProviderPanel 重复副本删,存布局覆盖)

批次 I(原 12 大改 · 后续专项):Dashboard 统计卡压底行(问题 1,依赖 P1 数据源)/ Projects 视图模式(问题 2)/ TaskDetail(4)·IdeaDetail(5)·KnowledgeDetail(6)·ProjectDetail(10)重设计 / ✅ project_event_repo 埋点已接入(2026-08-15 核验:commands/project.rs emit_project_event 封装 best-effort 写入 + list_project_activities 消费)

---

🔍 2026-08-04 aichat 历史会话实证诊断(弱模型工具行为失控)

触发:用户反馈"你好"时模型乱调 list_project_modules("DevFlow") + search_files("scan")。 实证:prod(76 会话/9928 消息/6392 工具)+ dev(98 会话/7853 消息)库 + 会话 dump 反推。详单 aichat历史会话实证诊断-2026-08-04.md。 核心:弱模型(sensenova-6.7-flash-lite)在任务中重复探索/绕工具/参数错误是系统性现象,非偶发。

💡 2026-08-04 MCP 多进程架构潜在问题(分析登记)

来源:df-mcp 进程实测 + 代码核查。根因:MCP server 独立进程 + 与 GUI 同库不同进程 + 绕过 GUI 业务层直调 Repo。 分析类登记,待决策后实施。 ✅ 2026-08-09 核查销账(2 agent 源码核验 + 主代抽查):8 项中 4 已落地(提交 02c8d8e 等)、4 本批补修(8cb666a)。

• [~] P0-2 🟡 部分(2026-08-09):GUI 内嵌 HTTP 形态已通(advance_task 数据变更映射本批补,data_change.rs);独立 stdio 进程仍无感知(on_write_call: None 无 AppHandle + 无轮询兜底),需设计 GUI 侧刷新机制

---

🔍 2026-08-04 miniapp 聊天渲染 vs 桌面端兼容性走查(剩余待办登记)

走查 apps/df-miniapp/src/pages/chat/index.vue / apps/df-miniapp/src/utils/mdRenderer.ts / src/components/ai/MessageList.vue 等 miniapp 聊天渲染与桌面端兼容性。已修复项不记录,仅归档未修剩余项。守 session-role-diagnose-only:本会话仅走查+登记,未实施代码。 ✅ 2026-08-09 核查销账(2 agent 源码核验 + 主代抽查):9 项中 7 已落地(e722823/795e05f/8cb666a)、本批补 2(mention chip + 语言标签)。

P1(兼容性/体验·2 项):

P2(打磨·6 项):

P3(外部依赖/低优·2 项):

---

🔍 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 待发送队列串到新对话(用户实测,根因已确认):

🟡 P1(前后端合并去重,按严重度):

🔵 P2(打磨/边缘):

其他已销项:CSW-P2-7(需实测确认,从待办去除)

🔍 2026-08-09 项目详情页走查(概览/文件/依赖图 · 3 agent 并行 + 主代核查)

用户要求「检查项目详情（概览、文件、依赖图）存在的问题」并「先检查做记录，不直接改」。详单见 项目详情页走查-2026-08-09.md。共 60 项（P0×1 / P1×6 / P2×14 / P3×27）。守 session-role-diagnose-only：仅走查登记，未实施代码。

P0（核心不可用）:

P1（数据正确性/一致性·6 项）:

• [~] PD-P1-3 — 🟡 已降级标注(2026-08-09 a9cb802):WorkflowEventPayload 无 project 维度无法按项目过滤 → 实时进度面板默认隐藏(wfProgressEnabled)+ 日志默认折叠+「全局事件」标注,不改事件协议(跨层大改留设计)

P2（体验/打磨·14 项）:

P3（边缘/打磨·27 项）: 见详单文档(概览 O10-18 / 文件 F13-24 / 依赖图 G14-18) — 部分已随批修(见下)

已随批修 P3：O7 sourceScores clamp / O8 descCollapsible DOM 测量 / O9 handleSync 补模块+灵感 / O10 parseStack 缓存 / 依赖图 G10 防环文案 cycleAddError / G14 后端 from!=to 校验 / G16 省略号统一。其余待后续批。

优先级建议：P0 G1 节点不渲染 → P1 F3 中文乱码 + G3 删依赖必失败 + O2 跨项目串数据 + O1 列表陈旧 + F1 变更不刷新 → P2 分批。 memory 指针：devflow-project-detail-walkthrough

---

🔍 2026-08-09 aichat 运行效率走查(6 路并行 · 单轮成本/工具/流式/前端/会话/LLM成本)

用户反馈「aichat 运行的效率很低」+「成本走查，比如有的 LLM 要求的缓存命中率规则」。详单见 aichat效率走查-2026-08-09.md。共 74 项（单轮13/工具9/流式12/前端12/会话16/LLM成本12）。守 session-role-diagnose-only：仅走查登记，未实施代码。

LLM 成本/缓存命中（用户重点 · P0×2）:

• [~] AC-EFF-C1-1 ✅ 日期挪易变段已修 / C1-2 🟡 每轮全量重发 O(n²) 部分缓解(cache_control+稳定前缀后第2轮起命中,增量滑窗留待后续批) / C1-3 ✅ augmentation+知识注入挪消息流已修

后端效率（单轮成本 + 会话 + 工具 · P0×4）:

前端效率（流式 + 交互 · P1×4）:

P2/P3 其余 50+ 项: 见详单文档（R2/R3/T2/T3/S2/S3/F2/F3/L1/L2/L3/C2/C3 全量）

优先级建议：① C0-1+C0-2 缓存命中率 → ② L0-1 save + L0-2 system 缓存 + L0-3 压缩后台化 → ③ R1-1 全量重放 + S1-1 流式增量 → ④ T1-1 审计批量 + F1-1/2/3 列表刷新收敛。 memory 指针：aichat-efficiency-walkthrough-2026-08-09

🔍 2026-08-09 任务/仪表盘/灵感知识走查(3 路并行 · 阶段②第一批)

详单见 任务+仪表盘+灵感知识走查-2026-08-09.md。共 59 项（任务19/Dashboard+Projects17/Ideas+Knowledge23，P0=0/P1=7/P2=25/P3=27）。守 session-role-diagnose-only：仅走查登记，未实施代码。

P1（确定性，优先修）:

P2（体验/数据）: WK-813 ✅ 已修(0554cc1):快捷菜单状态机+补cancelled / overflow裁切根治(顶底角裁剪下放) / loadTasks seq守卫+keyword / 搜索态隐藏进度徽章 / 分页越界钳制 / 失败统一toast。剩余 WK-1418 🟡 待后续

P3（27 项）: 见详单文档（TSK-1019 / DBP-1017 / IDEA-1012 / KNOW-610 / C-1~3）

优先级：WK-1 Dashboard 状态映射 → WK-2/3 Knowledge 确定性 → WK-4/5 Ideas → WK-6 状态徽章 → WK-7 错误条统一。

🔍 2026-08-09 Settings/审计/布局/后端命令走查(3 路并行 · 阶段②第二批)

详单见 settings+审计+布局后端走查-2026-08-09.md。共 95 项（Settings+AuditLog29 / layout+sidebar21 / 后端命令45，P0=0/P1=9/P2=32/P3=54）。守 session-role-diagnose-only：仅走查登记，未实施代码。

P1（确定性/安全，优先修）:

P2（体验/数据·32 项）: 见详单文档（SA-18 审计 i18n/脏表单/竞态、LS-210 侧栏偏好/小屏布局/审批浮窗/Paginator、BE-CMD-923 后端校验/聚合） P3（54 项）: 见详单文档（SA-931 / LS-1121 / BE-CMD-2445）

优先级：LW-1 ConfirmDialog 安全 → LW-2/3 update 裸奔 → LW-4 queue → LW-5 count/list → LW-6 软删 → LW-8 父聚合。 全系统索引：前端 13 + 后端 9 命令全走查完成 ✅，剩 crate df-mcp/df-execute/df-project/df-ideas/df-tunnel/df-relay/df-types。

🔍 2026-08-09 df-mcp + 工具 crate 走查(阶段②最后一批)

详单见 df-mcp+工具crate走查-2026-08-09.md。共 35 项（P0=0/P1=2/P2=8/P3=25）。守 session-role-diagnose-only：仅走查登记，未实施代码。

P1:

P3（25 项）: 见详单文档（MCP-716 / EX-14 / PRJ-24 / TUN-24 / RLY-2~5）

全系统走查（阶段②）完成 ✅——前端 13 模块 + 后端 9 命令 + 全部 crate 已走查登记。进入阶段③批量打包推进 /advance。

🔴 2026-08-09 AI 自审/工作流推进链路缺陷（✅ P0×3 已修,2026-10-05 核验销账）

用户「检查 AI self-review 遇到的问题」触发对工作流推进链路的深度审查。原结论「三条推进链全部不可用」已过时——P0×3 全部已修（task_id 注入 workflow.rs:340 + AiNode 自审落库含 agent 模式 + TaskDetail 审批 UI 随 2eea011 审批重设计批落地），核验详录迁 07-项目管理/todo归档/2026-10-05.md。以下原始诊断保留作档案,修复状态见归档勘误。

涉及文件：

• 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

---

🟡 P1:

🔧 既有测试失败修复(2026-08-11):累计修 7 项既有失败,df-nodes 175 全过 / df-storage 166 全过:

• ✅ ai_self_review_node::clamp_dimension_scores_in_place 类型保真:区间内整数保持整数(9 不转 9.0),仅越界 clamp——修 parse_review_json_valid_passes_through,同步调 clamps_out_of_range_scores 边界值断言(10 保持整数)
• ✅ build_review_prompt 模板说明文字裸 <task_requirements> 与真实标签同名,测试 find 首现误命中行内引用→真实标签加换行锚定定位(\n<tag>\n),说明文字标签加反引号
• ✅ project_module_repo::setup async 上下文直接 blocking_lock() 触发 "Cannot block the current thread" panic→改用 ProjectRepo::insert 异步 API(对齐 service_repo 风格)

---

关联：本走查与「2026-08-09 TaskDetail 操作按钮缺陷走查」同属 TaskDetail 交互审查线，但本段聚焦 AI 工作流推进链路（后端 + 审批 UI），按钮缺陷聚焦 TaskDetail 自身交互。修复时建议合并处理（都在 TaskDetail + workflow 链路）。

aichat agent loop 静默死亡走查待办（2026-10-02）

来源：中断根治批次全量走查（正常设计路径无漏 emit，风险集中四类）。P1-2/P0-1/P2-1 本批已修，以下为登记项。

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 改动，需谨慎设计+场景回放测试。

P1 conv 删除类静默退出族 6 处补终态事件

• 位置：agentic/mod.rs:417/:1316/:1379/:1437/:1593/:1423、stream_relay.rs:520-525（MidStream 保文时 conv-deleted 跳过 teardown emit，最刺眼）
• 现状：生成期间会话被删，裸 return 仅 guard Drop 迁 Idle，无终止事件。
• 修复：收敛到 conv-deleted 也 emit 带 conv_id 的 AiCompleted(incomplete) 或等价终态语义事件；至少 stream_relay.rs:525 处补 teardown。

P2 审批超时惰性收敛改主动任务

• 位置：agentic/approval_timeout.rs:5-6（cleanup_expired_approvals 仅 try_continue_agent_loop 入口调用）
• 现状：用户不点任何按钮，超时审批永久占位、会话永远停审批态；注释语义（自动转拒绝）与实现（下次交互才转）不符。
• 修复：审批挂起时 spawn timeout 定时任务到点主动 cleanup+emit（现有函数可复用）。

附：F2 兜底前移（可选）

• ai_chat_stop 的心跳 60s stale 判死+emit AiCompleted 兜底只在用户点停止时运行；可在 loop spawn 时自带一份，panic 死 loop 无需用户点停止也能收敛。

aichat 三路走查增量待办（2026-10-02 深夜）

来源：上下文管理批收口期 rev-backend/rev-frontend/rev-crates 三路走查（历三次会话重启后续跑完成）。全文与批次归并建议见 docs/05-代码审查/aichat三路走查报告-2026-10-02.md。以下为可执行登记，开工以现场源码为准。

批次2（后端高危）并入项

批次3（前端体验）并入项

机械批（可独立小批）

登记观察（定级前先核）

子代理调度走查（2026-10-03 两路，详情 temp/走查-子代理{UX,调度后端}-2026-10-03.md）

前端 13 项(P1×2/P2×4/P3×7) + 后端 P1×1/P2×3/P3×8；后端报告含 6 点「确认无恙」防重查。

• P1 子代理运行期切回父会话 spawn 卡「已完成」幽灵态：回载 parseConvMessages 恒标 completed+运行期零事件(useAiConversations.ts:230) ——半修(2026-10-05 核验):回载态判定已修(toolCalls status 改 toolResultMap.has || !convGenerating ? completed : running,运行期回载不再恒 completed);剩「运行期零事件」半(子代理运行事件仍不推父会话视图)待批

子代理深查两路（2026-10-03 晚，详情 temp/深查-子代理{AI效果面,x上下文管理交叉面}-2026-10-03.md）

与上节 25 项零重叠（报告尾附排除对账）。修复批：四路走查修复收口后，确定性项先行，需拍板项进拍板集。

• P1[需拍板→已实施] 熔断无收尾轮 ✅ 2026-10-06:max_rounds 打满不再直接截断,补一次无工具(tools=None)收尾 LLM 调用——system 指令「输出最终任务总结报告」,成功则 push 报告+落库后走原收尾;失败(全候选耗尽/MidStream)静默落回原截断路径(报告是增益非闸门,零新增停靠)。预算:仅 1 轮 max_retries=0,无放大(agentic/mod.rs 达上限分支)
• P1[需拍板→已实施] 报告被视图压缩吞掉 ✅ 2026-10-06:summarize_tool_results 加新近度豁免(RECENCY_EXEMPT_TOOL_RESULTS=2)——末尾 2 条 tool_result 恒不压缩(豁免在冻结决策之前,不进决策表),委托报告/末轮工具结果全文可见;单测 summarize_recency_exempt_keeps_last_two_tool_results 锁定行为(stall_detector.rs)
• P2 namespace 10MB 全局 LRU 淘汰:报告蒸发为「重新调用」死路+多代理共池互踩 ✅设计完成(2026-10-04 设计文档):pin 机制+EvictionLog 富提示(替代裸 EVICTED_PLACEHOLDER)+owner 软隔离三招,零 schema 变更;2 拍板点(pin 上限保护/报告外默认 pin 范围),约 0.5-1 天 ✅ 2026-10-06 实施完成 e0b29b4(pin+EvictionLog+owner 软隔离三招全落地,子代理报告出口 pin 收编;验收 cargo check 零 error)
• P2 被拒事实父上下文仅报告尾段单副本,LLM 压缩 prompt 无保留指令[需拍板]
• P2 完成卡(前端全文)与父上下文(压缩)双轨无「已消化」降级机制 ✅设计完成(2026-10-04 设计文档):勘察修正——重启回补已存在(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 节

无人值守长任务（2026-10-04 用户拍板方向，设计先行）

用户拍板：审批类（S2-B 真审批通道）延后不做；产品主线=任务规划一次性确定边界后，无人值守、自主无干预、稳定完成长任务，用户体验优先零打断。追加两维度：效率（完成快+tokens 高效）、可观测可控（进度花费看得见，暂停纠偏接管控得住）。 设计文档已定稿：docs/02-架构设计/专项设计/无人值守长任务-设计-2026-10-04.md（257 行，含效率/可观测可控补遗两章），拍板点 13 项各带建议。 缺陷靶心分析：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 断流=整任务终止 ✅已修(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 花费中途不可查/纠偏只能排队不能注入/预算中途调整不可达(归设计补遗两章分期)

后续规划方向（2026-10-02 用户口述，不分先后）

用户指令：完成 ai-chat 核心后，以下 9 项纳入后续规划，先记录后逐渐开展。此处为方向索引，开展时各自立项细化。

1. 打造核心 ai-chat 及上下文管理能力（当前上下文管理批即此项主线，持续演进）
2. 知识库、技能、记忆的管控管理（知识链路 B 系延伸；candidate 晋升/跨会话召回 C1/记忆空壳定案后续）
3. miniapp（关联 df-miniapp 跨端三层，Phase3 后端闭环已有，剩真机联调+UI+token 生产级）
4. 接入飞书 bot（启动定位=调度中枢的飞书侧动线，P0 打包+u-switch 接入已在本批）
5. devflow 云端化部署（分布式 ai 办公协同）
6. 接入企微
7. UX 体验交互体验（批次3 及后续 UX 批持续线）
8. 内置数据库、远程服务器连接能力（与代理工具生态 mysql-proxy/ssh-proxy 等整合）
9. 远程内网设备文件程序管控（中继+代理 client，内置于 u-desk/devflow 或全新设计，关联 u-relay）

使用数据分析深查(2026-10-04,logs+DB 实证,详情 temp/使用数据分析-1004/)

89 会话/15126 消息/9398 工具执行(3.5 个月真实使用);全文与 out1~out7 中间数据见分析目录。修复以现场源码为准。

• 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 迁移批】
• 观察自动执行模式架空审批(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 零)。

• 好评:ConversationSidebar/TaskBoundaryCard/DirAuthDialog 经前四轮修复质量扎实;无 transition:all/autoFocus 滥用等反模式

ai-chat UX 走查第四轮(2026-10-04,增量深查,详情 temp/UX走查-aiChat缺陷-2026-10-04.md)

P1 零;P2×7/P3×11;已修三轮清单已硬排除。修复批开工以现场源码为准。

后续规划登记(2026-10-04 用户口述)

• 各模块 UX 走查(全模块逐域走查,ai-chat 已做完四轮,剩余:项目/任务/工作流/想法池/知识/设置等域)——待令启动,建议逐域分批

DevFlow agent 狗粮实测短板(2026-10-04,84cb104c 会话数据实证,登记待排批)

当日 ~810 次工具调用;主循环配置 max_iterations=0(不限)实证 225 轮零触顶;子代理 spawn max_rounds 6 默认/模型自给 10→20(上限 20)。

新能力引入评估纪律(2026-10-04 用户令,长期生效)

引入任何新能力(协议/工具/机制/大重构)前,须做负面影响与破坏性判定,登记在设计文档内;审查(Review 会话)按此清单核。四维度基准:功能/接口适配/内容风格/性能,禁「未发现故障=不受影响」。

• 兼容性:旧数据/旧客户端/旧配置共存与迁移路径;迁移须可断点续跑(借鉴 V21 教训)且可逆(SQL 迁移带 DOWN 或等价回退)
• 破坏性:不可逆操作清单(删数据/拆兼容层/改协议旧值拒认);每项须有回退方案或「为何不可回退」论证
• 安全面:新增攻击面(端点/帧/命令执行/路径)逐项列;权限是否放大(对齐边界模型 risk 分级)
• 资源面:token/磁盘/内存/进程开销评估;日志与数据膨胀上限(借鉴日志无轮转教训)
• 回退开关:新能力默认关或带单点回退(借鉴 GOAL_PIN 系开关范式);灰度顺序与观测指标
  • P2 指令离线即丢(§7 不缓存):commander 发指令时 agent 离线=静默丢失,移动端控制场景用户无感知——补业务层送达回执或短缓冲
  • P2 Hello 无协议版本字段:下次破坏性变更仍是无通知硬切换——加 proto 版本字段(现在加便宜,以后加贵)
  • P3 单共享 token 可冒充任意 channel_id(§8 自述):补 token 轮换 runbook(/etc/u-relay.env 改+重启+四方客户端同步换,锁步成本需写明)
  • P3 心跳间隔未定值:nginx proxy_read_timeout=300s,间隔须 <300s,文档补建议值(30-60s)
  • P3 同 channel_id 多 agent 并存全投递(§3.3):双 devflow 实例共享通道=指令重复执行,补「一通道一 agent」运维纪律

提交历史重整(2026-10-04 用户令,交 DevFlow agent 执行)

现状:main ahead 6(本地未推送),六笔零 body/一笔主行超长/文档笔类型误标。执行前置:自身无在飞任务+git status 干净(历史重放期间不得并行改码)。

步骤(非交互,全程可脚本化)

1. OLD=$(git rev-parse HEAD) 记录现 HEAD(396f74d)
2. git reset --hard origin/main
3. 按原序 cherry-pick 六笔:3dfa45d → f90ff80 → 737cc1f → 8dd756c → d5d9d9a → 396f74d,每笔 pick 后 git commit --amend -F <消息文件> 换用下方草案
4. 校验:git diff $OLD HEAD --stat 必须为空(树逐字节一致)+ git status 干净 + git log --format="%h %s" 六笔齐

六笔消息草案(subject 全部 ≤50 字;body 每行一事项;可按你对实际改动的了解细化,但不得添加 diff 中不存在的说法)

1. 新增: 无人值守P0任务边界全链 body: 任务级授权边界判定与审批旁路单点插桩 / boundary_json 随会话落库(V45 可逆迁移) / 六路非正常终局统一安全停靠与托盘通知 / 每五轮进度事件与会话头部进度条 / 前端边界配置卡侧栏徽标及 UX 校验补齐(每条一行)
2. 优化: 子代理体验与纪律注入 body: 工具纪律段抽共享同源注入 / 子代理轨迹浮层与完成卡身份 / 分离窗会话切换修复 / 960s 统一出口报告不再蒸发
3. 修复: 协议层与体验缺陷六件 body: temperature 按模型适配仅收 1 的模型不再 400 / 流式 error 帧不再被 choices 必填整帧丢弃 / 只读缓存写后失效 / git diff 中文截断撞 UTF-8 边界 panic / 非视觉模型纯图片直接拒绝 / 全局快捷键补输入焦点守卫
4. 优化: 跨端链路协议对齐 body: miniapp 配置域旧端点强制重置 / df-tunnel 隧道协议与 relay 现网对齐 / relay e2e 例程入 examples
5. 优化: 子代理截断信号与缓存失效 body: max_tokens 截断标记穿透到完成卡 / 缓存写后失效补测试锁定 / 派发参数卡头信息补全
6. 文档: 设计定稿与评估纪律登记(类型由「优化」改「文档」,文件面全在 docs/) body: 无人值守长任务设计定稿含效率与可观测补遗 / u-relay wire 协议规格与五项评估结论 / 新能力引入评估纪律五项清单 / todo 销账与狗粮短板分析登记

提交重整补充(防坑,必读)

• reset --hard 前工作区必须干净:当前存在未提交改动(含本节处方)。执行顺序=①先收尾在飞工作,连同本节处方一并提交为第 7 笔(消息如 文档: 提交重整处方与在飞收尾)②然后 reset --hard origin/main ③按原序 cherry-pick 前六笔并逐笔 amend 换消息 ④第 7 笔原样 cherry-pick 不改消息 ⑤树一致性校验(git diff 原HEAD 为空)
• 重放期间禁止并行改码;校验不过立即 git reset --hard $OLD 回滚到重整前

能力建设批设计完成(2026-10-04 深夜,并行化+wake 原语)

设计: docs/02-架构设计/专项设计/并行化与异步唤醒-设计-2026-10-04.md(五项自评已过,拍板点 3 项)。实施按分工归 DevFlow agent 或我方批次,待令。

• W-a 写并行二维分组器(risk×路径租约:读类并行/写类异路径并行同路径保序/High 不变;顺带修 boundary 同文件双 patch 竞态)

• W-b wake 原语(内存 registry 三条件 delay/file-appear/process-exit,唤醒注入走 a5 路径+guard)

• W-c 与 M1 接力棒/飞书通道对接(依赖各方落地)

• W-d 空闲自领(wake 首应用):空闲检测→领 todo 确定性条目→边界内执行→完成回写+飞书推送;拍板点 4 项(默认关起步/30min 延迟/仅确定性/推送飞书)——设计要点见并行化与异步唤醒设计 §6.2

• W-d 挂机模式(用户拍板:自领/自推进/自拆解/自设计;设计 §6.3):W-d1 挂机循环骨架(确定性条目)/W-d2 自拆解+自设计(设计稿落 docs 挂待拍板)/W-d3 治理强化(预算闸+挂机报告+待人工清单);拍板点 4 项待定

• 指标阶梯升级为四支柱框架(2026-10-04 用户定):效率+自主+质量+可控四柱同时定级(木桶规则),每柱映射 L1-L4 指标族;已并入 baseline json framework 段;推进序不变

• W-e 多任务×子代理×真异步编排(设计 §七):W-e1 async spawn+报告轮界回填/W-e2 全局并发池+预算联动/W-e3 continuum 组合;前置=W-a+W-b;拍板点 2 项

• W-f 编排能力三层路线(设计 §八):1.0 板驱动(挂机内含)/2.0 task_links 依赖图自动推进(advance 回调+wake 解锁)/3.0 DAG×agent 融合(TaskAdvanceNode 插销已备);拍板点 2 项

• W-g 状态即时同步与通知(设计 §九):W-g1 出口扇出+即时级(依赖飞书通道)/W-g2 摘要级+远控查询命令族/W-g3 每日报告(挂机联动)

• W-h 会话间/代理间感知(FileLeaseRegistry:写前登记+冲突指路/query_leases 工具/兄弟感知/知识联动;与 W-a 组合成完整 lease)——设计 §十;根治今日全部互踩

• W-e2 全局并发池(小:子代理并发上限+预算联动)

• W-d1 挂机最小闭环(领单→执行→销账→循环+轻量续接;W-b wake 随其绑定实施)

• 冻结待信号: W-a 写并行吞吐(只先修竞态)/W-d2 自拆解自设计/W-f 编排 2.0-3.0/W-e1 async spawn——启动信号见设计 §十一

• C-m 上下文三层记忆(设计落档):C-m1 记忆卡四类(目标/决策/发现/待办)压缩重构/C-m2 压缩时机信息增益信号/C-m3 与召回闭环衔接;拍板点 3 项

• E-m 自进化能力(设计 §十二):E-m1 模式扫描报告(挂机自领类)/E-m2 在线启发(熔断对话化)/E-m3 技能注册管线;拍板点 1 项

• W-f 2.0 改为最小探针(依赖声明工具面暴露,使用率决定深化)——[补2] 方法修正

• F-m 失败学习环(设计 §十三):F-m1 失败归类统计(挂机自领类)/F-m2 教训提炼进 knowledges 失败分册+同类任务前置注入/F-m3 失败现场即时附学;拍板点 1 项(教训审核)

环境知识:GitHub 直连受限的替代方案(2026-10-04 深夜,失败学习环首条)

• download_file 拉 github.com releases 失败(今晚 protoc 实证)→ 替代:URL 前缀镜像(如 https://gh-proxy.com/ + 原URL)或 gh 命令(gh release download,已登录态)或本地包管理器(winget/choco 装 protoc 等构建依赖,一次预置后构建不再拉外网)

• 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 行,双端通用,可微调措辞不可删项)

## 派工纪律
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 类·机制移植(有实证差距,优先)

• D2 白名单热加载(u-claw 已有):现白名单启动时读死进 Ctx(L107),改 KV 须重启进程。修:whitelist 改 RwLock 或每消息现读 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 输出在面板无 ␛ 残留。 ✅ 2026-10-06 补销: 已随 70d6e98 修复(ANSI 源头抑制+strip 兜底), 当时漏销
9. 会话标题 content 泄漏:会话标题显示原始正文片段（如 <details> <summa…,84cb104c 会话同症）——标题生成输入未清洗或兜底直接取 content 头部。修:title 生成失败/超时兜底改为清洗后的首行摘要,含 HTML/Markdown 标签时剥离;验收:长会话标题无标签裸露。 ✅ 2026-10-06 补销: 已随 70d6e98 修复(标题剥标签 sanitize(title.rs)), 当时漏销

附:截图实证单会话 206 轮/1500 万 tokens——C 批次（上下文管理）紧迫性最强活证,随 C-r0 优先消化。

🔴 提交后跟进（2026-10-05 23:0x 走查发现,cb260ab 已入库但未修）

10. loop_state 对新会话/编排会话静默失效(高) ✅修复(2026-10-06,提交「修复: loop_state 懒创建继承与入口早退清理」):懒创建继承 running(conversation.rs)+入口早退清残留(agentic/mod.rs)+list_parked 消费方=TopBar「可恢复」分区(V49 读侧)。验收:cargo check EXIT 0+vue-tsc EXIT 0。
11. 【中】conversation_repo.rs:817 注释矛盾 ✅修复(2026-10-06 同批):update_full 剥离 loop_state 列,封 lost-update 窗口,注释与实现一致。
12. 【中】前端 i18n 双侧同缺 aiChat.reattachToMain 键 ✅修复(2026-10-06 同批):zh/en 补键。

以上为 72 文件走查结论(报告要点 23:0x 已交群),提交规范 18 笔全合规,质量项按本清单跟进。

流畅性根本解三件（2026-10-05 深夜用户立项：1+2+3，④双通道搁置）

13. ①过程流式 ✅ 2026-10-06 实施:run_stream_refresher 消费面扩容(AiTextDelta + AiAgentRound + AiToolCallStarted/Completed 四事件,conv 路由过滤共用)——过程流不刷屏:卡片改「头部一行摘要 + 正文增量」结构,头行=轮次 + ⚙当前工具执行中/已完成 N 步(历史步骤折叠为计数,决策价值过滤);过程事件标脏强制重刷(纯工具轮无文本也有"活着"信号,治 206 轮长任务卡片静止猜卡死);签名去重防同 tick 事件风暴空刷;超限保尾截断口径不变。4 单测锁格式契约(首轮无头行/工具执行中/轮间空档/截断)。验收:cargo check EXIT 0 + feishu 7 passed。参照 u-claw 进度卡治理;桌面过程视图同步对齐见「桌面端能力同步清单」。
14. ②任务式委托：重任务（agentic loop 任务）受理即回任务卡（「已受理·预计 N 分钟」），用户可离开；完成后卡片原地更新+结果在卡。底座已有（30min 超时任务后台不丢），重构 handle_message 等待形态为受理/完成两段式。验收：发「走查代码」3s 内收到受理卡，完成后卡片变结果，全程无需等待。
15. ③C 批次关联：本组两件的提速收益依赖 C 批次（prompt 71K→按需）——C-m1/m2 优先级顺位提升（单轮推理是 80% 耗时大头，见流畅性分析 2026-10-05）。
16. 纠偏注入通道(用户 2026-10-05 深夜点名,飞书对话补充消息目前只能排队不能注入运行中任务)✅ 2026-10-06 实施:引擎层 inject_runtime_message(chat.rs,活跃守卫 conv_states.is_active → 短锁 push per_conv.messages → save_conversation 增量落库,loop 下轮 build_for_request 自然带上,u-claw 补拉同构);飞书侧 handle_message 白名单后加注入旁路(chat_map 命中且 conv 活跃 → 注入 + 卡片确认「下一轮生效」,非活跃 Err 落回常规 spawn 路径零行为变更)。不改锁语义/不打断 loop;桌面任务卡补充入口待 14 异步委托批配。验收:cargo check EXIT 0 + chat 17 passed + feishu 3 passed(含注入前缀格式契约单测)。

14 升级（用户拍板 2026-10-06 凌晨）：桌面也要异步能力，不做双端分叉——异步委托是引擎层能力,桌面与飞书都是它的前端视图。实现要点:①引擎层 spawn 即受理返回,完成走通知桥广播(oneshot 改事件+等待者订阅) ②桌面任务卡 UI:受理/进行中 N 轮/完成+系统通知,发消息后可切会话/最小化 ③飞书为同一语义投影(受理卡/完成原地更新) ④锁语义保守起步=单会话单在途+排队,多并发看用量再说 ⑤yml 开关灰度。依赖链:16 纠偏通道(受理后补充入口)→13 过程流式(进行中视图)→本项。验收:桌面发任务→切走→完成收系统通知;飞书同构;双端行为一致。

设计约束（用户拍板 2026-10-06 凌晨）：任务会话高度复杂,代码设计一定要优雅——①状态机显式化:受理/运行/暂停/完成/失败用枚举统一,禁散落 bool 拼凑 ②单一事实源:任务状态只在引擎层,桌面/飞书 UI 都是投影(订阅不轮询) ③事件驱动贯通:13/14/16 共用同一事件总线,不做渠道私有旁路 ④优雅优先于速度:宁可工期换结构,不做特判堆补丁(优雅架构铁律)。

桌面端能力同步清单（与渠道对齐,2026-10-06）:16 纠偏注入做在 AiSession 会话层桌面天然受益;13 过程流式桌面过程视图同步对齐;14 任务卡+系统通知已在升级注记;另两件桌面专属:①V49 可恢复入口——走查实锤 list_parked 读侧零消费,桌面侧栏补「可恢复」列表消费它(断点续跑闭环最后一块)✅已做 e0b29b4(分组展示+点击恢复) ②缺陷9 会话标题泄漏桌面同症随批修。

17. 桌面会话内容同步飞书(同会话,2026-10-06 凌晨拍板):绑定飞书 chat 的 conv(chat_map 映射既有,恢复机制在)——桌面端该 conv 的新消息(user/assistant)实时投影飞书卡片,用户离机后手机飞书可跟任务全程。实现:订阅 ai_event_bus 的 conv 内容事件→飞书投影,与 13 过程流式/14 任务卡共用单写卡者;按决策价值过滤防刷屏(完整历史在桌面,飞书给关键节点)。与 14 组合即完整闭环:桌面发任务→切走→手机看过程→收结果。验收:桌面 conv 发消息/收回复,绑定飞书 3s 内卡片更新关键节点。
18. 渠道错误话术吞因(09:51 实证)✅ 2026-10-06 修复:①spawn Err 分类话术——并发护栏拒绝(「正在生成」)→「⏳ 该会话已有任务进行中,本条将在任务完成后处理;可稍后重发,或先 /status 查看进度」;其余失败→附截断原始原因(不吞因)。②探活告警口径修正——inflight 计数点从 spawn 前提前到 handle_message 白名单通过处(RAII 覆盖占位卡 HTTP+per-chat 锁排队窗口,原该窗口任务在跑却报「无在途会话」);旧计数点删除防双重计数。验收:cargo check EXIT 0 + feishu 7 passed。

附:09:48 桌面纠偏「不是 haogame 是 redtimer」被运行中 loop 下一轮直接接住——16 纠偏注入的桌面形态天然存在,飞书侧对齐即可。

工作流治理升级（2026-10-06 用户拍板：根本性增强,源自提交质量检查三不达标）

根因:任务传递靠软机制(看板摘要+群消息阅读),无结构化任务单与销账门禁——🔴被静默跳过/i18n 描述失实/描述与内容偏差,三层同源。

治理四条（对 devflow 工作流生效）

• G1 结构化修复单:走查/审查发现逐条独立成单,格式=[编号] file:line + 复现/影响 + 验收命令,🔴级不允许自由跳过(先销后立新)
• G2 🔴门禁:🔴级条目未清零前,新功能提交打回(cm 提交前置检查看板🔴余量)
• G3 描述反向核对:提交前 diff 关键词与描述机械比对,不符打回(cm 技能增强)
• G4 销账带证据:勾选 [x] 须附验收命令输出行,无证据视同未完成

桌面能力同步(随本批)

• G5 V49「可恢复」入口(桌面侧栏消费 list_parked,断点续跑闭环最后一块)✅ e0b29b4 可恢复分组+点击恢复已落地
• G6 缺陷9 标题泄漏桌面同症随批修

⚠️ 退回重处理（2026-10-06 用户令,G2/G3 治理标准首次执行）

• 三笔提交（cec4d11 委托引擎/84df9b5 租约/622507c UI）已 reset --mixed 退回（内容全在工作区,零丢失,未推远端无需处理远端）
• 重做要求：①先修 🔴10 loop_state 失效（G2 门禁:🔴不清零不得提交新功能）②描述按 G3 如实:实际干了 14+16+事件广播三件须逐件列全 ③i18n reattachToMain 键随批补上 ④修完按主题重新分组提交,销账 [x] 附验收输出（G4）

19. 飞书 outbound 统一出口(11:23 实证)✅ 2026-10-06 收口:勘察确认对话/受理/完成/注入回执已统一走 deliver_result(降级/裁剪/卡片链内聚);病灶「挂机进度汇总独立发送路径」在当前 main 不存在(属退回的挂机实验代码)。本批防复发收口:①新增 push_to_chat pub(crate) 正典出口(主动推送形态——挂机进度汇总/巡检通知将来落地时禁再开独立路径,强制走降级/裁剪/卡片链) ②ACTIVE_CLIENT OnceLock 全局句柄(渠道启动就绪,推送复用长连接 client 不临时建连,未启动静默跳过)。验收:cargo check EXIT 0 + feishu 7 passed。

附:挂机汇报自报 🔴10 已修验证通过+43 文件产出——挂机模式推进有效,路径修复别误伤它。

无人值守可靠性专项（2026-10-06 swarm 立项,设计档:docs/02-架构设计/无人值守可靠性专项设计-20261006.md+temp/V49断点续跑设计-20261006.md）

UI/UX 体验设计实施项（2026-10-06 设计档:temp/异步任务会话UIUX设计-20261006.md,依赖 13/14/16/17 机制先行）

• U1 任务卡生命周期组件(双端):桌面 TaskCard 八态投影枚举(全部由既有事件派生,零引擎新状态)+飞书 header 状态色结构卡(JSON 元素级规格已给,动作 v1 走文本命令)
• U2 进度语义:三层模型(活性脉冲/位置计数/内容工具名)+防假进度五规则——核心"数字不动+脉冲停才算卡死",无分母禁画百分比
• U3 通知分级:必达(L0决策/L2完成)与静默累积(L3过程)分级表;飞书侧=哪些事件值得动占位卡,注入回执走 reply 不动占位卡
• U4 纠偏交互:桌面直发默认注入·下一轮生效(排队可切),回执+前缀逃生;飞书回复即注入保持
• U5 异常态话术公式:状态+真实原因+已保留什么+≥2条出路;禁自动判死静默任务(15min 重入退避是合法等待),给判断材料不替用户决策
• U6 跨端一致性:引擎唯一写者,双端不直同步,"实时"=秒级最终一致;断线恢复桌面走 DB 回放/飞书走 /status 回查

20. 委托制伪受理断层(13:38 实证):受理卡在引擎确认可启动之前发出——12:57 任务停滞 Generating 时,「进度」spawn 被引擎拒但受理卡已发,之后零通知零进度(比 09:51 立即报错更隐蔽)。修:受理前过 can_accept_request,不可启动→直接回「前任务在跑,已排队/稍后」;可启动→才发受理卡+watcher 接力。附带:委托制下 inflight 生命周期改跟任务走(handle_message 提前返回致 18 修正再次失效,13:18 误报复现)。验收:同场景复测,占用期发消息得到明确排队提示而非静默受理。 ✅ 2026-10-06 c91b993(交互批八项合提,验收: cargo check 零 error+feishu 13/df-im-gateway 19/chat 17 passed+vue-tsc 0)

符号语义规范（2026-10-06 用户反馈:受理卡「✅ 已受理」歧义,随 19 统一出口一并落地）：

• 🚀 受理/开工（任务开始才用,禁 ✅）｜⏳ 进行中/排队/等待｜✅ 仅限完成且成功｜❌ 失败（必须附原因）｜⚠️ 警告/需注意（附数据）｜📎 附录/附加信息
• 原则:符号=状态的一眼判据,同一符号跨场景语义必须一致;受理卡改为「🚀 已受理,后台执行中」;完成推送才允许 ✅ 开头。

飞书交互面全量盘查（2026-10-06,11 条缺陷按恼人度降序,修复前话术避免引用 /status）

34. 🔴 过程推送散乱刷屏(14:06 用户截图反馈「信息太散乱爆炸了」):push_to_chat(:797)每调用必新开独立卡片,通道无聚合语义——昨日调试把链路测试/修复上线/加固明细等 L3 过程逐条直推 4+ 条进群,与 U3 分级相悖。修双层:①机制=push_to_chat 增滚动汇总卡——同 chat 维护在途事务卡 message_id(内存即可,重启另起),进度用已有 update_card(:730)原地追加;首推需 send_markdown_card 返回新卡 id(现 :683 is_ok() 丢弃,比照 reply_markdown_card);文本以 ✅/❌ 开头=终态,更新后清句柄下条另起新卡;更新失败回退新发并重绑(比照 deliver_result 兜底)。②纪律=L3 过程默认不推群,落日志+进度文件;push 收敛「需决策/完成✅」两时机,调试确需的验证推也进汇总卡不新开。验收:同事务多步进度群时间线只占 1 张卡,过程类推送零直达。 ✅ 2026-10-06 c91b993(交互批八项合提,验收: cargo check 零 error+feishu 13/df-im-gateway 19/chat 17 passed+vue-tsc 0)
35. 🔴 /status 被话术推荐但不存在(chat.rs:387/:486 两处):用户发了被当任务烧一轮 LLM。修:实现 /status(读 conv 状态返回进度摘要,配合委托制价值高)或先改话术删除引用。验收:发 /status 得进度卡而非 spawn。 ✅ 2026-10-06 c91b993(交互批八项合提,验收: cargo check 零 error+feishu 13/df-im-gateway 19/chat 17 passed+vue-tsc 0)
36. 🔴 35min 兜底回查会投出上一任务旧回答冒充本次结果(feishu_channel.rs:483/:939):回查整 conv 最后 assistant 文本无任务边界。修:回查限定受理时间戳之后的 assistant,无则给真实状态话术。 ✅ 2026-10-06 c91b993(交互批八项合提,验收: cargo check 零 error+feishu 13/df-im-gateway 19/chat 17 passed+vue-tsc 0)
37. 🔴 watcher 首超时后永不弃守(:486 continue 与注释"二次超时弃守"相反)+错误路径只发 AiError 无 AiAgentFinished→每 35min 重刷过期文案+任务泄漏。修:二次超时真弃守+AiError 也广播 Finished(status=error)。 ✅ 2026-10-06 c91b993(交互批八项合提,验收: cargo check 零 error+feishu 13/df-im-gateway 19/chat 17 passed+vue-tsc 0)
38. 无取消/审批通路:跑偏无法叫停(飞书零 stop 通道);审批挂起对飞书用户不可见(流式卡冻结无解释)。修:/cancel 对接 ai_stop_loop;审批事件上卡片(「需审批:xxx,回复 批准/拒绝」)。 /cancel 停止通路+watcher 收口+审批推送与批准/拒绝决议(路径类授权留原语差异), ✅ 2026-10-07 细项批(待提交)
39. 非文本消息静默丢(:243):发图/文件零反馈。修:回「暂仅支持文本,媒体能力规划中」(D7 前的兜底)。 非文本兜底已存在于基线(:255 回「暂仅支持文本」), ✅ 2026-10-07 核验补销
40. ⏳话术承诺排队实际不入队——话术与行为不符。修:改话术为实况(「可稍后重发」)或实现真排队(与 20 受理断层同修)。 ✅ 2026-10-06 c91b993(交互批八项合提,验收: cargo check 零 error+feishu 13/df-im-gateway 19/chat 17 passed+vue-tsc 0)
41. 快任务兜底死分支(:449 elapsed>=3s 入场即查恒假,「秒级任务直投终版」不可达)。修:受理卡发送后计时或事件驱动判定。 ✅ 2026-10-06 c91b993(交互批八项合提,验收: cargo check 零 error+feishu 13/df-im-gateway 19/chat 17 passed+vue-tsc 0)
42. 注入末轮竞态:loop 已在末轮则补充指令无人消费静默丢失。修:注入后检查 loop 剩余轮次,末轮则自动续一轮。 注入末轮顺延轮次预算(共享余量+轮顶动态判定+封顶 8), 5 单测锁定, ✅ 2026-10-07 细项批(待提交)
43. push_to_chat 取 KV map 首条(:792):多 chat 绑定可能发错会话。修:按 conv 反查 chat。 push_to_chat 按 conv 反查+多绑定取最近活跃(签名加 conv_hint 零涟漪), ✅ 2026-10-07 细项批(待提交)
44. 细节批::389 反引号不闭合;/new 大小写与附言容错;/new 时旧任务在跑无提示;标点半全角混排。 反引号闭合//new 容错与旧任务提示/半全角归一(parse_command 3 单测), ✅ 2026-10-07 细项批(待提交)

上下文根治专项（2026-10-06 设计定稿:docs/02-架构设计/上下文根治设计-20261006.md,取代旧 C 发散条目）

• P1(S)：工具结果瘦身——超 2K 结果正文落盘+句柄,上下文留摘要+路径(与 D2a 同构,最大头先行)
• P2(M)：L1/L2/L3 分层组装器(build_for_request 改造:常驻+滑动窗口+检索召回)
• P3(M)：压缩常规化(水位兜底→常规滑动)+记忆卡 C-m1+按段重载 C-r1
• P4(S)：量化验收——223:1→≤50:1,prompt 均值 71K→≤20K,agent 能力不降级回归
• 注:C-r0(验证后台化)独立不变;C-m2/C-r1 并入 P2/P3;旧 C 发散条目以新设计档为准销账。

上下文根治补充项（2026-10-06 完整审视第十节产出,设计档 docs/02-架构设计/上下文根治设计-20261006.md 第九/十节）

• G7 平台能力对齐调研（P2 前置）:模型/平台原生上下文能力盘点（Claude context editing/memory tool 等）vs 自研边界——能用原生不自研;自研聚焦平台没有的(任务聚类切换/跨会话页池)。产出:对齐结论一页,定 P2 增删。
• P2 细化:统一检索面——knowledge_inject 扩为全类型注册方(工具句柄/历史页/记忆卡/knowledge 同一召回入口,分类型返回+来源标注)+三层配额(prompt ≤20 条/每轮召回 ≤5 页/句柄按需)+调度器指标(页命中率/召回率/换出量)进日志与面板。
• P4 细化:任务回归集建设——固定任务清单(5-10 个代表任务),组装器改造前后跑对比(完成质量/轮数/token 成本),作为"能力不降级"的可证口径。

B5 无人值守续作引擎（2026-10-06 用户实证"总停下确定性任务"的根治,挂机治理核心缺口）

• B5a 挂钟闸分任务定级:确定性任务(看板任务/用户拍板项)挂钟闸放宽(如 120min)或按预估时长配置;闸到点改「检查点+续跑」(存进度不停工),仅非确定性/失控疑似才硬停靠。
• B5b 停靠自动续作:停靠/parked/批收敛后自动回读看板——有 parked 可续任务→自动 resume;有未完批次→自动领单续作;真需决策才停(附决策项)。无人值守的"永动"机制,CLAUDE.md 领单纪律的运行时化。
• B5c 审批无人值守策略:挂机中审批拦截按用户预设策略处置(低风险自动批+留痕,高风险停下+通知),策略 yml 可配。验收:挂机 4h 连续推进模拟(确定性批次队列),零人工干预零停顿;超大任务挂钟闸到点走检查点续跑。

任务自主推进全链卡点-治法映射（2026-10-06 补全,B5 系总览）

链路:感知领单→开工检查→执行→停靠/收敛→恢复→续作→汇报

• 感知领单:CLAUDE.md 领单纪律(新会话 ✔)/挂机长会话无回读驱动→B5b 治
• 执行中:30min 挂钟闸硬停→B5a 治;审批拦截无策略→B5c 治;工具失败低效重试(404 连环十几次,无退避换路策略,同 yideng 教训)→新增 B5d:工具失败快速放弃+换路径+退避策略;长上下文每轮变慢(223:1)→上下文根治 P1-P4 治;外部干预 loop 认知过时→B4(H3)治
• 停靠/收敛:停后不自动续→B5b 治;parked 恢复需人工点→B5b 自动恢复治
• 可见性:进度/卡点/审批对用户不可见→13 过程流式+24 审批卡治
• 汇报:B1-H1 git 实测已治 ✔
• 远期(真实需求触发):多任务并行度/跨会话任务分发 补齐优先序:B5d 工具重试策略 → B5a 挂钟定级 → B5b 自动续作 → B5c 审批策略 → B2 预算闸 → 13 过程流式

13a 飞书过程可见性加固(2026-10-06 用户实证"卡点到结束才回复",13 的最小件提前独立做,零新机制)

• 13a-1 刷新可观测:refresher 的 update_card 失败从"静默跳过"改为 feishu_log 记录+连续失败计数(≥3 连败告警)——当前刷了还是没刷、刷败全不可知,排查无从下手。 ✅ 2026-10-07 实施(feishu_channel.rs 单文件):刷失败 feishu_log 落盘(连败次数/chat/msg/chars)+连败 ≥3 告警一次(REFRESH_FAIL_ALERT_THRESHOLD=3,== 阈值触发后继续累计不重复)+刷新恢复记「此前连败 N 次」+成功归零。验收:cargo check -p devflow EXIT 0 + cargo test --lib feishu 16 passed 0 failed。
• 13a-2 静默期心跳汇报:AiHeartbeat(20s 既有事件)接入 refresher——超 N 分钟无内容刷新→主动刷一行「仍在跑:第 X 轮 · 最近动作 yyy」(数据源 AiAgentRound/最后工具名),防静默期卡片冻结。
• 13a-3 阶段汇报:AiTaskProgress(每 5 轮,mod.rs:1119 已 emit)接入 refresher——长任务的阶段性进展对飞书用户可见(当前只有桌面消费)。
• 13a-4 受理→首刷衔接:受理卡到首个 delta/心跳之间的静默窗口检查(>60s 无首刷则心跳兜底)。 验收:206 轮级长任务期间,占位卡至少每 3-5 分钟有一次真实更新(心跳或阶段),失败可见于 feishu-channel.log。

31. (自动续作) AI-Ops→devflow 派工通道(多 bot 编排正统通道,2026-10-06 缺口实证):AI-Ops 无法直接触发 devflow 开工(飞书 bot 消息不互触发/WebChat 无/remote_bridge 走 tunnel 不外用)。方案二选一:①u-claw 侧新增 ask_devflow(与既有 ask_uclaw 对等,经 remote_bridge 协议下发启动指令) ②devflow 侧看板轮询引擎(定时扫 todo.md 新🔴/高优条目自动开工,CLAUDE.md 领单纪律的运行时化=B5b 同源)。建议 ② 与 B5b 合并实现(同一套自动续作引擎)。验收:AI-Ops 写看板后 15min 内 devflow 自主开工,零人工中转。 ✅ 2026-10-07 方案②实施并与 B5b 合并落地(unattended.rs 636 行,B5b+31 同一引擎):看板解析器(编号条目四态+🔴 判据=标记后首字符防误判)/G2 门禁领单选择器(🔴 未清零只领红 fail-closed)/轮询调度器(tokio 常驻,KV 热读配置 df-unattended-{enabled,poll-secs,claim-scope,todo-path},默认关+300s)/收敛回读钩子 notify_batch_done 接 agentic emit_ai_completed_once 单点/parked 自动恢复优先/连续 3 次 spawn 失败熔断/领单原子写+spawn 失败回滚/引擎独立后台会话 pin_active=false。验收证据:①接线 rg 实测 lib.rs:77 unattended::start + agentic/mod.rs 收敛钩子调用 ②cargo test --lib unattended = 9 passed 0 failed(本轮实测修正 parse_statuses_and_red_marker 断言:🔴 判据仅认标记后首字符,正文提及不误判,与实现注释语义对齐) ③活证=本条目自身即引擎产出:AI-Ops 写板 → 引擎改写 31. [→](自动续作) → 派发本会话执行,零人工中转,15min 上限实测远低于下限。

31 泛化路线：「看板即队列」模板资产化（2026-10-06 swarm 设计定稿）

• 抽象：看板=任务队列（优先级/状态三态/验收口径）+ 领单纪律=消费者协议 + 治理门禁=质量闸。任何 Claude Code 实例 + 一个看板 = 一个自主工作单元。
• 组件三件套模板（提炼自 devflow 今日实践,新场景开箱即用）: 1.看板格式规范 2.领单纪律 CLAUDE.md 模板 3.治理门禁包(cm v1.3.0+pre-commit hook)
• 推广路线:devflow v1 验证 → 模板提炼进技能分发站 → u-claw 九实例各挂看板 → 多 bot 协作总线(N²→N+1) → 人-bot 协作(写板即派工)。
• 前置约束:仅异步任务适用;hook 随模板强制安装;多实例并发领单=[→]原子改写+git push 冲突天然仲裁。
• 32 泛化落地:devflow v1 跑通后,模板三件套提炼进技能分发站(skill 形态),九实例试点 2-3 个(先 AI-Ops 自领+devflow,跑一周数据再扩)。

33. devflow.md MVP(十四节多角色论证定稿):①启动读取 devflow.md(规范纪律+领单两分区)+CLAUDE.md 并入 build_runtime_prompt 第七段,内容按相关性裁剪禁全量 ②警示区走 insert 消息范式 ③状态不文件化(DB 直注+H3 git 实测) ④知识投影补相关性元数据。砍除运行中文件刷新。v2+:agent 自主维护/知识投影动态化/跨会话投影。验收:启动双文件并入生效;警示事件下一轮可见;token 零缓存击穿。

看板完整性防护（2026-10-06 todo.md 截断事故:文件被重写为 12 行+脱离 git 跟踪,内容经 git HEAD+残版合并零丢失恢复)

• 看板防护三件:①条目数骤降告警——看板条目数单次变化 >50% 时视为异常(防静默截断),提交/重写前自检 ②看板修改一律原子写(tmp+rename)+保留前版快照(todo-快照-*.md 滚动一份) ③git add 覆盖检查——提交流程确认看板在跟踪列表(防选择性 add 遗漏致脱离跟踪)。根因:agent 提交/整理流程对 todo.md 组合失误(重写+跟踪移除),细节在其 transcript 不可见——机制防护优先于行为归因。

编号防撞规则（2026-10-06 两次撞号/错引实证:31 撞号+W-d1 幽灵引用）

写板前必查重:grep -E "^<新编号>\. \[" docs/todo.md docs/todo-归档*.md 零命中才可用;多写者(AI-Ops/devflow)编号分段——AI-Ops 用偶数段或 B/G/P/U 前缀系,devflow 用奇数递增;引用编号前 grep 验证存在。机械闸 G8 已建(2026-10-06 晚,scripts/hooks/rules/todo-id-unique.sh):commit-msg 校验主板+全部归档中条目编号(^[0-9]+. [)全域恰好一次,撞号提交即拦;恢复搬回须同步删归档行。双向测试过(正向放行/重复 37 精确拦截)。34 与 13a 的调和:过程推送按决策价值过滤(u-claw 进度卡治理经验),可见性≠刷屏。 35. [~] H3 teardown 疑似过重 真相改写(验装日志实锤):17:47 进程消失=agent 自杀式换装脚本杀宿主(swap-install.log:17:48:14 old process stopped),非 H3——H3 嫌疑解除。真正缺陷转 36。

关联:13a 过程可见性四件置顶催办——受理后静默的体感投诉今天第三次(09:51/13:38/17:47+),13a-1 刷新可观测是排查此类问题的前提。

36. 换装脚本失败:杀进程后 3s 即安装,Windows 文件锁延迟释放致 NSIS 静默伪成功(17:48 实证 FAIL: exe not updated,installer exit=0)。✅ 2026-10-06 晚全链闭环:脚本加固(swap-install.ps1 v3,语法 0 错实测):①句柄释放探测(独占打开循环,30s) ②校验升级为构建产物 SHA256 强基准(mtime 判据作废,NSIS 保留源文件 mtime 必误报) ③校验失败自动重试一次 ④SYSTEM 触发时转投用户会话重入,四级 fallback,最坏落 swap-need-start.flag。上线验证过(18:44 版手动换装成功):运行 exe SHA256=构建产物=0C45683B,进程 12764 运行中,H1 行为实测通过(19:13 DevFlow 回复带「📎 git 实测」段)。

37. 监控轮询机制缺失(1004/1006 两次要求均未落地,全周响应性投诉的伴生缺口):10-04「持续不间断监控每 1 小时」+10-06 18:45「持续监控 10 分钟一轮」,两次均未建机制;18:45 断链实锤=传承摘要未继承该指令。根因:无头会话无定时能力(网关禁用 CronCreate)。方案二选一:①网关 cron(运维配 yml crons,周期拉 git/进程/日志快照+异常告警) ②devflow 侧自监控引擎(与 B5/31 看板轮询同源,顺带监控自身进程/会话活性+静默告警)。验收:监控自动轮询真实运转,devflow 静默/进程消失 1 个周期内被发现并通报。

38. 飞书出站 md 语法裸露净化+交互样式对齐 u-claw(AI-Ops 2026-10-06 晚实证落板):任务报告 ##/** 等 md 标记在飞书裸露(20:53 分析报告截图实锤)。根因:飞书 lark_md 不支持标题/表格等全谱语法,LLM 产出未经出站转换;主链 send_markdown_card(feishu_channel.rs:716,注释自认「text 类型会符号裸露」)只保粗体/链接,im-gateway StreamText 链纯文本直出。修:①出站净化层——md 转飞书友好格式(标题行转粗体/表格转列表/代码块适配),双层防线=出站兜底转换+agent 产出 prompt 约束,移植 u-claw 投递链降级/裁剪经验(u-claw 仓为范本) ②首回受理卡样式对齐 u-claw 任务状态卡(计数 N/M+逐条状态符+当前动作一行,10-02 用户拍板「效果不错」);受理卡符号 🚀 已由 AI-Ops 修(449 行)。验收:同类分析报告在飞书零 md 裸露标记,受理卡样式与 u-claw 一致。 ✅ 2026-10-06 c91b993(交互批八项合提,验收: cargo check 零 error+feishu 13/df-im-gateway 19/chat 17 passed+vue-tsc 0)

39. 🔴 提交冻结令被无人值守链路击穿(10-07 用户查问「最近提交不符合要求」实证):看板顶部 🔒 冻结令(10-06 深夜用户令,期间只改不提)生效后,挂机链路 01:56-57 仍连提 4 笔(c5ba755 续作引擎 811 行/d0281cb 飞书取消审批 345 行/7ab25e5 换装判据/73fa7c2 看板销账),且 73fa7c2 看板内容自书「细项批(待提交)」与提交事实自相矛盾——冻结仅是文本纪律,引擎与挂机会话的提交步无机械闸。修:①引擎自动提交路径与挂机会话提交步在 commit 前必查冻结标志(看板顶部 🔒 行视为生效,KV 标志更佳),在场即拒绝提交、改动留工作区;禁用全局 pre-commit 拦截(误伤用户本人提交) ②引擎派发的会话启动 prompt 注入「冻结期禁 commit」硬约束 ③解冻=用户「攒批提交通知」后由会话摘除 🔒 行再提。验收:冻结令在场时引擎/挂机会话 commit 步零执行(实测),摘令后恢复;随 31 引擎同测。 ✅ 2026-10-07 实施(commit_freeze 三层闸,零提交全在工作区):①机械闸=crates/df-execute/src/commit_freeze.rs 新模块——静态冻结位 set_frozen(引擎 unattended::run_tick 每轮按看板 🔒 行+KV df-commit-frozen 覆盖同步)+execute/execute_streaming 入口 check(),git commit 变体(git -C/复合命令 ;&&|/引号包裹/多空格)spawn 前拒绝,改动留工作区;未挂全局 pre-commit,用户本人终端零影响。②任务书注入:claim_and_spawn 冻结在场时追加「提交冻结令硬约束」段(禁 git commit/push,执行层闸兜底)。③解冻=用户摘 🔒 行或 KV df-commit-frozen=false,下一轮轮询(≤300s)自动同步放行。验收实测:cargo test -p df-execute 26 passed 0 failed(18 lib 含 6 冻结闸新用例:commit 变体识别/只读命令放行/冻结拦截/解冻恢复/静态位切换;8 shell 集成)+ cargo test -p devflow --lib unattended 10 passed 0 failed(含冻结判据新用例:🔒 行/blockquote > 🔒 形态/KV 双向覆盖/默认不冻结)+ cargo check -p devflow --lib EXIT 0。冻结在场实测=单测断言 check() 对 git commit 返回 Err 且 git diff 放行,摘令后恢复=static_flag_toggle 用例复位断言;真实看板形态(> 🔒 引用行)经 commit_freeze_board_and_kv_judge 实测命中。

40. 桌面侧 u-relay 常驻连接管理器（设计命题，待综合评估后再规划设计）（2026-10-07 用户议定「登记后处理」）：ask_uclaw 现为每请求独立 WS 短连接（connect→hello→探活→request→progress/result→close，任务执行期内本就实时）；用户提议改「全程一条常驻连接中转所有上下行（zhub 式单连接多路复用）」。本项仅登记命题，具体方案待后续综合评估——评估须回答：①当前唯一用例（ask_uclaw 15min 级委托）下常驻是否真有必要（握手 ~0.1s 可忽略、u-claw 侧单 channel 串行 worker 锁死并发=1）②push 型需求（u-claw 主动推事件/高频短指令/多 channel 并行/跨链路统一观测）何时兑现 ③是否与 10-05「推翻网关链路、定稿桌面直连」决策冲突（飞书直连接入-形态修正与问题记录-2026-10-05.md）。命中上述 push 型触发条件之一即启动评估；同构先例可参 df-im-gateway（一条常驻 tunnel 连接中转四端全部上下行）与 feishu_channel.rs。

41. (自动续作) 🔴 测试条目