mirror of
https://gitcode.com/JianFeeeee/homeagent-sdk.git
synced 2026-10-31 14:27:30 +00:00
fix(commondev): 投递任务改成真异步,不再同步等 pi 跑完
## 缺陷(用户质疑"投递不就是发一条消息"后实测确认)
`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 超时。
This commit is contained in:
@ -311,6 +311,25 @@ type ToolDef struct {
|
||||
// 判据优先级:**Serial 胜出**。显式声明"必须串行"不允许被
|
||||
// ParallelSafe 或任何默认值覆盖。
|
||||
Serial bool `json:"serial,omitempty"`
|
||||
// Timeout 声明本工具单次执行允许的最长时间(如 "2m"、"90s")。
|
||||
//
|
||||
// ★ 为什么需要它(2026-10-17 生产实测):
|
||||
// 内核在 agent/core/toolcall.go 里有一个**写死的 60s** 外层上限。
|
||||
// 它与工具自己的超时配置**互相矛盾**且内层形同虚设:
|
||||
// · cmd_run 有 timeout 参数(默认 30s,可传 "2m"),agent 真的传了
|
||||
// 130s 级的值,但外层 60s 先到 ⇒ 工具自己的设置完全不生效
|
||||
// · healthcheck 声明默认 120s ⇒ 被砍掉一半
|
||||
// · 向开发线投递用的 output_send__* 天然是长任务(子 pipeline 执行)
|
||||
// 实测后果:工具被内核掐断,模型看到「执行超时(60秒)」,
|
||||
// 只能换更小的任务重试 —— 而真正的问题是内核没给它足够时间。
|
||||
//
|
||||
// 为零值时的行为:留空 = 用内核默认(60s)。存量插件不改一行,
|
||||
// 行为与改动前逐字一致。声明它是**责任**:写长了要确保工具真能收敛,
|
||||
// 否则会把"卡死"拖得更久。
|
||||
//
|
||||
// 内核会取 min(声明值, 内核硬上限 10m):防止插件声明成 0(无限)
|
||||
// 或荒唐的大值把队列堵死。
|
||||
Timeout string `json:"timeout,omitempty"`
|
||||
}
|
||||
|
||||
// IOInjector provides methods for injecting input and interrupts into the agent pipeline.
|
||||
@ -480,6 +499,7 @@ type PluginSDK struct {
|
||||
rawFiles RawFilesAPI
|
||||
events EventSubscriber
|
||||
plgMgr PluginMgrAPI
|
||||
kernelCtl KernelControlAPI
|
||||
|
||||
// proxyReg 是反代声明的注册回调(内置插件经 RegisterProxy 声明服务)。
|
||||
// 与上面的 API 字段同受 apiMu 保护——写方是内核注入,读方是插件 Start
|
||||
@ -823,6 +843,25 @@ func (s *PluginSDK) PluginMgr() PluginMgrAPI {
|
||||
return s.plgMgr
|
||||
}
|
||||
|
||||
// SetKernelControlAPI sets the kernel control API (restart/shutdown).
|
||||
// Called by the bridge at startup; nil means "not available".
|
||||
func (s *PluginSDK) SetKernelControlAPI(k KernelControlAPI) {
|
||||
s.apiMu.Lock()
|
||||
s.kernelCtl = k
|
||||
s.apiMu.Unlock()
|
||||
}
|
||||
|
||||
// KernelControl returns the kernel control API (restart / shutdown).
|
||||
//
|
||||
// 可能为 nil(宿主没接这条通道,或插件没有 kernel-control 能力组)。
|
||||
// 调用方必须判 nil —— 拿到 nil 时应当如实告知用户"当前环境不支持",
|
||||
// 而不是假装点了没反应的按钮还能用。
|
||||
func (s *PluginSDK) KernelControl() KernelControlAPI {
|
||||
s.apiMu.RLock()
|
||||
defer s.apiMu.RUnlock()
|
||||
return s.kernelCtl
|
||||
}
|
||||
|
||||
// ---- IO Convenience Methods ----
|
||||
|
||||
// injector 取当前 injector 的快照。
|
||||
|
||||
Reference in New Issue
Block a user