Files
MailUI4Agents/server/internal/repo/markread_test.go
JianFeeeee 7634be8966 fix(inbox): 收件箱按**工作区**收窄(三维地址的 path 位此前从未被使用)
用户 12 天前就提过(`552fbc7` 只修了 session_id 那一维),这轮才真修。
用户原话:「难道让一个不在项目工作区的 agentsession 去修工程吗?」

# 缺陷(生产实测,2026-09-26)

在 `mc` 工作区干活的 pi 读收件箱拿到 **200 封,其中 191 封属于
`/home/program/agentmail`** —— 它照着那些信里的断言去改 agentmail 的代码,
把手上的 mc 活丢在一边。用户当场问它「你怎么干着干着修 agentmail 去了?」
(这条对话就在 mc 会话的 jsonl 里)

根因:`ListInboxScoped` 的 WHERE 只有 `m.to_name = $1`(+ 可选 session_id),
**没有任何 workspace 条件**。三维地址 `name@path.session` 的 path 位
在收件箱侧从未生效 —— 那不是"另一种语义",是没兑现契约。

# 三条守卫全部只覆盖自动转发,防不住这个

| 守卫 | 只覆盖 | 为何无效 |
| --- | --- | --- |
| 会话预算 | `relay != ""` 才扣 | 这批信 relay=0(模型主动发)⇒ 不扣 |
| maxRelayHops=5 | 同上,只数 relay | 同上 ⇒ 不进那个分支 |
| 插件自动转发守卫 | 插件代劳时 | 日志明说"本轮不自动转发" ⇒ 模型自己发的不受管 |

# 服务端

· `ListInboxScoped` / `CountUnreadScoped` / `MarkAllInboxReadForSession`
  三处统一加 `s.workspace = $N`(用会话的 workspace,不用 mails.to_workspace:
  后者是信封字段、可能是抄送或历史遗留;"线索属于哪个工作区"是会话属性)。
  ★ 三处必须是**同一个谓词** —— 列表看不到的信却被"全部标掉"标掉就是静默丢信
  (session_scope_test.go 记过这个形状)。
· **workspace 在 Agent 侧必需,缺了 400**(用户裁定:「不带 workspace 是错误
  发件格式,直接退回!」)。旧语义(不带=全部)正是缺陷本身,不留兼容回退。
· 人类侧**不过滤**(一个人跨工作区,WebUI 按 session_workspace 分组显示)——
  所以"必需"这条约束放在 Handler 而不是 repo 层:它是接口契约,不是数据层不变量。
· 新增 `UnreadWorkspaces`:心跳是**进程级**(一个桥服务所有工作区),没有
  "我的工作区"可言;但只有总数桥不知道去哪个工作区补投 ⇒ 心跳回
  `pending_workspaces` 清单,桥逐个消费。
· 决策载荷补 `workspace`(服务端知道 session→workspace,插件重启后推不出来)。
· `TouchAgentLastSeen` 从 HeartbeatAgent 拆出:middleware 在每个认证请求上都调它,
  而那时工作区还没解析(请求体没读),原来在白算一次 CountUnread。

# 三个插件(pi / opencode / dsh)

· 读类工具带 `workspace`;补投从"读一次全局收件箱"改为**逐工作区**读。
· pi:worker 信封的 `to_workspace` 经闭包递进工具(不是会话文件 header 的 cwd ——
  后者是"会话上次落在哪",前者是"这封信寄到哪个工作区")。
· opencode/dsh:插件常驻、信封在 deliverMail 那刻就消费掉了 ⇒ 新增
  `sessionWorkspace` 映射(键与既有 reverseMap 同一把)。
· 修一处真 bug:`UnreadWorkspaces` 原先会返回相对路径工作区(历史库里有
  `workspace='root'`),桥侧实测撞 400(`补投工作区 root 失败`)⇒ 只报可寻址的。

# 实测凭据

· 改前:`pi` 的收件箱 200 封混 3 个工作区(agentmail 191 / TrueAgent 7 / huawei 2)
· 改后:agentmail=100(total 228)、mc=16、TrueAgent=7 —— 各工作区独立
· 不带 workspace ⇒ **HTTP 400**,话术给出可执行步骤
· 桥日志:`rw=/home/newqqagent/plugindev/editdoc-upgrade` —— 终于是别的工作区了
  (改前 78 次 worker 启动**全部**是 `/home/program/agentmail`)

# 判据

· `server/internal/repo/workspace_scope_test.go`(3 条):
  两向收窄 + **反向对照**(不带时两条都看得到 ⇒ 证明是收窄不是清空)+
  未读数同口径 + 相对路径必须报错
· `plugins/pi-mail-bridge/test/inbox-workspace-scope.test.mjs`(4 条):接线 +
  取信封而非 cwd + 补投逐工作区 + 判据自检
· dsh 那条 `取不到会话时退回整体收件箱` **改了**:它钉的"退回整体"正是缺陷,
  现在钉"两维各自缺席时各自不带、服务端 400 让错误可见"
· 变异验证:服务端 2 处 + 插件 3 处,全部判红后恢复回绿

全量:server `go test ./...` 绿;三插件 513+340+403 全绿。
2026-09-26 07:44:33 +08:00

145 lines
4.0 KiB
Go
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.

package repo
import (
"context"
"testing"
"github.com/agentmail/gateway/internal/db"
"github.com/google/uuid"
)
// seedMailTo 造一封给 recipient 的未读邮件,可选带抄送。
func seedMailTo(t *testing.T, recipient string, cc string) uuid.UUID {
t.Helper()
ctx := context.Background()
sid, err := CreateSession(ctx, nil, "sender", "t", "")
if err != nil {
t.Fatal(err)
}
ccJSON := "[]"
if cc != "" {
ccJSON = `[{"name":"` + cc + `","path":"","session":"","raw":"` + cc + `"}]`
}
var id uuid.UUID
err = db.DB.QueryRowContext(ctx,
`INSERT INTO mails (session_id, from_name, to_name, subject, body, cc_list)
VALUES ($1, 'sender', $2, 's', 'b', $3) RETURNING mail_id`,
sid, recipient, ccJSON).Scan(&id)
if err != nil {
t.Fatal(err)
}
return id
}
func statusOf(t *testing.T, id uuid.UUID) string {
t.Helper()
var s string
if err := db.DB.QueryRowContext(context.Background(),
`SELECT status FROM mails WHERE mail_id = $1`, id).Scan(&s); err != nil {
t.Fatal(err)
}
return s
}
func TestMarkMailsReadForOnlyOwnMail(t *testing.T) {
setupTestDB(t)
ctx := context.Background()
mine := seedMailTo(t, "bot", "")
others := seedMailTo(t, "other", "")
// 一次请求里混着别人的邮件:自己的标掉,别人的动不了。
// 鉴权写在 UPDATE 的 WHERE 里,所以这不是「先查后拒」而是根本改不动。
n, err := MarkMailsReadFor(ctx, "bot", []uuid.UUID{mine, others})
if err != nil {
t.Fatal(err)
}
if n != 1 {
t.Fatalf("影响行数 = %d,期望 1(只有自己那封)", n)
}
if statusOf(t, mine) != "read" {
t.Fatal("自己的邮件没被标记")
}
if statusOf(t, others) != "unread" {
t.Fatal("别人的邮件被标记了 —— 鉴权失效")
}
}
// 重复标记是幂等的:Agent 通常把上一轮列出的 id 原样传回来,
// 其中混着已读的不该算错误
func TestMarkMailsReadForIsIdempotent(t *testing.T) {
setupTestDB(t)
ctx := context.Background()
id := seedMailTo(t, "bot", "")
if n, _ := MarkMailsReadFor(ctx, "bot", []uuid.UUID{id}); n != 1 {
t.Fatalf("首次应标掉 1 封,实际 %d", n)
}
n, err := MarkMailsReadFor(ctx, "bot", []uuid.UUID{id})
if err != nil {
t.Fatalf("重复标记不该报错: %v", err)
}
if n != 0 {
t.Fatalf("重复标记影响行数 = %d,期望 0", n)
}
}
// 被抄送的邮件也在收件箱里,也该能标掉
func TestMarkMailsReadForCoversCC(t *testing.T) {
setupTestDB(t)
ctx := context.Background()
id := seedMailTo(t, "other", "bot") // 主收件人是 other,bot 被抄送
n, err := MarkMailsReadFor(ctx, "bot", []uuid.UUID{id})
if err != nil {
t.Fatal(err)
}
if n != 1 {
t.Fatalf("被抄送的邮件应可标记,影响行数 = %d", n)
}
}
func TestMarkMailsReadForEmptyList(t *testing.T) {
setupTestDB(t)
// 空列表直接返回,不该拼出 `IN ()` 这种非法 SQL
n, err := MarkMailsReadFor(context.Background(), "bot", nil)
if err != nil {
t.Fatalf("空列表不该报错: %v", err)
}
if n != 0 {
t.Fatalf("空列表影响行数 = %d", n)
}
}
func TestMarkAllInboxReadForSkipsArchivedAndOthers(t *testing.T) {
setupTestDB(t)
ctx := context.Background()
a := seedMailTo(t, "bot", "")
b := seedMailTo(t, "bot", "")
others := seedMailTo(t, "other", "")
// 把 b 所在会话归档:那封在收件箱里根本看不到,
// 标掉它只会让「标记了 N 封」与用户看到的对不上
var sid uuid.UUID
db.DB.QueryRowContext(ctx, `SELECT session_id FROM mails WHERE mail_id = $1`, b).Scan(&sid)
db.DB.ExecContext(ctx, `UPDATE sessions SET status = 'archived' WHERE session_id = $1`, sid)
n, err := MarkAllInboxReadFor(ctx, "bot", "")
if err != nil {
t.Fatal(err)
}
if n != 1 {
t.Fatalf("影响行数 = %d,期望 1(排除归档会话)", n)
}
if statusOf(t, a) != "read" {
t.Fatal("活跃会话里的未读没被标掉")
}
if statusOf(t, b) != "unread" {
t.Fatal("归档会话里的邮件被标掉了")
}
if statusOf(t, others) != "unread" {
t.Fatal("别人的邮件被标掉了")
}
}