super-dsh 0.3.0-c → 0.3.0-e

package/node_modules/better-dsh/docs/50_test-reports/2026-09-23-ssh/345/267/245/345/205/267assisted-pty/344/274/232/350/257/235framing/345/256/236/346/265/213/346/212/245/345/221/212.md

@@ -1,207 +0,0 @@
-# ssh 工具 assisted-pty 远程会话（framing / 边界）实测报告
-
-- 日期：2026-09-23
-- 环境：workspace host（本 GUI 会话）→ 目标 `dev4`（`u1@137.131.54.174`，key `~/.ssh/id_key4`）与 `ctr-1`（本机 **Incus 容器**，`u1@10.245.164.100`，key `~/.ssh/id_key1`）
-- 触发：user「try ssh dev4」+「try ctr-1, lxd, any diff」；本报告为**探索性实测**，非发版验收
-- 结论摘要：会话机制解剖完成（**pty + 生成式 rcfile + OSC 133;D / OSC 7 framing**）；发现 4 类值得处理的行为——**①OSC 133;D 注入可伪造 exit code 并吞掉 stdout**、**②`timeout` 仅以 SIGINT 尽力中断**、**③后台写者可污染下一条命令的 stdout**、**④同 target 命令串行化（长命令阻塞队列）**；其余为设计内行为。**dev4（VM）与 ctr-1（容器）的会话语义逐项一致**，差异只在环境本身（bash/locale/TZ/进程名）。
-
----
-
-## 一、被测对象
-
-| target | 形态 | 连接 | 备注 |
-|---|---|---|---|
-| `dev4` | 远程 VM | `137.131.54.174:22`，`~/.ssh/id_key4` | rtt 0.7–1.2 s；`bash 5.2.21`，`LANG=C.UTF-8`，TZ `+08:00` |
-| `ctr-1` | **本机 Incus 容器**（`incus list`：`ctr-1, CONTAINER`） | `10.245.164.100:22`，`~/.ssh/id_key1` | rtt ~0.5 s；`bash 5.3.9`，`LANG=en_US.UTF-8`，TZ `+00:00`；`systemd-detect-virt` → `lxc` |
-| `lxd` | — | — | **不存在**：`[E_UNKNOWN_TARGET]`；已知 target = `github.com, dev2, dev3, mac, dev1, 137.131.54.174, dev4, ctr-1` |
-
-状态变更（已记录，便于回滚）：**`ctr-1` 实测前为 `STOPPED`，本次由 `incus start ctr-1` 拉起，报告时点仍为 RUNNING**（`incus stop ctr-1` 可还原）。
-
-附带（与 ssh 无关，user 指令）：删除 `dev4:~/openclaw-20260612-010937.tar.gz`（615,409,809 B，home 下唯一 openclaw 文件、无进程持有；`rm -v` 后复查已不存在）。
-
----
-
-## 二、会话机制解剖（关键，后文所有行为都由此解释）
-
-远端进程树（`ps -o pid,ppid,cmd -p $$ -p $PPID`，dev4）：
-
-```
-    PID    PPID CMD
-1169518 1169458 sshd: u1@pts/1
-1169728 1169518 bash --rcfile /tmp/.better-dsh-rc-6e1e345f3a3e4493
-```
-
-rcfile 全文（`/tmp/.better-dsh-rc-<hash>`，两个 target 上内容一致）：
-
-```bash
-# dashr engine rcfile — generated by dashr/remote/framing, do not edit.
-for f in ~/.profile ~/.bash_profile ~/.bashrc; do [ -f "$f" ] && . "$f"; done
-stty -echo 2>/dev/null || true
-PS1=''
-PS2=''
-PS0=$'\033]133;C\007'
-PROMPT_COMMAND='printf "\033]133;D;%s\007" "$?" ; printf "\033]7;file://%s\007" "$PWD"'
-export TERM=dumb
-```
-
-由此可判定的机制事实：
-
-1. **传输是真正的 pty**（`tty` → `/dev/pts/N`，`test -t 0/1/2` 全 yes；`stty -a`：38400 baud、40×120、canonical、`intr=^C`、`erase=^?`、`eof=^D`），不是 `bash -lc` 无 tty 管道；
-2. 会话是**单条常驻交互 bash**（跨调用 PID 不变），命令由 pty 送入、以 `PS0` 的 **OSC 133;C** 起帧、以 `PROMPT_COMMAND` 的 **OSC 133;D;<exit>** 收帧；**exit code 来自终端字节流解析**，不是 ssh 的 channel exit-status；
-3. **cwd 来自 OSC 7**（`file://$PWD`），`ssh({target})` 状态行的 `cwd:` 即此；
-4. `stty -echo` 关回显（所以 `stdin` 参数喂入的内容不会在输出里出现）；`PS1=''` 保证无提示符噪声；`TERM=dumb` 抑制分页/颜色协商。
-
-⚠️ 状态行自称 `env: login-shell (bash -lc)` 与实测不符——实际是**交互式 bash + 生成式 rcfile**（rcfile 内手动 source 了 `~/.profile ~/.bash_profile ~/.bashrc` 来模拟 login 语义）。属文案偏差，非功能缺陷。
-
----
-
-## 三、缺陷 / 风险（按严重度）
-
-### 3.1 🔴 OSC 133;D 注入：远端输出可伪造 exit code 并吞掉 stdout
-
-命令自身只要往 stdout 写 `ESC ] 133 ; D ; <n> BEL`，就会被 framing 当作**本命令的结束标记**：
-
-| 命令 | 观测结果 |
-|---|---|
-| `printf '\033]133;D;99\007'` | `[exit 99]`，stdout 为空（后续 `echo after-osc133-spoof` 被吞） |
-| `echo before-marker; printf '\033]133;D;55\007'; echo after-marker; false` | 输出仅 `before-marker`，`[exit 55]`（**真实 exit 为 1，被覆盖**） |
-| `printf 'MID\033]133;D;66\007TAIL\n'; echo end` | 输出仅 `MID`，`[exit 66]`（**行中位置同样生效**） |
-
-影响：任何远端程序/日志/被下载内容里的这一个字节序列，都能让 agent 得到**假失败或假成功**，并让 stdout 在注入点被截断（静默丢证据）。dev4 与 ctr-1 均复现（ctr-1 实测 `[exit 88]`）。这是本报告唯一建议**优先修**的项。
-
-对照：**OSC 7 注入不生效**（两条独立实证，见 §四.3）——即同一套 framing 对两类 OSC 的信任度不一致，说明「只认自己发的 marker」这件事是**可做到的**，133;D 侧漏了。
-
-### 3.2 🔴 `timeout` 是 SIGINT 尽力中断，不是 kill
-
-- 超时路径经 pty 发 `^C`：`cat`（stdin 阻塞）`timeout: 3` → `[exit 130 (=128+SIGINT) · interrupted]`，3.2 s 返回，符合预期；
-- 但**忽略 SIGINT 的命令能整段跑完**：`bash -c 'trap "" INT; echo ctr-trapped-int; sleep 4; echo ctr-survived-SIGINT'`，`timeout: 2` → 实跑 **4.0 s**，输出两行齐全，`[exit 0 · interrupted]`。dev4 侧同测（`sleep 5` / `timeout: 3` → 5.2 s）同样复现。
-
-影响：挂死且不吃 SIGINT 的命令（编辑器、REPL、`trap '' INT` 脚本）**不会被 timeout 终止**，且最终以 exit 0 上报，agent 会误判为成功。
-
-### 3.3 🟠 跨命令 stdout 污染：后台写者会混进下一条命令的输出
-
-framing 会丢弃**命令之间**的空档输出，但**下一条命令执行期间**到达的输出会被算进该命令：
-
-- ctr-1：调用 A `( for i in 1 2; do sleep 2; echo CTR-LEAK-$i; done ) & echo bg-launched`（瞬时返回）；调用 B `bash -c 'trap "" INT; … sleep 4 …'` 的输出里出现 `CTR-LEAK-1`、`CTR-LEAK-2` 及作业控制行 `[1]+ Done …`；
-- dev4 复现：调用 A 起 `for i in 1 2 3 … echo D4-LEAK-$i`（间隔 1 s），调用 B `echo start-slow-dev4; sleep 4; echo end-slow-dev4` → `D4-LEAK-1..3` 夹在 `start-slow-dev4` / `end-slow-dev4` 之间。
-
-⚠️ 修正一个早期结论：同测法在 dev4 上曾「看不到泄漏」，原因是**后台任务已跑完、输出落在两条命令的空档被丢弃**（时序巧合），并非免疫。凡「上一条命令留下存活的后台写者 + 下一条命令耗时」即污染可复现。
-
-### 3.4 🟡 同 target 命令串行化（正确但会阻塞）
-
-同一 target 的并发调用被排队（实测：`sleep 4` 调用 + 立即 `echo` 调用 → 后者 0.2 s 返回，用时互不重叠）。判别实验：调用 A 阻塞在 `read`（`timeout: 8` → 8.3 s `interrupted`），同批调用 B `echo B-INPUT-MARKER` **未被当作 A 的 stdin**、正常返回 —— 说明是**队列**而非并发共享 pty。
-
-影响：一条挂死命令会阻塞该 target 的后续所有调用（含 `ssh({target})` 状态查询）；跨 target 并行不受影响。**不要对同一 host 并发 fan-out**，要并行就换 target 或写成一条远端脚本。
-
----
-
-## 四、设计内行为（记录，供后续依赖/文档化）
-
-1. **完整 shell 状态跨调用持久**（同一 bash PID）：cwd、导出变量与非导出变量、shell 函数、alias、shell 选项（`set -o pipefail` 实测跨调用为 on）、作业控制均保留 → **一次 `set -e` / `cd` / `unset` / alias 会静默影响后续所有调用**；用完须显式还原。
-2. **命令为简单复合时进程即会话 shell 本身**（`$$ == $BASHPID`，PPID 为 sshd）——所以「子 shell 里的 cd」不生效、而顶层 `cd` 生效。
-3. **`exit` / `kill -9 $$` 杀掉会话 shell** → 工具上报 `[exit null]`（无 exit code），随后**新建 bash**（rcfile hash 变化，dev4 累计 3 个 rcfile；ctr-1 复用同一 hash，仅 1 个——差异未解释，仅记录）；导出变量丢失；**cwd 恢复到最后一次「成功完成命令」上报的路径**：
-   - 实证（ctr-1）：`cd /etc` 成功上报 → 下一条命令 `cd /var/tmp && kill -9 $$`（未上报即死）→ 恢复后 `pwd` = **`/etc`**（非 `/var/tmp`）。
-   - OSC 7 伪造不改变该恢复：`printf '\033]7;file://ctr-1/usr\007'; kill -9 $$` → 恢复仍 `/etc` 而非 `/usr`；另测伪造 `/etc` 后状态行仍显示真实 `/tmp`。**对 OSC 7 的信任是收敛的**。
-4. **输出截断为尾偏**：单次 338,959 chars → 只回**最后 30,000 chars**，头部丢弃，首尾均有 `truncated` 标记。（代价：把状态回显放在长输出开头会被截掉；诊断请用 `wc`/`tail`。）
-5. **stdout/stderr 合并**为同一有序流（stderr-only 正常出现）；**ANSI 转义原样保留**（`1b 5b 33 31 6d…`）；**NUL 字节被吞成空格**（`printf 'x\0y'` → `x y`）→ 二进制请 base64。
-6. **stdin 可用且是 pty**：`stdin` 参数对 `read` 生效（`read -r first; read -r second` 拿到两行）；裸 `cat` 无输入则永久阻塞（→ 超时 130）。
-7. **后台进程存活，不阻塞返回**：`setsid` / `nohup` / 裸 `&` 三者在会话 shell 被 kill 后均存活并完成写文件；`nohup … &` 会在 home 造 `~/nohup.out`（实测后已清理）。
-8. **错误面**：未知 target → `[E_UNKNOWN_TARGET]` 并列出已知 target；连接不可达 → `error : ssh connect failed: connect EHOSTUNREACH …`（ctr-1 停机时实测）。
-9. 其它：`sudo -n whoami` → `root`（dev4/ctr-1 均 NOPASSWD）；emoji/CJK/heredoc round-trip 正常；`locale` 见 §五。
-
-> 探针自身的一个坑（非工具缺陷）：在 `$( )` 里跑 `test -t 1` 会因命令替换把 fd1 接成管道而返回 false，最初误判「stdout 不是 tty」；直接在顶层测为 yes。
-
----
-
-## 五、dev4（VM） vs ctr-1（容器）差异表
-
-| 维度 | dev4 | ctr-1 | 是否影响会话语义 |
-|---|---|---|---|
-| 会话机制 | pty + `bash --rcfile /tmp/.better-dsh-rc-<hash>` | 同 | **无差异** |
-| rcfile 内容 | 8 行，同款 | 同款（逐字节一致） | 无 |
-| `bash` | 5.2.21(1) | 5.3.9(1) | 无（framing 只依赖 PS0/PROMPT_COMMAND/OSC） |
-| locale / TZ | `C.UTF-8` / `+08:00` | `en_US.UTF-8` / **`+00:00`** | 无（但注意 date 差 8 小时） |
-| sshd 进程名 | `sshd: u1@pts/1` | `sshd-session: u1@pts/1` | 无 |
-| 会话 PID 量级 | 116xxxx | 3xx（容器 PID ns） | 无 |
-| `busybox` | 有（`/usr/bin/busybox`） | 无 | 无 |
-| 虚拟化标识 | — | `systemd-detect-virt=lxc`，内核 `7.0.0-30-generic`（宿主内核） | 无 |
-| sudo | NOPASSWD | NOPASSWD | 无 |
-| 行为项（exit code / OSC spoof / SIGINT / 持久化 / kill 恢复 / 截断） | 一致 | 一致 | — |
-
-结论：**framing 层对「VM / 容器」无感**；差异全部来自 guest 环境本身。
-
----
-
-## 六、非 SSH 传输对照（同机 `ctr-1` 与 `corti` 容器）
-
-| 传输 | 默认 pty | `TERM` | 观测 |
-|---|---|---|---|
-| `ssh`（本工具） | ✅ 总是 | `dumb`（rcfile 强制） | `tty=/dev/pts/N`，40×120 |
-| `incus exec ctr-1 -- bash -lc …` | ❌ | 继承 `dumb` | `tty` → `not a tty` |
-| `incus exec -t ctr-1 -- …` | ✅（显式 `-t`） | `dumb` | `tty=/dev/pts/2` |
-| `docker exec corti sh -c …` | ❌ | **未设置** | `not a tty`；`TERM=<unset>` |
-
-即：只有 ssh 面默认给 pty；`exec` 类传输需要显式 `-t`，且 `TERM` 需自行注入——这正是下面附录 B 讨论的接口面。
-
----
-
-## 七、复现命令清单（全部为本报告实测命令）
-
-```bash
-# 机制解剖
-ps -o pid,ppid,cmd -p $$ -p $PPID; cat /tmp/.better-dsh-rc-*; stty -a
-
-# 3.1 OSC 133;D 注入
-printf '\033]133;D;99\007'
-echo before-marker; printf '\033]133;D;55\007'; echo after-marker; false
-
-# 3.2 timeout 只发 SIGINT
-bash -c 'trap "" INT; echo trapped-int; sleep 5; echo survived'   # ssh timeout: 3 → 5.2s / exit 0
-
-# 3.3 跨命令 stdout 污染
-( for i in 1 2 3; do sleep 1; echo LEAK-$i; done ) & echo launched   # 调用A
-echo start; sleep 4; echo end                                        # 调用B（LEAK-n 混入）
-
-# 3.4 串行化判别
-echo waiting; read -r x; echo "got:[$x]"   # 调用A（timeout: 8，阻塞）
-echo B-INPUT-MARKER                        # 调用B（未被当作 A 的 stdin）
-
-# 四.3 cwd 恢复语义
-cd /etc; echo reported-from-etc            # 调用A
-cd /var/tmp && kill -9 $$                  # 调用B → exit null
-pwd                                        # 调用C → /etc（非 /var/tmp）
-printf '\033]7;file://ctr-1/usr\007'; kill -9 $$   # 伪造后再杀 → 仍 /etc
-```
-
----
-
-## 八、建议（未实施，待裁决）
-
-1. **133;D 收帧加固**：只接受「帧内首个、且位于命令输出之后的 harness 自产 marker」不可靠；建议给 marker 加**每会话随机 nonce**（`133;D;<nonce>;<exit>`）或改用独立边带通道（stdout 之外的 fd / 文件），使远端输出无法自证结束。若不愿改协议，退而求其次：解析时**取最后一个 133;D**（`PROMPT_COMMAND` 必然在命令之后执行）可让「命令内注入」失效——但命令若在注入后自杀（`exit`）仍可绕过，故 nonce 才是根治。
-2. **timeout 二段式**：SIGINT 后 N 秒未收帧即升级 SIGKILL（需 kill 远端进程组，pty 前台 pgid 可查）。
-3. **污染面**：收帧后到下一 `133;C` 之间的输出应显式丢弃并计数；或在 3.3 场景下把 job-control 噪声也过滤掉。
-4. **文案**：状态行 `login-shell (bash -lc)` → 改为 `assisted pty (bash --rcfile)` 之类，避免误导。
-5. **文档化**（面向使用方）：状态跨调用持久、同 target 串行、尾偏截断、忽略 SIGINT 的命令不会被超时终止——这 4 条会直接改变 agent 的使用策略。
-
----
-
-## 附录 A：非常规测点清单（本次覆盖）
-
-pty/tty 三 fd 语义 · `stty -a` 行规程 · 回显/`stty -echo` · OSC 133;C/133;D/7 语义与伪造 · exit code 通道（子 shell/管道 `PIPESTATUS`/`command not found` 127/SIGTERM 143/SIGKILL 137/`exit` → null）· `set -e`/`pipefail` 跨调用残留 · alias/函数/非导出变量持久 · cwd 持久与 kill 后恢复 · stdin（`read`/裸 `cat`/`stdin` 参数）· 大数据截断方向 · NUL/CR/ANSI 字节保真 · stdout+stderr 合并序 · heredoc/引号/emoji/CJK · 后台进程存活（setsid/nohup/`&`）与 `~/nohup.out` · 后台输出跨命令污染 · 并发同 target 串行 vs stdin 误食 · 未知 target 与不可达 target 报错面 · sudo NOPASSWD · 容器 vs VM 差异 · `incus exec`/`docker exec` 无 pty 对照。
-
-## 附录 B：通用化讨论（**非实测**，讨论稿，2026-09-23）
-
-> user 议题：「如果所有 remote 都提供这种 assisted pty session——docker、远程机器 over websocket」。以下为基于本次实测的推演，未落地。
-
-**收益（为什么值得统一）**：assisted pty 把「远程执行」从『一次性 `exec` 取 stdout』升级成**有状态的会话面**——持久 cwd/env、可交互 stdin、真实 tty（TUI/彩色/进度条/`sudo` 提示都可工作）、以及通过 framing 拿到的**结构化 exit code + cwd**。同一套 framing 换个 transport 即可复用，agent 侧只认一套语义（本次 dev4/ctr-1 逐项一致就是证据：framing 对 VM/容器无感）。
-
-**成本/风险（本次已暴露的都在这里放大）**：
-- **信任边界翻转**：marker 走的是**被观测对象的输出**。133;D 注入已经能伪造 exit code；一旦 transport 变成 docker daemon / WebSocket 网关这种「中间层」，多一个可注入 stdout 的位置就多一个伪造点。正解是 **nonce / 边带通道**，让「结束」由 harness 自己证明，而不是由远端输出自证。
-- **生命周期归属**：pty 会话是长命进程。docker 容器重建、WebSocket 断线重连、k8s pod 漂移之后，**会话必须被判死并重建**，否则会出现「协议还对、shell 已换人」的僵尸会话（本次 `kill -9` 后 PID 变更 + rcfile hash 变更即其简化版）。需要会话身份（boot id/nonce）随帧下发，客户端校验不一致即重连。
-- **状态泄漏**：持久 shell 是把双刃剑（§四.1）。容器场景下更危险——一个 agent 的 `export TOKEN=`/`cd`/alias 会跨 turn、甚至跨「逻辑任务」残留；多云多租户时这就是横向面。建议每条 framing 命令都带**可选无状态模式**（等价 `bash -lc` 语义：新 shell、显式 cwd、显式 env），把「持久」变成 opt-in 而非默认。
-- **背压与串行化**：本次同 target 串行是安全选择，但 `docker exec`/WebSocket 是**天然可并发**的 channel；若照抄「一会话一队列」，长任务会互相阻塞。需要区分「会话（pty，串行）」与「命令（channel，可并发）」两层，并把强制串行限制在真的共享 pty 的那一层。
-- **`TERM` 与噪声**：`incus exec`/`docker exec` 默认无 tty 且 `TERM` 缺失/继承（§六）。统一层必须**显式分配 pty 并注入 TERM**，否则 TUI 类工具在容器里行为漂移；同时 `PS1=''`+`stty -echo` 这类「消噪」也要成为 transport 契约的一部分，而不是 ssh 专属技巧。
-- **窗口/尺寸与控制字符**：40×120 是本次观测到的固定尺寸。docker/WebSocket 侧需要 `TIOCSWINSZ` 协商，否则 `less`/`top`/`gdb` 一类程序布局错乱；`^C`/`^D` 语义（本次 timeout=SIGINT）也必须定义成契约，而不是各 transport 自行其是。
-- **可观测性**：既然 exit code 与 cwd 都来自字节流，那么**字节流本身就是审计证据**。建议 transport 层留存原始帧（含 marker 与注入点），这样 133;D 这类事件可被事后检出，而不是静默生效。
-
-**一句话**：assisted pty 的**语义**（有状态、可交互、结构化收帧）值得在 docker / WebSocket 上复用，但**信任模型**必须同时升级——marker 必须由 harness 用 nonce/边带自证，会话身份必须可校验，状态持久与并发必须显式可选。否则就是把 ssh 面已经暴露的三个坑（自证结束、僵尸会话、状态残留）复制到更多 transport 上。

package/node_modules/better-dsh/docs/50_test-reports/2026-09-24-v0.1.7-rc.1/345/257/271/351/275/220/350/275/256-compaction/344/270/216failover/350/256/276/347/275/256/351/235/242/344/277/256/345/244/215/345/256/236/346/265/213/346/212/245/345/221/212.md

@@ -1,65 +0,0 @@
-# v0.1.7-rc.1 对齐轮 — compaction / failover 设置面修复实测报告（2026-09-24）
-
-分支 `align/v0.1.7-rc.1`（基线 main = 0.2.4-b，prod 同版）；提交 `5aa9ca0` + `eea888f`。
-
-## 一、症状与根因
-
-prod（3080）已运行 dsh **0.1.7-rc.1**（npm，`~/.local`）+ better-dsh **0.2.4-b**。用户报告：
-
-1. **compaction 组件不在 Settings/General 出现**；
-2. **failover 设置行在，但选择后报"cannot save to file"**。
-
-根因只有一个 —— **dsh 0.1.7 移除了 settings.yaml namespace 模型**：
-
-| 0.1.6 及以前（better-dsh 0.2.4 所说方言） | 0.1.7-rc.1（现实） |
-|---|---|
-| `SettingsProvider.installSection(ctx, ns, schema, base, hooks)` | **已删除**（新 `SettingsForms` 无此方法） |
-| namespace = 自由字符串，存 `settings.yaml` | namespace = **Loader entry id**；值以 profile patch 用户层落盘（configEditor） |
-| `settings.get(ns)` | 已删除 |
-| 自定义写校验钩子（validate） | 无此 seam（只剩 schema 校验） |
-| v3 消息 source `{kind:'plugin', plugin}` | v4 producer-owned kind（`plugin:better-dsh`，migration fallback 即此形） |
-
-两个症状的精确链条：
-
-- **compaction 行消失**：`CompactionRow.loadConfig()` 在 `describe()` 里找不到 `ns === 'compaction-tuning'`（0.1.7 的 ns 是 entry id `dashr-compaction-tuning`）→ 返回 null → `CompactionRow` 对 absent namespace **渲染 null**。行没注册失败，是自己选择不渲染。
-- **failover 存不进**：行本身渲染不依赖 namespace（空默认也渲染），但 save 走 `remote.settings.update('failover', …)` → 0.1.7 `SettingsForms.write()` 抛 **`No configurable plugin entry "failover"`** → 行内 toast `Save failed: settings/rejected: …`（用户转述为"cannot save to file"；该字符串不属上游也不属 better-dsh，是 toast 模板 + 服务错误的拼接）。
-- **隐藏第三伤（用户未及看到）**：两个 host 半的 `ctx.inject(['settings'], sctx => sctx.settings.installSection(…))` 在 0.1.7 会 TypeError —— failover 的 per-turn 切换链、compaction 的引擎同步实际都已残废。
-
-## 二、修复（对齐 upstream `agent-default-model` 范式）
-
-`packages/core/agent-default-model/src/index.ts` 是 0.1.7 的官方样例：`.volatile()` 字段以 `Volatile<T>` live ref 进入 resolved config（runtime 原地改写 ref，读侧 `.get()` 即实时）、`settings.configure({auto:false}, fiber)` 压掉原生自动表单、持久化交给可选 `configEditor.edit(entry,…)`。better-dsh 逐条对齐：
-
-- **schema**：`fallback1/2`、`thresholdRatio` 加 `.volatile()`（`retainTokens` 保持非 volatile = 组合面专用，表单写永不触碰）。
-- **failover host**：删 installSection；`source` 每次请求/失败实时 `readSlot(ref)`；`configure({auto:false})`。
-- **compaction host**：给引擎一个 **frozen getters 视图**（`thresholdRatio`/`retainTokens` 为 getter，读 `live()`），引擎每次 `resolveTargetPolicy()` 自然读到新值 —— 无需 re-apply、无需事件；保留 `retainRatio` 删除语义；advisory 窗口探测保留并降级为告警日志（0.1.7 无写校验 seam）。
-- **client**：ns 常量改为 entry id（`FAILOVER_SETTINGS_ENTRY='dashr-failover'`、`COMPACTION_SETTINGS_ENTRY='dashr-compaction-tuning'`）；UI locale/slot id 不变。
-- **其它 0.1.7 破面清扫**：`agent/session-start` → **`agent/created`**（serial，dispatcher 注入 agent）；ContentBlock **`'tool-result'` 移除** → role-`'tool'` 消息 + `message.isError`；session v4 source kind 在 `MessageSourceMap` 里声明 **`'plugin:better-dsh'`**；`SubagentResult.output` readonly 化。
-
-## 三、验证（验收 = 改动同类：真实运行时里设置面可用）
-
-环境：Dev/Test 1，upstream checkout 切 **dsh-v0.1.7-rc.1**，全量 `pnpm run build`，内嵌副本 = 本修复；`PORT=4988`（4999 被 superd PoC 占用）。
-
-1. **构建卫生**：`tsc --noEmit` **0 错**；vitest **600 passed / 1 skipped / 0 failed**（54 文件）。
-2. **第一人称 CDP 实测**（`.scratch/probe-049/verify-settings-049.mjs`，真实浏览器走 token URL → Settings → General）：
-   - `Auto-compact threshold` 行 **可见**，stepper 在位，点击后 **无 "Save failed"**；
-   - failover 两个 select 目录填充（deepseek-official/*），选择 `deepseek-official/deepseek-flash` → **saveError: false**、**valueRetained: true**；
-   - `pageErrors: []`；截图 `.scratch/probe-049/settings-general.png`。
-3. **落盘证据**：`.dsh-test/profiles/web/cordis.patch.yml` 出现
-   `dashr-compaction-tuning.config.thresholdRatio: 0.75`（≠ 默认 0.8 = UI 写入）与
-   `dashr-failover.config.fallback1: deepseek-official/deepseek-flash`（= 探针所选）—— 0.1.7 的 entry-patch 持久化闭环成立。
-4. **回归探针**：boot graph 含 `better-dsh` + client.js URL；`/plugins/??better-dsh/client.js&rev=…` 200，与 `lib/client/index.js` 字节一致（服务端仅追加 sourceMappingURL）。
-
-## 四、本轮环境新账（全部已处理，后来者必读）
-
-1. **根 package.json 新 patch：`vite: ^6.0.0`** —— rc.1 起 `apps/desktop/tsdown.config.ts` 运行时 `import { build } from 'vite'`；本机 Node 走 unrun 加载 config，从 `.unrun` 缓存目录解析不到根 vite → build:lib 死。（上游 CI native loader 无此问题。）
-2. **孤儿残骸**：rc.1 删除了 `packages/settings/settings-file`，但 checkout -f 不清 gitignored `lib/` → tsdown workspace glob 吞进旧 `lib/types`（引用已不存在的 `SettingsProvider` 导出）→ build:lib 硬错。已 `rm -rf packages/settings/settings-file`。
-3. **cordis 身份**：副本 devDep `cordis: 4.0.2`（registry）与工作区全量的 **vendor/cordis 4.0.4** 是两个声明实例 → 增补（settings/tools/Events）分裂 → 212 个假错。副本改 `workspace:*` 后归一 → 0 错。sync 脚本已把 vendor 家族纳入手术名单。
-4. **同步脚本**：`.scratch/sync-better-dsh-copy.sh`（rsync → 手术 → install → tsdown → build-client → tsc）。手术名单 = `/tmp/workspace-provides.txt` ∪ `/tmp/vendor-provides.txt`（后者由 `vendor/*/package.json` 生成，易失，脚本失效时先重建）。
-5. **`installSection` grep 教训**：`git grep … | head` 截断曾让 0.1.6 树看起来"没有 installSection"——head 截断会伪造结论，长输出一律落文件再查。
-
-## 五、发布面（红线内，待 user 裁决）
-
-- 修复只在 `align/v0.1.7-rc.1` 分支；**未 npm publish**（未获授权）。
-- peer range `>=0.1.5 <0.2.0-0` 在 pnpm 预发布元组规则下**匹配不到 0.1.7-rc.1**（autoInstallPeers 会落到 0.1.5-rc.3）——发布前建议把 peer range 修成能覆盖 0.1.7 线的形状（如 `>=0.1.7-rc.1 <0.2.0-0` 或双分支），随下次发版定。
-- prod 部署路径不变：user 以普通用户 `pnpm add @pgmi-builds/better-dsh@<新版>`（bundle 行）→ 重启 dsh.service。compaction/failover 两行在 prod 的用户层 patch 值会经 entry-patch 模型继续生效。
-- 遗留小项：`dsh://config` 的 ns 现在是 entry id（`dsh://config/dashr-failover`）；url-schemes 文档如提及旧 ns 需随发版更新。

package/node_modules/better-dsh/docs/50_test-reports/2026-09-27-lsp-ast-reminder-4999/345/256/236/346/265/213/346/212/245/345/221/212.md

@@ -1,53 +0,0 @@
-# v0.2.4-b（未发版 HEAD）LSP mount 修复 + AST 可用性提醒 4999 实测报告
-
-> 状态：**第一人称实测通过**（user 真实会话，2026-09-27）；报告落位 = 发布闸 b 完成。
-> 发布闸 c（user 单次确认发包）**待定**。
-> 变更：change `2026-09-26-lsp-ast-reminder`（commit `f92a7cc`，含此前 HEAD 上未发布的
-> `agent/created` mount 修复 `ce0541c`）；计划 `docs/10_plans/2026-09-26-lsp-ast-reminder.md`。
-
-## 1. 被测内容
-
-| 项 | 内容 |
-|---|---|
-| LSP gate mount 修复 | per-agent 安装事件 `agent/session-start`（0.1.7 已死）→ `agent/created`；修的是"hook 从未装上" |
-| AST 可用性提醒 | `write/edit/grep` 结果尾部一行 `ast_edit / ast_grep available — …`；per-session cap 5（write/edit/grep 共享预算，agent dispose 重置）；语言范围 = AST 自身 grammar 能力面（实测探针：py/js 家族/rs/go/c-cpp-h/html/css/json/yaml/sh/rb；排除 .md 与未证实 grammar），与 LSP 表解耦 |
-| 交付形态 | 新规范（guide §4.2）：`npm pack` → `plugin remove` → `plugin add tarball`；rig `test123`（`.test/home/compat`） |
-
-## 2. 构建卫生（agent 侧）
-
-- 单测 **621 passed + 1 skipped**（新增 ast-reminder 单测 + post-execute 钩子级测试）
-- `tsc --noEmit` host + client **0 错**；`npm run build` 干净
-- rig 重启后 boot graph 含 `better-dsh`；cookie 认证 200（新规则 §3.3 生效实证）
-
-## 3. 第一人称实测（user，2026-09-27，rig 4999 真实会话）
-
-**三个设备全绿**（user 实测原文要点）：
-
-- **ast_grep** ✅：`owners.set($K, $V)` 命中 2 处，含位置与 `metaVariables`；
-- **ast_edit** ✅：dry-run 正确计算替换区间不落盘；`dryRun:false` 实改 scratch 文件
-  `add($A, $B)` → `add($B, $A)` 一次换两个调用点，`applied: true`，盘面核实后清理；
-- **lsp（typescript-language-server）** ✅：diagnostics（精确命中 2×TS6133）/ hover
-  （返回接口 + doc comment）/ references（3 处，跨文件）/ definition / format
-  （`changed: true`）/ reload / status 全通。
-
-**提醒链路（agent 侧客观证据，rig session log）**：user 验收会话
-`session-d33f5db1`（superd workspace）工具结果尾部实测出现
-**LSP nag ×1 + AST 提醒行 ×1**——mount 修复 + 提醒链路在真实运行时生效的直接证据。
-（另一会话 `session-c8472342` 的 15 次 AST 行属**旧无 cap lib** 时段（今晨 04:59–05:08
-HKT，早于调优构建 16:19 HKT），非 cap 违规；新 lib 时段计数正常。）
-
-## 4. 实测学到的 gotcha（攒批处理清单）
-
-| # | 现象 | 候修 |
-|---|---|---|
-| G1 | **LSP 冷启动竞态**：server spawn 后首次 hover/references/definition 返回空（`text:""`/`locations:[]`），diagnostics 可预热，reload+重试确认 | 设备侧查询前 ensure/等待就绪，或空结果附 retryHint |
-| G2 | **ast_grep/ast_edit 要求绝对路径**：workspace 相对路径 ENOENT | 相对路径按 workspace cwd 解析 |
-| G3 | **lsp write 必须 `action` 字段**：usage 字符串的 `read:` 选择器语法易误导（`status`/`diagnostics?file=` 是 read 面） | usage 文案补 write 契约示例 |
-| G4 | **`plugin remove` 曾停掉运行中的 rig unit**（journal "Stopping" 恰在 remove 时刻，观察 1 次） | 查 CLI remove/reconcile 是否有停 unit 副作用 |
-
-## 5. 发布闸状态
-
-- a. 4999 第一人称实测 ✅（本文 §3）
-- b. 报告落位 ✅（本文）
-- c. **user 单次确认发包：待定**。HEAD = `v0.2.4b` + 19 commits（含 0.1.7 对齐修复、
-  本 change）；下一版号建议 `0.2.4c`（字母顺延），批量携带 G1–G4 修复与否由发布时定。

package/node_modules/better-dsh/docs/50_test-reports/2026-09-28-ctx-scheme/351/225/277/344/274/232/350/257/235utility/345/256/236/346/265/213/346/212/245/345/221/212.md

@@ -1,155 +0,0 @@
-# ctx:// scheme 长会话 utility 实测报告（2026-09-28）
-
-- **对象**：better-dsh `ctx://` URL scheme（recallable-context 面）
-- **被测构建**：better-dsh **0.2.4-c**（`35535d2`，现役发布版；装于 prod `~/.dsh/profiles/web`）
-- **测试载体**：**第一人称、真实长会话**——本报告就是在该会话里写的。样本参数：15 条真实 user prompt、405 条 agent message、343 次 tool call、**1 次 compaction（shadow 825 items / 386,226 tokens）**、76 条注入消息。非合成夹具，正是该 scheme 的目标场景（超长会话）。
-- **方法**：逐面活体探测（roster / snapshot / episode / raw window / 集合 / 元素 / 错误路径 / 跨 compaction grep），每条结论均有本会话内的真实调用为证。
-
-## 一、逐面结果
-
-| Surface | 探测 | 结果 |
-|---|---|---|
-| `ctx://`（roster） | 裸读 | ✅ 10 行自描述面，含每个 sub-path 的语法与 `:raw:N-M` 提示；无需 live agent |
-| `ctx://session`（快照） | 裸读 | ✅ totals（343 tool calls / 15 prompts / 1 compaction）+ segments（compacted 16–2336 vs live 2337–2379）+ **内联 compactions 清单**（label 2348、shadowed 825 items / 386k tokens、8 段 ×100 字预览）+ hints。长会话里这是"我丢了什么"的一张卡，一次读全拿到 |
-| `ctx://session/compactions[2348]` | episode 摘要 | ✅ 8 段全文 verbatim（prepared 面），与本会话真实 checkpoint 内容一致 |
-| `compactions[2348]:600-604` | **shadowed 原始跨度行窗口** | ✅ 精确回到被 compact 掉的历史，带 seq 标签（`[0000212] TOOL bash` 等） |
-| `ctx://session/user_prompts[0]` / `[17]` | 元素面 + seq 二象性 | ✅ 0-based 序数与事件 seq 寻址等价（`[17]`≡`[0]`），返回完整原始 prompt（含中文长文无损） |
-| `user_prompts[17]:1-2` | 元素面行窗口 | ✅ `:N-M` 在元素面上照常生效 |
-| `ctx://session/tool_calls[342]` | 元素面 | ✅ name + arguments + result 三段式（result 空缺见 F2） |
-| `ctx://session/injections` | 索引面 | ✅ **本会话 76+ 条注入的完整台账**：seq、source kind、~100 字预览。subagent-settled / agent-message / agent-instructions / compact-checkpoint 全在——长会话里这就是"我离开期间发生了什么"的账本 |
-| `grep path: ctx://session/transcript` | **跨 compaction 全文搜索** | ✅ 把含 shadowed 跨度的全量 transcript 物化到 `/dev/shm` 检索，命中 6 处 `gate-removal`（含 compact 前的旧事件），**行号 = transcript 规范坐标**，可与 `:N-M` 窗口直接组合。长会话第一杀器 |
-| `compactions[2348]/original` | 已废路径 | ✅ `CTX_BAD_PATH`，错误文本直接给出替代写法（"superseded by the :raw / :raw:N-M selectors"） |
-
-## 二、utility 结论（长会话视角)
-
-**该 scheme 在其设计目标场景（超长会话 + compaction 后回溯）里成立且好用**：
-
-1. **丢context自知**：快照的 segments + 内联 manifest 让模型精确知道 shadow 了什么（825 items / 386k tokens）以及每段摘要——不需要盲猜。
-2. **三级召回粒度齐全**：摘要（episode 面）→ 精确行（`:N-M` raw 窗口）→ 全文定位（grep 物化检索），三者共用同一套规范坐标，可组合。
-3. **索引面价值实测**：injections 台账在本会话里直接回答了"哪些 subagent 何时 settle 过"这类跨天问题。
-4. **错误质量好**：废路径、未知 key、越界元素全部结构化且回显可操作的修复指引。
-
-## 三、Findings（按 §〇.5 攒批，不烧版本）
-
-- **F1（utility gap + 错误外 观）**：裸 `ctx://session/user_prompts`（tool_calls / agent_responses 同）→ `CTX_NO_SUCH_ELEMENT`，且错误回显为 `ctx://…[]`——**空括号 URL 不是模型输入的 URL**。impl 把裸集合面当元素查找（`handlers/ctx.ts:486` 的条件把无名 bracket 落进元素分支）。spec 侧该三集合是否应有 index face 存在歧义（"user_prompts continues to list" 一句两读）；从 utility 看，user_prompts（15 条）加 seq+预览索引面价值高，tool_calls/agent_responses（343/405 条）裸索引过长、宜支持窗口化索引。至少：错误不应回显空括号。
-- **F2（召回盲点，非 ctx:// 渲染缺陷）**：大输出 tool result 在 `tool_calls` 元素面与 transcript 面均为**空串**（样本 seq 2379 / 2406，`resultTextOf` 产出空）。两 face 一致 → 归因于持久层对大 result 的省略存储；但"大输出"恰是长会话里最想召回的内容。建议后续核实上游持久化行为，若确为 elision，ctx:// 侧至少回显 `(result elided, N chars)` 而非静默空。
-- **F3（UX 小刺）**：`read` 的 `offset`/`limit` 分页参数对 `ctx://` URI **静默忽略**（实测 limit:15/20 均无效，injections 返回全量）。行窗口的 sanctioned 机制是 `:N-M`，但原生 read 契约写明"File reads page with offset/limit"——URI 读既不分页也不提示，宜在文档或错误提示里点名。
-
-## 四、判定
-
----
-
-## 五、第二轮活体复测（2026-09-28 晚，同一会话、4 次 compaction 后）
-
-同一长会话的后续采样：距首轮报告又历经 3 次 compaction（现役 4 块 shadow + live 段仅 51 items；totals 1371 tool calls / 35 prompts / 1248 agent messages；会话 2026-09-23 起、跨约 5 天，shadow 合计 2715 items / ~1.40M tokens）。被测构建不变：better-dsh **0.2.4-c** 仍在 prod web profile（磁盘核实），harness 基座 0.1.7-rc.2。
-
-| 探测 | 结果 |
-|---|---|
-| `ctx://session` 快照 | ✅ 4 块 compaction 全清单内联（2485 / 4634 / 5637 / 7033，含 `replaces_checkpoint` 链与 8 段 preview），segments 图一次读全 |
-| `grep path: ctx://session/transcript`（pattern `0\.1\.3-v`） | ✅ **跨全部 4 块 shadow 命中 16 处**（materialized canonical 行 14998–15308，深处远超 live 起点）；召回内容与本会话 checkpoint 事实逐项吻合（0.1.3-v commit 文全文、dev3 满堂红探针命令、prod 安装命令与输出）——跨天跨 compaction recall 零失真实证 |
-| `compactions[2485]:1-2` | ✅ 4 层 compaction 之前的会话首条真实指令 **verbatim 召回**（`[0000012] USER`：0.1.7 对齐令） |
-| `compactions[2348]`（首轮报告引用的旧 label） | ⚠️ **label 漂移（新 F4）**：`CTX_NO_SUCH`，错误列出现役 labels `(2485, 4634, 5637, 7033)` 可即时恢复；但首块 shadow 已从报告时的 label 2348 / span 16–2336 / 825 items / 386,226 tokens 重划为 label 2485 / span 12–2477 / 967 items / 365,535 tokens——后续 compaction 会吸收旧 checkpoint 之后的 live 段并重贴 label |
-| 裸 `ctx://session/user_prompts`（F1 复测） | ⚠️ 依旧 `CTX_NO_SUCH_ELEMENT` + 空括号回显 `ctx://…[]`；错误文案现含集合长度与 0-based 提示（更可用），缺陷面不变 |
-| `read(ctx://session, limit:1)`（F3 复测） | ⚠️ limit 静默忽略、全量快照卡返回——F3 照旧 |
-
-### 第二轮结论
-
-- **核心承诺在 4×compaction 规模下依旧成立**：快照自知、清单内联、跨 shadow grep、深层 verbatim 召回全部可用，且 grep 召回经与 checkpoint 事实比对无失真。长会话跨 5 天后，scheme 仍是「我丢了什么 / 怎么拿回来」的完整答案。
-- **F4（新，compaction label 非稳定引用键）**：后续 compaction 重划更早 shadow 的 label 与 span（2348→2485），跨 turn 按 label 引用会悬空。建议：文档点名「compaction label 仅对当次 shadow 结构有效，跨 turn 引用先重读快照」（错误信息已支持该恢复路径）；或提供快照中已有的 `compactionId`（uuid）作稳定寻址键。
-- F1 / F3 复现如前，攒批不变。判定维持**通过**。
-**通过**。0.2.4-c 的 `ctx://` 面在真实超长会话中全部核心承诺兑现：快照自知、清单内联、三级召回、跨 compaction grep。F1–F3 均为小瑕，按惯例攒批并入下次发布轮处理。
-
-## 六、第三轮活体复测（2026-09-28 14:03，同工作线后继会话实例、1×compaction）
-
-第三轮换载体：不再是前两轮的长会话本体（09-23 起、4×compaction），而是同一 superd 工作线的**后继会话实例**（`session-9d55447a`，cwd `/home/u1/workspaces/superd`，创建于 2026-09-25 11:34，2026-09-27 14:15 经历唯一一次 compaction）。采样时点参数：shadow seq 16–2099 = **681 items / 361,515 tokens**、live 仅 36→54 items（两次读数间自增）、totals ≈ 349 tool calls / 11 prompts / 315 agent messages / 193 reasoning blocks。被测构建磁盘再核实不变：better-dsh **0.2.4-c**（prod web profile）+ harness 0.1.7-rc.2。本轮顺带回答一个问题：**scheme 在「普通」形态（仅 1×compaction）下是否同样成立**。
-
-| 探测 | 结果 |
-|---|---|
-| `ctx://session` 快照 | ✅ 单 compaction 全清单内联（label 2108 / checkpoint_seq 2109 / `compactionId` uuid / `replaces_checkpoint: null` / 8 段 preview）+ segments 图；两次读取间 totals 活体前移（tool_calls 343→349、live 36→54）——快照与持久层实时一致 |
-| `compactions[2108]:1-3` | ✅ shadow 首事件 verbatim（`[0000016] USER` @native-ui-fusion 两份计划文档），与 checkpoint「Primary Request」吻合 |
-| `user_prompts[0]` | ✅ 同一事件的元素面 verbatim（`[0]` ≡ seq 16 二象性复现）；episode 面与元素面跨 face 一致 |
-| grep `82de0f3` on `ctx://session/transcript` | ✅ 5 命中横跨 shadow+live：台账终局 bash 命令全文、memory_add 载荷、checkpoint 摘要行、以及 grep 调用自身（检索自包含）；召回内容与本线真实终局（0.1.5 merge/tags/publish/rig 迁移）逐项吻合，零失真 |
-| `tool_calls[342]` | ✅ name+arguments verbatim；result 空串 → **F2 三度复现** |
-| 裸 `ctx://session/user_prompts`（F1 复测） | ⚠️ 照旧 `CTX_NO_SUCH_ELEMENT` + 空括号回显；错误含集合计数与 0-based 提示 |
-| `read(ctx://session, limit:1)`（F3 复测） | ⚠️ 照旧静默忽略、全量快照返回 |
-| `?q=` 行过滤（新探测） | ❌ **F5（新）**：`Error: ctx://: unsupported selector kind "query"`——harness 内部 scheme 选择器契约记载 `?q=<q>`（dot-path 搜索 / 行过滤），ctx provider 在 selector 解析层即拒；fail-closed、错误干净，但回显丢 face（只剩裸 `ctx://`）。实用面无损（grep on ctx path 即行过滤替代，三轮均已证），属契约/文档缺口而非功能缺陷 |
-| `thinking[0]:1-2` / `system:1-3` | ✅ 两面首次入矩阵：首个 reasoning 块、会话级 system 消息 verbatim，`:N-M` 在元素面照常生效。另观察：快照 `system_prompt.chars` 恒 0（preset prompt 统计）与 system 消息面是两回事，前者语义未表（记录，不立案） |
-| F4 label 漂移 | N/A——单 compaction、轮内无重划；`compactionId` uuid 确认在清单在场，round 2 的稳定键建议继续成立 |
-
-### 第三轮结论
-
-- **核心承诺在普通形态（1×compaction、live 36 items）全额兑现**：快照自知、清单内联、三级召回、跨 shadow grep、跨 face 一致性全部复现，grep 召回与外部事实（git/npm/rig 终局）比对无失真。scheme 的 utility 不依赖极端 compaction 深度，首次 compaction 后即达设计意图。
-- **F5 入批**（`?q=` selector 未实现 + 错误回显丢 face）；F1/F2/F3 三度复现、攒批不变；F4 本轮无复现机会。判定维持**通过**。
-
-## 七、设计复核：compaction 面的体量语义与渐进披露（2026-09-28 14:2x，user 提问触发，源码+实测双证）
-
-user 之问：裸读 `compactions[<id>]` 返回 digest 还是 shadowed 全文？若 auto-compaction 阈值 500k tokens，召回工具自己会不会把上下文塞爆？核对 `better-dsh/src/url-schemes/handlers/ctx.ts`（L332–426）后的事实：
-
-| URL 形态 | 返回 | 体量 |
-|---|---|---|
-| `ctx://session` | 快照卡：8 段 ×100 字 summary_preview + shadowed range/items/**tokens** + compactionId | 有界（本会话实测 ~2k tokens） |
-| `ctx://session/compactions` | 逐 episode 一行：label / checkpoint_seq / compactionId / at / range+items+tokens / replaces_checkpoint / 120 字 preview | 每块 ~1 行 |
-| `compactions[<id>]`（裸） | **仅 digest**（= compaction 时定稿的 8 段 checkpoint 摘要，`applyFace(..., 'prepared')`）；不随 shadowed 体量增长（本会话 361k shadow → ~4.5k digest，≈80:1） | 有界 |
-| `compactions[<id>]:N-M` | shadowed span 行窗口 | 窗口即上界 |
-| `compactions[<id>]:raw`（span > 64 KiB） | **仍返回全文**，仅尾注一句「original span is N chars — page with :N-M or grep」（L419，warn-don't-block） | ⚠️ **无硬护栏** → **F6** |
-
-- **结论（user 的设计诉求已大半在场）**：默认路径（一切裸 URL）永不返回 bulk 原文；「digest + 寻址范围 + statistics」正是快照/清单/episode 三层的现役形态，digest 体量 = checkpoint 本身（模型上下文里已有同一份，重读≈复读）。**残余风险一处 = F6**：>64 KiB span 的裸 `:raw` 只警示不拦截。500k-token shadow（≈2 MB）一次裸读仍会倾泻。建议升级为 bash 式 spill-to-file（本仓 grep 物化 `/dev/shm/dashr-url-*/content.txt` 已有先例可复用：截断 + 落盘 + 报路径），或硬拒并指引 `:N-M` / grep。**F5 修正**：`?q=` 不支持并非首发现——2026-09-12 `url-schemes-grammar-matrix` 报告已记录同缺陷（彼处亦编 F5），本轮系复测而非新发现。
-- **Context injection root**：`injections` 裸读 = 索引台账（seq + source kind + 100 字预览，L436–442），**非全文**——比 user 预期（「直接给可以」）更省；全文按条 `[n]`，`:raw` 才全量拼接（该 face 无 oversize 注记，同类小隐患，量级低，附于 F6 备注）。
-- **Sub-agent（user 之前提需修正）**：master 会话日志**并不内嵌** child 全 transcript——内嵌的只有终态工件：`agent` 工具调用的 arguments+result（`tool_calls[k]` 可寻址，result 携带 durable subagent id）与 report/settled 注入（`injections[k]`）。child 全 transcript 是独立 session 文件，专用寻址面 = **`agent://`**（design.md D6）：`agent://` 家族 roster（仅 continuable 后代；**one-shot child 不入 roster**——只能经 master transcript 的 tool_calls 找回，小 gap 备注）/ `agent://<id>` 终态输出 / `agent://<id>/transcript` 全 transcript / `agent://<id>/<child>` 嵌套；settled child 经 sessionPersistence 仍可寻址；跨家族 id 一律 `AGENT_UNKNOWN_ID`（寻址范围 = 自家族，含授权语义）。两 scheme 组合即完整链：`ctx://session/tool_calls[k]` 拿 id → `agent://<id>/transcript` 拿全文。ctx://session 无需也不应再抠 subagent 专字段。
-
-## 八、长会话导航化：设计定调与 findings F7–F10（2026-09-28，user 提问触发；下一波开发即做此项）
-
-### 载体与证法
-
-本轮实测载体 = 本会话 `session-36c2b2ef-a498-49d0-8ff6-af1a92a758ad`（探测时 **1×compaction**：shadow seq 16–2336 = 825 items / 386,226 tokens，live 2337–2379，totals 343 tool calls / 15 prompts；同轮内 totals 已前移至 17 prompts）。**F7–F10 均为代码/规格级缺陷**（与载体无关），活体探测仅作证；§七 的源码复核（`handlers/ctx.ts` L332–426）与本轮互为正交。
-
-### 范畴声明（user 裁决 — 写死为非目标）
-
-本工具族 = **以文本关键词为主的可回溯导航**（原文 + 索引 + 寻址）。**语义层不是我们的工作**：向量检索、语义索引属于记忆类工具（本 profile 并装 corti-memory 一类），属不同工具分类。理由：大模型本身就是语言模型——同义替换、中英转换、换关键词变着法 grab 都是它的本职；我们只需保证**原文可取 + 可寻址**。故：不做 embedding、不做语义排序、不做「我记不清那个词」的检索。我们提供的是电话簿 + 索引 + 指针，不是记忆。
-
-### Findings
-
-**F7（高 — 必须先修）：surface 单位 ≠ 可寻址单位（seq vs line）**
-
-- manifest 的 `shadowed_range` 是 **seq 单位**（`{start:16, end:2336}`）；但唯一的窗口选择器 `:N-M` 是 **line 单位**。
-- 实测：`compactions[2348]:16-16` → 空行（seq 16 实际位于 transcript 行 1）；该 span 实际占 transcript 行 ≈1–5230。
-- 后果：照 manifest 字面下 `compactions[2348]:16-2336`，拿到的是 **~45% 的静默截断视图**——不报错、内容相关，模型会自信地以为「我已读过 shadowed 范围」。对导航器而言这是最坏的失败模式（静默非完整）。
-- 修法（改动很小）：manifest / episode 携带 `lines:{start,end}`（或改以行区间为主、seq 仅作元数据）。episode 面**本已接受**行窗口，缺的只是把「可寻址范围」告诉模型。
-
-**F8：`:path/` 选择器在 ctx:// 未实现（F5 的姊妹项）**
-
-- 实测 `ctx://session:path/totals` → `unsupported selector kind "path"`；`?q=` 为 F5（§六已录，且据 §七 更正系 2026-09-12 旧账复测）。
-- 二者在模型面 `url-schemes-instruction.md` 中列为**通用**选择器、无 per-scheme 免责；`CTX_BAD_SELECTOR` 文案不回显支持集（ctx 其它错误均为模范级）、且回显丢 face（只剩裸 `ctx://`）。
-- utility 影响：窄读一个字段（`:path/totals.tool_calls`，省去整张快照卡）与过滤一个索引面（`injections?q=subagent-settled`）恰是长会话导航要的窄口径。
-
-**F9（低）：快照无 `asOf`** — totals 在会话推进中前移（本轮 15→17；§六亦观察 live 36→54）。模型缓存一次快照后在陈旧数字上推理，无自知。建议快照带 `asOf`（seq/line），或明示「每次读都是即时值」。
-
-**F10（中）：越界静默空串** — 实测 `compactions[2348]:3300` 有内容、`:5500` → 空串。episode 面确实被 span 约束（好），但：① 越界与 span 内空行不可区分；② **上界落在 3300–5500 之间且无从得知**（无任何面告知）——这本身就是 N1 要解决的问题。建议边界显式（如 `[end of episode span at line N]`）。
-
-### 设计立场（本轮定调，供下波开发直接采）
-
-1. **坐标统一不变式（user 点明）**：scheme 展示给模型的每一个数字/单位（行、段、seq、label），都必须是**同一 URL 族内可直接寻址的**；不可寻址的数字不得作为指针出现（纯 metadata 须显式标注单位）。当前违背者 = F7。这是「导航系统」与「一堆面」的分界，应写成规格不变式。
-2. **给指针，不给统计（user 校正用词）**：原提案的「statistics」实指**可导航坐标 + 方向标**（user 原用「state」一词，其预设 = surface 出来的 sequence/line/段落等同于工具可寻址的 selector——该预设正确，当前实现违背它，即 F7）。计数只在作为 **fidelity 信号**时保留一行：`user_turns : tool_calls` 比 → 决定摘要该不该信（tool 重的 span 摘要可信、细节可再生；user 意图密集的 span 必丢细节 → 必须下钻）。**方向标** = 按类型分组的坐标清单，全部以行坐标输出、直接可喂 `:N-M`：
-   - user turn 坐标（实测：17 个 user prompt 的行号清单一眼看出会话重心分布——前 1500 行仅 4 轮，其后密集；但今天需要模型自己发明 `grep '^\[\d{7}\] USER$'`，非 scheme 给的 affordance）；
-   - 失败 tool call / 重试坐标（「哪里出过事」）；
-   - **touch 过的文件路径 + 次数**（编码场景最值的语义索引：「哪个 episode 动过 `auth.ts`」）；
-   - span 内**前序 checkpoint 数**（决定「这是不是摘要的摘要、该往哪个 label 下钻」；本会话实测 = 1，链深 1）。
-3. **渐进披露与递归扇出**：10M–100M token 规模下聚合计数可活、扁平名册活不下来（5 亿 token 可能有数千 user turns）→ 每层必须用一屏回答「这里有什么 + 下一步去哪」。到那个尺度 seq/line 都失去直觉，**时间**与**主题（文件/子系统）**才是稳定轴，故两者必须进每个节点的坐标块。
-4. **digest 复读问题的两看（user 提出，本轮定论）**：
-   - **latest compaction**：其 digest 已作为 checkpoint 消息**驻留在当前上下文**里（实测：digest 即 seq 2349 的 `compact-checkpoint` 注入，可寻址于 `transcript:5230-5299`，下一事件 seq 2358 起于行 5300）。故裸读**不应再倾泻 digest**，而应回**自定位提醒**：「本次 digest 已在你上下文中（`transcript:5230-5299`），需要原文可自行取；这里有用的是 span 导航」+ 指针块。` :raw` 仍返回原文跨度 ⇒ digest 永不丢失（它本身可寻址）。
-   - **older compaction**：其 digest 已被二次压缩进更新的 checkpoint，只存在于 span 内 ⇒ **应当照常返回全文 digest**（它是该段历史最便宜的入口，且不构成「吃回来」）。
-   - **规则化**：digest 正文的返回条件 = **该 digest 未驻留于 live 上下文**（即仅非 latest episode）。
-   - **设计警戒（user 赞同）**：stat/digest 只能是指针、不能是内容——嵌摘要 = 把刚 compact 掉的东西又吃回来。
-
-### 下波开发 backlog（建议序）
-
-| # | 项 | 依据 |
-|---|---|---|
-| N1 | episode 节点坐标可寻址化：manifest / episode 暴露 `lines:{start,end}`；越界边界显式 | F7 / F10 |
-| N2 | episode prepared 面改「导航块」：latest → 自定位提醒 + 指针（不倾泻 digest）；older → 全文 digest + 指针 | 设计立场 4 |
-| N3 | 方向标（scoped landmark 名册）：user turns / failures / touched paths / prior checkpoints，行坐标输出 | 设计立场 2 |
-| N4 | fidelity 一行（`user_turns : tool_calls`）内联进 manifest 每 episode | 设计立场 2 |
-| N5 | `:path/` + `?q=` 在 ctx:// 落地，或在 instruction 明示 per-scheme 差异；`CTX_BAD_SELECTOR` 回显支持集与 face | F8 / F5 |
-| N6 | 快照 `asOf`（或明示即时性） | F9 |
-
-- 判定：**通过，且方向确认**。方案不需要新机制——F7 的修法是把已有数字换成可寻址的那套单位；N2–N4 都是在现有 episode/快照结构上加指针，不引入新检索层。