JianFeeeee
f321380fa3
## relay 死循环防护（两道防线） ### 主防线：免配额只给发往人类的 relay（handler/mail.go） 原设计：relay 走免配额通道（harness 搬运不该算模型自主发信）。 问题：收件方是另一个同样会自动转发的 Agent 时，整个回路里没有任何 一处在计数——生产上跑出过 41 封（会话 f3d824ce），间隔从 15 分钟 缩到 5 秒，且用了 37 封才烧掉 4/20 预算。 改为：repo.IsHumanUser(to.Name) 判定。Agent→Agent 的 relay 照样扣预算。 顺带修次序问题：原来是「先占幂等键再扣预算」，预算耗尽时幂等键 已被占用，加了额度也无法重发。现在预算失败会 ReleaseRelay 还回去。 ### 兜底：hop_limit 列接通（repo/relayhops.go） schema 里早有 hop_limit INT DEFAULT 5，从未有代码读它。 CountTrailingRelayHops 从最新邮件往前扫，遇到第一封非 relay 邮件即停（中间有一封自主发信或人类插话就归零）。 5 测试：空会话 / 只数 relay / 自主发信打断归零 / 达到上限 / 按会话独立 ## DSH 工作区注册修复 问题：上一轮加的 workspaceRegistry.create(cwd) 用了兜底值 cwd（来自 resolveWorkspaceCwd，可能是 ~/.dsh/mail-sessions/mail-<uuid>）， 而不是会话 header 里的真实 cwd。两者不一致时 attachSession 拒绝， 且 create 已先执行，每封邮件都往注册表里塞一条空的垃圾 workspace。 修复：读 handle.agent.session.header.cwd —— create 路径下是 meta.cwd， resume 路径下是持久化 header 里那个。 ## homeagent 插件：11 工具齐平 opencode tools.go 新增：read_mail / forward_mail / suggest_address / list_contacts / session_participants / read_thread / connect_to_server + handleConnectToServer（注册到 Gateway 前先用候选坐标试注册， 成功才写回 p.gwURL/p.key，失败不破坏原配置） 关键修：Plugin.name（插件名，homed 注册用）与 Plugin.agentName （AgentMail 身份，Gateway 密钥绑定用）是两个命名空间。 它们混淆会导致 403：「该密钥已绑定到 Agent 'homeagent'，不能用于 注册 'homeagent-mail-bridge'」。现已分开，并在 systemd drop-in 里显式设 AGENTMAIL_AGENT_NAME=homeagent。 ## 三插件补齐 connect_to_server 之前只有 opencode 有。后果：Gateway 换地址或密钥需要重新登记时， opencode 里的模型能自己修好，其他平台只能干等环境变量被人改。 DSH 版：从 GatewayClient 内部调 register()，成功后写回 client.baseURL 与 client.agentKey 当场生效。 pi 版：新导出 KEY_FILE / saveLocalKey（从 gateway.mjs），connect 工具直接用。 # 测试 relayhops_test.go 5 例 opencode 172 / dsh 188 / pi 214 全绿 check-shared-libs.sh 三方同源（rename-proposal 已纳入校验）
110 lines
4.8 KiB
JavaScript
110 lines
4.8 KiB
JavaScript
/**
|
||
* 会话改名提议 —— 所有平台插件共用。
|
||
*
|
||
* # 这是什么
|
||
*
|
||
* 模型干完活后可能觉得当前别名不贴切：会话建立时叫 `witty-planet`（平台随机 slug）
|
||
* 或 `排查登录问题`（人写的邮件主题），摸清问题后它知道这其实是
|
||
* `fix-session-cookie-leak`。改名提议就是让它把这个判断说出来。
|
||
*
|
||
* # 为什么是「提议」而不是直接改
|
||
*
|
||
* 别名是**人**的寻址入口 —— `name@path.<别名>` 里那一段。Agent 干到一半自己改掉，
|
||
* 人上一秒记住的地址下一秒就 404（`session` 位三态语义要求指向不存在的会话直接报
|
||
* 「无法送达」，不会静默新建）。所以提议入库、由人在界面上点「接受」才真正生效。
|
||
*
|
||
* 这与平台命名自动同步（`POST /sessions/{id}/sync`）互补，两者不冲突：
|
||
*
|
||
* | | 谁发起 | 何时 | 是否打扰人 |
|
||
* |---|---|---|---|
|
||
* | 自动同步 | 平台的命名机制 | 每轮结束 | 不，后台静默生效 |
|
||
* | 改名提议 | 模型的主动判断 | 它认为有必要时 | 是，界面上出提示条 |
|
||
*
|
||
* # 为什么载体是 HTML 注释
|
||
*
|
||
* `/mail/send` 没有 `propose_alias` 字段 —— 提议**搭在正文里**发出去，
|
||
* 服务端用正则摘出来再把标记从入库正文中剥掉。选 HTML 注释的三个理由：
|
||
*
|
||
* - react-markdown 默认不解析 raw HTML，万一服务端没剥掉，它在页面上也只是
|
||
* 一行不显眼的转义文本，不会破版
|
||
* - 纯文本邮件客户端里是一行不碍事的注释，不像自造标记那样显眼
|
||
* - 不与 Markdown 语法冲突，格式化工具不会改写它
|
||
*
|
||
* # 为什么必须共用
|
||
*
|
||
* 标记格式是**服务端正则的镜像**（`gateway/internal/handler/rename_proposal.go`）。
|
||
* 各平台各写一遍拼接，某一处少个空格或把双引号写成单引号，服务端匹配不上 ——
|
||
* 而失败是静默的：邮件照常发出，提议凭空消失，模型以为自己提过了。
|
||
*/
|
||
|
||
/**
|
||
* 服务端能识别的别名字符集。
|
||
*
|
||
* 与 `validateSessionAlias` 一致：`. 空白 / @` 会与三维地址解析冲突，
|
||
* `new` 是寻址保留字。这里**不做规范化**（不把非法字符替换成 `-`）——
|
||
* 规范化是服务端 `normalizeAlias` 的职责，插件擅自改写会让模型看到的
|
||
* 「我提议的名字」与实际入库的不一致。
|
||
*
|
||
* @param {string} alias
|
||
* @returns {boolean}
|
||
*/
|
||
export function isProposableAlias(alias) {
|
||
const a = String(alias ?? '').trim();
|
||
if (!a) return false;
|
||
if (a === 'new') return false;
|
||
// 双引号是标记本身的定界符，含它会截断标记
|
||
if (/[.\s/@"]/.test(a)) return false;
|
||
// 服务端 VARCHAR(128)，按字节算
|
||
if (Buffer.byteLength(a, 'utf8') > 128) return false;
|
||
return true;
|
||
}
|
||
|
||
/**
|
||
* 把改名提议标记追加到正文末尾。
|
||
*
|
||
* 格式必须与服务端正则逐字符对应：
|
||
* `<!-- agentmail:rename-session alias="x" reason="y" -->`
|
||
* reason 可选，为空时**整个属性都不写**（写成 `reason=""` 服务端会存一个空理由，
|
||
* 界面上的提示条就少了那句解释）。
|
||
*
|
||
* 别名不合法时**原样返回正文**，不追加标记：与其发一个服务端匹配得上却
|
||
* 被 `validateSessionAlias` 拒掉的标记，不如当它没提 —— 调用方据此告诉模型。
|
||
*
|
||
* @param {string} body 原始正文
|
||
* @param {string} [alias] 提议的别名
|
||
* @param {string} [reason] 提议理由，一句话
|
||
* @returns {{body: string, proposed: boolean}} proposed=false 表示别名不合法，未追加
|
||
*/
|
||
export function appendRenameProposal(body, alias, reason) {
|
||
const text = String(body ?? '');
|
||
if (!isProposableAlias(alias)) return { body: text, proposed: false };
|
||
|
||
const a = String(alias).trim();
|
||
// 理由里的双引号会截断标记，去掉而不是转义：HTML 注释里没有转义机制
|
||
const r = String(reason ?? '').replace(/"/g, '').trim();
|
||
const reasonAttr = r ? ` reason="${r}"` : '';
|
||
|
||
return {
|
||
body: `${text}\n\n<!-- agentmail:rename-session alias="${a}"${reasonAttr} -->`,
|
||
proposed: true,
|
||
};
|
||
}
|
||
|
||
/**
|
||
* 提议提交后回给模型的那句话。
|
||
*
|
||
* 必须说明「等人确认」。不说的话模型会以为改名已经生效，接着在后续邮件里
|
||
* 用新别名当地址发信 —— 而那个别名此刻还不存在，投递会失败。
|
||
*
|
||
* @param {string} alias
|
||
* @param {boolean} proposed appendRenameProposal 的返回值
|
||
* @returns {string} 空串表示没有需要追加的说明
|
||
*/
|
||
export function renameProposalNote(alias, proposed) {
|
||
if (!alias) return '';
|
||
if (!proposed) {
|
||
return `（改名提议 "${alias}" 未提交：别名不可为 new，不可含 . 空白 / @ 或双引号。）`;
|
||
}
|
||
return `已附上改名提议 "${alias}"，等用户在界面上确认后生效 —— 在那之前继续用原别名寻址。`;
|
||
}
|