Files
MailUI4Agents/plugins/pi-mail-bridge/test/inbox-workspace-scope.test.mjs
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

66 lines
3.6 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.

/**
* read_inbox 必须把列表收窄到**自己所在的工作区**(2026-09-26 用户报的缺陷)。
*
* # 缺陷(用户当场指出,此前已提过多次)
*
* 在 `mc` 工作区干活的 pi 读收件箱拿到 200 封,其中 **191 封属于
* `/home/program/agentmail`** —— 它照着那些信里的断言去改 agentmail 的代码,
* 把手上 mc 的活丢在一边。用户当场问「你怎么干着干着修 agentmail 去了?」
*
* 三维地址是 `name@path.session`:**path 位本来就该参与寻址**,而收件箱侧此前
* 完全没用它(`ListInboxScoped` 的 WHERE 里只有 `to_name`)。
*
* # 与 inbox-session-scope 的分工(两条判据、两维收窄,别混)
*
* · `session_id` —— 只列**这条线索**的信。防的是"A 会话的 worker 标掉 B 会话的未读"。
* · `workspace` —— 只列**这个工作区**的信。防的是"在 mc 干活却读到 agentmail 的信"。
*
* 两维都要,缺一维就漏一类越界。这里只验**接线**;服务端语义
* (读 A 工作区不动 B)由 `server/internal/repo/workspace_scope_test.go` 负责。
*/
import { test } from 'node:test';
import assert from 'node:assert/strict';
import { readFileSync } from 'node:fs';
import { dirname, join } from 'node:path';
import { fileURLToPath } from 'node:url';
const HERE = dirname(fileURLToPath(import.meta.url));
const tools = readFileSync(join(HERE, '..', 'src', 'tools.mjs'), 'utf8');
const worker = readFileSync(join(HERE, '..', 'src', 'worker.mjs'), 'utf8');
const index = readFileSync(join(HERE, '..', 'src', 'index.mjs'), 'utf8');
test('read_inbox 的收窄参数带上 workspace', () => {
assert.match(tools, /workspace=\$\{encodeURIComponent\(ws\)\}/,
'scopeQS 要真的拼出 workspace=…(服务端缺它直接 400)');
assert.match(tools, /const ws = wsParam\(\);/,
'scopeQS 要消费 wsParam,而不是只留着函数不调');
});
test('worker 把"这封信寄到哪个工作区"递给工具', () => {
assert.match(worker, /getWorkspace: \(\) => mailContext\.workspace/,
'要传闭包而不是快照(worker 每回合的 mailContext 会变)');
assert.match(worker, /workspace: msg\.data\?\.to_workspace/,
'★ 取**信封的 path 位**(to_workspace),不是会话文件的 cwd —— ' +
'前者是"这封信寄到哪个工作区",后者是"会话上次落在哪"');
});
test('补投逐工作区走,不再读一次全局收件箱', () => {
// 原来:client.get('/mail/inbox?status=unread&limit=20') —— 不带收窄,
// 于是桥会把所有工作区的漏投一起重放。
assert.match(index, /pending_workspaces/,
'心跳要消费 pending_workspaces 清单');
assert.match(index, /mail\/inbox\?status=unread&limit=20&workspace=\$\{encodeURIComponent\(ws\)\}/,
'每个工作区各读一次,且带上 workspace');
assert.doesNotMatch(index, /client\.get\('\/mail\/inbox\?status=unread&limit=20'\)/,
'旧的"不带收窄读全局"那条路必须消失(它就是跨工作区重放的载体)');
});
test('★ 判据自检:拿没带工作区收窄的旧写法喂进来必须判红', () => {
const oldScope = "const sid = typeof getMailSessionId === 'function' ? getMailSessionId() : '';\n return sid ? `session_id=${encodeURIComponent(sid)}` : '';";
assert.equal(/workspace=\$\{encodeURIComponent\(ws\)\}/.test(oldScope), false);
const oldCatchup = "const box = await client.get('/mail/inbox?status=unread&limit=20');";
assert.match(oldCatchup, /client\.get\('\/mail\/inbox\?status=unread&limit=20'\)/,
'自检:旧写法确实能被那条 doesNotMatch 抓到');
});