fix(bridges): 续谈失败静默 + duplicate_relay 静默挂死(两个都是「人那边什么都收不到」)

同一类问题在两个地方:出事的当下看不出来,表现是「信发出去了,然后再无音讯」。

## 1)pi 的续谈失败不回失败信(实测缺口)

模型侧 402(余额不足)时,**新会话**那条路会回一封「处理失败」,而**续谈**那条路
只写日志就 `throw` —— 发件人什么都收不到。邮件驱动的会话没有本地界面可以看,
没有这封信就等于静默挂死。复现条件很普通:往一条**已存在**的会话再发一封信。

修法与邻居一致:续谈失败也回失败信。但**不能复用**共用库的 `renderFailureReport`
——那段文案说「划定范围内的模型全部调用失败」并建议「调整可用模型范围」,
而续谈是**故意不降级**的(换模型=换会话=丢掉上下文,而上下文正是发件人指定
这条会话的原因)。照抄等于让人去调一个在这里无效的旋钮,他会去改配置,
然后发现依然失败。新增 `renderResumeFailure`:点明是续谈、附上游错误原文、
建议「确实要换模型就新建一条会话」。

**活体验证**(模型侧仍是 402,失败本身就是测试条件):发一封进 pi 的已有会话,
5 秒内收到失败信,内容含 402 原文且不再出现「调整模型范围」。

顺带把 pi 里 2 处没 clamp 的 relay_key 收敛(上一轮审计只看了权限键)。

## 2)duplicate_relay:只有 zcode 认,另三桥会等一个永远不会来的决策

网关对重复的 relay_key 回 **HTTP 200 `{status:"duplicate_relay"}` 并提前返回**:
不建请求、不发邮件、**永远不会有人来决策**。zcode 桥认它并当场失败,而
pi/opencode/dsh 把它当成功,接着等 `permission_decision` 事件 —— pi 那句
`await new Promise(...)` 连超时都没有。这是 zcode 上一轮那个缺陷的同类,
只是发生在另三个桥上。

- `lib/relay-key.js`(**共用**,四处逐字节同源)新增 `isDuplicateRelay` /
  `DUPLICATE_RELAY_STATUS`:它长得像成功(200),所以必须单独认;对「发信」
  那一侧重复就该当成功(幂等),但对「等一个决定」那一侧它与故障后果相同。
- pi / opencode / dsh 三桥在权限转发处接上判据并**当场拒绝**
  (各自用自己的拒绝形状:`block: true` / `output.status = "deny"` / `'rejected'`)。
- zcode 里那份本地实现收敛到共用库(同一判据不该有两个定义)。

## 3)新增接线断言(带判据自检)

`test/permission-forward-wiring.test.mjs`(pi/opencode/dsh 三份同一内容):
纯函数测试对这类缺口天生无能为力(函数是对的,只是没人调用它),所以它读源码
验形态,钉住「判据在、落在权限转发这条路上、给出本桥形状的拒绝」。

三条自检都在写的过程中抓到了我自己的错:
- 第一次 `ROOT` 算错 → 过滤后 0 个桥、循环全不跑而「全绿」→ 加了
  「找不到装着各桥的目录就判红」;
- 顺序判据写成「在文件里最早的 await 之前」,量到了别处的等待 → 三桥全红,
  改成「必须在上报之后」;
- dsh 是**两段式**(`.then` 里抛、`catch` 的 `duplicateRelay` 分支里拒),
  第一版抽取套错了分支 → 永远找不到 `return 'rejected'`。
扰动验证:把 pi 的判据禁用后该条变红,还原即绿(改动前后都核对了字节数)。

而 dsh 那条也暴露了:我把返回形状写成了 opencode 的 `{status:'deny'}`,
**`tsc` 没报错**(返回类型是宽联合),只有对着邻居读才发现 DSH 要的是
`'rejected'` 字符串 + `noteDenial`。

## 4)部署脚本:zcode 分支现在会重启驱动

`redeploy-plugin.sh` 的 zcode 分支只切软链(宿主是 ZCode 应用,不能重启它),
但**驱动是我们自己的 unit** —— 不重启它,进程里跑的还是切换前的代码。
这个由刚写的 `check-deploy-drift.mjs` 当场抓到(它比进程启动时刻与软链切换时刻),
而当时所有其它检查都是绿的。已补上重启并验证。

## 复查

四桥全量 413 / 321 / 370 / 380 全绿;共用库四方同源;部署漂移四项全通过;
四桥真发真收冒烟(dsh/opencode/zcode 正常回信;pi 因模型侧 402 回失败信 ——
这正是上面第 1 条要修的路径)。

另:写这段时踩到一个自伤 —— 用 `npx asar extract-file <asar> dist/index.html`
检查包内容时,它把文件**写进了 cwd**,正好覆盖掉 Vite 的源码模板
`client/electron/index.html`(下次构建会拿被污染的模板去构建)。已还原并重建,
产物哈希与之前一致。要看 asar 内容请用 `@electron/asar` 的 API(返回 Buffer),
别用这个 CLI 子命令。
This commit is contained in:
2026-09-12 23:13:48 +08:00
parent b53afd4523
commit 630b5bfdd7
19 changed files with 1157 additions and 38 deletions

View File

@ -28,7 +28,7 @@ import {
replyInstruction,
inboundHeadline,
} from '../lib/relay-policy.js';
import { clampRelayKey, isPermanentFailure } from '../lib/relay-key.js';
import { clampRelayKey, isPermanentFailure, isDuplicateRelay } from '../lib/relay-key.js';
import { BoundedMap, BoundedSet, MAX_TRACKED_MAILS, MAX_TRACKED_SESSIONS } from '../lib/bounded.js';
import {
userMessage,
@ -1737,23 +1737,54 @@ export function apply(ctx: any, config: PluginConfig): void {
// 无人可问则 409。插件若把来信人当决策人Agent 之间转派任务时
// A 把活分给 B权限邮件会发给 Agent 自己 —— Agent 不可能在界面上点
// 「同意」,于是下面那个 await 永不 resolve会话无声挂死。
await client.post('/permission/request', {
question: `请求执行 ${req.toolName}`,
options: ['同意', '拒绝'],
context: [
`工具:${req.toolName}`,
req.callId ? `调用 ID${req.callId}` : '',
req.reason ? `理由:${req.reason}` : '',
// 决策人未必是这条会话的参与者Agent 转派出来的会话,人从没见过它),
// 只给工具名无从判断得说明这活是谁派的、为的什么事B-8.4)。
mctx?.subject ? `触发任务:${mctx.subject}` : '',
mctx?.replyTo ? `任务来自:${mctx.replyTo}` : '',
].filter(Boolean).join('\n'),
session_id: mailSessionID,
relay_key: relayKey,
});
} catch (e: any) {
// 409 = 服务端已判定这条任务链上没有人类,永远不会有人来点头。
await client.post('/permission/request', {
question: `请求执行 ${req.toolName}`,
options: ['同意', '拒绝'],
context: [
`工具:${req.toolName}`,
req.callId ? `调用 ID${req.callId}` : '',
req.reason ? `理由:${req.reason}` : '',
// 决策人未必是这条会话的参与者Agent 转派出来的会话,人从没见过它),
// 只给工具名无从判断得说明这活是谁派的、为的什么事B-8.4)。
mctx?.subject ? `触发任务:${mctx.subject}` : '',
mctx?.replyTo ? `任务来自:${mctx.replyTo}` : '',
].filter(Boolean).join('\n'),
session_id: mailSessionID,
relay_key: relayKey,
}).then((accepted: any) => {
// ★ 幂等命中:网关回 200 `{status:"duplicate_relay"}` 并**提前返回** ——
// 没有产生新的询问,也永远不会有人来决策,而下游只等
// `permission_decision` 事件。不认它的代价是静默挂死
// (与上面那个「把权限邮件发给 Agent 自己」是同一个后果,不同成因)。
// 详见 lib/relay-key.js 的 isDuplicateRelay。
if (isDuplicateRelay(accepted)) {
console.error(
`[dsh-mail-bridge] 权限询问被判为重复 ${relayKey},本次没有产生新请求`
);
throw Object.assign(new Error('duplicate_relay'), { duplicateRelay: true, relayKey });
}
});
} catch (e: any) {
// 幂等命中(键重复)与 409无人可问都是「永远不会有人来决策」
// 必须当场表态;两者的原因文案不同,但落点一致:不能 `return next()`。
if (e?.duplicateRelay) {
console.error(
`[dsh-mail-bridge] 权限询问被判为重复 ${relayKey},本次没有产生新请求`
);
// 原因走 noteDenialDSH 把 approval 的 'rejected' 翻译成 dsh-tools 里
// 写死的一句「the user rejected tool X」而这里**没有任何用户拒绝过它**。
// 与上面 409 / 4xx 两条分支同一手法。
noteDenial(agentId, req.callId, [
`这个授权询问之前已经发过一次key=${relayKey}),本次没有产生新的询问。`,
'可能原因:插件重启后重放同一轮,或上一次询问已经有人决定过但这个决策没有回到这里。',
'请改用不需要授权的方式完成,或在回信里说明需要人工执行哪一步。',
].join('\n'));
// 返回 DSH 的 ApprovalOutcome而不是某个对象 —— 这里与 409 / 4xx
// 两条分支一致(写成对象能被 tsc 放过,因为返回类型是宽联合,
// 但 DSH 会把它归一化成 'unavailable',拒绝就变成了“不可用”)。
return 'rejected';
}
// 409 = 服务端已判定这条任务链上没有人类,永远不会有人来点头。
//
// 不能 `return next()`:下一个 answerer 是本地 UI而邮件驱动的会话
// 根本没有 UIwaterfall 跑到尾以后依旧无人应答 —— 这正是生产事故