mirror of
https://gitcode.com/JianFeeeee/homeagent-sdk.git
synced 2026-10-31 14:27:30 +00:00
28c162cf81
## 缺陷（用户实测反馈） 「commondev 无法取消正在运行的 session，agent 反馈它无法取消错误的 pi session，只能等它跑完。」 日志佐证：agent 在 09:07 收到 interrupt 请求后只能如实回答无法取消。 ## 根因不是"没实现取消"，而是取消能力从来没被暴露 pi 的 AgentSession **本身就有** abort()（agent-session.d.ts:598， "Abort current operation and wait for agent to become idle"）。 但 commondev 注册的 30 个工具里一个 cancel/stop 都没有， sidecar 也只有 ping/prompt/state/close 四个 method。 这是异步投递（2026-10-17）带来的新缺口：改动之前 prompt 是同步的， 调用方阻塞到任务结束，没有"中途要停"这个需求；改成异步投递后， 任务在后台长跑，用户却失去了停止它的手段。 ## 改动 **sidecar 三个平台各有各的取消方式：** pi → session.abort()（协作式中断，必须 await：不 await 会立刻 回"已中断"而实际还在跑 = 谎报成功） zcode → 整组杀掉当前回合的子进程（没有 abort API） spawn 时 detached=true 建了独立进程组，killTree 整组杀 **interrupt 语义如实回报：** interrupted=true 确实有任务在跑并被终止 interrupted=false 当时没有在跑的任务（不算错误） ok=false + error 该 CLI 没实现 / 调用失败 **三个收尾分支都清 currentChild**（timeout / error / close）： 不清的话 interrupt 会拿到已死的子进程去杀，或更糟 —— 误杀下一轮。 ## 判据（4 条 + 「不谎报」） · pi 的两个 sidecar 都有 interrupt 且用 await session.abort() · zcode 的 interrupt 真的 killTree 且用 currentChild · 三个 sidecar 无重复声明（我写的时候真撞了：zcode 已有 currentChild） · **不谎报成功**：sidecar 没跑 / CLI 没实现时必须 interrupted=false ## 变异验证 pi 删 interrupt case → 咬 pi 去掉 await → 咬（"会谎报已中断"） zcode 不 killTree → 咬（"只回 ok 不真杀"） ## 顺带 既有判据 TestEveryRegisteredToolHasHandler 立刻抓到我加了 RegisterTool 但没在 handlerFor 映射里登记 —— 它比我先发现漏了接线。
commondev
commondev plugin
Build
hmapdev build
Channels
入站与出站是分开登记的两件事：
| 方向 | API | 用途 |
|---|---|---|
| 入站 inputch | RegisterInputChannel(name, def) | 声明「谁会往这个通道注入输入」。凡是用 InjectText/InjectInput/InjectInterrupt*(source, "", ...) 注入的通道名都要登记** |
| 出站 output | RegisterOutputChannel(name, caps, desc, def, handler) | 声明 output_send__ 的回复发给谁；handler 收到 {payload,type,meta} |
def（ChannelDef）描述该通道在记忆计算层的行为：NoMemory: true = 该通道输入不进记忆； Cleaner = 计算层清洗后再向量化/提关键词（原文不改）。
只登记出站通道、却用同名通道注入输入时，内核会兜底登记同名 inputch 并在日志里告警。 兜底只为兼容老插件 —— 请显式登记，让「这是入站通道」成为插件的明确意图。
Install
Upload the .hmap file through the Plugin Manager API.