[yeshilei-QWQ]

摘要 (Summary)

本 PR 修复了当前活跃存在的 5 项关键生命周期与并发稳定性缺陷（#429, #430, #431, #432, #385），并附带全量针对性单测与全量构建验证证据。

---

修复问题与变更详情 (Changes & Fixes)

1. fix(coordinator): 顶层并发 delegate_batch 批级表隔离 ([bug] 顶层 delegate_batch 并发时 order.id 碰撞，批级共享表跨批互删/污染 #429)

   • 问题: 当顶层调用并发执行 delegate_batch 时，两批内相同 order.id（如 batch:0）发生碰撞，导致 batchPrewarmByOrder、batchStigmergyByOrder、policyCancelledIds 与 orderControllers 跨批互相覆盖/删除。
   • 修复: 在保持 order.id 外部展示与 dependsOn 解析稳定的前提下，引入内部隔离键 orderDispatchKey(order) 索引批级私有状态表，防止并发互相干扰。
   • 测试: src/agent/__tests__/coordinator-concurrency-tables.test.ts

2. fix(agent): 看门狗误杀 rescue 后重置 abortController 与状态同步 ([bug] P7 watchdog ghost-abort rescue 结构性失效：rescue 后本轮仍被立即再中止 #430)

   • 问题: P7 watchdog ghost-abort rescue 后，abortController.signal.aborted 仍然为 true，后续步骤（如 compaction）立刻被中止；且未检查是否为用户显式 Esc 中止。
   • 修复: 区分看门狗超时中止与用户主动 Esc；仅在看门狗误杀且用户未主动 abort 时执行 rescue，重置 abortController 并清理看门狗中止标志位。
   • 测试: src/agent/__tests__/ghost-abort-rescue.test.ts

3. fix(turn-orch): 清理工具批 abort drain 泄漏定时器 ([bug] 工具批 abort drain 竞速定时器不 clear 也不 unref（同类先例 #184） #431)

   • 问题: 工具批中止 drain 定时器既未 unref() 也未在批完成时 clearTimeout，导致定时器堆积并拖慢进程退出高达 6s。
   • 修复: 对 drain 定时器添加 drainTimer.unref?.()，并在 Promise 结算的 finally 块中执行 clearTimeout(drainTimer)。

4. fix(mcp): MCP close 失败时保留连接登记供退出兜底清理 ([bug] MCP 连接 close 失败路径被提前摘除登记，子进程沦为孤儿 #432)

   • 问题: shutdownServer 等在 transport.close() 失败时提前将连接从 connections Map 中移除，导致进程退出阶段 killChildrenSync() 无法感知失败连接的僵尸子进程。
   • 修复: 调整清理逻辑，仅当 transport.close() 成功后才从 this.connections 移除；若异常则保留在表中，并设置 suppressReconnect，由 killChildrenSync() 在退出阶段兜底强杀。
   • 测试: src/mcp/__tests__/manager-close-failure.test.ts

5. fix(skills): 兼容 Windows 反斜杠 SKILL.md 路径解析 ([bug] Windows 技能快照构建全线失败：endsWith('/SKILL.md') 正斜杠恒假导致 Missing linked skill resource（v3.29.0） #385)

   • 问题: Windows 下 current.path.endsWith('/SKILL.md') 因路径分隔符为 \ 导致恒为 false，技能资源包扫描失败。
   • 修复: 改用 basename(current.path) === 'SKILL.md' 进行跨平台路径判定。
   • 测试: src/skills/__tests__/skill-windows-path.test.ts

---

测试与验证证据 (Test Evidence)

• 新增/针对性单测: 全部通过 (6/6 PASS)
  • src/skills/__tests__/skill-windows-path.test.ts ✔
  • src/mcp/__tests__/manager-close-failure.test.ts ✔
  • src/agent/__tests__/coordinator-concurrency-tables.test.ts ✔
  • src/agent/__tests__/ghost-abort-rescue.test.ts ✔
• 子系统集成回归测试:
  • npm test -- src/mcp/__tests__/ src/skills/__tests__/: 233/233 PASS (0 failed)
• 编译与构建:
  • npm run build: Build success in 6079ms (dist 包、Native 模块与 runtime checks 全绿)
  • npm run typecheck: Typecheck clean (pre-push hook 自动化校验通过)

[huiliyi37]

已通过 sync 流程合入 dev，感谢 @yeshilei-QWQ 的贡献 🎉

本 PR 的改动（fix: batch concurrency (#429), ghost-abort rescue (#430), drain timer leak (#431), MCP orphan process (#432) and Windows skill path (#385)）已经 sync 流程合入主仓（本次 sync），并已收录进 CONTRIBUTORS.md。

按仓库的双仓流程，公开仓 PR 不经 merge 按钮合入（保持 dev 主仓唯一事实源），现以 sync-merged 标记关闭。欢迎继续贡献！