## 配额重构:废除 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 把插件测试也纳入部署前门禁
126 lines
3.5 KiB
Go
126 lines
3.5 KiB
Go
package repo
|
||
|
||
import (
|
||
"context"
|
||
"os"
|
||
"path/filepath"
|
||
"testing"
|
||
|
||
"github.com/agentmail/gateway/internal/db"
|
||
)
|
||
|
||
// setupTestDB 起一个临时 SQLite 库并建表,供配额测试使用。
|
||
// 直接用真实的 SQLite 而非 mock:配额的正确性核心在于「判断与自增在同一条 UPDATE 里」,
|
||
// 这正是只有真实数据库才能验证的部分。
|
||
func setupTestDB(t *testing.T) {
|
||
t.Helper()
|
||
|
||
dir := t.TempDir()
|
||
if err := db.Connect(context.Background(), filepath.Join(dir, "test.db")); err != nil {
|
||
t.Fatalf("connect: %v", err)
|
||
}
|
||
if err := db.Migrate(context.Background()); err != nil {
|
||
t.Fatalf("migrate: %v", err)
|
||
}
|
||
t.Cleanup(db.Close)
|
||
}
|
||
|
||
func seedAgent(t *testing.T, name string, max int) {
|
||
t.Helper()
|
||
_, err := db.DB.ExecContext(context.Background(),
|
||
`INSERT INTO agents (agent_name, secret, platform, default_rounds) VALUES ($1, 'x', 'test', $2)`,
|
||
name, max)
|
||
if err != nil {
|
||
t.Fatalf("seed agent: %v", err)
|
||
}
|
||
}
|
||
|
||
// default_rounds 是「派给这个 Agent 的新任务默认多少个来回」,
|
||
// 不是会拦请求的终身额度 —— 真正的额度在 sessions.max_rounds 上。
|
||
func TestDefaultRoundsRoundTrip(t *testing.T) {
|
||
setupTestDB(t)
|
||
seedAgent(t, "bot", 0)
|
||
ctx := context.Background()
|
||
|
||
st, err := SetDefaultRounds(ctx, "bot", 15)
|
||
if err != nil {
|
||
t.Fatal(err)
|
||
}
|
||
if st.DefaultRounds != 15 {
|
||
t.Fatalf("default_rounds = %d,期望 15", st.DefaultRounds)
|
||
}
|
||
if got := DefaultRoundsFor(ctx, "bot"); got != 15 {
|
||
t.Fatalf("DefaultRoundsFor = %d,期望 15", got)
|
||
}
|
||
|
||
// 负数归一为 0(不限),而不是造出一个永远发不出信的默认值
|
||
if st, err = SetDefaultRounds(ctx, "bot", -3); err != nil {
|
||
t.Fatal(err)
|
||
}
|
||
if st.DefaultRounds != 0 {
|
||
t.Fatalf("负数应归一为 0,实际 %d", st.DefaultRounds)
|
||
}
|
||
}
|
||
|
||
// 未注册的 Agent 取默认预算时给兜底值而不是报错:
|
||
// 派活的人不该因为「对方还没上线」就拿不到一个合理默认值 ——
|
||
// 邮件本来就支持发给尚未上线的收件人。
|
||
func TestDefaultRoundsForUnknownAgentFallsBack(t *testing.T) {
|
||
setupTestDB(t)
|
||
if got := DefaultRoundsFor(context.Background(), "ghost"); got != fallbackDefaultRounds {
|
||
t.Fatalf("未注册 Agent 应回落到 %d,实际 %d", fallbackDefaultRounds, got)
|
||
}
|
||
}
|
||
|
||
// BumpSentCount 是纯统计:只累加,绝不拦请求,也绝不返回错误
|
||
func TestBumpSentCountOnlyCounts(t *testing.T) {
|
||
setupTestDB(t)
|
||
seedAgent(t, "bot", 0)
|
||
ctx := context.Background()
|
||
|
||
for i := 0; i < 5; i++ {
|
||
BumpSentCount(ctx, "bot")
|
||
}
|
||
st, err := GetAgentStats(ctx, "bot")
|
||
if err != nil {
|
||
t.Fatal(err)
|
||
}
|
||
if st.SentTotal != 5 {
|
||
t.Fatalf("累计发信 = %d,期望 5", st.SentTotal)
|
||
}
|
||
|
||
// 不存在的 Agent 也不该 panic 或报错 —— 它只是没有行可更新
|
||
BumpSentCount(ctx, "ghost")
|
||
}
|
||
|
||
func TestGetAgentStatsUnknownAgent(t *testing.T) {
|
||
setupTestDB(t)
|
||
if _, err := GetAgentStats(context.Background(), "ghost"); err == nil {
|
||
t.Fatal("不存在的 Agent 应报错")
|
||
}
|
||
}
|
||
|
||
func TestListAgentStats(t *testing.T) {
|
||
setupTestDB(t)
|
||
seedAgent(t, "alpha", 0)
|
||
seedAgent(t, "beta", 0)
|
||
ctx := context.Background()
|
||
SetDefaultRounds(ctx, "alpha", 5)
|
||
|
||
list, err := ListAgentStats(ctx)
|
||
if err != nil {
|
||
t.Fatal(err)
|
||
}
|
||
if len(list) != 2 {
|
||
t.Fatalf("应有 2 个 Agent,实际 %d", len(list))
|
||
}
|
||
// 按名字排序,alpha 在前
|
||
if list[0].AgentName != "alpha" || list[0].DefaultRounds != 5 {
|
||
t.Fatalf("alpha 的记录不对:%+v", list[0])
|
||
}
|
||
}
|
||
|
||
func TestMain(m *testing.M) {
|
||
os.Exit(m.Run())
|
||
}
|