DevFlow/temp/后续批次预排-2026-10-03.md

后续批次预排（2026-10-03）

定位：批次4 从轮廓细化为可派工颗粒 + 子代理增强线排期 + 专项债/待拍板 + 时序总览。 第二批（2c/3c）细化不重写，见 temp/下一批次规划-2026-10-03.md（已解锁可立即派工）。 锚点均本会话 grep 实测；行号漂移处改写函数名。派工时仍以现场源码复核为准。 复核结论：走查报告 P0 压缩 conv_id 分裂（chat.rs:1734）已由 W1 修（现 :1740 cid = conversation_id.clone()）；V21 断点续迁已落地（v21_crash_midway_resumes 测试在）——两项不进未修池。

一、批次4 细化（第二批后）

4a df-storage 清债（走查报告 P2 ①-⑨）

#	锚点	修法一句话
①	conversation_repo.rs:20 ai_provider_from_row（:58 unwrap_or(1)/:61 unwrap_or(50)）	列缺失降级保功能但补 warn 留痕，坏数据可观测
②	conversation_repo.rs:269/:286 手写 BEGIN/COMMIT	改 guard.transaction()，panic 不残留打开事务
③	conversation_repo.rs:612 insert_checkpoint OR IGNORE	核对 affected 行数，冲突不静默
④	message_repo.rs:164 limit.max(1)	limit=0 语义定案（返空集）+ 注释，消除 0 被钳成 1 的分裂
⑤	task_validation.rs:50 validate_parent_id	父任务存在性校验补 deleted_at IS NULL，回收站父拒挂子
⑥	project_service_repo.rs:128 impl_repo! 宏 update 路径	宏生成 update/update_full 绕过 validate_record，对齐 :198 update_full_with_validation 收口
⑦	project_module_repo.rs:172 delete / :190 delete_by_project	删模块先清 module_dependencies 依赖边再删，FK 不再报错
⑧	task_repo.rs:800 update_full_cas（缺 deleted_at，updated_at TEXT 等值）	CAS 补 deleted_at IS NULL（与 P1-9 同批：project_repo/宏 crud/mod.rs:183-196）
⑨	task_repo.rs:30 / idea_repo.rs:107 / project_repo.rs:114 from_db_str.unwrap_or_default	未知 status 降级加 warn，防 update_full 回写放大

颗粒评估：单项均小（1-20 行+单测），任一项单代理一轮内自证 cargo test -p df-storage 合格，无需再拆。

同文件依赖分组（防互踩硬约束）：

• 组A1（conversation/message repo 读侧）：①②③④ — 碰 conversation_repo.rs + message_repo.rs
• 组A2（task 域）：⑤⑧⑨-task — 碰 task_validation.rs + task_repo.rs
• 组A3（project/service/idea 域）：⑥⑦⑨-project/idea — 碰 project_service_repo.rs + project_module_repo.rs + project_repo.rs + idea_repo.rs
• 派工形态：A1 一代理，A2+A3 一代理（同 crate 串行验证），共 2 并发。⑧ 的 P1-9 连带文件（project_repo.rs:452、crud/mod.rs 宏）归 A2/A3 各自域内。

4b df-ai 清债（P2 ⑪-⑳，⑲ 提优先）

#	锚点	修法一句话
⑲	df-ai/src/ai_tools.rs:257 tool_signature（消费点 src-tauri helpers.rs:266 / tool_registry.rs:2641）	签名归一化补参：read_file+search、search_files/grep+offset/limit/-i/output_mode、run_command+working_dir——合法换参不再共享签名误触 G2 熔断
⑳	ai_tools.rs:241 附近 SigValKind::Json 组	不只用 keys[0]，全键参与归一化
⑪	intent.rs:185/:194 "api"/"hi" 规则 + :423 contains 匹配	关键词加词边界，"history" 不再判 Chat 0.9
⑫	context/mod.rs:308 restore_from_messages	重放后重置 pending_topic_marker，消假话题锚点
⑬	context_helpers.rs:73-80 URL 图 token 地板	地板不被 ×0.35 稀释（1600 保底）
⑭	context_helpers.rs:879 sync_after_compress	JSON 解析失败补 warn 不吞
⑮	context_helpers.rs:828 build_injection	修脏窗口 off-by-one（少注一轮）
⑯	context/sanitize.rs:236/:315 TOOL_MISSING_PREFIX	前缀即「已配对」判定补边界（真 orphan 仍自愈）
⑰	df-ai manager_tests 恒零断言（报告 :401-405/:484-489）	改造为真断言或删，测试资产去水分
⑱	src-tauri chat.rs:810/:2112 begin_turn 调用点	begin_turn 喂原文而非变换后文本（调用方漂移归位）

颗粒评估：单项 1-15 行+单测，单代理一轮自证 cargo test -p df-ai 合格。⑨⑳ 同文件必须同代理。

同文件依赖分组：

• 组B1（签名域）：⑲⑳ — 碰 ai_tools.rs + src-tauri 两消费点回归
• 组B2（context 域）：⑫⑬⑭⑮ — 碰 context/mod.rs + context_helpers.rs（可吸收 ⑰）
• 组B3（sanitize+intent 域）：⑪⑯ — 碰 intent.rs + context/sanitize.rs
• 组B4：⑱ — 碰 chat.rs，与 2c 压缩段（chat.rs:1697-1830 域）互斥，必须 2c 之后（同文件硬约束）
• 派工形态：B1/B2/B3 三代理并行；B4 并入 2c 收尾或其后单点。

4c 编排/网络 latent（㉑-㉝，按启动需要挑）

推荐挑 4 项（实测锚点均在）：

#	锚点	修法一句话
㉗	retry.rs:77 1u64 << (attempt - 1)	改 saturating_shl/封顶，位移溢出 + 预算口径对齐文档 30s
㉙	sse_parser.rs:153 BUF_MAX 截头	截头改保尾（保留最近完整事件边界），防 JSON 永久破损
㉜	openai_helpers.rs:310-311 finish_reason 判定	content_filter 纳入终态，无 [DONE] 流也有收敛
㉑	git_worktree.rs:175 merge-tree 三参数形态	三参 merge-tree 语义复核（base,branch,base 存疑），预检失效修参数序

• 颗粒：各单文件单点，一代理串 2-3 个（df-ai 网络域 ㉗+㉙+㉜ 一组；㉑ git 域单独评估）单轮自证。
• 其余（㉒ coordinator JoinSet panic 缺项、㉓ 清理吞错、㉔ 路由全禁用静默回落、㉕ plan_executor 假并行、㉖ namespace 上限突破、㉘ 未知 provider 回落、㉚㉛ usage/tool_use 缺省、㉝ model_probe 误判）挂池，专项或顺带修。

二、子代理增强线排期（依赖序）

现状锚点：事件 src-tauri .../ai/mod.rs:238 AiAgentFinished{agent_id, conversation_id=父, summary, status, rounds, tokens}；出口 agentic/sub_agent.rs:320 统一 emit；前端全仓 grep 零消费。子轨迹落库（V44 origin 列）已完成待提交。

步	内容	锚点/勘察点	验收标准
S1	AiAgentFinished 前端展示	新增消费点挂 useAiEvents 族；父会话内轻量卡（状态+轮数+tokens+summary 摘要）	父会话可见子代理完成卡；后台会话不串视图（带 conversationId 过滤）；Truncated/Failed 有区分样式；vue-tsc 0
S2	子代理审批挂起	勘察先行：sub_agent.rs grep「approval」零命中——子会话工具审批现状（trust 默认放行？）须先定语义再实施；事件路由复用 AiApprovalRequired 挂子 conv_id	子代理高危工具触发审批卡可批可拒；批准后子代理续跑、拒绝后 AiAgentFinished{status:"failed"} 优雅终止；依赖 3c pendingApprovals per-conv 合并先落
S3	轨迹调用树	数据源=origin='sub_agent' 落库轨迹（V44）+ Started/Finished 事件；父会话展示子代理列表，点击进子会话只读轨迹（复用会话加载链）	多子代理父会话树形可见；子会话消息可回看不可写；主列表不出现子会话（过滤已落地，回归验证）
S4	TaskDrawer 跳转	src/components/task/TaskDrawer.vue（Tasks.vue:388 挂载）加「关联会话」入口；勘察点：spawn_agent 是否已存 task→conv 关联字段，无则补	任务抽屉可跳转到关联会话并激活；无关联时入口隐藏不占位

依赖关系：S1 最轻可先派（建议等提交换装后，联调即跑真后端）；S2 依赖 3c 审批数组合并 + 勘察结论；S3 依赖 V44 提交换装（迁移落 origin 列）；S4 依赖 S3 的会话定位或独立勘察。文件域：S1/S3 前端 ai 组件族、S4 TaskDrawer.vue，互斥可并行；S2 前后端同碰，单独派。

三、专项债 / 待拍板（搬运 + 新观察）

搬运（源自下一批次规划§二/§四，不重复展开）：ai-router/sanitize 重构；run_agentic_loop 拆分（w4 已落地，职责边界评估窗口已到，可启动）；df-mcp 多进程 3P0；C1/C2/C3 知识线拍板；9-28#17 图片外域开源边界。

新观察（本轮 grep/走查增量）：

• 流式健壮性专项候选（P1-1 error 帧+㉙+㉜+㉚/㉛ 同家族）：分散修会反复开同类账，建议聚成小专项一次收口。优先级高——「无声截断/无终态」直接伤日常可用性。
• 子代理审批语义空白（S2 勘察前置项）：若现状为 trust 默认放行高危工具，属安全债，S2 优先级应升。
• save_conversation needs_full_rewrite 复核（走查报告「待下批核对」）：核查型半天任务，建议塞进 4a A1 组顺带核，不单开批次。
• ⑰ 测试恒零断言：成本低收益是资产保真，随 B2 顺带。

四、时序总览

时序	内容	状态	并行关系
T0	提交+换装（子轨迹落库+第一批六路+上下文管理批）	等用户令	阻塞其后的换装依赖项（S3 迁移、S1 联调）
T1	第二批 2c（删除域）+3c（UX 两代理）	可立即派工	2c/3c 互不碰可并行；2c 先于 4b-B4（chat.rs 互斥）
T2	批次4：4a（A1/A2+3 两代理）‖ 4b（B1/B2/B3 三代理）‖ 子代理线 S1	批次4 在第二批核查销账后	4a/4b 同 workspace 但不同 crate 文件域，可并行；S1（前端）与 4a/4b（后端）文件域互斥可并行
T3	批次4 收尾：4b-B4（chat.rs:810/:2112）+ 4c 按需（网络域组/git 域）	2c 后	单代理串修
T4	子代理线 S2（审批挂起，依赖 3c）→ S3（轨迹树）→ S4（TaskDrawer）	排队	S2 前后端同碰单独派；S3/S4 与批次4 后续可并行
T5	专项债/立项（run_agentic_loop 拆分评估、流式健壮性专项、大方向 3/5/6/8/9）	用户定优先级	各自立项设计先行

原则：提交换装点全程只有 T0 一处（攒批等令）；每批核查销账后再放下一批；同文件依赖（chat.rs、ai_tools.rs、conversation_repo.rs）已在组内吸收，跨批互斥仅 chat.rs（2c→B4）一处。

五、UX P2/P3 批与遗留池排期（2026-10-03 晚追加）

来源：三域 UX 走查（temp/UX走查-*-2026-10-03.md，P1×8 已当轮修复）+ 各批遗留登记。 经验蒸馏已沉淀：docs/01-技术文档/多代理流水线实战经验-2026-10-03.md。

UX-P2 批（换装后即派，4 路并行文件零交集）

路	内容	文件域
P2-chat	对话域 6 项：排队超时 computed 非响应式/队列静默清空提示/审批超时串扰/审批卡强拉滚动/等长切换不回底/编辑丢图	ChatInput/AiChat/aiShared/ToolCardList/MessageList
P2-conv	会话侧 4 项：筛选计数矛盾/失败气泡错配/键盘可达性（菜单 Esc）/搜索态重命名	ConversationSidebar 族
P2-task	任务侧 3 项：子任务 toast 文案错位/看板加载态/拖拽静默弹回提示	Tasks/TaskDrawer
P2-set	设置域 6 项：快捷键焦点守卫/主题跟随系统/顶栏切换语义/托盘首关提示/表单脏态拦截/密钥显隐	App.vue/TopBar/settings 族

P3 打磨批（P2 销账后，攒一批 24 项按域 2-3 路清）

遗留池归并

• F2 心跳前移（chat.rs/mod.rs 空窗已开，可并入任一后端批）
• removeGoal 回写（TopBar.vue:530）/streamingGuard 全局清 queue（多会话）→ 并入 P2-chat
• ⑥ update_field settings 白名单旁路（无调用方，低危）→ 4c 池
• S2-B 真审批通道（三批：挂起路径→resume 通道→超时前端）→ 等用户对产品语义拍板
• 4c 挂池 9 项（㉒㉓㉔㉕㉖㉘㉚㉛㉝）→ 按专项/顺带修归入后续

更新后时序

T0 提交换装（唯一等令点）→ UX-P2 批 4 路并行 → P3 打磨批 ‖ 4c 挂池 ‖ S3 轨迹树（依赖 T0）→ S4 TaskDrawer → 专项债/S2-B 按拍板。