JianFeeeee
e6fd2fafdc
## 别名替换（让 .new 邮件可寻址）
repo/autoalias.go: AutoAliasFor + EnsureSessionAlias
- .new 建完会话立刻给别名（形如 dsh-重构导入路径）
- 名字与主题都要：只用主题跨 Agent 撞名，只用名字看不出聊什么
- sanitizeAliasPart 只留 unicode.IsLetter/IsDigit，其余折 -
- 撞名追加 -2/-3，全占用退 session-<uuid前8位>
- 不复用 SyncSessionAlias：那个假定已存在且跳过 manual
- 条件写入 WHERE alias IS NULL OR ''，并发安全
- resolveTarget 的 .new 与默认会话两条路径都调
notifyRecipients 加三个字段（每个收件方拿到自己那个地址的版本）：
- session_alias / reply_address / self_address
- 别名为空时退回省略 session 位，绝不写 new
FormatAddress(name,path,session) 空 path 也必须留 @ 与 .
## Agent 侧寻址发现（五个只读端点）
handler/agent_discovery.go:
- /agent/contacts + /agent/contacts/suggest（三段式补全）
- /agent/mail/{id} + /agent/mail/{id}/thread
- /agent/sessions/{id}/participants
- 不复用人类路由：scope 不同、审计需求不同
- 一律只读：归档/改名/权限决策仍只有人能做
repo/participants.go: SessionParticipants 逐封扫 from/to/cc
- Roles 用集合、MailCount 只数发信（0=还没开口的人）
- 发件人 path 不取 from_workspace（那列存的是 Agent 名）
repo.SuggestPaths 重写：mails.to_workspace（按 MAX(created_at) 倒序）
+ agents.workspaces 并集。原只读 workspaces，官方插件传 [] 永远空
## 共用模块（三插件逐字节相同）
lib/addressing.js: formatAddress/roleOf/replyAddressFor/selfAddressFor/participantsOfMail
lib/discovery.js: renderNameSuggestions/renderPathSuggestions/renderSessionSuggestions/
renderParticipants/renderContacts/renderThread
lib/inbox-format.js: renderMail 新增收件人/身份/可投递地址三段
- selfName 参数（兼容旧调用不传的情况）
check-shared-libs.sh 纳入 addressing + discovery
## 插件侧
opencode: suggest_address + list_contacts + session_participants + read_thread + read_mail
dsh: 同上 + forward_mail（此前只有 opencode 有）+ upload_attachment 改真 multipart
pi: 同上（createMailTools 加 agentName 参数）
dsh: ctx.agents.create id collision 改为 readSession 探测后 resume
dsh: 关键路径日志改 console.error（ctx.logger 不进 journalctl）
## 测试
repo: autoalias_test.go 11 + participants_test.go 7 = 18 例
plugins: addressing.test 17 + discovery.test 23 + inbox-format.test 31 = 71 例
go test ./... + npm test（opencode 155 + dsh 173 + pi 199）全绿
端到端验证：admin 发 dsh@....new 抄送 opencode@....new
→ dsh 用 session_participants 取到地址 → send_mail 给 opencode
→ 地址取自工具返回值（.crisp-planet），未手工拼写
82 lines
2.8 KiB
JavaScript
82 lines
2.8 KiB
JavaScript
import assert from 'node:assert/strict';
|
||
import test from 'node:test';
|
||
|
||
import { MAX_CATCHUP, mailToEvent, selectCatchup } from '../lib/catchup.js';
|
||
|
||
const mail = (over = {}) => ({
|
||
mail_id: 'm1',
|
||
session_id: 's1',
|
||
from_name: 'admin',
|
||
subject: '主题',
|
||
mail_type: 'normal',
|
||
to_workspace: '/tmp/ws',
|
||
...over,
|
||
});
|
||
|
||
test('mailToEvent 产出与 SSE new_mail 同形的对象', () => {
|
||
const ev = mailToEvent(mail());
|
||
// 投递侧读的就是这几个键，形状不一致会让补拉那条路径静默地少带信息
|
||
for (const k of ['mail_id', 'session_id', 'from_name', 'subject', 'mail_type', 'to_workspace']) {
|
||
assert.ok(k in ev, `缺少 ${k}`);
|
||
}
|
||
assert.equal(ev.role, 'to');
|
||
assert.equal(ev.catchup, true);
|
||
});
|
||
|
||
test('mailToEvent 对缺字段的行给出空串而非 undefined', () => {
|
||
const ev = mailToEvent({});
|
||
assert.equal(ev.mail_id, '');
|
||
assert.equal(ev.to_workspace, '');
|
||
assert.equal(ev.mail_type, 'normal');
|
||
});
|
||
|
||
test('已经通过 SSE 投过的不再补投', () => {
|
||
const mails = [mail({ mail_id: 'a' }), mail({ mail_id: 'b' })];
|
||
const got = selectCatchup(mails, new Set(['a']));
|
||
assert.deepEqual(got.map(e => e.mail_id), ['b']);
|
||
});
|
||
|
||
test('按时间正序补投（收件箱是倒序返回的）', () => {
|
||
// 收件箱：新的在前
|
||
const mails = [mail({ mail_id: 'new' }), mail({ mail_id: 'mid' }), mail({ mail_id: 'old' })];
|
||
const got = selectCatchup(mails, new Set());
|
||
assert.deepEqual(
|
||
got.map(e => e.mail_id),
|
||
['old', 'mid', 'new'],
|
||
'先来的邮件必须先处理，否则同一会话里的上下文顺序是乱的',
|
||
);
|
||
});
|
||
|
||
test('permission 类邮件不补投', () => {
|
||
const mails = [mail({ mail_id: 'p', mail_type: 'permission' }), mail({ mail_id: 'n' })];
|
||
const got = selectCatchup(mails, new Set());
|
||
assert.deepEqual(got.map(e => e.mail_id), ['n']);
|
||
});
|
||
|
||
test('超过上限的部分留在收件箱里', () => {
|
||
const mails = Array.from({ length: MAX_CATCHUP + 4 }, (_, i) => mail({ mail_id: 'm' + i }));
|
||
const got = selectCatchup(mails, new Set());
|
||
assert.equal(got.length, MAX_CATCHUP, '一次补拉不该把几十封邮件同时放出去');
|
||
});
|
||
|
||
test('上限可显式压到 0（用于禁用补拉）', () => {
|
||
const got = selectCatchup([mail()], new Set(), 0);
|
||
assert.deepEqual(got, []);
|
||
});
|
||
|
||
test('空输入与非数组不炸', () => {
|
||
assert.deepEqual(selectCatchup([], new Set()), []);
|
||
assert.deepEqual(selectCatchup(undefined, new Set()), []);
|
||
assert.deepEqual(selectCatchup(null, new Set()), []);
|
||
});
|
||
|
||
test('没有 mail_id 的行跳过', () => {
|
||
const got = selectCatchup([mail({ mail_id: '' }), mail({ mail_id: 'ok' })], new Set());
|
||
assert.deepEqual(got.map(e => e.mail_id), ['ok']);
|
||
});
|
||
|
||
test('seen 传 undefined 时不去重也不报错', () => {
|
||
const got = selectCatchup([mail({ mail_id: 'x' })], undefined);
|
||
assert.deepEqual(got.map(e => e.mail_id), ['x']);
|
||
});
|