better-dsh 0.2.4-a → 0.2.4-b

package/docs/50_test-reports/2026-09-23-remote-framework/345/256/236/346/265/213/346/212/245/345/221/212.md

@@ -0,0 +1,92 @@
+# Remote 执行框架（`remote` 工具）4986 第一人称实测报告
+
+- **日期**: 2026-09-23
+- **分支**: `remote-framework`（worktree `.worktrees/remote-framework`，基 `main` @ e9061b8）
+- **代码范围**: `better-dsh/src/remote/*`（nonce-framing / target / transports / oneshot / pty-session / driver / status / tool / plugin，9 模块）+ 三处接线（exports `./remote`、tsdown entry、cordis.patch.yml `dashr-remote` 行）
+- **对照设计**: `docs/10_plans/2026-09-23-remote-execution-framework.md`（spec 权威）+ 实施计划 `docs/10_plans/2026-09-23-remote-framework-impl.md`（含 Rulings P1–P14）
+- **第一人称载体**: `dsh --profile headless`（真实运行时 session、真实 LLM、真实工具派发；9 次 headless 运行覆盖 18 case 矩阵）
+
+## 一、环境与部署
+
+- Dev/Test 1：monorepo `upstream/deepseek-harness`（dsh-v0.1.6-alpha.2 基线 + 仓内 patch）；canonical src 自 worktree rsync，devDeps 手术 14× workspace:* 照旧重打。
+- **零新增依赖**：本框架纯 `node:child_process` / `node:crypto` + 系统 CLI（ssh / docker / incus / util-linux script）——RM0 的 ssh2 native 依赖面不存在。
+- 构建：`pnpm --filter better-dsh exec tsdown` + `tsx scripts/build-client.ts`（lib/client 清洗陷阱照旧）；`lib/remote/plugin.js` 产出。
+- 实例：`PORT=4986 bash .tests/dsh-test1/start-4999.sh`（unit `dsh-4986-test`，boot 走构建产物 `apps/cli/lib/bin.js` + 裸 node——双平面红线遵守）。
+- 配置面：`web --dump-config`（产物 bin）确认 `dashr-remote` 行入组合（`- id: dashr-remote / name: better-dsh/remote`，紧随 better-dsh/mobile）。
+- 别名路由（case 9）：test home 层 `cordis.patch.yml` 追加 `dashr-remote` 行重述 + `config.containers.{"ctr-1": "incus:ctr-1"}`——**行重述覆盖机制真通**（home 层 config 覆盖 bundle 层默认）。验收后已清理还原。
+
+## 二、18 case 验收矩阵（全部 ✅）
+
+| # | case | 证据（第一人称 verbatim 摘录） | 判定 |
+|---|---|---|---|
+| 1 | ssh oneshot 基础 | `{dev4, echo ok && git --version}` → `CASE1: 0 \| ok / git version 2.43.0` | ✅ |
+| 2 | 退出码透传 | `{dev4, exit 42}` → `CASE2: 42`（二进制退出码，零字符串扫描） | ✅ |
+| 3 | 复合语法（管道+变量） | `{dev4, ls / \| head -2 && echo $HOME}` → `bin / bin.usr-is-merged / /home/u1` | ✅ |
+| 4 | pty 状态保持 | cd /tmp + export F=1 → 次 turn `pwd && echo $F` → `/tmp` + `1`，`cwd=/tmp` | ✅ |
+| 5 | 多行单帧 | `"echo a\necho b"`（单串含换行）→ 一帧 `a\nb`，exit 0 | ✅ |
+| 6 | 伪 marker 免疫 | 打印静态 `\033]133;D;deadbeef…;99` → exit **0**（非 99）、输出含 real、流无截断（agent 转打时引号被 shell 搅碎成 command-not-found 噪音——帧判定不受影响，更狠的实证） | ✅ |
+| 7 | pty 超时打断 | `sleep 300` timeout 2 → `exit 130 \| interrupted \| 2.3s`（P8 两段打断在真 `ssh -tt` 上成立）；随后 `echo alive` exit 0 **会话存活** | ✅ |
+| 8 | incus oneshot | `{incus:ctr-1, cat /etc/os-release \| head -1}` → `Ubuntu 26.04 LTS` | ✅ |
+| 9 | incus pty + 别名路由 | 显式前缀 pty `cd / && pwd` → `cwd=/`；裸名 `ctr-1` → 路由进容器（`via-alias / ctr-1` hostname 证实）——别名优先于 ~/.ssh/config 同名 Host | ✅ |
+| 10 | docker oneshot | `{docker:dashr-remote-t1, …}` → `in-docker / Ubuntu 24.04.5 LTS` | ✅ |
+| 11 | docker pty（script 托管） | `cd /root && pwd` → `cwd=/root`（util-linux `script -qfec` 宿主 PTY + 远端 init 双层静默成立） | ✅ |
+| 12 | BYO-PTY spawn | `{spawn:"docker exec -it dashr-remote-t1 bash", cmd:"echo spawned && hostname"}` → `spawned / 728e1cf8a10e` | ✅ |
+| 13 | 错误透明 | ssh：`ssh: Could not resolve hostname no-such-host-xyz: Temporary failure in name resolution`（exit 255）；docker：`Error response from daemon: No such container: no-such-ctr`（exit 1）——原生 stderr 逐字 | ✅ |
+| 14 | 断联自愈 | `kill -9 $$` → exit null；次调用 → 首行逐字 `[remote: session reconnected to fresh shell; cwd reset to default]` + `back` + `cwd /home/u1`（归默认） | ✅ |
+| 15 | 后台输出 Non-Goal | `nohup sleep 5 >/dev/null 2>&1 & echo bg-ok` → 输出恰 `bg-ok`、stderr 空、零噪声（使用者重定向职责示范成立） | ✅ |
+| 16 | status 可达探测 | `{dev4}`（无 cmd）→ `probe: reachable in 3193ms (just now, on demand)` + `session: none — dials on first exec`；**全文无 "offline"**（agent 明确确认） | ✅ |
+| 17 | status 会话层 | pty 用过之后 → `session: idle 4s (connected)`（user 裁决的 idle 语义：连接在、无 activity） | ✅ |
+| 18 | status 容器事实/错误 | `{docker:no-such-ctr}` → `probe: error — error: no such object: no-such-ctr`（docker 原生文本透传） | ✅ |
+
+**审计抽查** ✅：headless session log（`session-5628b047…`）含结构化 `dashr/remote-exec` 事件 3+ 条/会话——`{target, cmd, cwd, exit, durationMs}`（含中断记录：`sleep 300 → exit 130, 2260ms`）。
+
+## 三、四层模型映射核对
+
+| spec 层 | 实现 | 证据 |
+|---|---|---|
+| L2 Bash One-shot（选定） | `ssh -o BatchMode=yes -T / docker exec -i / incus --force-noninteractive` + `bash -lc`，退出码即收尾 | case 1-3, 8, 10, 13 |
+| L4 Assisted PTY（选定） | `ssh -tt` / `incus --force-interactive` / `script -qfec`（docker+spawn）+ nonce 收帧 | case 4-7, 9, 11, 12, 14 |
+| L1/L3（拒绝） | 不存在对应代码路径 | — |
+
+## 四、状态词汇表行为证据（user 2026-09-23 裁决）
+
+- **禁 `offline`**：三态探测输出 + 会话层输出全程缺席（agent 被直接问及并明确否认）。
+- reachable / unreachable / 容器事实态 / error + `idle Ns` / `busy` / `none — dials on first exec` / `died` 全部按 Ruling 16 渲染。
+- **on-demand 双重超时**（Ruling 17）：探测在调用瞬间执行（"just now, on demand" 标注）；本矩阵全部真目标秒回，超时上限（5s/10s）未触发——由单测覆盖（`probe timed out after 10s` 标签路径）。
+- 对比 RM0 时代的歧义（agent reasoning log 里纠结 "offline 是什么"）：本轮 agent 零困惑、零多余 verify 尝试。
+
+## 五、Non-Goal 三条行为证据
+
+1. **后台输出不隔离**：case 15 使用者显式重定向 → 输出干净；未重定向的后台进程按 POSIX 会话语义自然出现在流里（工具不清洗）。
+2. **不重建 shell 内存状态**：case 14 重连后 cwd 归默认 + 明示提示行——由 Agent 上下文决定是否 cd 回去。
+3. **不暴露终端微调**：行列固定 40×120 烤进 init（无任何参数面）。
+
+## 六、真实观察（不阻塞，记录在案）
+
+- **oneshot 会等 ssh 会话通道收尾**：case 15 中 `nohup sleep 5 >/dev/null 2>&1 &` 后调用持约 16.6s 才返回（远超 echo 即出的 bg-ok）——OpenSSH 会话通道语义（sshd 等会话内全部进程释放 fd），非本工具缺陷；agent 需要"发射后不管"时应加 `timeout` 或 `setsid` 全脱钩。工具侧如实等待（错误透明原则），描述文本可后续补一句披露。
+- status probe 的 rtt 含 ssh 全握手（LAN 约 3.2s——含 DNS/KEX）；纯 TCP rtt 需另设基准，非本期范围。
+- dev4 无 docker，嵌套穿透（spec 场景 3 范式 A/B 的 ssh -t 嵌套 docker）未在本矩阵覆盖——spawn 通道（case 12）已证 BYO-PTY 机制本身；嵌套留待有嵌套环境时补测。
+- pty 模式 stdout/stderr 合流（spec §4.2 诚实代价）；oneshot 分离保留。
+
+## 七、测试基线
+
+- worktree 单测：`test/remote/` **9 spec 69/69**（nonce 13 / target 5 / transports 9 / oneshot 6 / pty-session 13 / driver 6 / status 7 / tool 7 / plugin 3）。
+- 全量 vitest（worktree）：恰为基线 14 失败（url-schemes 2 + surface-devices/agent-family 12，皆先在、与本特性无关），577 通过 + 1 skip，无新增失败。
+- `tsc --noEmit`：14 既有错误（同基线集合），remote/* 0 新错。
+
+## 八、遗留（后续里程碑候选）
+
+- RM2 线：forward / tmux 驻留 / WebUI 终端面板（本框架 Non-Goal 边界外）。
+- `ws://` transport（spec §二.2 远期）。
+- status 的 `unreachable` 真机路径（断网/防火墙 DROP 场景）只有单测证据，真机矩阵未覆盖（需临时断 dev4）。
+- 描述文本补一句 oneshot 会话通道持留语义的披露（§六 第 1 条）。
+
+## 九、发布前增量补遗（P16–P20，2026-09-24，均含第一人称验证）
+
+- **P16** `ssh:` 显式选择器落地（后被 P20 降级为消歧备用）；`ssh:ctr-1` 冒烟 exit 0。
+- **P17** 删除自定义 `dashr/remote-exec` session 事件（原生事件集冻结、自定义类型落盘重载必拒——用户实测发现 history 加载失败）；14 个毒化会话以 `ignorable:true` 信封手术修复。原生 `tool/call`+`tool/result` waterfall 即完整审计。
+- **P18** 删除别名机制（插件数据不上 cordis 配置面；行 config 只留运行旋钮）。
+- **P19** `remote({})` = roster 注意力入口（ssh config hosts + docker ps -a + incus list + 池内活会话，本地扫描零拨号）；实测渲染无 exec 尾巴、池 key 内部标记剥离。
+- **P20** 裸名按名优先解析（ssh config → docker → incus，撞名 ssh 优先）；实测裸 `corti` 命中 docker、裸 `dev4` 走 ssh。description 重写为决策表开头 + 输出帽/流分离/pty 生命周期披露；`mode` 上 schema enum。
+- 基线 14 失败定性为包版本锚定问题（user 裁决留待 housekeeping 批处理）。
+- 最终态：`test/remote/` 78/78（11 spec）、tsc 既有基线零新增。

package/docs/50_test-reports/2026-09-23-remote-framework/347/254/254/344/270/200/344/272/272/347/247/260/345/244/215/346/265/213/346/212/245/345/221/212.md

@@ -0,0 +1,125 @@
+# Remote 执行框架 — 第一人称复测报告（approval policy = `never`）
+
+- **日期**: 2026-09-23（矩阵 20:52–20:59 +08:00）
+- **分支/HEAD**: `remote-framework` @ `ac8720a`（**post-P15**：pty 4M 尾窗环 + deathWaiter 摘除）
+- **复测载体**: **本 agent 自己的 live session**（Dev/Test 1 实例 4999 Web 运行时，`session-95c48291-f958-455c-83ab-98de3fa815a4`，cwd `/home/u1/workspaces/dashr`），直接以 `remote` 工具逐条派发——不是 headless 代跑
+- **策略面**: 同一 session 内 `approval/policy: ask → never`（seq 2 → 6）、`sandbox/mode: workspace-write → danger-full-access`（seq 1 → 5）；全部复测动作发生在 `never` 之后
+- **对照**: 原验收报告 `docs/50_test-reports/2026-09-23-remote-framework实测报告.md`（矩阵 @ c696fca，**pre-P15**）+ SDD ledger `.superpowers/sdd/2026-09-23-remote-framework-impl/progress.md`
+- **运行时同一性**: 实例 20:22:08 启动，`lib/remote/plugin.js` 构建于 20:21:34；rsync 后 worktree `src/` 与 monorepo 副本 `src/` `diff -rq` 为空 → **所测即 `ac8720a`**。P15 之前从未在真运行时跑过矩阵（Task 10 矩阵早于 `ac8720a`），本报告是 **P15 代码的首次第一人称实测**。
+
+---
+
+## 一、结论
+
+| 面 | 结果 |
+|---|---|
+| 18 case 矩阵（本 agent 亲自派发） | **18/18 ✅**（1–8、10–18 直接复现；9 别名腿在 4999 原地热生效后复现） |
+| P15/C1 输出帽（此前仅单测） | **✅ 第一人称**（oneshot 30k 帽 + pty 4M 环，尾保留，daemon 存活） |
+| 原报告 §八 遗留「unreachable 真机路径」 | **✅ 补上真机证据**（`192.0.2.1` 黑洞 → `Connection timed out`） |
+| 审计事件 | **✅** 本 session 日志含结构化 `dashr/remote-exec`（target/cmd/cwd/exit/durationMs，含 exit 130 中断） |
+| approval 耦合 | **零**。`never` 下无一次 approval 询问/拒绝（63 次工具调用，0 错误，0 `approval/request|denied`） |
+| `test/remote/` 单测 | **70/70 ✅**（9 spec） |
+| 全量 vitest | 14 失败（**同基线 2 文件**）/ **578 通过** / 1 skip（593） |
+| `tsc --noEmit` | **14 错，集合同基线，`remote` 0 提及** |
+
+---
+
+## 二、18 case 矩阵（本 session verbatim）
+
+| # | case | 本 session 调用与结果 | 判定 |
+|---|---|---|---|
+| 1 | ssh oneshot | `{dev4, echo CASE1: … / git --version}` → `CASE1: 0 \| ok / git version 2.43.0`，exit 0 · 4.2s | ✅ |
+| 2 | 退出码透传 | `{dev4, exit 42}` → exit **42** · 3.4s | ✅ |
+| 3 | 复合语法 | `{dev4, ls / \| head -2 && echo $HOME}` → `bin / bin.usr-is-merged / /home/u1` | ✅ |
+| 4 | pty 状态保持 | `cd /tmp && export F=1`（cwd `/tmp`）→ `pwd && echo $F` → `/tmp` `1` | ✅ |
+| 5 | pty 多行单帧 | `"echo a\necho b"` → `a\nb` 一帧，exit 0 · 0.3s | ✅ |
+| 6 | 伪 marker 免疫 | `printf '\033]133;D;deadbeefdeadbeef;99\007' ; echo real-after-marker` → `real-after-marker`，exit **0**（非 99） | ✅ |
+| 7 | pty 超时打断 | `sleep 300` timeout 2 → `exit 130 · 2.2s · interrupted`；随后 `echo alive` → exit 0（会话存活） | ✅ |
+| 8 | incus oneshot | `{incus:ctr-1, cat /etc/os-release \| head -1}` → `Ubuntu 26.04 LTS` | ✅ |
+| 9 | incus pty + **别名路由** | 显式前缀 pty `cd / && hostname && pwd` → `ctr-1` `/`；**裸名 `ctr-1`** pty `cd / && echo via-alias && hostname && pwd && cat /etc/os-release \| head -1` → `via-alias / ctr-1 / / Ubuntu 26.04 LTS`，cwd `/` | ✅ |
+| 10 | docker oneshot | 新起 `dashr-remote-t1`（ubuntu:24.04）→ `in-docker / Ubuntu 24.04.5 LTS` | ✅ |
+| 11 | docker pty（script 托管） | `cd /root && pwd` → cwd `/root` · 0.1s | ✅ |
+| 12 | BYO-PTY spawn | `{spawn:"docker exec -it dashr-remote-t1 bash", cmd:"echo spawned && hostname"}` → `spawned / de819743d988` | ✅ |
+| 13 | 错误透明 | ssh：`ssh: Could not resolve hostname no-such-host-xyz: Temporary failure in name resolution`（exit 255）；docker：`Error response from daemon: No such container: no-such-ctr`（exit 1）——原生 stderr 逐字 | ✅ |
+| 14 | 断联自愈 | `kill -9 $$` → `exit null` · 0.2s；次调用 → 首行逐字 `[remote: session reconnected to fresh shell; cwd reset to default]` + `back /home/u1`，cwd `/home/u1` | ✅ |
+| 15 | 后台输出 Non-Goal | `nohup sleep 5 >/dev/null 2>&1 & echo bg-ok` → 输出恰 `bg-ok`，stderr 空，**3.6s**（见 §四.1） | ✅ |
+| 16 | status 可达探测 | 无 pty 的 `dev3`/`dev2`：`probe: reachable in 1438/1061ms (just now, on demand)` + `session: none — dials on first exec`；**全文无 "offline"** | ✅ |
+| 17 | status 会话层 | 用过 pty 后 `{dev4}` → `session: idle 8s (connected)` | ✅ |
+| 18 | status 容器事实/错误 | `{docker:no-such-ctr}` → `probe: error — error: no such object: no-such-ctr`；`{docker:dkr-1}`（已退容器）→ `probe: container exited` | ✅ |
+
+**审计抽查 ✅**：本 session 日志（`session.v3.jsonl.zstd` 解压）含逐条 `dashr/remote-exec`：`{target, cmd, cwd, exit, durationMs}`——含 `sleep 300 → exit 130, 2233ms`、别名腿 `target: "ctr-1" → cwd "/", exit 0`、`target: "docker exec -it … bash"`（spawn）。工具面失败路径（Task 8 的 Ruling 14）本轮无异类失败可触发，未新增样本。
+
+---
+
+## 三、补测：原报告遗留缺口
+
+### 3.1 输出帽（P15 / 终审 C1，此前仅 5M 单测）
+
+| 面 | 调用 | 结果 |
+|---|---|---|
+| oneshot 30k 帽 | `{dev4, python3 -c "print('x'*50000)"}` | 文本首行 `[truncated: showing last 30000 of 50001 chars]`，尾标 `truncated, original 50001 chars`，exit 0 · 3.4s |
+| pty 4M 尾窗环 | `{dev4, mode:pty, head -c 5000000 /dev/zero \| tr '\0' 'y'; echo; echo TAIL-MARK-OK}` | 文本首行 `[truncated: showing last 30000 of 4000000 chars]`，**尾部 `TAIL-MARK-OK` 在位**，尾标 `truncated, original 4000000 chars`，exit 0 · 4.8s |
+
+判读：pty 收集段被 4,000,000 UTF-16 环截断（`OUTPUT_HARD_CAP`），模型面再经 30k 尾窗；超 5MB 输出下 daemon 无 OOM、无卡死、尾字节保留——**C1 修复在真运行时成立**。注意 `original 4000000` 是**环上界**而非真实总量（帽后切片，设计如此）。
+
+### 3.2 status 真机 `unreachable`（原报告 §八 缺口）
+
+`{192.0.2.1}`（TEST-NET 黑洞）→
+
+```
+192.0.2.1 — ssh host
+probe: unreachable — ssh: connect to host 192.0.2.1 port 22: Connection timed out
+session: none — dials on first exec
+```
+
+词汇表 `unreachable — <native error>` 自此有真机证据（此前仅单测标签路径）。
+
+### 3.3 别名路由的**热生效**事实（新发现）
+
+原 Task 10 把 case 9 的别名腿当"改 home 层 patch（隐含需重启）"处理。本次实测：写入 `.dsh-test/cordis.patch.yml`（`[]` → 一行 `dashr-remote` 行重述 + `containers: {ctr-1: incus:ctr-1}`），**约 3s 内 4999 活体自行重新对账**——
+
+- 之前：`{ctr-1}` → `ctr-1 — ssh host`（~/.ssh/config 同名 Host 胜出）
+- 之后：`{ctr-1}` → `ctr-1 — incus container` + `probe: container RUNNING`，pty 落容器（`via-alias / ctr-1`）
+- 复原（`[]`）同样 ~3s 热生效：`{ctr-1}` 回到 `ssh host`
+
+即 0.1.6 的 HMR reconcile 覆盖 home 层 patch 写读，**别名腿无需重启**。副产品观察见 §四.2。
+
+---
+
+## 四、与原报告的差异 / 真实观察（均不阻塞）
+
+1. **case 15 的"oneshot 等 ssh 会话通道 ~16.6s"未复现**。本轮同形命令 **3.6s** 返回（≈常规 ssh 握手成本），输出/退出码/静默性均符 Non-Goal。原 §六 第 1 条的持留观察在本环境本轮不成立；描述文本是否补披露可再议（不据此改代码——一次观测 vs 一次观测，证据对等）。
+2. **配置热重载会丢弃 live pty 会话**：别名行热生效后，此前 idle 的 dev4 pty 会话从 `session: idle 8s (connected)` 变为 `session: none — dials on first exec`（插件行重挂 → `PtyPool` 重建）。行为可解释（重挂即新建 driver），但**不是** `idleTtlSec` 的语义，属"配置热改的代价"，记录在案。
+3. **case 17 的 idle 语义**在热重载前验证成立（8s connected）；热重载后必然归 none，两者不矛盾。
+4. dev4 无 docker，嵌套穿透（ssh -t 内嵌 docker）仍未覆盖（与原报告一致）——spawn 腿（case 12）已独立证 BYO-PTY 机制。
+
+---
+
+## 五、approval policy `never` 的专门核对
+
+- 同一 session 策略事件：`approval/policy {ask}`（seq 2, 20:46）→ `{never}`（seq 6, 20:50）；`sandbox/mode {workspace-write}` → `{danger-full-access}`。
+- `never` 生效后：**63 次工具调用、0 次 `approval/request` / `approval/denied` / `sandbox/denied`**，18 case + 补测全部完成。
+- 源码面核对：`src/remote/*` 无 `approval` / `sandbox` / `escalat` 任何引用（grep 0 命中）——本框架在 daemon 侧直接派发系统 CLI，**不经** agent 工具审批链，因此策略从 `ask` 收紧到 `never` 对 `remote` 功能面无影响。这条正是本轮复测要回答的问题。
+
+---
+
+## 六、单测 / 类型基线（worktree @ `ac8720a`）
+
+- `npx vitest run test/remote/` → **Test Files 9 passed (9)，Tests 70 passed (70)**（nonce 13 / target 5 / transports 9 / oneshot 6 / pty-session 14 / driver 6 / status 7 / tool 7 / plugin 3——pty-session 较原报告的 13 多 1，即 P15 的 5M 回归）。
+- `npm test` → **14 failed | 578 passed | 1 skipped (593)**；失败恒为 **2 文件**：`test/url-schemes.spec.ts`（2）+ `test/surface-devices/agent-family.spec.ts`（12），单独复跑同得 `14 failed | 41 passed`——**全为 main 既有病，与本特性无关**。（ledger 记的 577 为 `ac8720a` 前数值；P15 新增 1 测试后应为 578。）
+- `npx tsc --noEmit` → 14 错，文件集合同基线（`src/index.ts` 3、`src/url-schemes/index.ts` 1、`src/url-schemes/handlers/agent.ts` 1、`test/url-schemes.spec.ts` 2、`test/url-schemes/gates.spec.ts` 1、`test/surface-devices/agent-family.spec.ts` 6）；**`remote` 0 提及**。
+
+---
+
+## 七、清理与现场状态
+
+- 别名 patch：`.dsh-test/cordis.patch.yml` 已还原为 `[]`（原文件备份 `.scratch/cordis.patch.yml.bak-task10retest`），并已复核热还原。
+- scratch 容器 `dashr-remote-t1` 已 `docker rm -f`；`docker ps -a` 无残留（`{docker:dashr-remote-t1}` 现报 `no such object` 即为清理后真值）。
+- 未触碰 `corti` / `jellyfin` / `ctr-1` / `app` 等既有资产；未改任何源码或构建产物；未重启 4999（本轮全程在同一 session 内完成）。
+- 证据落盘：解压后的本 session 日志 `.scratch/retest-session.jsonl`（356 行，含全部 audit 事件）。
+
+## 八、遗留
+
+- 复核结论：**矩阵与缺口补测全过，approval `never` 无影响；分支 `ac8720a` 的实测证据面现覆盖 post-P15 代码**。
+- 原报告 §八 其余两项仍开放（仅作里程碑候选）：`ws://` transport（spec 远期）；oneshot 会话通道持留语义的披露措辞（且本轮未复现，证据对等）。
+- 本轮产物：本报告；无源码/测试改动，故无新单测需求。

package/lib/client/index.js

@@ -71,7 +71,7 @@ const zh = {
 };
 
 //#endregion
-//#region \0dsh-css:/home/u1/workspaces/dashr/better-dsh/src/failover/client/FailoverRow.module.css.mjs
+//#region \0dsh-css:/home/u1/workspaces/dashr/.worktrees/remote-framework/better-dsh/src/failover/client/FailoverRow.module.css.mjs
 const css$1 = "\n._440e1d7b_row {\n  display: flex;\n  align-items: center;\n  gap: 8px;\n  padding: 12px 0;\n}\n\n._a4f2ceec_rowText {\n  flex: 1;\n  min-width: 0;\n  display: flex;\n  flex-direction: column;\n  gap: 4px;\n}\n\n._9865b509_title {\n  font-weight: 600;\n  font-size: 14px;\n}\n\n\n._3cfec826_slots {\n  display: flex;\n  flex-direction: column;\n  align-items: flex-end;\n  gap: 6px;\n}\n\n._11c2662d_select {\n  width: 280px;\n  max-width: 100%;\n  min-width: 0;\n}\n\n._b7c358f9_alert {\n  color: var(--dsw-alias-danger, #c0392b);\n  font-size: 12px;\n}\n";
 const tagId$1 = "better-dsh/FailoverRow.module.css";
 if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$1) + "]") === null) {
@@ -463,7 +463,7 @@ const zh$1 = {
 };
 
 //#endregion
-//#region \0dsh-css:/home/u1/workspaces/dashr/better-dsh/src/compaction/client/CompactionRow.module.css.mjs
+//#region \0dsh-css:/home/u1/workspaces/dashr/.worktrees/remote-framework/better-dsh/src/compaction/client/CompactionRow.module.css.mjs
 const css = "\n\n\n._13e3747c_thresholdRow {\n  display: flex;\n  align-items: center;\n  gap: 8px;\n  padding: 16px 0;\n  border-bottom: 0.5px solid var(--dsw-alias-border-l2);\n}\n\n._8ad3ff3f_thresholdText {\n  flex: 1;\n  min-width: 0;\n  display: flex;\n  flex-direction: column;\n  gap: 4px;\n  padding-right: 48px;\n}\n\n._9ffb627e_thresholdTitle {\n  font-size: 14px;\n  font-weight: 400;\n  line-height: 22px;\n  color: var(--dsw-alias-label-primary);\n}\n\n._01bea389_thresholdDesc {\n  font-size: 12px;\n  font-weight: 400;\n  line-height: 18px;\n  color: var(--dsw-alias-label-tertiary);\n}\n\n._7f9578de_thresholdError {\n  font-size: 12px;\n  font-weight: 400;\n  line-height: 18px;\n  color: var(--dsw-alias-danger, #c0392b);\n}\n\n\n._cddd78cd_thresholdControl {\n  display: inline-flex;\n  align-items: center;\n  gap: 8px;\n}\n\n._6058fea9_thresholdStepper {\n  position: relative; \n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  min-width: 72px;\n  height: 36px;\n  border-radius: 18px;\n  background: var(--dsw-alias-bg-module-platform);\n}\n\n._39d30469_thresholdValue {\n  min-width: 18px;\n  text-align: center;\n  font-size: 14px;\n  line-height: 22px;\n  font-variant-numeric: tabular-nums;\n  color: var(--dsw-alias-label-primary);\n}\n\n._68bd35c6_thresholdUnit {\n  font-size: 14px;\n  line-height: 22px;\n  color: var(--dsw-alias-label-secondary);\n}\n\n\n._904da366_thresholdArrows {\n  position: absolute;\n  right: 8px;\n  display: flex;\n  flex-direction: column;\n  gap: 2px;\n  opacity: 0;\n}\n\n._6058fea9_thresholdStepper:hover ._904da366_thresholdArrows,\n._6058fea9_thresholdStepper:focus-within ._904da366_thresholdArrows {\n  opacity: 1;\n}\n\n\n._ae9106b1_thresholdArrow {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  width: 17px;\n  height: 12px;\n  padding: 0;\n  border: none;\n  border-radius: 3px;\n  background: color-mix(in srgb, var(--dsw-alias-bg-layer-1) 75%, transparent);\n  color: var(--dsw-alias-label-primary);\n  cursor: pointer;\n}\n\n._ae9106b1_thresholdArrow:hover:not(:disabled) {\n  background: var(--dsw-alias-bg-layer-1);\n}\n\n._ae9106b1_thresholdArrow:disabled {\n  color: var(--dsw-alias-label-caption);\n  cursor: default;\n}\n";
 const tagId = "better-dsh/CompactionRow.module.css";
 if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {

package/lib/fs-aware/sandbox-plugin.js

@@ -6,7 +6,7 @@ import { FsError } from "@deepseek-ai/dsh-fs";
 import { writableRoots } from "@deepseek-ai/dsh-sandbox";
 import { stat } from "node:fs/promises";
 
-//#region node_modules/@deepseek-ai/dsh-fs-sandbox/lib/index.js
+//#region ../../../better-dsh/node_modules/@deepseek-ai/dsh-fs-sandbox/lib/index.js
 /**
 * Path-containment mechanics for the filesystem sandbox. Canonical spellings
 * take the fast lexical path; filesystem identity supplies the conservative

package/lib/remote/plugin.d.ts

@@ -0,0 +1,24 @@
+import { Context } from "@deepseek-ai/cordis";
+import z from "@deepseek-ai/schemastery";
+
+//#region src/remote/plugin.d.ts
+
+declare const name = "dashr-remote";
+declare const inject: string[];
+/** 运行参数旋钮（Ruling P18）：无别名表面——容器一律显式 'docker:' / 'incus:' 前缀。 */
+interface RemoteRowConfig {
+  execTimeoutSec: number;
+  idleTtlSec: number;
+  maxOutputChars: number;
+}
+declare const Config: z<RemoteRowConfig>;
+/** MUST stay an arrow（RM0 plugin.ts 同注：function 声明会被 cordis 当构造器 new 掉，返回的 disposer 丢失）。 */
+declare const apply: (ctx: Context, config: RemoteRowConfig) => (() => void);
+declare const _default: {
+  name: string;
+  inject: string[];
+  Config: z<RemoteRowConfig>;
+  apply: (ctx: Context, config: RemoteRowConfig) => (() => void);
+};
+//#endregion
+export { Config, RemoteRowConfig, apply, _default as default, inject, name };