JianFeeeee d9c2e51f61 fix(agent): cancel 停不下调度循环 —— 队列非空时永远不看 ctx.Done ...

## 缺陷（真缺陷，不是测试问题）

`schedulerLoop` 只在"队列空"的分支里 select `ctx.Done()`：

	if kind == nextNone {
		select { ... case <-a.ctx.Done(): return }
	}

于是**只要队列里有任务，循环就永远不看 ctx.Done** —— 一直取、一直执行，
直到队列被取空才可能退出。

生产后果（`reclaim` / `destroy`）：销毁流程先回收残余任务、再销毁子。
而回收到销毁之间子仍在运行，继续把队列里的任务取走执行 —— 那些任务的
结果**永远无人认领**（子随即被销毁），且日志无痕迹：既不在"残余清单"里，
也没跑到出结果。带 ResponseCh 的同步调用方（cli/a2a）更糟：Stop 的
drainPendingInterrupts 给它补一个 "skipped"，用户看到"已跳过"，
而任务其实执行过。

## 修法

1. `schedulerLoop` 循环顶部（**取任务之前**）检查 ctx.Done。
2. 新增 `waitSchedulerStopped`：cancel 之后等 running 归零（上限 5s，
   超时如实记日志，不让控制面永久挂住）。
3. 新增 `FinishResident`：停止调度 → 回收残余 → 处置 → 收割记忆 → 销毁，
   **一步完成**，消除"取完到销毁"之间的窗口。`reclaim` / `destroy` 改走它。
4. 记忆收割抽成 `harvestResidentMemory`，供 FinishResident 的 onDestroy 复用
   （必须在 Destroy 之前 —— Destroy 会关掉 temp）。

## 判据（2 条，都做了"撤销修复必须变红"的验证）

 · TestSchedulerStopsTakingTasksAfterCancelWithNonEmptyQueue
   用阻塞 provider 把循环钉在 executeNewTask 里，此时塞 5 条进队列、
   cancel、放行。修复在位 ⇒ 5 条一条都不执行；撤销修复 ⇒ 取走 5 条。
   **实测撤销后报「仍取走了 5 条（剩 0/5）」，恢复后 10/10 绿。**
 · TestFinishResidentIsAtomic
   断言返回后子已从登记表移除（销毁确实在同一事务内完成）。

原 flaky 的 TestResidualKeepReturnsTasksToParent 与
TestResidualDropNotifiesSyncCaller 也修了：先 cancel + 等静止再入队，
得到确定的初始状态（它们验的是转交逻辑，不是子的生命周期）。30/30 绿。

## 我踩过的两条弯路（都写进判据注释了）

1. 加 `scheduler.freeze` 绕过。错在：调度器本来就有停止语义（ctx），
   再引入一个状态位会让"谁负责停"含糊，且忘了解除就永久僵住。已删。
2. 判据第一版写成「先 Start、再 cancel、然后入队」—— 那时队列是**空的**，
   循环正好走 nextNone 看到 ctx.Done 退出，于是**撤掉产品修复判据依然
   30/30 全绿**。是用户追问"凭什么说修好了"才发现这是假绿。
   必须造出"队列非空时 cancel"这个确切场景才测得到。

2026-10-18 13:07:40 +08:00

..

agent_functions_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

agent_helpers_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

agent_tools_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

agent.go

feat: 模块化内核（编译期依赖图定序）+ 密钥防火墙 + 插件三态生命周期 (#10)

2026-10-17 19:18:24 +08:00

argvalidate_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

argvalidate.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

builtin_toolapi_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

builtin_toolapi.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

comefrom_test.go

feat: 模块化内核（编译期依赖图定序）+ 密钥防火墙 + 插件三态生命周期 (#10)

2026-10-17 19:18:24 +08:00

comefrom.go

feat: 模块化内核（编译期依赖图定序）+ 密钥防火墙 + 插件三态生命周期 (#10)

2026-10-17 19:18:24 +08:00

commondev_premise_test.go

feat: 模块化内核（编译期依赖图定序）+ 密钥防火墙 + 插件三态生命周期 (#10)

2026-10-17 19:18:24 +08:00

context_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

context_tuning_test.go

feat: 模块化内核（编译期依赖图定序）+ 密钥防火墙 + 插件三态生命周期 (#10)

2026-10-17 19:18:24 +08:00

context.go

feat: 模块化内核（编译期依赖图定序）+ 密钥防火墙 + 插件三态生命周期 (#10)

2026-10-17 19:18:24 +08:00

crossmodal.go

feat: 模块化内核（编译期依赖图定序）+ 密钥防火墙 + 插件三态生命周期 (#10)

2026-10-17 19:18:24 +08:00

device_tool_auth_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

distill.go

feat: 模块化内核（编译期依赖图定序）+ 密钥防火墙 + 插件三态生命周期 (#10)

2026-10-17 19:18:24 +08:00

emitresponse_e2e_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

emitresponse_usage_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

encshell_premise_test.go

feat: 模块化内核（编译期依赖图定序）+ 密钥防火墙 + 插件三态生命周期 (#10)

2026-10-17 19:18:24 +08:00

encshell_redundancy_test.go

feat: 模块化内核（编译期依赖图定序）+ 密钥防火墙 + 插件三态生命周期 (#10)

2026-10-17 19:18:24 +08:00

eventloop.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

firewall_e2e_test.go

feat: 模块化内核（编译期依赖图定序）+ 密钥防火墙 + 插件三态生命周期 (#10)

2026-10-17 19:18:24 +08:00

gpttest_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

graphmedia_test.go

test(memory)!: 块 union 化判据重写（CAS 淘汰第二阶段：测试）

2026-10-12 14:26:13 +08:00

graphmedia.go

refactor(memory)!: 块 union 化，彻底淘汰 CAS 第一阶段（生产代码）

2026-10-12 10:13:36 +08:00

inplace_scrub_test.go

feat: 模块化内核（编译期依赖图定序）+ 密钥防火墙 + 插件三态生命周期 (#10)

2026-10-17 19:18:24 +08:00

inputch_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

inputch.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

inputroute_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

inputroute.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

inputunify_test.go

test(memory)!: 块 union 化判据重写（CAS 淘汰第二阶段：测试）

2026-10-12 14:26:13 +08:00

leakback_test.go

feat: 模块化内核（编译期依赖图定序）+ 密钥防火墙 + 插件三态生命周期 (#10)

2026-10-17 19:18:24 +08:00

lightprofile_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

medialive_test.go

test(memory)!: 块 union 化判据重写（CAS 淘汰第二阶段：测试）

2026-10-12 14:26:13 +08:00

medialoop_test.go

test(memory)!: 块 union 化判据重写（CAS 淘汰第二阶段：测试）

2026-10-12 14:26:13 +08:00

medialoop.go

feat: 模块化内核（编译期依赖图定序）+ 密钥防火墙 + 插件三态生命周期 (#10)

2026-10-17 19:18:24 +08:00

mediaref_test.go

test(memory)!: 块 union 化判据重写（CAS 淘汰第二阶段：测试）

2026-10-12 14:26:13 +08:00

mediaref.go

refactor(memory)!: 块 union 化，彻底淘汰 CAS 第一阶段（生产代码）

2026-10-12 10:13:36 +08:00

memory_scrub.go

feat: 模块化内核（编译期依赖图定序）+ 密钥防火墙 + 插件三态生命周期 (#10)

2026-10-17 19:18:24 +08:00

memorycommit_count_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

memoryface.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

memorypass_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

memorypass.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

modalfallback_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

modalfallback.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

multimodal_departed_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

offload_test.go

fix(agent): cancel 停不下调度循环 —— 队列非空时永远不看 ctx.Done

2026-10-18 13:07:40 +08:00

offload.go

refactor(config): 默认值单一来源 —— ConfigDef.Default，不再各调用点重复硬编码

2026-10-18 10:16:53 +08:00

output_grant_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

output_rules_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

output.go

feat: 模块化内核（编译期依赖图定序）+ 密钥防火墙 + 插件三态生命周期 (#10)

2026-10-17 19:18:24 +08:00

overflow_test.go

feat: 模块化内核（编译期依赖图定序）+ 密钥防火墙 + 插件三态生命周期 (#10)

2026-10-17 19:18:24 +08:00

overflow.go

feat: 模块化内核（编译期依赖图定序）+ 密钥防火墙 + 插件三态生命周期 (#10)

2026-10-17 19:18:24 +08:00

parallelsched_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

persist_leak_test.go

feat: 模块化内核（编译期依赖图定序）+ 密钥防火墙 + 插件三态生命周期 (#10)

2026-10-17 19:18:24 +08:00

persona_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

persona.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

plugin_health.go

fix(llm): 参数无法解析时给出真因，不再静默丢弃整条调用

2026-09-19 16:49:16 +08:00

plugin_tools_service_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

plugins.go

feat: 模块化内核（编译期依赖图定序）+ 密钥防火墙 + 插件三态生命周期 (#10)

2026-10-17 19:18:24 +08:00

preempt_logging_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

process.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

prompt_parallel_test.go

feat(prompt): 提示词声明「同轮默认并行」及其例外（阶段 2.5）

2026-09-27 11:55:33 +08:00

promptvars_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

prunepolicy_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

prunequery_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

queue_access_test.go

test(agent/core): 消除测试对 scheduler.queue 的无锁直读，并加判据防回归

2026-10-06 09:22:12 +08:00

recallpolicy_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

resident_output_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

resident_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

resident_tools.go

fix(agent): cancel 停不下调度循环 —— 队列非空时永远不看 ctx.Done

2026-10-18 13:07:40 +08:00

resident.go

fix(agent): cancel 停不下调度循环 —— 队列非空时永远不看 ctx.Done

2026-10-18 13:07:40 +08:00

residual_freeze_test.go

fix(agent): cancel 停不下调度循环 —— 队列非空时永远不看 ctx.Done

2026-10-18 13:07:40 +08:00

scene_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

scenemerge_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

scenepolicy_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

scheduler_channel_routing_test.go

refactor(core)!: N0 无状态化 —— 删除 Agent.currentOutputChannel，通道只跟输入事件/帧走

2026-09-13 08:59:15 +08:00

scheduler_critical_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

scheduler_e2e_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

scheduler_kernel_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

scheduler_preempt_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

scheduler_rearm_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

scheduler_regression_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

scheduler_stack_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

scheduler_starvation_test.go

feat(scheduler)!: 中断/排队两类别模型 + 插件声明 L1-L3、L4 内核独占

2026-09-13 07:00:51 +08:00

scheduler_stress_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

scheduler_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

scheduler.go

fix(agent): cancel 停不下调度循环 —— 队列非空时永远不看 ctx.Done

2026-10-18 13:07:40 +08:00

secret_tools_test.go

feat: 模块化内核（编译期依赖图定序）+ 密钥防火墙 + 插件三态生命周期 (#10)

2026-10-17 19:18:24 +08:00

secret_tools.go

feat: 模块化内核（编译期依赖图定序）+ 密钥防火墙 + 插件三态生命周期 (#10)

2026-10-17 19:18:24 +08:00

security_concurrency_test.go

feat: 模块化内核（编译期依赖图定序）+ 密钥防火墙 + 插件三态生命周期 (#10)

2026-10-17 19:18:24 +08:00

spawn_replenish_test.go

fix(spawn): 子 Agent 报告如实 + 跑满预算不再丢弃成果 + 提示词补执行纪律

2026-10-08 10:40:53 +08:00

spawn_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

spawn.go

fix(spawn): 子 Agent 报告如实 + 跑满预算不再丢弃成果 + 提示词补执行纪律

2026-10-08 10:40:53 +08:00

stage.go

feat: 模块化内核（编译期依赖图定序）+ 密钥防火墙 + 插件三态生命周期 (#10)

2026-10-17 19:18:24 +08:00

stages_plugin_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

stages_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

stages_tooldef_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

stages.go

feat: 模块化内核（编译期依赖图定序）+ 密钥防火墙 + 插件三态生命周期 (#10)

2026-10-17 19:18:24 +08:00

status_onnx_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

status_usage_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

status.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

stop_semantics_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

stream_accumulate_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

stream_flush_order_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

stream_index_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

task_lifecycle_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

task_terminal_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

task_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

task.go

feat: 模块化内核（编译期依赖图定序）+ 密钥防火墙 + 插件三态生命周期 (#10)

2026-10-17 19:18:24 +08:00

terminal_registry_test.go

refactor(terminal): 内核开终端/命令历史权威视图，WebUI 与 CLI 都改接内核

2026-09-17 18:56:15 +08:00

terminal_registry.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

tokenbudget_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

tokenbudget.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

tokenusage_merge_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

tool_timeout_test.go

fix(agent): 工具超时不再一刀切 60s，支持工具自声明与按参数推导

2026-10-18 06:38:51 +08:00

toolapi_auth_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

toolbatch_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

toolcall_adjacency_test.go

fix(agent): 批内附加消息延迟到整批落完，修复上游 tool_calls 配对 400

2026-10-13 16:18:13 +08:00

toolcall_block_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

toolcall_error_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

toolcall.go

fix(agent): 工具超时不再一刀切 60s，支持工具自声明与按参数推导

2026-10-18 06:38:51 +08:00

tooldefs.go

fix(agent): 工具超时不再一刀切 60s，支持工具自声明与按参数推导

2026-10-18 06:38:51 +08:00

toolerror_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

toolerror.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

tooloop_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

toolresult_budget_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

toolresult_budget.go

merge: 整合 main（设备桥能力对齐 + 公开仓库清理 + 记忆块体系） (#2)

2026-10-05 11:25:20 +08:00

toolresult_scrub_test.go

feat: 模块化内核（编译期依赖图定序）+ 密钥防火墙 + 插件三态生命周期 (#10)

2026-10-17 19:18:24 +08:00

usagestats_test.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

usagestats.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

utils.go

chore(module): Go module 路径随托管地迁移 gitcode → github

2026-10-08 10:40:17 +08:00

zz_timeout_helper_test.go

fix(agent): 工具超时不再一刀切 60s，支持工具自声明与按参数推导

2026-10-18 06:38:51 +08:00