## 配额重构:废除 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 把插件测试也纳入部署前门禁
109 lines
4.3 KiB
JavaScript
109 lines
4.3 KiB
JavaScript
// 自动转发去重的回归测试。
|
||
//
|
||
// 这个 bug 是生产里真实发生的:模型带附件主动回了一封(311 字节),
|
||
// session.idle 又把它最后那段话自动转了一封(342 字节),
|
||
// 收件箱里两封说同一件事,其中只有一封能下载附件。
|
||
//
|
||
// 逻辑放在 lib/relay-dedup.js 而不是 index.js:opencode 把入口模块的每一个
|
||
// 导出都当成插件工厂,入口多导出一个 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);
|