Agent→Agent 不自动转发 + 提示词区分新活/回复/补投
## 设计规则：Agent 之间不自动转发
自动转发存在的理由是「人不该等模型记得调 send_mail」—— 收件方是人时这是
纯收益。**收件方是另一个 Agent 时这个理由不成立，而且有害**：双方的插件都
会自动回一封，于是两个模型都以为「我只要把话说完就行」，实际在持续互相唤醒。
生产实测 pi 与 dsh 客套 6 轮直到撞上连续 relay 跳数上限。
规则现在写死在共用模块 `lib/relay-policy.js`（三平台逐字节相同）：
- `autoRelayDecision` — 插件该不该替模型开口
- `replyInstruction` — 提示词怎么跟模型说（人类 vs Agent 各一套措辞）
- `inboundHeadline` — 进来的是新活、回复、还是补投
`from_human` 缺失时保守按 Agent 处理：宁可让模型多调一次 send_mail，
也不能承诺一个不会发生的自动回信让发件方白等。
## Gateway 侧：`in_reply_to` + `from_human`
- `notify.Mail` 新增 `ParentMailID`（非空 = 这是对收件方某封信的回复）
- `notify.Mail` 新增 `FromHuman`（走 `repo.IsHumanUser`）
- SSE payload 里叫 `in_reply_to` / `from_human`
- 四个调用点全部传入：handler/mail（转发后产出的邮件，parentMailID 从
resolveTarget 取）、handler/me（同理）、handler/forward（传空串，
因为对收件方而言那封原邮件不在它的线索里）、scheduler/calendar（传空串）
- `ListInbox` 的 SELECT 加 `EXISTS (SELECT 1 FROM users u WHERE u.username = m.from_name)`
→ `models.Mail.FromHuman`，让补拉路径也有这个信号
## 提示词分流
三种处境各一套标题：
- 新活（人类）：「你收到一封新邮件」+ 「回信不用你自己发：…」
- 新活（Agent）：「你收到一封新邮件（对方是一个 Agent）」+ 「插件不会替你
回信。需要回复时你必须自己调 send_mail…请先判断是否真的需要回复」
- 回复到了：「你上一封信的回复到了。**这不是新任务**。」
- 补投：在标题里说明「离线期间积压」
## homeagent 特殊处理
Go 插件不能直接 `import('../lib/relay-policy.js')`，因此新增 `relay_policy.go`
（Go 对应物）+ `relay_policy_test.go`（11 例，逐条对齐 Node 侧判据）。
`sseLoop` / `catchUp` 两条路径都接上。
## `mailEvent` 命名类型
homeagent 的 SSE 事件解析 / handleNewMail / handlePermissionDecision 三处
原来各写一遍匿名 struct（字段列表几乎相同），加 `from_human` / `in_reply_to`
时漏改一处 → 编译报错但错误信息是两串几乎相同的字段列表，极难定位。
提成 `mailEvent` 命名类型：一处改、三处跟着走。
## 测试
- `lib/relay-policy.test.mjs`（Node）16 例：含「replyInstruction 与
autoRelayDecision 不得互相矛盾」「Agent 来信的标题要点名且回复要明确反对」
- `relay_policy_test.go`（Go）11 例：逐条对齐 Node 侧
- `turn.test.mjs` +3 例：from_human 缺失时按 Agent 处理 / Agent 来信时改口 /
回复到了说「不是新任务」；删掉两条旧的「必定自动转发」断言
- 共用脚本 `check-shared-libs.sh` +1 个文件（relay-policy）
- pi 288 / dsh 241 / opencode 217 / homeagent 14 / gateway 8 包全绿
This commit is contained in:
@ -22,6 +22,11 @@ import {
|
||||
shouldSkipAutoRelay,
|
||||
} from '../lib/relay-dedup.js';
|
||||
import { adoptedSessionID, adoptMissingMessage } from '../lib/adopt.js';
|
||||
import {
|
||||
autoRelayDecision,
|
||||
replyInstruction,
|
||||
inboundHeadline,
|
||||
} from '../lib/relay-policy.js';
|
||||
import {
|
||||
userMessage,
|
||||
replySubject,
|
||||
@ -145,7 +150,13 @@ class GatewayClient {
|
||||
const sessionMap = new Map<string, { dshSessionId: string; directory: string }>();
|
||||
const reverseMap = new Map<string, string>();
|
||||
const mailDrivenSessions = new Set<string>();
|
||||
const mailContexts = new Map<string, { replyTo: string; subject: string; mailID: string }>();
|
||||
// 回信上下文。fromHuman / inReplyTo 是服务端给的两个信号：
|
||||
// 前者决定要不要自动转发（Agent 间不转，见 lib/relay-policy.js），
|
||||
// 后者决定提示词说「新任务」还是「你上封信的回复到了」。
|
||||
const mailContexts = new Map<string, {
|
||||
replyTo: string; subject: string; mailID: string;
|
||||
fromHuman: boolean; inReplyTo: string;
|
||||
}>();
|
||||
const relayedSummaries = new Map<string, string>();
|
||||
|
||||
// 管理员在配置页划定的可用模型范围（按优先级）。随心跳响应更新。
|
||||
@ -582,16 +593,18 @@ export function apply(ctx: any, config: PluginConfig): void {
|
||||
if (kind === 'permission') {
|
||||
return `你之前发起的权限请求已有结论：${data.decision}（决策人：${data.decided_by || '用户'}）。请据此继续后续工作。`;
|
||||
}
|
||||
const fromHuman = data.from_human === true;
|
||||
return [
|
||||
`本会话收到一封新邮件（AgentMail）。`,
|
||||
inboundHeadline({ inReplyTo: data.in_reply_to, fromHuman, reused: true }),
|
||||
``,
|
||||
`发件人：${data.from_name || 'unknown'}`,
|
||||
`主题：${data.subject || '(无主题)'}`,
|
||||
`邮件 ID：${data.mail_id || 'unknown'}`,
|
||||
...(data.in_reply_to ? [`回的是你那封：${data.in_reply_to}`] : []),
|
||||
...(data.reply_address ? [`回信地址：${data.reply_address}`] : []),
|
||||
``,
|
||||
`请先调用 read_inbox 读取完整正文，然后处理其中的请求。`,
|
||||
`回信不用你自己发：把这一轮做完、把结论说出来就行，`,
|
||||
`插件会在轮次结束时把你最后那段话发回给 ${data.from_name || '发件人'}（不消耗配额）。`,
|
||||
...replyInstruction({ fromHuman, replyAddress: data.reply_address }),
|
||||
].join('\n');
|
||||
}
|
||||
|
||||
@ -610,6 +623,8 @@ export function apply(ctx: any, config: PluginConfig): void {
|
||||
replyTo: data.from_name || '',
|
||||
subject: data.subject || '',
|
||||
mailID: data.mail_id || '',
|
||||
fromHuman: data.from_human === true,
|
||||
inReplyTo: data.in_reply_to || '',
|
||||
});
|
||||
}
|
||||
|
||||
@ -682,19 +697,30 @@ export function apply(ctx: any, config: PluginConfig): void {
|
||||
replyTo: data.from_name || '',
|
||||
subject: data.subject || '',
|
||||
mailID: data.mail_id || '',
|
||||
fromHuman: data.from_human === true,
|
||||
inReplyTo: data.in_reply_to || '',
|
||||
});
|
||||
}
|
||||
const promptText = kind === 'permission'
|
||||
? `你之前发起的权限请求已有结论：${data.decision}（决策人：${data.decided_by || '用户'}）。请据此继续后续工作。`
|
||||
: [
|
||||
`本会话收到一封新邮件（AgentMail 续谈）。`,
|
||||
inboundHeadline({
|
||||
inReplyTo: data.in_reply_to,
|
||||
fromHuman: data.from_human === true,
|
||||
reused: true,
|
||||
}),
|
||||
``,
|
||||
`发件人：${data.from_name || 'unknown'}`,
|
||||
`主题：${data.subject || '(无主题)'}`,
|
||||
`邮件 ID：${data.mail_id || 'unknown'}`,
|
||||
...(data.in_reply_to ? [`回的是你那封：${data.in_reply_to}`] : []),
|
||||
...(data.reply_address ? [`回信地址：${data.reply_address}`] : []),
|
||||
``,
|
||||
`请先调用 read_inbox 读取完整正文，然后处理其中的请求。`,
|
||||
`回信不用你自己发：把这一轮做完、把结论说出来就行。`,
|
||||
...replyInstruction({
|
||||
fromHuman: data.from_human === true,
|
||||
replyAddress: data.reply_address,
|
||||
}),
|
||||
].join('\n');
|
||||
live.followup(userMessage(promptText));
|
||||
// 等 turn/end 而不是立即返回：这封邮件的轮次未结束时投递下一封，
|
||||
@ -725,18 +751,26 @@ export function apply(ctx: any, config: PluginConfig): void {
|
||||
const promptText = kind === 'permission'
|
||||
? `你之前发起的权限请求已有结论：${data.decision}（决策人：${data.decided_by || '用户'}）。请据此继续。`
|
||||
: [
|
||||
`你收到一封新邮件（AgentMail）。`,
|
||||
inboundHeadline({
|
||||
inReplyTo: data.in_reply_to,
|
||||
fromHuman: data.from_human === true,
|
||||
catchup: data.catchup,
|
||||
reused: false,
|
||||
}),
|
||||
``,
|
||||
`发件人：${data.from_name || 'unknown'}`,
|
||||
`主题：${data.subject || '(无主题)'}`,
|
||||
`邮件 ID：${data.mail_id || 'unknown'}`,
|
||||
...(data.in_reply_to ? [`回的是你那封：${data.in_reply_to}`] : []),
|
||||
`身份：你是 ${AGENT_NAME}`,
|
||||
...(data.reply_address ? [`回信地址：${data.reply_address}`] : []),
|
||||
``,
|
||||
`请先调用 read_inbox 读取完整正文（附带附件清单，如有附件可用 download_attachment 取回），然后处理其中的请求。`,
|
||||
``,
|
||||
`**回信不用你自己发**：你把本轮工作做完、把结论正常说出来就行，`,
|
||||
`插件会在这一轮结束时自动把你最后那段话作为回信发回给 ${data.from_name || '发件人'}（不消耗你的发信配额）。`,
|
||||
`只有在需要主动联系其他人、或要带附件时才调用 send_mail。`,
|
||||
...replyInstruction({
|
||||
fromHuman: data.from_human === true,
|
||||
replyAddress: data.reply_address,
|
||||
}),
|
||||
].join('\n');
|
||||
|
||||
// 按管理员划定的范围逐个尝试建 agent，全部失败才回一封说明原因的邮件。
|
||||
@ -778,6 +812,8 @@ export function apply(ctx: any, config: PluginConfig): void {
|
||||
replyTo: data.from_name || '',
|
||||
subject: data.subject || '',
|
||||
mailID: data.mail_id || '',
|
||||
fromHuman: data.from_human === true,
|
||||
inReplyTo: data.in_reply_to || '',
|
||||
});
|
||||
}
|
||||
|
||||
@ -1326,7 +1362,24 @@ export function apply(ctx: any, config: PluginConfig): void {
|
||||
const mailSessionID = reverseMap.get(String(agent.id));
|
||||
if (!mailSessionID) return;
|
||||
const mctx = mailContexts.get(mailSessionID);
|
||||
if (!mctx?.replyTo) return;
|
||||
|
||||
// **只给人类来信自动转发**（见 lib/relay-policy.js）。
|
||||
//
|
||||
// 对方是 Agent 时它那边的插件也会自动回一封，于是两个模型都以为「我只要
|
||||
// 把话说完就行」，实际在持续互相唤醒 —— 生产实测 pi 与 dsh 客套 6 轮直到
|
||||
// 撞上连续 relay 跳数上限。日志走 console.error：ctx.logger 不进 journalctl，
|
||||
// 而「本轮为何没有回信」必须能查到。
|
||||
const policy = autoRelayDecision({
|
||||
fromHuman: mctx?.fromHuman === true,
|
||||
replyTo: mctx?.replyTo,
|
||||
});
|
||||
if (!policy.relay) {
|
||||
console.error(`[dsh-mail-bridge] 本轮不自动转发：${policy.reason}`);
|
||||
return;
|
||||
}
|
||||
// policy.relay 为真已经蕴含 mctx?.replyTo 非空（autoRelayDecision 的第一道判定），
|
||||
// 但 TS 推不出那层关系 —— 显式窄一下，而不是给后面每处加非空断言。
|
||||
if (!mctx) return;
|
||||
|
||||
// 取最后一条 assistant 消息的文本
|
||||
const events = agent.session?.events ?? [];
|
||||
|
||||
Reference in New Issue
Block a user