super-dsh 0.1.12 → 0.3.0

package/node_modules/better-dsh/docs/50_test-reports/upstream-dsh-0.1.3-alpha.2-report.md

@@ -0,0 +1,110 @@
+# 上游 dsh 0.1.2-alpha.5 / rc.1 → 0.1.3-alpha.2 差异调研报告
+
+- 调研日期：2026-09-08（本机复核日；上游 rc.1 发布 2026-09-03、alpha.2 发布 2026-09-07T13:11Z）
+- 方法：**clean source git diff，非 npm tarball**。本机 `upstream/deepseek-harness` checkout 拉取 `dsh-v0.1.2-rc.1` / `dsh-v0.1.3-alpha.1` / `dsh-v0.1.3-alpha.2` 三个 tag 后，以 tag 树间 diff + 仓内 `.agents/notes/implemented/` 设计笔记 + npm registry 事实三源互证。文件/行数口径：`dsh-v0.1.2-alpha.5` vs `dsh-v0.1.3-alpha.2`（rc.1 与 alpha.5 代码零差，等价）；commit 数口径：`rc.1..alpha.2`（rc.1 是 alpha.2 的祖先，范围线性、无歧义）。
+- 版本事实：
+  - **rc.1 = release-only**：`alpha.5..rc.1` 只有 2 个 commit——release commit `a66e470204`（`release(dsh): 0.1.2-rc.1`，2026-09-03）+ 1 个空 merge（`5a69ba1cdd` Merge PR #3445，把 alpha.5 发布分支并入主线）；代码差**为零**（见专题一）。npm `latest`/`next` dist-tag 均指 `0.1.2-rc.1`——今天裸装 `@deepseek-ai/dsh` 拿到的就是 alpha.5 代码。
+  - **alpha.1 = 只 tag 未上 npm**：`dsh-v0.1.3-alpha.1` tag 存在（merge PR #3554，09-04），但 registry `versions` 里 **没有 0.1.3-alpha.1**，0.1.3 线从 alpha.2 起；`alpha` dist-tag = `0.1.3-alpha.2`。
+  - alpha.2 tag = merge PR #3685（worktree/release-dsh-0.1.3-alpha.2，09-07）；rc.1 与 alpha.1 均为其祖先（rc.1..alpha.1 = 328，alpha.1..alpha.2 = 316）。
+
+---
+
+## 数字复核表（转述值 → 实测值）
+
+对来源总结逐项复核，两处需修正口径，其余全部精确命中：
+
+| 来源总结 | 实测（本机复核） | 结论 |
+|---|---|---|
+| rc.1 落后 alpha.5 "1 commit" | `alpha.5..rc.1` = 2 commits（release `a66e470204` + 空 merge `5a69ba1cdd`） | 口径差异；结论不变——代码零差 |
+| rc.1 vs alpha.5 "252 文件全 package.json 版本号" | 252 文件，**0 个非 package.json**，diff 行过滤 `"version"` 后**零残留** | ✅ 精确命中 |
+| alpha.2 "417 commits" | `rc.1..alpha.2` 共 **644** commits = 227 merges + **417 非 merge**（first-parent 仅 76） | 417 = 非 merge 数；总数 644 |
+| "~103k+/40k− across 4.8k files" | 4,866 files，**+103,306 / −39,537** | ✅ 命中 |
+| "~59k+/19k− 真实代码（剔 notes/snapshots/docs）" | 仅剔这三前缀 = 1,974 files，**+84,482 / −27,248**——到不了 59k | ❌ **不可复现**（见下"剔除阶梯"） |
+| fix 178 / test 97 / docs 53 / ci 11 / perf 9 | 对 644 条 subject 前缀统计：fix **178** / test **97** / docs **53** / ci **11** / perf **9**（另有 refactor 27 / feat 21 / chore 13 / revert 2 / release 3 / merge+other 230） | ✅ 全命中 |
+| rc.1 = latest/next；alpha = alpha.2 | `npm view dist-tags`：latest=0.1.2-rc.1, next=0.1.2-rc.1, alpha=0.1.3-alpha.2 | ✅ |
+| alpha.1 从未上 npm | `npm view versions` 无 0.1.3-alpha.1 | ✅ |
+
+**真实代码量的"剔除阶梯"（都可精确复现）**：ALL 4,866 files +103,306/−39,537 → 剔 `.agents/notes/`+`snapshots/`+`docs/` 1,974 files +84,482/−27,248 → 再剔 `pnpm-lock.yaml` 1,973 files +83,369/−27,204 → 再剔各包 `tests/`·`test/`·`__snapshots__` 1,366 files +38,948/−11,653。来源总结的 ~59k+/19k− 落在前两档之间，对应的剔除集本机未能还原（可能含更大的生成语料剔除），**引用时以阶梯为准，勿再用 59k 口径**。
+
+主题占比（包组级，alpha.5..alpha.2，实测）：`session*`（session 组全部 8 包）211 files **+25,333/−10,849**；`client*` 358 files +10,871/−2,691；`apps/web` 95 files +2,423/−641；`subagent` 75 files +3,144/−1,955；`api` 64 files +3,695/−985；`core` 71 files +2,919/−1,861；`llm` 68 files +3,011/−493。与来源"dominant areas = client/session/subagent/core/llm/api/apps/web"一致，session 显著居首。
+
+---
+
+## 专题一：rc.1 是一个纯发布 commit——bump 过去只买一个标签
+
+`git diff dsh-v0.1.2-alpha.5 dsh-v0.1.2-rc.1`：252 个变更文件全部是各包 `package.json`，且 diff 内容除 `"version"` 字段外零残留（无 lockfile、无源码、无配置）。rc.1 相对 alpha.5 **功能字节级一致**。
+
+含义：**以 rc.1 为目标 = 白动**（只换 dist-tag 外观）。真正的代码分水岭在 `dsh-v0.1.3-alpha.2`。若只想要"稳定标签"，rc.1 与 alpha.5 无差别；若需要 0.1.3 线的修复，只能走 alpha 通道（alpha.2 起）。
+
+---
+
+## 专题二：session format v2 + 内嵌 assistant 流（落盘/回放契约变更）
+
+**三个 breaking commit 全部落在 omp-web 桥接的会话持久化/回放接缝上**（均实测在 `rc.1..alpha.2` 范围内）：
+
+| commit | subject（实测原文） | 性质 |
+|---|---|---|
+| `f99b06eaed` (09-01) | `feat(session)!: embed assistant streams in format v2` | 断（格式面） |
+| `d1521ea783` (08-31) | `feat(session)!: add released format migration` | 断（迁移面） |
+| `bec6805d6a` (08-28) | `refactor(session-persistence)!: handle-based seam with a lifecycle-owned write path` | 断（写路径面） |
+| `c58097a826` (08-31) | `feat(session-persistence-jsonl): cross-process write-ownership lease` | 紧邻（lease 即 `session-persistence-omp.ts` 直接对话对象） |
+
+配套证据（tag 树内设计笔记，路径均已核实）：
+- `implemented/architecture/2026-09-01-v2-embedded-assistant-streams.md`（v2 内嵌流设计）
+- `implemented/architecture/2026-09-05-read-only-session-migration-preparation.md` + `2026-09-06-embedded-stream-record-readers.md`（回放侧按 compact record 读内嵌流）
+- `implemented/feature/2026-08-31-cross-process-session-write-lease.md`、`implemented/simplification/2026-08-30-jsonl-only-session-persistence.md`（jsonl-only 收敛 + 跨进程写权）
+- 新包齐备：`packages/session/` 下新增 `session-format`、`session-format-catalog`、`session-format-v0-to-v1`、`session-format-v1-to-v2`（src：codec/dispositions/migration/validation）、`session-log-deepseek`、`session-checkpoint-policy`；`session-persistence-jsonl/src` 现含 `lease.ts`/`migration-verifier.ts`/`format.ts`/`generation.ts`/`storage.ts`/`worker.ts`。迁移测试语料是全 diff 最大单体（`v1-to-v2/tests/migration.spec.ts` +1,251）。
+
+流/回放修复链（同簇，非断）：`30e045dfad` `feat(agent): emit live assistant stream frames`；`165cc31eb8` `perf(llm,host): read embedded Assistant streams per compact record`；`7bab91d247` `fix(llm): retain Anthropic resolved model during replay`。
+
+---
+
+## 专题三：persistence 重构主题（读/写/迁移的 perf 潮）
+
+除专题二四枚外，`session-persistence*` 在本范围有一整条 perf 链：prepared reads before publication、streamed migration publication/verification、restore 冻结读（来源总结定性）；`2026-09-04-session-open-performance-gate` 测试笔记佐证"打开会话性能门槛"成为一等关注。对桥接方的含义集中在专题二列出的断点 + lease——即"谁持有某 jsonl 写权、生命周期何时移交、跨进程并发写如何排他"，这正是第三方持久化实现需要对齐的契约。
+
+---
+
+## 专题四：其余主题簇（非断，但升级需知）
+
+| 簇 | 证据（实测 subject，均 in-range） | 备注 |
+|---|---|---|
+| **str_replace_editor 默认下架** | `36a4665144` `feat(base): remove str_replace_editor from default tools`；`965adbb5cf` `feat(sdk): disable str_replace_editor by default` | 笔记 `2026-09-05-base-default-file-editor`；升级后默认工具面少一个 editor |
+| **outbound 全走 proxy** | `545e2ad914` `feat(net): route every outbound request through the configured proxy` | 未配 proxy 时无行为变化 |
+| **read_image 图片卡** | `56ca8af0ee` / `a4d4404708`（ui-tool 渲染嵌套/直接 read_image 结果为图） | 前端渲染面 |
+| **通用文件存储 + 提交生命周期流式** | `bafa6ae11d` `feat(conversation): stream files through submission lifecycle` | 附件面 |
+| **agent/UX** | `48cc1cf1d6` `feat(agent): announce model switches`；`96ead6091d` `feat(subagent): align human inbox controls`；`040d73871b` `feat(agent-team): unify messages on steer` | |
+| **message-edit：landed 又 revert** | `ef88756f13`（09-02）`feat(session, agent, web): support same-session message editing` → `e974a655a0`（09-02）`Revert "…"` | 同日往返；**别按该 feat 写适配** |
+| **telemetry/feedback：default-on 又回滚** | `02a029e679` feedback 记录进 session log、`9ffe85a512` OTel 默认全量上传统计 → `13daefe073` `revert(session-telemetry-otel): leave telemetry on its own transport` | 笔记 `2026-09-05-canonical-feedback-log` / `nonofficial-feedback-otel`；prod 跑 `DSH_TELEMETRY_DISABLED=1`，升级时查 session log 是否开始夹带 feedback 记录 |
+| 其余重churn | fix 178 / test 97 / docs 53 / ci 11 / perf 9；web-heavy（sending states、skill chips、terminal cards、session reveal） | 体积主导：`.agents/notes`（含 notes i18n.yaml 迁移与 archived manifest.json 重组，~2.4k files）+ session/client 组 |
+
+---
+
+## 对本线（omp-web 桥 + dashr 测试线）的含义
+
+1. **对 omp-web 不是 drop-in bump**。format v2（`f99b06eaed`）+ released migration（`d1521ea783`）+ handle-based seam（`bec6805d6a`）+ 写权 lease（`c58097a826`）恰好是 `session-persistence-omp.ts` / `replay.ts` 桥接的契约面。升级 = 一次 upstream-alignment 适配轮：diff 载体 → 新格式读写 + lease 语义对齐 → 迁移读兼容验证 → 冒烟，按所在仓的 AGENTS.md 节奏（dashr 侧即 S1–S7）。
+2. **别追 alpha.1**：npm 无该版本，registry 线从 alpha.2 起；本地 tag 在库即可，发布侧不存在。
+3. **dashr 自己的 4999 测试线（现 alpha.5）将来对齐 alpha.2 时的 S7 盯点**（本轮不执行）：默认工具面少 `str_replace_editor`（工具清单对比）；session 落盘格式迁移（老 session 读兼容靠上游 released migration，验收一条老会话打开）；`__DSH_TRANSPORT__`/`connection` 行/`AppFrame` 语义属性的行形状是否被 web-heavy churn 漂移（upstream-alignment.md S7.5 三处 + S7.8 两处查表在切换轮现查）；telemetry 默认面变化对 `DSH_TELEMETRY_DISABLED=1` 立场的验证。
+4. **数字口径提醒**：引用本报告数字时用复核表/剔除阶梯的实测值；"417 commits""~59k real code"两个转述口径已修正。
+
+---
+
+## 参考索引
+
+| 主题 | 证据 |
+|---|---|
+| rc.1 release-only | commit `a66e470204`；`git diff alpha.5 rc.1` = 252 package.json，版本号-only |
+| format v2 / 内嵌流 | commit `f99b06eaed`；笔记 `implemented/architecture/2026-09-01-v2-embedded-assistant-streams.md` |
+| released 迁移 | commit `d1521ea783`；包 `packages/session/session-format-v1-to-v2/`（codec/migration/validation） |
+| handle seam | commit `bec6805d6a`；`session-persistence-jsonl/src/{lease,storage,worker,migration-verifier}.ts` |
+| 写权 lease | commit `c58097a826`；笔记 `implemented/feature/2026-08-31-cross-process-session-write-lease.md` |
+| jsonl-only 收敛 | 笔记 `implemented/simplification/2026-08-30-jsonl-only-session-persistence.md` |
+| 回放读内嵌流 | commit `165cc31eb8`；笔记 `implemented/architecture/2026-09-06-embedded-stream-record-readers.md` |
+| 迁移只读准备 | 笔记 `implemented/architecture/2026-09-05-read-only-session-migration-preparation.md` |
+| message-edit 往返 | commit `ef88756f13` / revert `e974a655a0`（均 09-02） |
+| telemetry 往返 | commit `02a029e679`/`9ffe85a512` → revert `13daefe073`；笔记 `…/2026-09-05-{canonical-feedback-log,nonofficial-feedback-otel}.md` |
+| editor 下架 | commit `36a4665144` + `965adbb5cf`；笔记 `simplification/2026-09-05-base-default-file-editor.md` |
+| proxy 全覆盖 | commit `545e2ad914` |
+| 图片卡 / 文件流 | commit `56ca8af0ee`/`a4d4404708`/`bafa6ae11d` |
+| agent/UX | commit `48cc1cf1d6`/`96ead6091d`/`040d73871b` |
+| 体积与类型 | 复核表 + 剔除阶梯；session 组 +25,333/−10,849 居首 |

package/node_modules/better-dsh/docs/50_test-reports/upstream-dsh-0.1.5-rc.2-local-test-report.md

@@ -0,0 +1,79 @@
+# upstream dsh 0.1.5-rc.2 本地对齐实测报告（Dev/Test 1 · 4988 实例）
+
+> 日期：2026-09-11（HKT）
+> 执行：对齐轮 S1–S7（runbook：`docs/60_exploration-and-research/05-dashr-dev/upstream-alignment.md`）
+> 目标 tag：`dsh-v0.1.5-rc.2`（npm dist-tag `next`，最高版本；`latest` 停在 rc.1）
+> 前置版本对账报告：`docs/upstream-dsh-0.1.5-rc.2-report.md`（846 commits / 3170 files / ~104k 行）
+
+---
+
+## 一、实测范围与结果表
+
+| # | 步骤 | 结果 |
+|---|---|---|
+| S1 | patch 载体 tag 间 diff + dashr 56 个 `@deepseek-ai/*` 引用名对新 tag 包集全数命中 | ✅ |
+| S2 | checkout `dsh-v0.1.5-rc.2` + 三 patch 手工重放（pnpm-workspace.yaml 冲突按新 allowBuilds 手解） | ✅ |
+| S3 | rsync 副本 + stale peerDep 复查（absent）+ **新增 devDeps 手术**（见瑕疵 F2） | ✅ |
+| S4 | `pnpm install`（36s，供应链策略 1543 entries 过）+ `pnpm run build`（234 client artifacts）+ 副本 tsdown/client 半 | ✅ |
+| S5 | 插件契约对齐：**4 处真实语义漂移移植**（见 §三） | ✅ |
+| S6 | `tsc --noEmit` **0 errors**；`vitest --run` **493/493**（37 files，128s） | ✅ |
+| S7 | 4998 实例 systemd-run 冒烟 **8/8 探针全绿**（见 §四） | ✅ |
+
+红线遵守：未 npm publish、未动 prod 3080、未动 Caddyfile。
+
+## 二、环境事实
+
+- monorepo：`upstream/deepseek-harness` @ `dsh-v0.1.5-rc.2`（detached），本地 patch 三件套在场（unrun devDep / storeDir+verifyDepsBeforeRun+zeromq / tsdown resolveRepositoryRoot）。
+- allowBuilds 冲突解：采纳上游新集（**fs-ext 移除**——flock 改走 node-addon-system 预编译；新增 `electron-winstaller: false`、`msgpackr-extract: false`），保留本地 `zeromq: true` 与两条 `dsh-subprocess-local`。
+- 副本 `packages/better-dsh/better-dsh/` = canonical 0.2.3-b + devDeps 手术（14 个 `workspace:*`）。
+- 实例：unit `dsh-4988-test`，`DSH_HOME=~/.dsh-test`，`DSH_TRUSTED_HOSTS=test.pc.randomhash.app pc.randomhash.app 192.168.31.130`，`UnsetEnvironment=DISPLAY WAYLAND_DISPLAY`，**端口 4988**（4997–4999 被 superd PoC 占用，见瑕疵 F4）。
+- 残留实验文件未动：`packages/boot/app-boot/bun-registry/`、`bun-internal-bridge.ts`（2026-09-06 bun compile 实验，构建容忍，untracked 不碍 checkout）。
+
+## 三、契约漂移与移植（本轮核心工作）
+
+对 0.1.5-rc.2 的 **4 处真实漂移**全部移植，canonical 已同步（src/test 与副本 diff = 空）：
+
+1. **会话事件改名**（Session V3「PTC durable vocabulary」）：`tool/code-dispatch(-start)` → `tool/ptc-dispatch(-start)`。`src/index.ts` 2 处 append + 3 处注释；测试 3 文件的字符串断言同步。
+2. **subagents 统一消息缝**：`followup`/`reportFrom` 两方法合并为 `sendMessage(sender, targetId, content, {signal})`（上行 = targetId 命中 sender 的 `parentSession` 自动走 send-to-parent；`source`/`delivery` 选项 knobs 已删，runtime 自盖章）。移植面：`src/subagents-surface.ts` 接口重述、`src/bridges/index.ts` 两调用点（parent 方向新增 root-agent 本地护栏，语义等价旧 UNAUTHORIZED）、`delegation.spec`/`bridges.spec`/`helpers.ts` 全部 fake 与断言。
+3. **持久化读路径**：`SessionPersistence.inspect` 消失（接口只剩 create/open/flush/stat/list）；读 = `open(id,'read')` → `handle.read(offset?,length?,opts)` + `close()`，元数据 = `stat(id).header.createdAt`。移植面：`src/url-schema/handlers/agent.ts` 的 surface 接口重述 + 3 调用点收敛为 `persistedEventsOf` helper。
+4. **SessionSeq 品牌化**：裸 `number` 不再可赋值，需 `SessionSeq(n)` 构造（`dsh-session` 导出）；`assistant/message` 事件 data 新增必填 `stream: AssistantStreamRecord[]`（V3 in-history stream 内嵌）——测试 fixture 两处补 `stream: []`。
+
+另有两处**行形状查表结论**（runbook S7.5/S7.8，全绿）：
+- `connection` 行（web-app cordis.patch.yml）tag 间**逐字节同形**（仅注释位移）——fence 腿整行重述继续有效；
+- `__DSH_TRANSPORT__`/ownsHost 消费点、`data-sidebar-collapsed`（AppFrame.tsx:210 仍在）、`conversation.session.header` 与 `settings.general.item` slot、`apps/web/index.html` viewport meta、`webserver injections.ts` head splice——**全部原样存活**。
+
+## 四、S7 冒烟明细（unit dsh-4988-test）
+
+| 探针 | 结果 |
+|---|---|
+| `web --dump-config` → dashr-repl 行 + `DASHR_KERNEL_PYTHON` 注入 | ✅ |
+| fence：trusted Host `/api` = **401**（过栅栏卡认证）；evil Host = **403** | ✅ |
+| token 鉴权根页 200 + `__DSH_TRANSPORT__` boot script 在页 | ✅ |
+| boot graph `"id":"better-dsh"` + `/plugins/??better-dsh/client.js&rev=…` | ✅ |
+| client bundle：200，**17824B 与本地逐字节一致**（+84B = 服务端 sourceMappingURL 追加，符合已知行为） | ✅ |
+| mobile 锚点：layout 模块含 `data-sidebar-collapsed` + `SIDEBAR_AUTO_COLLAPSE = 1024` | ✅ |
+| hashline 中央库 `$DSH_HOME/storages/dsh-better-edit/hash-store.sqlite` 在位 | ✅ |
+| 0.1.5 新组合在场：ui-sidebar-right/documentpreview/files、client-resources、api-workspace-files、ui-deliverables 均入 module batch | ✅ |
+
+实例**保持运行**供 user 验收：`http://127.0.0.1:4988/?token=<redacted>`（token 每次重启轮换）。
+
+## 五、发现的瑕疵（定性 + 去向）
+
+- **F1（流程/runbook 漂移）**：`packages/node_modules` 在新 tag 安装布局下不再生成 → runbook 的 `../../node_modules/.bin/tsx`（build-client）失效，正确为 `../../../node_modules/.bin/tsx`。→ 已回写 AGENTS.md §二。
+- **F2（工具链坑，重要）**：canonical 的 npm-range optional peerDeps（`>=0.1.2-alpha.1 <0.2.0-0`）在 pnpm 11 严格预发布 semver 下**不匹配 workspace `0.1.5-rc.2`**（元组规则），autoInstallPeers 落到 registry **0.1.2-rc.1**（唯一满足该 range 的 registry 版本）→ 副本 node_modules 双身份，tsc 品牌类型互斥报错。**解法（S3 新增手术）**：副本 package.json devDependencies 注入 14 个 `workspace:*`（dashr 实际 import 的 dsh-* 名单），每次 rsync 后重打。→ 已回写 AGENTS.md §二；canonical 不动（npm 发布语义保持）。
+- **F3（上游观察，非阻塞）**：rc.2 的 `test`/`build:bench` scripts 前置 `build:native-system`；主 `build` 已含（scripts/build.ts:44），无额外步骤。`native/system/packages/linux-x64/bin/glibc/system.node` 已产出。
+- **F4（环境冲突）**：4997（127.0.0.1）、4998、4999（0.0.0.0）被 superd multi-context PoC 占用（`~/workspaces/superd/.scratch/multi-context-poc/poc4-v3-e2e.mjs`，pid 2233871 + 1393092，Sep 10 19:41 起，独立 DSH_HOME）——不可杀（user 的在跑实验），本轮实例改 **4988**。**注意：若 Caddy test.pc.randomhash.app 后端指 4999，域名叫到的将是 superd 实例**——user 域名验收前需先对齐端口或等 PoC 结束（Caddyfile 红线未动）。
+- **F5（上游观察）**：`pnpm peers check` 有 WARN（副本 npm-range peers vs workspace 版本）——F2 的同一根源，运行期无影响（profile symlink 直连 monorepo）。
+
+## 六、流程化产出
+
+- 本报告 + AGENTS.md §二 write-back（tag 对齐记录、tsx 路径、devDeps 手术、端口事实）。
+- `.scratch/dsh-v0.1.3-alpha.2-local-patches-backup.patch`（旧 patch 备份，切换前快照）。
+
+## 七、Open items
+
+1. **user 验收**（第一人称）：127.0.0.1:4988 实例（域名词见 F4 注意）；重点 = dashr-repl 真跑一轮（kernel 三级供给在新 runtime 下）、better-edit 读改写、mobile 手势/zoomGuard 真机。
+2. canonical 改动（4 文件 src + 6 文件 test）**未 commit**——等 user 指令（上轮有 commit 前 "Wait" 先例）。
+3. Caddy test.pc → 4999 端口归属与 superd PoC 的冲突排查（user 裁决）。
+4. 既有遗留：v0.2.5 zoomGuard standalone 双形态 CDP 复验（AGENTS.md 已记）。
+5. prod（3080）**维持 0.1.3-alpha.2 不动**；升 0.1.5 需另行裁决（对账报告 §六建议先行）。

package/node_modules/better-dsh/docs/50_test-reports/v0.1.8-improved-/345/256/236/346/265/213/346/212/245/345/221/212.md

@@ -0,0 +1,142 @@
+# DASHR v0.1.8 改进版复测报告（第一人称实测）
+
+> 复测方式：仍以 DASHR 运行时自身为被测对象（本会话，dsh Web GUI）。运行时已按上版报告调整并重启，本次对**上版全部问题逐条复测**，并重跑测试套件。
+> 复测日期：2026-08-24（同日晚，更新 commit `7ec46ac`）
+
+---
+
+## 0. 结论摘要
+
+| 结论 | 结果 |
+|---|---|
+| 上版 **P0（snapshot 失效）** | ✅ **已修复** |
+| 上版 **P1（docstring 回归）** | ✅ **已修复** |
+| 上版 P2/P3（命名漂移、masking 张力、fgm→pgmi） | ✅ **全部修复/重新设计** |
+| 测试套件 | ✅ **156/156 全绿**（上版 155/163） |
+| 遗留问题 | 🟡 README 中后段 + 根 README 仍残留旧架构文档；`compact` 引擎本部署仍未挂载 |
+
+**一句话结论**：改进版把上版报告里的**功能性问题全部清零**——内核环境自管（Python 3.11 + dill）让 snapshot 复活，delegation 工具从「桥接包装」改为「直接暴露」消除了 masking 与 dual-exposure 的张力；但**文档层还有两处 README 残留旧架构描述**需要清理。
+
+---
+
+## 1. 本次变更（commit `7ec46ac`）
+
+```
+dashr: runtime-owned kernel environment + native delegation exposure
+```
+
+1. **内核环境自管**（新增 `src/kernel-env.ts`，210 行）：运行时自己 provision 一个托管 CPython 3.11 venv（`ipykernel` + `dill`），落在**包内 `.venv-kernel`**（不再 `/tmp` 悬空 symlink）。显式解释器被校验：缺 `dill` = 响亮告警（禁用快照），缺 `ipykernel` = 硬错误。
+2. **原生 delegation 直接暴露**：masking 从 8 名收敛到**仅 2 名**（`send_message` + `report`）；`subagent`/`subagent_fork`/`list_agents`/`interrupt_agent`/`workflow`/`ralph` 直接暴露为 `tool.*` 成员；**`rlm`/`agent_list`/`rlm_workflow`/`rlm_ralph` 桥接全部删除**。
+3. **Rebrand**：`@fgm-builds/dashr` → `@pgmi-builds/dashr`；RLM 术语在 CONTEXT/ADR 去强调。
+
+---
+
+## 2. 上版问题逐条复测
+
+| 上版问题 | 严重度 | 本次实测证据 | 状态 |
+|---|---|---|---|
+| snapshot 失效（dill 缺 + Python 3.14） | 🔴 P0 | 实测内核 `Python 3.11.15` + `dill 0.4.1` + `ipykernel 7.3.0`；`.venv-kernel` 指向 uv 托管 3.11；快照测试全绿 | ✅ 修复 |
+| docstring 回归 | 🟠 P1 | 实测 `helper.__doc__ == 'First summary line.\n    Details follow.'`；`runtime.spec.ts` 绿 | ✅ 修复 |
+| `agent_message` vs `send_message` | 🟡 P2 | 实测 `tool.agent_message` → `unknown binding`；`tool.send_message` 为双向桥接；CONTEXT/ADR 已改 | ✅ 修复 |
+| flat-global vs `tool.*` | 🟡 P2 | CONTEXT.md「Binding」已改「`tool.*` member」 | ✅ 修复 |
+| `fgm` vs `pgmi` | 🟡 P2 | `package.json` name / `cordis.patch.yml` 均 `@pgmi-builds/dashr` | ✅ 修复 |
+| masking 7 vs 8 | 🟡 P2 | 重新设计为 2 名，ADR-0002 已同步 | ✅ 修复 |
+| masking 对直接面无效（结构性张力） | 🟡 P3 | 决策落地：delegation 直接暴露、`rlm` 删除，张力消除 | ✅ 修复 |
+| 桥接错误风格不一致 | 🟡 P3 | `rlm_workflow` 等已删，仅剩 `send_message`（结构化 error 值） | ✅ 消除 |
+
+---
+
+## 3. 新功能面实测（第一人称逐项）
+
+### ✅ 3.1 内核环境自管 —— 通过
+
+```
+kernel python: 3.11.15
+dill: 0.4.1
+ipykernel: 7.3.0
+```
+
+`.venv-kernel/bin/python` 现指向 `/home/u1/.local/share/uv/python/cpython-3.11-linux-x86_64-gnu/bin/python3.11`（真实存在，非悬空）。
+
+### ✅ 3.2 原生 delegation 直接暴露 —— 通过
+
+`tool.subagent` / `tool.subagent_fork` / `tool.list_agents` / `tool.interrupt_agent` / `tool.workflow` / `tool.ralph` 现在**全部直接绑定**（call-through 返回的是真实工具的参数校验错误，而非 `unknown binding`）：
+
+```
+tool.subagent        -> REJECTED (invalid arguments: missing required property "description")
+tool.list_agents     -> bound+callable（返回子代理列表）
+tool.workflow        -> REJECTED (missing required property "script")
+tool.ralph           -> REJECTED (missing required property "objective")
+```
+
+### ✅ 3.3 桥接收敛（仅 send_message + refine + compact）—— 通过
+
+```
+tool.send_message    -> bound+callable   （双向桥接）
+tool.refine          -> bound+callable
+tool.compact         -> bound+callable
+tool.rlm             -> REJECTED (unknown binding "tool.rlm")
+tool.agent_list      -> REJECTED (unknown binding)
+tool.rlm_workflow    -> REJECTED (unknown binding)
+tool.rlm_ralph       -> REJECTED (unknown binding)
+tool.agent_message   -> REJECTED (unknown binding)
+```
+
+`rlm` 家族彻底移除，递归改走 `tool.subagent` / `tool.subagent_fork` 直连。
+
+### ✅ 3.4 递归 + A2A 全链路（新形态）—— 通过
+
+```
+tool.subagent spawn → {'kind':'continuable','subagentId':'3e8f3609-...'}   （8*9）
+child 完成上报
+tool.send_message(receiver='child') 下行追问 9*9 → 上报 "81"
+tool.send_message(receiver='parent') from root → 结构化 UNAUTHORIZED（guard 仍在）
+```
+
+### ✅ 3.5 无回归项 —— 通过
+
+`tool.*` 绑定、跨 cell 持久化、`ToolCallError(.toolName)`、`asyncio.gather`、顶层 `return` → SyntaxError 均与上版一致，无回归。
+
+### ✅ 3.6 测试套件 —— 全绿
+
+```
+Test Files  18 passed (18)
+     Tests  156 passed (156)
+```
+
+上版失败的 `snapshot-revive` / `snapshot-restore` / `lifecycle` / `session-keys` / `runtime`(docstring) 全部转绿；新增 `bindings.spec.ts`（7）、`parallel.spec.ts`（2）。
+
+---
+
+## 4. 遗留问题（新发现）
+
+### 🟡 4.1 包内 `dashr/README.md` 中后段仍描述旧架构
+
+header 段已更新（`dsh-rlm-mode`→`dashr`、`RLMRuntime`→`ReplRuntime`、`ipython`→`eval`、kernel 自管），但**中后段未同步**，仍残留：
+
+- 「**`ipython`** — the only tool the model may call directly」（应为 `eval`）
+- 「FLAT top-level callables — `await name({...})`」（应为 `tool.*` member）
+- 「bridge callables `rlm`, `send_message`, `agent_list`, `rlm_workflow`, `rlm_ralph`」（已删）
+- 「Delegation and messaging (rlm, send_message, agent_list, rlm_workflow, rlm_ralph)」整段 `rlm()` API 文档（已删）
+- install 段仍指 `dsh-rlm-mode` + `rlm-mode` preset（preset 已删）
+- `dashr-kernel` group `isolate: { rlmRuntime: true }`（旧 realm 架构，现为 host-plane `dashr-repl`）
+
+### 🟡 4.2 根 `README.md` 完全未 rebrand
+
+根 `README.md` 仍是「# Dashr: RLM Plugin for `dsh`」+ `dsh-rlm-mode` npm badge + 完整 RLM 定位 + `rlm()` API 示例——本次 commit **未触碰根 README**。
+
+### 🟡 4.3 `compact` 引擎本部署未挂载
+
+`tool.compact` 返回 `{'context_tokens': 137635, 'error': 'compact() is unavailable: no ctx.compaction engine is mounted in this composition'}`——桥接存在，但本 composition 无宿主压缩引擎（与上版一致，非本 commit 引入）。
+
+### ⚪ 4.4 观察项：会话续接时工具目录未随插件升级刷新
+
+本会话（`session-5037d6a6`）跨过了插件更新 + 运行时重启，但**本会话的 system prompt（Tool Catalog）仍是旧版**——仍在声明 `rlm`/`agent_list`/`rlm_workflow`/`rlm_ralph` 可用，而实测运行时已 `unknown binding`。新开会话应得到正确目录，但「持久会话热升级插件后目录不刷新」值得留意。
+
+---
+
+## 5. 建议
+
+1. **清理 README 残留**：把 `dashr/README.md` 中后段（ipython/flat/rlm 家族/install/preset/isolate realm）+ 根 `README.md`（RLM 定位、`dsh-rlm-mode` badge、`rlm()` API）对齐 v0.1.8 实际形态（`eval`、`tool.*`、直接 delegation、`@pgmi-builds/dashr`）。
+2. **验证 compact 部署**：在目标部署形态下挂载宿主压缩引擎，复验 `compact` 与 Global Context Recency Window。
+3. **会话续接目录刷新**（可选）：考虑在插件升级/重启后让持久会话的 Tool Catalog 失效或重算，避免模型看到过期工具面。

package/node_modules/better-dsh/docs/50_test-reports/v0.1.8-/345/256/236/346/265/213/346/212/245/345/221/212.md

@@ -0,0 +1,193 @@
+# DASHR v0.1.8 实测报告
+
+> 实测方式：以 DASHR agent 运行时自身（本会话，运行于 dsh Web GUI）作为被测对象，直接调用 `eval` 持久内核与 `tool.*` 绑定逐一实测，并运行仓库 `npm test` 测试套件交叉验证。
+> 实测日期：2026-08-24
+
+---
+
+## 0. 摘要（TL;DR）
+
+| 结论 | 结果 |
+|---|---|
+| 核心 REPL 能力（`eval` 持久内核、`tool.*` 绑定、masking、`rlm` 递归、A2A） | ✅ **全部实测可用** |
+| 测试套件 | ⚠️ **155/163 通过，8 个失败** |
+| 失败根因 | 🔴 **snapshot 快照/恢复功能失效**（`dill` 缺失 + 内核运行在 Python 3.14.4 而非文档要求的 3.11） |
+| 文档/命名漂移 | 🟡 若干（`agent_message` vs `send_message`、flat-global vs `tool.*`、`fgm` vs `pgmi` 等） |
+
+**一句话结论**：v0.1.8 的「eval 持久内核 + 统一 `tool.*` 桥接」这条主线功能是**成立且可用的**，递归子代理（RLM）与 A2A 通信全链路走通；但 **snapshot 快照/恢复（README 标注的 `dill` 全命名空间快照）在当前环境是坏的**，且存在多处文档与代码的命名/架构漂移。
+
+---
+
+## 1. 被测对象与版本
+
+| 项 | 值 |
+|---|---|
+| 插件包名 / 版本 | `@fgm-builds/dashr`（`dashr/package.json` `version: 0.1.8`） |
+| 工作区 git 状态 | 工作区未提交改动；`git describe` = `v0.1.6-1-gec7b844`（v0.1.7/v0.1.8 均为未提交的开发产出） |
+| 宿主运行时 | `dsh 0.1.1-rc.2`（`dsh --version`） |
+| Node | v22.22.1 |
+| 内核 Python（实测） | **3.14.4**（系统 `/usr/bin/python3`） |
+| ipykernel | 7.3.0 |
+| `dill` | ❌ **未安装**（`ModuleNotFoundError: No module named 'dill'`） |
+| 内核 venv | `.venv-kernel/bin/python` → `/tmp/dashr-py311/bin/python3.11` **悬空**（目标已删） |
+
+---
+
+## 2. v0.1.8 相对 v0.1.6 的关键变化（读代码 + 文档得出）
+
+1. **Rebrand**：`dsh-rlm-mode` → `@fgm-builds/dashr`，定位从「RLM 插件」转向「Better Dash 完整 App（distro）」（`docs/repositioning-and-rebranding.md`、`docs/distro-blueprint.md`）。
+2. **架构升级（最大改动）**：`cordis.patch.yml` 从 `[]`（空壳）改为在 **HOST 平面** 挂载 `dashr-repl`（`eval` 工具 + 持久 kernel REPL 运行时落到全局作用域层，对所有 preset 可见）。旧的 `preset/rlm-mode/agent.cordis.yml`、`preset.yml` **删除**——这是 v0.1.5「DashrDaemon 空壳」的正式落地。
+3. **传输工具改名**：`run_cell` → **`eval`**（`EVAL_NAME = 'eval'`）。
+4. **绑定形态切换**：从 v0.1.5 的「平级 top-level global」切到 **统一 `tool.*` namespace**（每工具 = `await tool.name({...})` 成员 async callable），对应 distro-blueprint §2.2 的「dual exposure / both 模式」。
+5. **Masking 名单扩充**：`MASKED_TOOL_NAMES` 含 **8 个名**（ADR-0002 只写 7 个，实际多了 `report`）：`subagent, subagent_fork, send_message, list_agents, interrupt_agent, workflow, ralph, report`。
+6. **桥接工具**（bridge tools，`BRIDGE_TOOL_SCHEMAS`）：`rlm` / `send_message` / `agent_list` / `rlm_workflow` / `rlm_ralph`。
+
+---
+
+## 3. 实测结果 — 功能面（逐项亲测）
+
+### ✅ 3.1 `eval` 持久内核 —— 通过
+
+`eval` cell 正常执行，内核为真实 IPython 持久内核，`await` / 顶层表达式 / 变量跨 cell 存续均正常。
+
+### ✅ 3.2 状态跨 cell 持久化 —— 通过
+
+Cell 1 定义 `persist_probe`，Cell 4 仍可读：`persist_probe still alive: {'made_in': 'cell-1', 'answer': 42}`。
+
+### ✅ 3.3 `tool.*` 统一绑定 —— 通过
+
+`tool.read` / `tool.bash` / `tool.grep` / `tool.glob` / `tool.write` / `tool.edit` / `tool.web_search` / `tool.skill` / `tool.memory_*` / `tool.refine` / `tool.todo_write` / `tool.get_goal` 均可用（实测调用返回正确 JSON）。
+
+### ✅ 3.4 `ToolCallError` 类型化拒绝 —— 通过
+
+真实工具调用失败（文件不存在）抛 `ToolCallError`，`.toolName` 正确携带绑定名：
+
+```
+caught ToolCallError: ToolCallError | toolName = read
+```
+
+### ✅ 3.5 `asyncio.gather` fan-out —— 通过
+
+并发 `tool.read` + `tool.bash` 同 cell 完成。
+
+### ✅ 3.6 Masking（呈现层排除，host 端拒绝）—— 通过（REPL 内）
+
+`tool.subagent` / `tool.list_agents` / `tool.interrupt_agent` / `tool.workflow` / `tool.ralph` / `tool.subagent_fork` / `tool.send_message`(上游工具名) → 全部返回 `ToolCallError: unknown binding`。
+legacy 传输名 `tool.run_cell` / `tool.run_code` / `tool.ipython` / `tool.eval`（嵌套）→ 同样 `unknown binding`（`eval` 自身不可重入）。
+
+> 关键机制：`_DashrBindingHolder.__getattr__` 对**任意**名字都返回 proxy（`getattr` 永不抛 AttributeError），真实「是否绑定」由 host 在**调用时**判定拒绝。因此 `dir(tool)` 为 0 成员、`getattr` 恒真——需要**调用**才能区分 masked 与否。
+
+### ✅ 3.7 桥接工具 —— 通过
+
+| 桥接名 | 实测 |
+|---|---|
+| `tool.rlm` | `rlm({"mode":"bogus"})` → 结构化错误值 `{'error': 'rlm() requires ...'}`（非异常） |
+| `tool.agent_list` | 返回子代理列表 |
+| `tool.send_message` | 上行/下行均走通（见 3.9/3.10） |
+| `tool.rlm_workflow` | 校验失败抛 `ToolCallError`（missing meta.name） |
+| `tool.rlm_ralph` | 实际触发一次 Ralph 循环（`status: blocked`） |
+
+### ✅ 3.8 RLM 递归子代理全链路 —— 通过
+
+```
+rlm spawn → {'kind':'continuable','subagentId':'26e2842e-...'}
+child 完成上报: "42"（6*7）
+send_message 下行追问 7*8 → child 再上报: "56"
+```
+
+spawn → child 执行 → wakeup 上报 → parent 下行追问 → 再上报，**完整闭环走通**。
+
+### ✅ 3.9 `agent_list` 状态流转 —— 通过
+
+`running → ready`（`ready` = 空闲可续聊，非终结态）。
+
+### ✅ 3.10 A2A 上行 guard —— 通过
+
+root 调 `tool.send_message(receiver='parent')` → 结构化错误：`only a live continuable child agent can report to its parent`（`authorizeReporter` 的 `UNAUTHORIZED` 路径，root 不具上行资格）。
+
+### ✅ 3.11 REPL 语义 —— 通过
+
+顶层 `return` → `SyntaxError: 'return' outside function`（parse 期即拒绝，符合原生 IPython cell 语义）。
+
+### ⚠️ 3.12 `compact` 压缩 —— 本环境不可用
+
+`tool.compact` 返回 `{'context_tokens': 88407, 'error': 'compact() is unavailable: no ctx.compaction engine is ...'}`——宿主 `ctx.compaction` 引擎未在本部署加载，压缩能力无实际效果。
+
+### 🔴 3.13 snapshot 快照/恢复 —— 失效
+
+见 §5/§6，根因是 `dill` 缺失。
+
+---
+
+## 4. 测试套件结果（`npm test` = `vitest --run`）
+
+```
+Test Files  5 failed | 13 passed (18)
+     Tests  8 failed | 155 passed (163)
+```
+
+失败分布（8 个失败，7 个集中在 snapshot）：
+
+| 文件 | 失败数 | 失败用例 |
+|---|---|---|
+| `test/snapshot-revive.spec.ts` | 4 | 全部（revive/降级/超限快照/over-cap） |
+| `test/lifecycle.spec.ts` | 1 | dispose 时写快照 |
+| `test/session-keys.spec.ts` | 1 | 每 principal 快照独立子目录 |
+| `test/snapshot-restore.spec.ts` | 1 | eval 快照路径 + 恢复纯用户态 |
+| `test/runtime.spec.ts` | 1 | **keep function docstrings intact**（非快照，单独问题） |
+
+> 注：`npm test` 进程退出码为 0（vitest 失败但外层 bash 收 0），CI 若直接依赖退出码会**漏报失败**——建议核对 vitest 的 exit-code 配置。
+
+---
+
+## 5. 根因分析
+
+### 5.1 snapshot 失效（7 个失败）—— 环境链式断裂
+
+```
+.venv-kernel/bin/python  →  /tmp/dashr-py311/bin/python3.11   （悬空，目标已删）
+        ↓ 测试 helper: existsSync(悬空 symlink)=false → 回退 'python3'
+        ↓ 内核运行在 Python 3.14.4（系统解释器）
+系统 python3.14 已装 ipykernel 7.3.0，但 ❌ 无 dill
+        ↓ snapshot/restore 依赖 dill.dump/dill.load（src/python.ts:163,242）
+        ↓ dump 失败 → manifest.json 从未写出 → 测试 ENOENT / assertion 失败
+```
+
+即：**文档承诺的「Python 3.11 内核（uv venv）+ dill」部署前提在本机已失效**，运行时静默回退到 3.14.4 且缺 dill，导致快照功能整体不可用。
+
+### 5.2 docstring 失败（1 个）—— 疑似 Python 3.14 行为变化
+
+`runtime.spec.ts`「keeps function docstrings intact」断言 `helper.__doc__` 精确等于 `'First summary line.\n    Details follow.'`，在 3.14 下不成立。与 5.1 同源（内核 Python 版本漂移），需在 3.11 下复验。
+
+---
+
+## 6. 问题清单（按严重度）
+
+### 🔴 P0 — 快照功能整体失效
+README「State Snapshot & Revival 💾 Full Namespace Snapshot (dill)」在当前环境不可用。需修复内核 Python 环境（重建 3.11 venv + `ipykernel dill`），或让运行时在缺 dill 时显式告警而非静默跳过。
+
+### 🟠 P1 — docstring 回归
+可能由 Python 3.14 引入；需在 3.11 内核下确认是否仍存在。
+
+### 🟡 P2 — 文档/命名漂移（多处）
+1. **`agent_message` vs `send_message`**：`CONTEXT.md` 术语表写 A2A 函数为 `agent_message(receiver, message, *, subagent_id)`，但 v0.1.8 实际桥接名为 **`send_message`**（`tool.send_message`）。实测 `tool.agent_message` → `unknown binding`。
+2. **flat-global vs `tool.*`**：`CONTEXT.md`「Binding = flat global」及 `V0.1.5-development-plan.md`（Q8 平级 globals）描述的是旧形态；v0.1.8 已切换为统一 `tool.*` namespace，`rlm`/`agent_list` 等**不再是裸全局**（实测 `rlm(...)` 裸调用 → `NameError`）。
+3. **`subagents-surface.ts` 头注释**仍描述「preset 的 entry-local `isolate: { replRuntime: true }` realm」旧架构；v0.1.8 已改为 HOST 平面全局挂载，注释过时。
+4. **`@fgm-builds/dashr` vs `pgmi-builds`**：最近一次 commit（`ec7b844`）把 GitHub namespace 从 fgm-builds 改成 pgmi-builds，但 `package.json` 的 `name` 仍是 `@fgm-builds/dashr`，仅 `repository.url` 是 pgmi-builds，未同步。
+5. **masking 数量**：ADR-0002 / V0.1.5 plan 写 7 个 masked 名，代码 `MASKED_TOOL_NAMES` 实际 **8 个**（多了 `report`）。
+
+### 🟡 P3 — 观察项（供决策，非必然 bug）
+1. **masking 对「直接 function-calling 面」无效**：ADR-0002 意图是「模型看不到这 7/8 个名」，但实测 masking 只作用于 REPL 内 `tool.*`；作为 dual-exposure（both 模式）副作用，`subagent`/`send_message`/`list_agents`/`interrupt_agent`/`workflow`/`ralph`/`subagent_fork` 仍出现在模型**直接可调用的工具面**。这是 both 模式与 masking 意图的结构性张力，需 maintainer 决策（是否要在直接面也收敛）。
+2. **桥接工具错误风格不一致**：`rlm()` 参数校验失败返回**结构化 error 值**，`rlm_workflow()` 校验失败抛 **ToolCallError**，两种风格并存。
+3. **README/描述措辞**：`package.json` description 写 `tool.*`，README 正文仍写 `tools.*`（复数，旧名），需统一。
+4. **`compact` 依赖宿主压缩引擎**：本部署无 `ctx.compaction` 引擎，DASHR 的「Global Context Recency Window / compact」压缩能力未在此环境生效，需在目标部署形态下复验。
+
+---
+
+## 7. 建议
+
+1. **优先修复内核环境**：重建 `.venv-kernel`（Python 3.11 + `ipykernel` + `dill`），消除悬空 symlink；否则快照功能与 7 个测试持续红灯。
+2. **为缺 dill / 版本漂移加显式护栏**：运行时启动时探测 `dill` 与 Python 版本，缺依赖时降级快照并**告警到模型/日志**，而非静默跳过。
+3. **同步文档与命名**：统一 `CONTEXT.md`（`agent_message`→`send_message`、flat-global→`tool.*`）、`subagents-surface.ts` 头注释、`package.json` `name`（fgm→pgmi）、README 的 `tools.*`→`tool.*`。
+4. **明确 masking 边界**：在 dual-exposure 下重新定义「masking 语义」——是只收敛 REPL 内 `tool.*`，还是也要在直接工具面收敛，形成 ADR。
+5. **CI 退出码**：核对 vitest 失败时是否向 CI 返回非零退出码，避免「红测试绿流水线」。

package/node_modules/better-dsh/docs/50_test-reports/v0.1.8b-/345/256/236/346/265/213/346/212/245/345/221/212.md

@@ -0,0 +1,96 @@
+# DASHR v0.1.8b 实测报告（决策记录 + 待拿掉缺口清单）
+
+> 状态：决策已定，代码待落地。本文为**需求移交文档**：本会话只做实测/记录，不动代码；后续开发 agent 按 §4 一次性改。
+> 日期：2026-08-24
+
+---
+
+## 0. 结论摘要
+
+| 项 | 决策 |
+|---|---|
+| `refine`（Continual Harness） | 🔴 **移除**（本轮定） |
+| `compact`（`tool.compact` 上下文压缩 REPL 桥接） | 🔴 **移除**（上轮已定） |
+| `recency`（被动 recency 压缩引擎，后台 auto） | ✅ **保留** |
+| `send_message`（A2A 双向桥接） | ✅ 保留 |
+| `eval`（传输工具） | ✅ 保留 |
+
+DASHR 自登记的工具从 4 个（eval + send_message + refine + compact）收敛为 **2 个（eval + send_message）**——即「DASHR 独有、原生工具链没有的」两个桥接（refine/compact）全部拿掉。
+
+---
+
+## 1. 决策一：移除 `refine`（本轮，2026-08-24）
+
+`refine` 是抄 Prime Agent 的 **Continual Harness**（Prime Agent 三大支柱：RLM / Context as variable / Continual harness）。移除理由（用户定）：
+
+**1.1 定位与界限不清**
+- `refine` 功能上接近「记忆 / 技能」（memory / skill）。
+- Hermes、openclaw 这类 Persona Agent 已经在做 cross-session enhancement（harness 跨 session persist）。
+- DASHR 在 runtime 内重组 System Prompt 确实难得；但**同 session 重组后 persist 下来，下个 session 也会带着这个 harness**——这混淆了 **cross-session（跨会话）** 与 **per-session real-time（会话内实时）** 的界限。
+- 很多「当时当地有用」的配置并不该跨 session 固化；做 coding/项目的 agent，用户更倾向**每次唤醒时外围 harness 固定、可控**，需要调整再走别的机制。
+- 核心未决问题：**Dash 的定位到底是 Persona Agent（人格体、跨会话增强），还是 CLI 式（每次唤醒执行独立新任务）？** 定位不清，refine 的语义就悬空。
+
+**1.2 有效性待测**
+- real-time harness 的作用有多大未验证。
+- 它是在 runtime 内由**旁路大模型**做总结，且 persist over session——多一次推理、多一层持久状态，收益不明确。
+- Memory / Skill 已经有外围插件填补了生态位；唯一缺口只是「不能在 runtime 内实时重组」，而「实时重组」目前看偏超前、有效性存疑。
+
+**1.3 模型没空主动调它（用户补充）**
+- 大模型几乎**每一个 turn、每一个 user prompt 都有任务要做**，不会「有心思」在 runtime 里主动去调用 refine 这种自我维护动作。
+- 让模型在忙正事的同时抽空做 harness 重组，是天方夜谭；它只会专注手头任务。
+
+**可逆性**：项目有 Git 版本控制，随时可切回 v0.1.6 或更早查看源码；上游 Prime Agent 也在做相关探索，届时可再引入。故本次**暂不引入 Refine**。
+
+---
+
+## 2. 决策二：移除 `compact`（上轮已定）
+
+`compact` 是把宿主 `ctx.compaction` 引擎硬桥进 REPL 的 DASHR 独有桥接。移除理由：
+- 上下文压缩是**宿主运行时的事**，不属于 REPL（REPL 是 Agent 运行时的「外部环境」）。
+- 原生工具链根本没有 `compact` 工具（只有 CLI 命令 + 压缩引擎 service），DASHR 是「无中生有」映射进来的。
+- 实测 `tool.compact` 一调就返回 `no ctx.compaction engine is mounted`（本部署未挂引擎），映射了也没意义。
+- 程序逻辑上「既不桥接、也不屏蔽」最简洁——上游不提供，删掉即自然缺位。
+
+> 注意：移除的是 `tool.compact` 这个**模型可见的 REPL 桥接**；被动 recency 压缩引擎（`RecencyAwareCompactionEngine`，`auto: true` 后台自动压）**保留**——两者是两回事（见 §4）。
+
+---
+
+## 3. 全量「待拿掉缺口」清单
+
+| # | 缺口 | 类型 | 状态 |
+|---|---|---|---|
+| 1 | `compact` REPL 桥接（`compactCallable` + catalog + bindings） | 代码 | 🔴 待落地 |
+| 2 | `refine` REPL 桥接（`refineCallable` + catalog + bindings） | 代码 | 🔴 待落地 |
+| 3 | `refine` 连带 machinery：`refineModel` 配置、`dashr:harness` prompt 段、`src/refine.ts`、`src/harness-store.ts`（注：`compactModel`/`src/compaction-surface.ts`/`src/compaction/recency-engine.ts` 属 recency，**保留**） | 代码 | 🔴 待落地（随 1/2 一并） |
+| 4 | `dashr/README.md` 中后段仍描述旧架构（`ipython` 传输、FLAT callables、`rlm`/`agent_list`/`rlm_workflow`/`rlm_ralph`、`dsh-rlm-mode`、`rlm-mode` preset、`dashr-kernel` isolate realm） | 文档 | 🟡 待修 |
+| 5 | 根 `README.md` 完全未 rebrand（仍「RLM Plugin for dsh」+ `dsh-rlm-mode` badge + `rlm()` API） | 文档 | 🟡 待修 |
+| 6 | 持久会话热升级插件后 Tool Catalog 不刷新（system prompt 残留 `rlm`/`agent_list` 等旧名） | 运行时 | 🟡 待修（新开会话自愈，属会话续接边界） |
+
+---
+
+## 4. 落地范围（已定稿：refine 删、recency 保留）
+
+**移除 —— refine（Continual Harness）：**
+1. `BRIDGE_TOOL_SCHEMAS` 删 `refine` 条目（留 `send_message`）。
+2. 删 `refineCallable` 函数 + bindings 装配处 `refine: refineCallable`。
+3. 删 `src/refine.ts`、`src/harness-store.ts`（及其测试）。
+4. 删 `refineModel` 配置项 + `resolveRefineTarget` + `requireLlm` 相关 wiring。
+5. 删 `dashr:harness` prompt 段（refine 是唯一写入方，删后必然为空）。
+
+**移除 —— compact（仅 `tool.compact` 桥接，不动 recency）：**
+6. `BRIDGE_TOOL_SCHEMAS` 删 `compact` 条目。
+7. 删 `compactCallable` 函数 + bindings 装配处 `compact: compactCallable`。
+
+**保留：**
+- `send_message` 桥接（A2A 双向）。
+- `eval`（传输核心）。
+- **被动 recency 压缩引擎**：`src/compaction/recency-engine.ts`（`RecencyAwareCompactionEngine`，`auto: true` step 间自动压）+ `compactModel` 配置 + `src/compaction-surface.ts` + `scopedCompaction` wiring —— **全部保留**（被动压缩有用，且不占 REPL 面）。
+
+---
+
+## 5. 复测计划（落地后执行）
+
+1. 跑 `npm test`（预期原 156 用例中，refine/compact/harness 相关 spec 删除或转绿）。
+2. 实测 `tool.*` 面：`tool.refine` / `tool.compact` → `unknown binding`；`tool.send_message` / `tool.eval` 正常。
+3. 确认 `refine`/`compact` 不再出现在 Tool Catalog。
+4. 文档缺口（#4/#5）核对 README 是否对齐 v0.1.8b 实际形态。