|
|
011957ac97
|
refactor(pi-bridge): A 方案落地 —— 平台兜底值搬回平台侧，workspace.js 恢复逐字节相同
pi 定的 A（2026-09-15）。要点是：**契约的逃逸口不是豁免清单，而是
`resolveWorkspaceCwd(workspace, fallback)` 的第二个参数** —— 平台兜底值本来就该由平台侧传进去。
四个桥对照很清楚：
| 桥 | 平台兜底值在哪 | 怎么交给共用函数 |
|----------|--------------------------------------------------|------------------|
| opencode | 自己的 `index.js` | 传 `directory` |
| zcode | 自己的 `src/index.mjs`（`zcodeSessionFallback`） | 传进去 |
| dsh | 共用的 `mailSessionFallback`（写死 `.dsh`） | 直接用 |
| pi | **原来造在共用模块里**（本次出的错） | → 现在也传进去 |
⇒ `docs/PLUGIN-CONTRACT.md` 第 1150 行**不用改、也不该加旁路**：pi 只是唯一一个把平台值
造在共用模块里的，挪回平台侧就恢复了规矩。
**改动（与 pi 预测的形状一致）**：`workspace.js` 删掉那 15 行、`pool.mjs`/`worker.mjs`
各改一行 import，外加新文件 `src/paths.mjs`。`git diff --stat` 实测
`15 -` / `3 +-` / `3 +-` —— 没有多余改动。
**为什么新家是 `src/paths.mjs` 而不是 `lib/sandbox.js`**（pi 给了两个选项，我选前者）：
`lib/` 按契约是"**候选共用**"目录，把一个 pi 专有文件放进去**正是这次出事的形状** ——
下一个人会问"它为什么不在 `ALL_LIBS` 里"。`src/` 下同名文件不会引起这个问题。
父子同源（worker 的沙箱 rw 由父进程算）由"两边 import 同一个模块"继续满足。
**验收四条（pi 给的，逐条实测）**：
1. `cmp opencode/lib/workspace.js pi/lib/workspace.js` **相同**；
`check-shared-libs.sh` **exit 0**；`install.sh --check` **exit 0** ✓
2. 测试数**不降**：491 → **496**（+5，见下）✓
3. 给 `piMailFallback` **补测试**（原先一条都没有 —— 这正是当初的不对称：
四个桥 `npm test` 全绿、只有 `check-shared-libs` 抓得到）→ 新增
`test/pi-paths.test.mjs` 5 条 ✓
4. 四个调用点改 import 后 diff 只应是 import 行 + 删掉的那 15 行 ✓
**新测试为什么是独立文件**：`test/workspace.test.mjs` 在四个桥里**逐字节相同**
（md5 一致，属共用测试），往里加 pi 专有断言会把共用测试也弄分叉 —— 与 `lib/` 同一条规矩。
**判据含结构断言 + 行为断言**，并已按纪律先验区分力：
· 变异 1（把 `piMailFallback` 塞回共用模块 = 本次分叉的形状）⇒ 结构判据**变红**；
· 变异 2（把 `.pi` 改成 `.dsh`）⇒ 三条行为判据**变红**；
两次变异都用 `cp` 恢复并以 `cmp` 校验一致。
★ 顺带记下 pi 指出的一条：`check-deploy-drift.mjs` 的判据 ① 是我扩到"比全部 133 个文件"的，
所以这次分叉**它能抓到** —— 但 `check-shared-libs` 先红了，说明两道门的分工是对的。
|
2026-09-15 06:31:18 +08:00 |
|
|
|
e6fd2fafdc
|
feat: agent 邮件寻址能力全面补齐 + .new 别名替换
## 别名替换（让 .new 邮件可寻址）
repo/autoalias.go: AutoAliasFor + EnsureSessionAlias
- .new 建完会话立刻给别名（形如 dsh-重构导入路径）
- 名字与主题都要：只用主题跨 Agent 撞名，只用名字看不出聊什么
- sanitizeAliasPart 只留 unicode.IsLetter/IsDigit，其余折 -
- 撞名追加 -2/-3，全占用退 session-<uuid前8位>
- 不复用 SyncSessionAlias：那个假定已存在且跳过 manual
- 条件写入 WHERE alias IS NULL OR ''，并发安全
- resolveTarget 的 .new 与默认会话两条路径都调
notifyRecipients 加三个字段（每个收件方拿到自己那个地址的版本）：
- session_alias / reply_address / self_address
- 别名为空时退回省略 session 位，绝不写 new
FormatAddress(name,path,session) 空 path 也必须留 @ 与 .
## Agent 侧寻址发现（五个只读端点）
handler/agent_discovery.go:
- /agent/contacts + /agent/contacts/suggest（三段式补全）
- /agent/mail/{id} + /agent/mail/{id}/thread
- /agent/sessions/{id}/participants
- 不复用人类路由：scope 不同、审计需求不同
- 一律只读：归档/改名/权限决策仍只有人能做
repo/participants.go: SessionParticipants 逐封扫 from/to/cc
- Roles 用集合、MailCount 只数发信（0=还没开口的人）
- 发件人 path 不取 from_workspace（那列存的是 Agent 名）
repo.SuggestPaths 重写：mails.to_workspace（按 MAX(created_at) 倒序）
+ agents.workspaces 并集。原只读 workspaces，官方插件传 [] 永远空
## 共用模块（三插件逐字节相同）
lib/addressing.js: formatAddress/roleOf/replyAddressFor/selfAddressFor/participantsOfMail
lib/discovery.js: renderNameSuggestions/renderPathSuggestions/renderSessionSuggestions/
renderParticipants/renderContacts/renderThread
lib/inbox-format.js: renderMail 新增收件人/身份/可投递地址三段
- selfName 参数（兼容旧调用不传的情况）
check-shared-libs.sh 纳入 addressing + discovery
## 插件侧
opencode: suggest_address + list_contacts + session_participants + read_thread + read_mail
dsh: 同上 + forward_mail（此前只有 opencode 有）+ upload_attachment 改真 multipart
pi: 同上（createMailTools 加 agentName 参数）
dsh: ctx.agents.create id collision 改为 readSession 探测后 resume
dsh: 关键路径日志改 console.error（ctx.logger 不进 journalctl）
## 测试
repo: autoalias_test.go 11 + participants_test.go 7 = 18 例
plugins: addressing.test 17 + discovery.test 23 + inbox-format.test 31 = 71 例
go test ./... + npm test（opencode 155 + dsh 173 + pi 199）全绿
端到端验证：admin 发 dsh@....new 抄送 opencode@....new
→ dsh 用 session_participants 取到地址 → send_mail 给 opencode
→ 地址取自工具返回值（.crisp-planet），未手工拼写
|
2026-09-03 12:09:12 +08:00 |
|
