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:
JianFeeeee
2026-10-18 06:39:24 +08:00
parent 81a3efa4df
commit 4387e12ca8
7 changed files with 342 additions and 18 deletions

View File

@ -65,6 +65,8 @@ try {
let session;
let started = false;
// inflight 是**已受理但未完成**的 prompt 数(异步投递后用于观测与优雅退出判断)
let inflight = 0;
async function ensureSession() {
if (session) return session;
@ -114,13 +116,52 @@ async function handle(method, params) {
const text = params?.text ?? "";
const want = params?.session_id || sessionId;
const s = await ensureSession();
await s.prompt(text);
// ★★ 投递语义(2026-10-17 修):立即返回"已受理",不等 pi 跑完。
//
// 原实现是 `await s.prompt(text)` —— 同步等整个任务结束再返回。
// 而 pi 开工程线干活(克隆/改代码/跑测试)要几十秒到几分钟,
// 于是内核的 60s 工具超时先到,用户看到「执行超时(60秒)」,
// 而任务其实还在正常跑。通道的语义是"**投递**任务",不是"等完成"。
//
// 现在:prompt 在后台跑;跑完后用 **主动通知**(id=0)把结果推回
// Go 侧,由 deliverToPi 注册的 onNotify 注入回 agent(走 inputch)。
const got = s.sessionId ?? s.id ?? want ?? null;
// 记录在途数量,供 state 查询
inflight++;
(async () => {
try {
await s.prompt(text);
const reply = s.getLastAssistantText ? s.getLastAssistantText() : "";
send({
jsonrpc: "2.0",
id: 0, // ★ 0 = 主动通知(Go 侧 readLoop 按此分派)
result: {
event: "prompt_done",
session_id: s.sessionId ?? s.id ?? got ?? null,
reply: String(reply || "").slice(0, 4000),
},
});
} catch (e) {
send({
jsonrpc: "2.0",
id: 0,
result: {
event: "prompt_error",
session_id: got,
error: String((e && e.message) || e),
},
});
} finally {
inflight--;
}
})();
return {
ok: true,
status: "accepted", // ★ 明确:已受理,未完成
// ★ 必须回报 session_id:Go 侧据此断言「会话漂移」
session_id: got,
reply: s.getLastAssistantText ? s.getLastAssistantText() : "",
};
}
case "state": {