mirror of
https://gitcode.com/JianFeeeee/homeagent-sdk.git
synced 2026-10-31 14:27:30 +00:00
4387e12ca8
## 缺陷（用户质疑"投递不就是发一条消息"后实测确认）
`deliverToPi` 的注释写着"把给 pi 发消息包装一下"，但实际是：
await s.prompt(text) // 同步等 pi 把**整个任务**跑完
而 pi/zcode 开工程线干活（克隆/改代码/跑测试）要几十秒到 20 分钟。
生产日志实测两次：
23:04:03 executing tool: output_send__commondev_br-...
23:05:03 ★ timed out after 60s
通道的语义是"**投递**任务"（见 outputch 描述），不是"等完成"。
把它实现成同步等待，就必然撞上内核的 60s 工具超时。
★ 我一开始的诊断是错的：以为"超时值太小"，给 output_send 声明了 3m
—— 那是掩盖症状。投递本该瞬时返回，慢是 bug 不是需求。已撤回。
## 改动
投递 → 立即回 status=accepted（瞬时）
→ pi 在后台跑
→ 跑完推**主动通知**（id=0）
→ Go 侧 onNotify 经 inputch 注入回 agent
`sidecar.go` 的 readLoop 里早就留好了这个扩展位：
if resp.ID == 0 { // 主动通知（暂未使用，保留扩展位）
现在接上了 `makePromptNotifier`。
pi 与 zcode 两份 sidecar.mjs 都改了（rawfile/ 里那两份同步更新）。
## 判据抓到我三次（都是真问题）
1. `TestSidecarScriptShipsWithPackage`：rawfile/ 与工程根不一致
—— 我只改了根那份
2. `TestZcodeMissingCLIErrorIsActionable`：`inflight is not defined`
—— zcode 版用了未声明变量
3. 同一条判据随后**卡死 2 分钟**：CLI 不存在本该立刻报，异步后错误
被吞进后台通知 ⇒ 用户先收到"已受理"、几秒后才知道配置错。
改成**受理阶段就校验 CLI**（配置错是立刻可判定的，不该推迟）。
判据还逼我保住语义：原 `TestZcodeSidecarArgvBehavior` 断言首轮拿到
真实 `sess_` id，异步后要到完成通知里才有 —— 断言保留、改从通知取，
没有削弱。
## 真机 e2e（三条全过，都要求真改工程文件）
TestZcodeFullPipeline 42.1s
TestZcodeOverSSH 72.4s
TestZcodeOverSSHWithPerHostEndpoints 75.1s
受理现在是瞬时的 ⇒ 内核工具不会再 60s 超时。
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.