Files
MailUI4Agents/plugins/opencode-mail-bridge/test/auto-relay.test.mjs
JianFeeeee 07e6b789b2 feat: 配额下沉到会话 + 窄屏覆盖式布局 + 工作列表卡片视图
## 配额重构:废除 Agent 终身额度

原实现在 agents 上放一个 max_rounds/used_rounds 计数器,used_rounds 单调递增、
永不重置 —— 跑满就要管理员手工重置才能再干活。那是把一次性资源模型套在长期
在线的服务上,且并行任务互相抢额度。

改为:
- 唯一被强制的预算是【会话】的往返预算(sessions.max_rounds/used_rounds),
  写信时给、对话页里随时改 —— 配额的语义是「这件事值得多少个来回」,
  那是任务的属性而不是 Agent 的属性
- agents.default_rounds 只作为「派给这个 Agent 的新任务」的默认值(默认 20)
- agents.used_rounds 降级为纯统计
- 新建会话速率限制(1h/20 条)堵住用 .new 开一串新会话绕过预算;
  人类不受限(agentLimiterKey 返回空串即不计量)

## 窄屏适配(用户反馈「窄屏基本不可用」)

原先只有三栏并排:60(导航)+320(列表)+详情,375px 屏上详情被挤到 0。

第一版做成「一次只显示一栏」,用户纠正应当是新页面覆盖老页面并带动画,
于是重做为覆盖式:
- NarrowStack:底层列表始终挂载,详情绝对定位盖在上面。两个好处 ——
  列表滚动位置与选中态天然保留;退出动画有东西可播(直接卸载再渲染另一个
  组件的话,没有任何一帧能让旧页面往右滑出去)
- 因此必须区分「逻辑上是否打开」与「是否还在 DOM 里」:关闭时先播 200ms
  滑出,动画结束才卸载
- 入场用双层 requestAnimationFrame:必须让浏览器至少绘制一帧「在右侧之外」
  的状态,否则挂载与 translate-x-0 在同一帧内完成,transition 不触发
- 窄屏专属控件用 useIsNarrow() 条件渲染而非 md:hidden —— 后者只是视觉隐藏,
  宽屏用户按 Tab 会聚焦到看不见的返回按钮
- 底部导航 + 抽屉侧栏 + env(safe-area-inset-bottom)

## 工作列表卡片视图(Phase 7.1 最后一项)

中间栏可切列表/卡片。列表答「跟谁在聊」,卡片答「在聊什么、进展如何」:
主题 + 最新一封的发件人与摘要 + 往返预算徽标。

- 两种视图共用同一份数据与同一套动作;归档确认框也共用 —— 归档是破坏性操作,
  换个视图就换套确认 UI 只会让人对「自己点了什么」更没底
- 预算徽标在「不限」时不显示(对每张卡片都成立的「0/0」是纯噪声)
- 数据一次取回,不让卡片为每条会话再打一次库

## 修掉的缺陷

- GET /me/sessions 一直 500:ListSessionsFor 的 SELECT 加了预算两列却没加进
  Scan,列数不匹配。联系人栏一条数据都拉不到,而错误只是「Failed to list sessions」
- GET /sessions/{id} 忘了填充附件:前端会话视图走的是这个端点,于是 Agent
  回信里的附件在 UI 上完全不存在(另一个端点填了但没人调用)
- 插件曾完全没在加载:为了可测在 index.js 里 export 了辅助函数与一个 Map,
  而 opencode 把入口模块的每一个导出都当成插件工厂逐个检查,多导出一个 Map
  就 "Plugin export is not a function",插件静默失效、邮件全投不进去。
  逻辑挪到 lib/relay-dedup.js,并加断言钉住「入口只有 default 导出」
- 同一件事发两封邮件:模型带附件主动回信后,session.idle 又把它最后那段话
  自动转了一遍(生产实测 311 与 342 字节各一封)。explicitSends 记录本轮
  主动发信,自动转发据此让位;relay_key 幂等管不了这个 —— 那个键保证的是
  「同一条消息不转两次」
- SQLite 时间戳只有秒精度:同秒插入的多封邮件排序不确定(实测同秒插 5 封,
  顺序由随机 UUID 决定)。「会话里最早那封」(决定联系人身份)与「最后那封」
  (决定最新进展)都会取错。NOW() 升到微秒 + mails 的 INSERT 显式传它
  (改 schema 默认值只对新库生效,SQLite 没有 ALTER COLUMN)+ 所有
  ORDER BY created_at 补 mail_id 兜底
- fillAttachments 从逐封查询改成一次 IN(...):原来是 N+1,200 封的会话打开
  要打 200 次库
- repo 层 5 处 rows.Next() 循环补 rows.Err():没有它,读到一半连接断掉会
  静默返回部分结果,UI 上表现为「邮件凭空少了几封」
- go:embed 占位页改名 placeholder.html:叫 index.html 会被 Vite 产物覆盖并
  提交进去,而它引用的 assets/ 是被忽略的 —— 新克隆打开是白屏

## 回复/转发栏

- 两处都加抄送(可折叠);原邮件带抄送时多一个「回复全部」,回填用
  cc_list[].raw 而非重拼 name@path(后者会丢掉会话段)
- 会话视图每张卡片加转发入口:转发之前只存在于单封邮件视图,而人多数时间
  待在会话视图里,等于功能在 UI 上找不到
- ReplyBar 的错误从 console.error 改为显示出来:预算耗尽、地址不存在、
  速率限制都走这条路,之前点发送毫无反应

## 测试

- repo: 列顺序(三个 SQL 分支)、卡片字段、previewRunes 边界、时间戳亚秒精度、
  批量附件查询、速率限制(80 goroutine 断言恰好 20 条通过)
- web: 窄屏布局 16 条结构性断言(覆盖而非分栏、延迟卸载、双层 rAF、
  条件渲染而非 md:hidden)
- 插件: 自动转发去重 17 条(含「入口只有 default 导出」不变量)
- install.sh 把插件测试也纳入部署前门禁
2026-09-02 14:16:46 +08:00

109 lines
4.3 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

// 自动转发去重的回归测试。
//
// 这个 bug 是生产里真实发生的模型带附件主动回了一封311 字节),
// session.idle 又把它最后那段话自动转了一封342 字节),
// 收件箱里两封说同一件事,其中只有一封能下载附件。
//
// 逻辑放在 lib/relay-dedup.js 而不是 index.jsopencode 把入口模块的每一个
// 导出都当成插件工厂,入口多导出一个 Map 就会让整个插件加载失败
// (实测 "Plugin export is not a function",插件静默不加载,邮件全投不进去)。
import {
shouldSkipAutoRelay,
noteExplicitSend,
explicitSends,
addrName,
} from '../lib/relay-dedup.js';
let failed = 0;
const check = (name, cond, detail = '') => {
if (cond) console.log(` 通过 ${name}`);
else {
console.error(` 失败 ${name}${detail ? ' — ' + detail : ''}`);
failed++;
}
};
console.log('自动转发去重:');
// ---- addrName ----
check('三维地址取名字段', addrName('admin@root.tidy-tiger') === 'admin');
check('纯名字原样返回', addrName('admin') === 'admin');
check('空值不炸', addrName(undefined) === '' && addrName(null) === '');
check('去空白', addrName(' admin @root') === 'admin');
// ---- 没有主动发信记录 → 照常自动转发 ----
check(
'本轮没主动发信 → 不跳过(自动转发是默认行为)',
shouldSkipAutoRelay(undefined, 'admin', 'mail-1') === false
);
// ---- 收件人同名 → 跳过 ----
explicitSends.clear();
noteExplicitSend('ses-1', 'admin@root.tidy-tiger', 'mail-1');
check(
'模型已回给同一个人 → 跳过',
shouldSkipAutoRelay(explicitSends.get('ses-1'), 'admin', 'mail-1') === true
);
check(
'收件人写法不同但同名 → 仍跳过(地址带路径/会话段)',
shouldSkipAutoRelay(explicitSends.get('ses-1'), 'admin@root', 'mail-1') === true
);
// ---- 发给别人 → 不跳过 ----
explicitSends.clear();
noteExplicitSend('ses-2', 'ops@root.new', 'mail-9');
check(
'模型主动联系了第三方,但本轮的来信还没回 → 不跳过',
shouldSkipAutoRelay(explicitSends.get('ses-2'), 'admin', 'mail-1') === false
);
// ---- reply_to 相同 → 跳过(即使收件人名字对不上)----
explicitSends.clear();
noteExplicitSend('ses-3', 'someone-else@root', 'mail-1');
check(
'已回过同一封信 → 跳过reply_to 命中,收件人名字不同也算)',
shouldSkipAutoRelay(explicitSends.get('ses-3'), 'admin', 'mail-1') === true
);
// ---- 一轮里发了多封 ----
explicitSends.clear();
noteExplicitSend('ses-4', 'ops@root', 'mail-8');
noteExplicitSend('ses-4', 'admin@root', 'mail-1');
const rec4 = explicitSends.get('ses-4');
check('一轮多封都记下', rec4.names.size === 2 && rec4.replyTos.size === 2);
check('其中任一命中即跳过', shouldSkipAutoRelay(rec4, 'admin', 'mail-1') === true);
check('都不命中则不跳过', shouldSkipAutoRelay(rec4, 'someone', 'mail-99') === false);
// ---- 无 sessionID 不记录(防止污染一个 undefined 键)----
explicitSends.clear();
noteExplicitSend(undefined, 'admin@root', 'mail-1');
check('没有 sessionID 时不记录', explicitSends.size === 0);
// ---- 空 mailID 不该让 replyTos 命中 ----
explicitSends.clear();
noteExplicitSend('ses-5', 'ops@root', '');
const rec5 = explicitSends.get('ses-5');
check('空 reply_to 不入集合', rec5.replyTos.size === 0);
check(
'本来要转的邮件没有 id 时只看收件人',
shouldSkipAutoRelay(rec5, 'admin', '') === false
);
// ---- 不变量:插件入口只能有 default 导出 ----
//
// opencode 用 Object.values(mod) 逐个检查每个导出是不是函数,
// 多导出一个 Map/常量就抛 "Plugin export is not a function"
// 整个插件静默不加载 —— 邮件全都投不进去。实测踩过这个坑。
import { readFileSync } from 'node:fs';
const entry = readFileSync(new URL('../index.js', import.meta.url), 'utf8');
const exports_ = entry.match(/^export\s+(?!default\b).*/gm) || [];
check(
'入口 index.js 只有 default 导出',
exports_.length === 0,
exports_.length ? `多出:${exports_.map(l => l.slice(0, 50)).join(' | ')}` : ''
);
check('入口确实有 default 导出', /^export default /m.test(entry));
console.log(failed === 0 ? '\n自动转发去重全部通过' : `\n自动转发去重:${failed} 项失败`);
process.exit(failed === 0 ? 0 : 1);