super-dsh 0.1.12 → 0.3.0

package/node_modules/better-dsh/docs/50_test-reports/2026-09-17-plugins/351/241/265/345/205/255/347/273/204/344/273/266/346/213/206/345/210/206/345/256/236/346/265/213/346/212/245/345/221/212.md

@@ -0,0 +1,76 @@
+# Plugins 页组件化（6 行拆分）+ 卡片描述 实测报告
+
+- 日期：2026-09-17
+- 变更：spec `dashr/docs/specs/plugins-page-components/spec.md`（bundle patch 1 insert → 6 inserts；package.json 补 `description`；native-capture 提升共享模块）
+- 测试环境：Dev/Test 1（upstream 0.1.5-rc.2 源码树 + 内嵌 dashr 副本），实例 **4988**（4999 被占用），LAN socat 中继
+- 结论：**目标全部达成**（dev 线可证的全部事实）；UI 行开关逐键验收待 prod 安装后（见 §六）
+
+## 一、机制事实（对 prod 0.1.3 线 plugin-manager 源码核实）
+
+- 插件页卡片描述 = 包 manifest `description` 字段（`BundleInfo.description` JSDoc："`description` of the package manifest"）。better-dsh 此前缺该字段 → 卡片无描述。官方包走 locale 表（`builtinAgentTeamTitle/Description`），非官方回退 manifest。
+- 页面"组件" = bundle patch 的 **insert 行**（`declaredRows()`：inserts 才进 `rows`；非 insert 行进 `overrides`，该页不显示）。行开关 = 向 profile 用户层 patch 写 `{id, disabled}`，HMR 即时生效（`writePluginEnabled(profile.patchPath, …)` + `reload()`）。
+- 0.1.5-rc.2 测试线无 plugin-manager（无行开关 UI，仅只读 inventory）；行结构为两线共用的 host 侧事实。
+
+## 二、交付物
+
+1. `package.json`：`description` 逐字取 awesome-dsh-plugins listing en 文案（与市场单源一致）；新增 5 个子路径导出（`./url-schemes`、`./failover`、`./compaction-tuning`、`./web-trust`、`./mobile`）。
+2. `cordis.patch.yml`：6 条 insert（dashr-repl 核心 / dashr-url-schemes / dashr-failover / dashr-compaction-tuning / dashr-web-trust / dashr-mobile）；compaction 再启用三条与 `connection` fence 保持 override 行（原生页不列 override——做成 insert 需 fork 上游模块，不采纳）。
+3. 配置键迁移：`urlSchemes`/`hashline`/`trustedPageAuthorities`/`mobile` 离开 dashr-repl Config，落所属行 schema（`DSH_TRUSTED_HOSTS` 派生默认保留在 web-trust 行 schema；MOBILE_CONFIG 原文迁至 mobile 行）。
+4. **顺序不变式结构化**：`native-capture` 升为共享模块（tsdown 多入口 chunk 共享 `native-capture-x_Hos2e8.js`，单例 WeakMap）；wire mask 监听器第一步 `captureAllTools(agent)` 后才 restrict——两行激活顺序无关（`lib/index.js` 与 `lib/url-schemes/index.js` 实测引用同一 chunk）。
+
+## 三、构建卫生
+
+- dev 基 `tsc --noEmit`：与 stash 基线**逐条一致**（仅同类既有错误的行号漂移；基线 15 条均为独立 dev 检出的 host 类型漂移）。
+- dev 基 vitest 全量：**508 过 / 14 挂** —— 14 挂经 stash 基线复跑证实**先于本改动**（url-schemes.spec 2 + agent-family 12，同源类型漂移）。
+- surface.spec 夹具更新为**双行挂载**（镜像真实组合），10/10 过；**反向挂载顺序**（mask 行先于 url-schemes 行）同样 10/10 —— 顺序无关性实测成立。
+- monorepo 副本：`pnpm install`（node_modules 曾被清，build 产物完好）→ `tsdown` + `build-client.ts` 双半重建成功。
+
+## 四、4988 实例实测（第一人称）
+
+boot log 当前段零 error/warn；shell 200；boot graph 含 `"id":"better-dsh"`；`/plugins/??better-dsh/client.js&rev=…` 200 且与 `lib/client/index.js` 仅差服务端追加的 sourceMappingURL 行。
+
+1. **组合面**：`web --dump-config` 六行齐落 —— `dashr-repl→better-dsh`、`dashr-url-schemes→better-dsh/url-schemes`、`dashr-failover→better-dsh/failover`、`dashr-compaction-tuning→better-dsh/compaction-tuning`、`dashr-web-trust→better-dsh/web-trust`、`dashr-mobile→better-dsh/mobile`；override 行 `compaction-basic` `disabled: false` 在位。
+2. **双腿活体**：served HTML 同时含 `__DSH_TRANSPORT__`（authorities = `[test.pc.randomhash.app, pc.randomhash.app, 192.168.31.130]`，schema 默认自 DSH_TRUSTED_HOSTS 派生 ✓）与 `__DASHR_MOBILE__` + zoomGuard 段。
+3. **行开关往返**（用户层 patch 写 `{id: dashr-mobile, disabled: true}`，即 prod 开关按钮的落盘形态）：
+   - 禁用 → 3 秒内 HMR 生效：`__DASHR_MOBILE__` 0、zoomGuard 0、`__DSH_TRANSPORT__` 1（web-trust 行不受牵连）；
+   - 恢复 → `__DASHR_MOBILE__` 2、zoomGuard 1、transport 1。零重启。
+4. **LAN 中继**：`http://192.168.31.130:4988/?token=…` 303（认证重定向，链路通）。
+5. `.dsh-test` 用户层旧 override（`hashline`/`urlSchemes` 挂在 dashr-repl 行）已顺手迁移清零（键已随拆分移行）。
+
+## 五、已知边界
+
+- 0.1.5 测试线的 Settings → Plugins → Plugin list 只读 inventory 不展示 bundle 行（新 UI 模型）；六行 UI 开关验收属 prod 0.1.3 线 plugin-manager 页面。
+- url-schemes 行关闭时：eval/委派桥正常（mask 自带 capture 步骤固化被 mask 定义——单元级由 surface.spec 双行挂载覆盖）；read/write/grep/glob 回落原生语义。
+- failover / compaction-tuning 行关闭后，其 client 设置卡仍在 General 页写 settings（无消费者）——与拆分前"卡在、宿主逻辑在"的形态一致的降级，已在 spec §Out of Scope 记录。
+
+## 六、待办
+
+- user 以普通 user 身份自装实测（发布红线 a→c；本次未 publish、未动 prod）。
+- prod 安装后的 UI 验收清单：better-dsh 卡片显示 listing 描述；6 组件行在列；逐行开关 + HMR 生效；`dashr-mobile` 关闭后真机手势熄灭。
+
+---
+
+## 七、追加轮（2026-09-21）：对齐 harness 0.1.6-alpha.2，真 UI 全量验收 ✅
+
+user 裁决：侧栏 Plugins 页（plugin-manager UI）仅存在于 **0.1.6-alpha.2** 线；prod 已是 0.1.6-alpha.2 + latest better-dsh（0.2.4）。Dev/Test 1 checkout 由 `dsh-v0.1.5-rc.2` 切至 `dsh-v0.1.6-alpha.2`（ddefc45fbc）。
+
+### 对齐轮落位
+
+- **本地 patch 手工重放**（未盲 apply）：pnpm-workspace.yaml（storeDir/verifyDepsBeforeRun/linkWorkspacePackages + allowBuilds `zeromq`、`@deepseek-ai/dsh-subprocess-local`）；root package.json devDep `unrun@^0.3.1`；`packages/client/tsdown.client.ts` REPOSITORY_ROOT 派生（clean apply）；apps/web vite preact alias/dedupe + devDeps preact 10.29.8 pin（冲突手工并，pin 保留）。
+- **vendor 文档再迁移**：`vendor/docs/`（前轮 ENOTDIR 补丁位）在 0.1.6 会被 root tsdown.config 的 `vendor/*` workspace glob 当作**幻影包**（无 package.json → 向上找名 → `@deepseek-ai/dsh-root` → `Cannot find entry lib/types/{index,invariant,startup}.js` 全 build 失败）。已移出 vendor，落 `.scratch/vendor-docs/`。vendor 根不允许任何子目录缺 package.json。
+- **bun 工作流隔离**：树内另一 workstream 的未跟踪 bun-compile 实验文件（`packages/boot/app-boot/src/bun-internal-bridge.ts` + `bun-registry/` + 根 `x`）破坏 pristine tag 的 tsc（生成物 `dsh-bun-registry-entries/bun-registry.generated` 不存在，tracked 代码零引用）。已整体隔离至 `.scratch/bun-workstream-quarantine/`，未删除。
+- **测试 profile 依赖声明**（本轮关键发现）：0.1.6 plugin-manager 以 **profile package.json `dependencies`** 判定"已安装 bundle"；`.dsh-test` profile 此前只有 bundle 行 + 手工 symlink、dependencies 为空 → better-dsh 卡片不出现。已补 `"better-dsh": "0.2.4"`（镜像 prod 形态；不跑 profile install，symlink 供位不变）。
+- 全量构建通过（248 client artifacts）；copy 侧 tsdown + build-client 双半重建；pnpm install 完成 copy 的 14 项 `workspace:*` devDeps 手术链接。
+
+### 真 UI 验收（CDP，4988 @ 0.1.6-alpha.2-ddefc45-dirty）
+
+1. **卡片**：`better-dsh v0.2.4` + listing 文案描述全文在卡（"Make your dsh ready for serious coding tasks. (Tools x Schemas)^REPL. …"）—— description 修复在真 UI 得证。
+2. **组件**：`Components 6 total · 6 running` —— dashr-repl / dashr-url-schemes / dashr-failover / dashr-compaction-tuning / dashr-web-trust / dashr-mobile，模块名逐行正确，各带 `role="switch"`。
+3. **行开关真 UI 往返**（dashr-mobile）：
+   - 关 → aria-checked true→false；用户层 patch 立现 `{id: dashr-mobile, disabled: true}`；2.5s 内 served HTML `__DASHR_MOBILE__` 归零、zoomGuard 消失、`__DSH_TRANSPORT__` 不受牵连；
+   - 开 → override 行被移除、行态回 true、mobile 全局 + zoomGuard 复返。零重启，零页面错误。
+4. 截图：`.scratch/4988-plugins-016.png`（列表）、`4988-mobile-off.png` / `4988-mobile-on.png`（往返两态）。
+
+### 结论
+
+两项原始诉求（卡片描述、组件化行开关）在**与 prod 同版**的 harness 上全量验收通过。发布仍按红线等待 user 单次明确放行。

package/node_modules/better-dsh/docs/50_test-reports/2026-09-22-4988/345/217/214/345/271/263/351/235/242/345/220/257/345/212/250/344/277/256/345/244/215/345/256/236/346/265/213/346/212/245/345/221/212.md

@@ -0,0 +1,76 @@
+# 4988 双平面启动修复（首工具调用 'prepare' 崩溃 + 会话毒化）实测报告
+
+- 日期：2026-09-22
+- 环境：Dev/Test 1（upstream `dsh-v0.1.6-alpha.2` checkout + 内嵌 better-dsh 0.2.4 副本），实例 4988（unit `dsh-4988-test` + LAN socat 中继），`DSH_HOME=/home/u1/workspaces/dashr/.dsh-test`
+- 结论：**根因修复 + 第一人称实测通过**。崩溃与 better-dsh 无关（headless 无 better-dsh 一样崩；prod 3080 带 better-dsh 0.2.4 正常）；根因是 **tsx 源码启动的双平面模块分裂**。修复 = 产物面启动（`apps/cli/lib/bin.js` + 裸 node，与 prod 同构）。
+
+## 一、症状（user 报告，2026-09-21/22）
+
+每个新 session 的**第一个工具调用**必失败：
+
+```
+This turn failed  Cannot read properties of undefined (reading 'prepare')  UNKNOWN
+```
+
+其后同 session 任何后续轮次：
+
+```
+This turn failed  DeepSeek Messages tool calls need immediate results  INVALID_REQUEST
+```
+
+会话从此不可用。复现的失败工具：`bash`、`skill`；Llm `thinking` 流正常出字（LLM 请求/响应路径完好），崩溃点在工具调度。
+
+## 二、证据时间线（session log 全量扫描，88 个 zstd session）
+
+| 时间（HKT） | session | 工具调用数 | turn 错误 | 备注 |
+|---|---|---|---|---|
+| 09-12 ~ 09-15 01:09 | 数十个 | 1–289/个 | 0 | 同一 09-12 01:13 boot，read/write（dvc:// URI 走 better-dsh remask）全部成功 |
+| 09-15 01:26 | `…7842bf` | 1 | prepare + INVALID_REQUEST | **首例**；agent preset `cordis`；旧 0.1.5-rc.2 boot |
+| （无 session） | — | — | — | 09-15→09-22 间无任何真实 chat session 复测 |
+| 09-22 00:06 | `…8c2514ba` | 1 | prepare + INVALID_REQUEST | user 复测；默认组合 |
+| 09-22 00:12 | `…5ca418a1` | 1 | prepare | user 复测；preset cordis |
+
+关键事实：09-15 01:09（成功，13 调用）与 01:26（首败）在**同一 daemon 进程**上——非重启/重建引入；align 轮（09-21）之前已存在。
+
+## 三、根因链（每步有实证）
+
+1. **崩溃点**：`agent-loop/src/tool-calls.ts` `startCall` 的 `ctx.tools[TOOL_RUNTIME_SCHEDULER].prepare(call.exec)`。栈经临时诊断打点捕获（已还原）。`tool/call` 事件先落（`appendToolCall`），prepare 抛 TypeError → turn 以 UNKNOWN 结束；**孤儿 tool/call 无结果** → 之后每轮 DeepSeek 序列化器拒绝（`llm-deepseek/src/protocols/messages/serialize.ts:117` 的 "tool calls need immediate results"）。
+2. **诊断打点实测**：`ctx.tools` 是 ToolRuntime 实例，ownSymbols 含 `Symbol(@deepseek-ai/dsh-tools.scheduler)`，但与 agent-loop 导入的 symbol **同 description 不同对象** = 同进程两份 `@deepseek-ai/dsh-tools`。
+3. **两份从哪来**：tsx 源码启动 = 双平面运行时——
+   - TS 文件（apps/cli、各包 src）经 `tsconfig.base.json` `paths`（`@deepseek-ai/dsh-*` → `packages/*/*/src/index.ts`）→ **src 副本**；
+   - plugin loader 把组合行模块名解析为构建 lib 的 file URL → **lib 副本**（且 vendor/cordis 的 lib bundle 陈旧——不含 `FiberState` 导出）。
+   - lib 侧 ToolRuntime 把 scheduler 挂在 lib 副本 symbol 下；src 侧 agent-loop 按 src 副本 symbol 查 → `undefined`。
+4. **为何 prepare 门不接住**：`prepareExecution` 的 try/catch 只包门内瀑布；`ctx.tools[SYMBOL]` 在 agent-loop 侧、门之前求值。
+5. **为何 paths-less 收敛不可行**：`vendor/cordis/src/fiber.ts` 的 `export const enum FiberState` 被 tsc 内联（bundle 无该运行时导出），tsx 只能保留 value import → 产物 lib 面 boot 必然 `SyntaxError: ... does not provide an export named 'FiberState'`。**源码启动本质上需要 src 面** → 唯一正解 = 产物面启动。
+
+## 四、better-dsh 判定：**无关（exonerated）**
+
+- headless 一次性任务（无 web profile、无 better-dsh、`--profile headless`）在 tsx 启动下**同栈同错**；
+- prod 3080（npm 0.1.6-alpha.2 + better-dsh 0.2.4，产物面运行）工具调用全部正常——本报告撰写会话即运行其上；
+- 九条运行期 import 的 better-dsh 嵌套链接审计：8 条本就指 workspace，1 条（`dsh-home-paths` → `.pnpm/@deepseek-ai+dsh-home-paths@0.1.2-rc.1`）为陈旧 registry 副本，**已改链**到 `packages/util/home-paths`（见 §六）。
+
+## 五、修复与验证
+
+**修复**（对 src 零改动——三个临时诊断打点已全部还原，`git status` 干净）：
+
+- `tests/start-4999.sh`：boot 行改为 `node apps/cli/lib/bin.js web --no-open --port $PORT`（产物面 + 裸 node，无 tsx），附根因注释与 lib/bin.js 存在性守卫；
+- `AGENTS.md` §二 启动块同步改写：新命令 + 红线（tsx 源码启动禁止用于回归验收）+ `pnpm run build` 前置条件；
+- 全量 `pnpm run build` 已跑（exit 0），产物面完整。
+
+**验证**：
+
+1. headless A/B（同 checkout 同 home）：tsx 启动 → 必现 `prepare` 崩溃；`node apps/cli/lib/bin.js` → 过（调度器查找命中）。
+2. **真 session 第一人称**（systemd-run 沙箱外一次性任务，真 LLM + 真 bwrap）：
+   - `bash`：`echo repro-marker-4988` → `repro-marker-4988`（exit 0）✅
+   - `skill`：调用返回**结构化结果**（"skill using-superpowers is unknown"——headless cwd 无该技能目录，属正常业务错误；关键在 tool result 落账，不再 UNKNOWN）✅
+3. 4988 web 实例（修复后重启，`LAN=1`）：shell HTTP 200、`__DSH_BOOT__` 在位、boot graph 含 `"id":"better-dsh"`；进程确认为 `node …/apps/cli/lib/bin.js web --no-open --port 4988`。
+4. agent-loop/tools lib 复查：无 `dashr-debug` 残留；两包 src 无本地改动。
+
+## 六、遗留与备注
+
+- better-dsh 副本嵌套树仍存在非运行期陈旧链（`dsh-agent-loop`、`dsh` → `.pnpm …@0.1.2-rc.1`；运行期不 import，无实害）。运行期九链已全 workspace 化。
+- `packages/subagent/tool-subagent-report/` 为**只含 lib/ 的异源残留**（无 package.json/src、git 未跟踪；疑另一 workstream 产物），未被任何 manifest 引用，无实害；处置待 user 裁决。
+- **旧中毒 session 无法复活**（孤儿 tool/call 已落账）：09-15 `7842bf` 与 09-22 两个 session 请弃用；新 session 正常。
+- prod 3080 无需任何动作（本就产物面运行）。
+- 09-15 `7842bf`（旧 0.1.5 树 + cordis preset）为同类双平面机制在旧树的另一形态；旧树已升级，不回溯归因。
+- 诊断过程临时文件：`.scratch/session-debug/`（session 解包与扫描脚本），留作证据。

package/node_modules/better-dsh/docs/50_test-reports/2026-09-22-better-dsh/347/273/204/344/273/266/347/203/255/346/217/222/346/213/224/344/270/216/344/276/235/350/265/226/347/272/247/350/201/224/345/256/236/346/265/213/346/212/245/345/221/212.md

@@ -0,0 +1,134 @@
+# better-dsh 六组件热插拔（Cordis HMR）与行间依赖级联 实测报告
+
+- 日期：2026-09-22
+- 问题：better-dsh 是否可热插拔（cordis HMR）？六个组件行是否逐个可热插拔？若组件间存在依赖，关掉被依赖组件时，依赖方是自动关闭还是留在 active 里运行时出错？
+- 测试环境：Dev/Test 1 实例 **4988**（`DSH_HOME=/home/u1/workspaces/dashr/.dsh-test`，harness 0.1.6-alpha.2 + better-dsh 0.2.4，与 prod 3080 同版），systemd `dsh-4988-test.service`
+- 结论：**全部可热插拔（零重启）**；**六个组件行无一例外**；**行间不存在 inject 边，因此关闭任一组件不会级联关闭其他组件**（诊断见 §四）
+
+---
+
+## 一、机制事实（源码锚点）
+
+### 1.1 行开关 = 写 profile 用户层 patch + 活体重算
+
+- `Plugins` 页的行开关落到 `PluginManager.setPluginEnabled`（`upstream/deepseek-harness/packages/boot/plugin-manager/src/index.ts:302`）：写 `{id, disabled}` 到 `profile.patchPath`，再 `reload()`。
+- `writePluginEnabled`（`packages/boot/plugin-manager/src/patch.ts:14`）用 yaml Document **原地改最后一个同 id 行**（有则改 `disabled`，无则追加），保留注释与其余字段；本实例对应文件 `.dsh-test/profiles/web/cordis.patch.yml`。
+- `reload()` → `reconcileProfilePatches`（`packages/boot/app-boot/src/index.ts:251`）：把完整 patch 列表`entry.update()` 进根 Include 行，然后 `ctx.loader.await()` 等激活收敛——**在同一个进程里 unmount/mount**。
+- `change()`（`plugin-manager/src/index.ts:557`）里 `application` 的取值由是否在场决定：`ctx.get('hmr') !== undefined ? 'applied' : 'restart-required'`。即**没有 hmr 服务的 profile，开关仍写盘，但要重启才生效**。
+- 反向兜底：`dsh-hmr` 也 watch profile patch 文件本身（`packages/boot/hmr/src/index.ts:215`，watch `profile.patchPath` + `$DSH_HOME/cordis.patch.yml` + profile `package.json`），所以**手改这些文件同样热生效**，不必点 UI。
+
+### 1.2 什么被 watch，什么不被 watch
+
+- `packages/bundle/base/cordis.patch.yml:28-32` 给 hmr 行配的是 **`root: []`**（注释原文 "Profile configuration reloads by default; module roots are opt-in."；`HmrConfig` JSDoc："an empty list leaves only explicit configuration watches"）。
+- 推论：**只有配置面热**。改 better-dsh 的 `lib/*.js` 不会触发 host 侧重载，必须重启（除非显式给 hmr 配非空 `root`）。
+- client 面：整套客户端是**一个 bundle**（`package.json` 的 `dsh.client`），不按组件拆；`client-hmr`（`packages/client/hmr/src/index.ts`）是 host 侧 500ms stat-poll 每个 graph 行的 client bundle + SSE 推 `rebuilt`，浏览器侧换模块——**行开关不碰 client bundle**，客户端靠"页面全局缺席即休眠"降级。
+
+### 1.3 组件行的定义
+
+页面上的"组件" = bundle patch 的 **insert 行**（`declaredRows()`，`plugin-manager/src/index.ts:447`）；非 insert 行只进 `overrides`，页面不列、不可单独开关。
+
+`better-dsh/cordis.patch.yml:19` 起共 **6 条 insert**：
+
+| 行 id | 模块 | 源码 inject |
+|---|---|---|
+| `dashr-repl` | `better-dsh` | `['tools']`（`better-dsh/src/index.ts:132`） |
+| `dashr-url-schemes` | `better-dsh/url-schemes` | `['tools','fs','skills','subagents','sessions','settings','agents','sessionPersistence']`（`better-dsh/src/url-schemes/index.ts:78`） |
+| `dashr-failover` | `better-dsh/failover` | `[]`（行内 `ctx.inject(['settings'])`，`better-dsh/src/failover/index.ts:43`） |
+| `dashr-compaction-tuning` | `better-dsh/compaction-tuning` | `[]`（行内 `ctx.inject(['settings'])`/`['compaction']`，`better-dsh/src/compaction/index.ts:56`） |
+| `dashr-web-trust` | `better-dsh/web-trust` | `[]`（行内 `ctx.inject(['webServer'])`，`better-dsh/src/web-trust.ts:180`） |
+| `dashr-mobile` | `better-dsh/mobile` | `[]`（行内 `ctx.inject(['webServer'])`，`better-dsh/src/mobile/plugin.ts:29`） |
+
+override 行 4 条：`compaction-basic` / `command-compact` / `tool-result-pruner`（再启用）+ `connection`（fence）——**不是组件**，页面无法开关。
+
+---
+
+## 二、实测方法
+
+1. 备份 profile 用户层 patch：`.scratch/cordis.patch.yml.bak-hotplug-probe-1790010496`。
+2. 取本 boot token URL（`.scratch/.4988-url`），`curl -c jar -L` 拉 served HTML 作为 boot script 双腿探针（基线 `http=200 bytes=36031`；`__DASHR_MOBILE__ 2`、`__DSH_TRANSPORT__ 1`、`ios-zoom-font-floor 1`、`zoomGuard 2`）。
+3. 逐行 `plugin_manager set_plugin {enabled:false}` → 读 `list_plugins`（`enabled` / `fiberPhase`）→ 再 `{enabled:true}` → 复读。
+4. 全程以 `ChangeResult.application` 判定是否热生效；`restart-required` 与 `applied` 互斥可验。
+5. 收尾：从备份还原 patch 文件并复验 composed 状态与 served HTML。
+
+---
+
+## 三、实测结果
+
+### 3.1 逐组件 off → on（全部 `{"changed":true,"application":"applied","warnings":[]}`）
+
+| 行 | off 后 `fiberPhase` | on 后 | 副作用探针 |
+|---|---|---|---|
+| `include:dashr-mobile` | `null`（enabled:false） | `active` | served HTML：`__DASHR_MOBILE__` 2→**0**→2、`zoomGuard` 2→**0**→2、`ios-zoom-font-floor` 1→**0**→1；`__DSH_TRANSPORT__` 恒 1（web-trust 腿不牵连） |
+| `include:dashr-web-trust` | `null` | `active` | `__DSH_TRANSPORT__` 1→**0**→1；mobile 腿恒 2（互不牵连） |
+| `include:dashr-failover` | `null` | `active` | — |
+| `include:dashr-compaction-tuning` | `null` | `active` | — |
+| `include:dashr-url-schemes` | `null` | `active` | off 期间 read/grep/edit 回落原生语义仍可用（`read`/`grep` 复验通过）；核心行全程 `active` |
+| `include:dashr-repl`（核心） | `null` | `active` | off 时同页 `list_plugins` 里**其余 5 行全部保持 enabled:true / active**；eval 工具随行卸载，重开后 `eval` 恢复（复验 cell 跑通，pad 命名空间由 turn-1 快照恢复） |
+
+- 用户层 patch 形态（以 mobile 为例）：`- id: dashr-mobile` + `disabled: true`（关闭）→ `disabled: false`（打开），原地改写、注释保留。
+- **零重启**：全程 `application:"applied"`，无 `restart-required`。
+
+### 3.2 收尾复原
+
+- `diff` 备份 vs 现文件：**逐字一致**（`cp` 还原 + `RESTORED IDENTICAL`）。
+- served HTML 回基线（2 / 1 / 1 / 2），`list_plugins` 六行全 `enabled:true / active`。
+- NOTE：`writePluginEnabled` 的语义是"改最后一次匹配行，否则追加"，所以 probe 期间会给 `dashr-web-trust`/`dashr-failover`/`dashr-compaction-tuning`/`dashr-url-schemes` 追加 `disabled: false` 覆盖行、并给 `dashr-repl` 行补 `disabled: false`；**这些都只是 probe 残留，已随备份还原清除**。正常 UI 使用中，用户关闭过的行会留下 `disabled: false` 覆盖行，这是该实现的设计行为（幂等、语义无变化）。
+
+---
+
+## 四、行间依赖与级联：结论与通用语义
+
+### 4.1 better-dsh 六行之间：不存在依赖边，无级联
+
+- **实测**：关任一组件时其余五行保持 active（含关核心 `dashr-repl` 的那一刻）。
+- **静态**：六行 `inject` 只声明 host 服务；行内动态 `ctx.inject([...])` 也是 host 服务（`settings` / `webServer` / `compaction`）。全包 grep **无 `provide()`**；唯一被提供的服务 `replRuntime` 由核心行自己 `ctx.plugin(DashrRuntime)` 注册、并由**同一行**的 `ctx.inject(['replRuntime'])`（`better-dsh/src/index.ts:966`、`:997`）消费——是**行内边**，随行一起销毁/重建，不跨行。
+- **唯一跨组件耦合**是模块级单例 `native-capture`（`better-dsh/src/native-capture.ts`，capture-before-mask）：核心行的 wire mask 监听器第一步自己调 `captureAllTools`，url-schemes 行缺席也照常；反之 url-schemes 缺席时核心的 eval/委派桥正常。这是**共享 ESM chunk，不是 cordis 服务边**，因此不参与 fiber 依赖计算。
+- 组件行关闭后的降级形态是设计内且 fail-open 的（见 `docs/specs/plugins-page-components/spec.md` §五 / §Out of Scope）：url-schemes 关 → read/write/grep/glob 回落原生；failover / compaction-tuning 关 → 其 client 设置卡仍在但无消费者；mobile / web-trust 关 → 页面全局缺席，客户端惰性。
+
+### 4.2 若真存在 inject 边：消费方**自动挂起（PENDING）**，不是留在 active 里运行时崩
+
+Cordis fiber 的依赖语义（`upstream/deepseek-harness/vendor/cordis/src/fiber.ts`）：
+
+- `_refresh()`（`:611`）把消费方的 epoch 由"每个 inject 服务提供者 fiber 的 uid 串"决定；provider 消失（`reflect` 删 impl 后 `notify` → 各依赖 fiber `_refresh()`，`vendor/cordis/src/reflect.ts:277`/`:314`）→ epoch 变 `INACTIVE`。
+- `_setEpoch()`（`:625`）在 epoch active→INACTIVE 时调 **`_unload()`**（`:675`）：跑完该 fiber 全部 disposer、撤销其全部注册（工具、事件、slot…），状态落到 **`PENDING`**。
+- provider 回来 → epoch 变有效 → **`_reload()`**（`:646`）重跑 plugin `apply`。即 **自动关 + 自动开**。
+- 启动/重算期把这状态报成 `pending (waiting for service(s): X)`（`packages/boot/app-boot/src/index.ts:795`、`:826`）；preset 挂载审计里是 `... waiting for X`（`packages/preset/agent-presets/src/mount.ts:322`）。
+
+**重要副作用（本次新发现，源码推导，未做破坏性实测）**：`reconcileProfilePatches` 把重算后新出现的非 ACTIVE 条目判为 introduced failure 并 **throw**（`packages/boot/app-boot/src/index.ts:268`；`inactiveEntries` 遍历全部 loader 条目、非 ACTIVE 即计入，`:769`）。因此"关掉被依赖组件"这一次 toggle 的返回会是 **`application:"failed"` + diagnostic（点名 pending 的依赖方）**，而盘上的 `disabled:true` 已经写入且运行时确实已挂起依赖方——即用户看到的是**开关报错 + 依赖方变 pending**，而非静默坏掉或"留在 active 里崩"。
+
+**例外：用 `ctx.get()` 的消费方不参与依赖计算**，provider 消失时它**留在 active**、运行时自行降级或报错。本插件内就有这种形态：`better-dsh/src/compaction/index.ts:116`/`:151` 的 `ctx.get('llm')`/`ctx.get('compaction')`、以及 plugin-manager 自己 `ctx.get('hmr')`（缺 hmr 就退回 `restart-required`）。
+
+---
+
+## 五、边界与未验证
+
+- **代码面默认不热**：`hmr` 行 `root: []`，默认部署下改 `better-dsh/lib/*.js` 不触发热重载。**但 opt-in 后可用**，见 §七（同日追加轮实测）；prod 安装态的不可热性为源码推导，未实测。
+- **client 半不按组件拆**：行开关只影响 served HTML 注入腿；client bundle 需重建 + `client-hmr` stat-poll 才会换模块。
+- **§4.2 的级联失败路径为源码推导**：本 profile 内没有"两个都可开关、且其一 inject 另一个"的行对（六组件间无边；host 侧 provider 行多为 `management-required` 或动它会打断本 session），故未做破坏性 live 验证。若日后需要实证，最小实验是造一对测试行（provider + `inject:[...]` 消费方）在同一 bundle patch 里，关 provider 观察消费方 `fiberPhase` 与 `ChangeResult`。
+- 本次实测在 Dev/Test 1（4988）；prod 3080 未动。
+
+---
+
+## 七、追加轮（2026-09-22）：代码热替换（module HMR）实测 ✅
+
+**更正前文口径**：§1.2 的"只有配置面热"是**默认部署**的结论，不是 DSH 的能力边界。给 hmr 行配非空 `root` 后，**改插件代码会活得即时重载**。同实例（4988）实测：
+
+1. profile 用户层 patch 追加：`- id: hmr` + `config: { root: [/…/packages/better-dsh/better-dsh/lib] }`（hmr 行自重配，组合照常收敛，served HTML 标记不变）。
+2. 在构建产物 `lib/mobile/plugin.js` 给注入脚本加可观测标记（`raw + "\n/*hmrprobe*/"`）。
+3. 无重启 `curl` 鉴权页面：`hmrprobe` **0 → 1** —— 进程清模块缓存、重新 import、重新 apply 该行插件。
+4. 还原文件：`hmrprobe` **1 → 0**，文件字节一致；随后摘掉 hmr `root` 覆写，patch 文件回基线（`diff` 逐字一致），页面标记回 `mobile=2 / transport=1`。
+
+**为什么 dev rig 能热、prod 安装态不能**（源码锚点，`packages/boot/hmr/src/index.ts`）：上游把可重载单元定义为"用户代码"，`loadDependencies` 与变更分类都硬排除 `/node_modules/`（`:70`、`:357`），reload 判定只认"依赖树里含 accepted 文件"的插件（`:441-453`）。prod profile 里插件 realpath 就在 `node_modules` → 依赖列表为空 → 永不重载；dev rig 的 `node_modules/better-dsh` 是指向 monorepo 的 symlink，Node ESM 解析到 realpath（无 `node_modules` 段）→ 可重载。§七步骤 3 的成功本身反向印证了这一点。
+
+**已知粒度风险（未实测）**：`partialReload` 只重载"accepted"模块，一次 `tsdown` 全量重建会改 chunk 文件名，可能出现新旧 chunk 混装的中间态；手工改单文件很干净。
+
+机制详述与开法见 dev doc：`~/workspaces/superd/docs/02-dsh/plugin-row-hot-plug.md` §2。
+
+---
+
+## 六、相关文档
+
+- 组件拆分设计：`docs/specs/plugins-page-components/spec.md`
+- 前序实测（拆分 + 真 UI 开关往返）：`docs/50_test-reports/2026-09-17-plugins页六组件拆分实测报告.md`
+- 插件机制速查：`docs/60_exploration-and-research/05-dashr-dev/plugin-development.md`
+- override 三条硬边界 / patch 层序：根 `AGENTS.md` §四

package/node_modules/better-dsh/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/node_modules/better-dsh/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 会话通道持留语义的披露措辞（且本轮未复现，证据对等）。
+- 本轮产物：本报告；无源码/测试改动，故无新单测需求。