dsh-context-compression-improved 0.2.1 → 0.3.0

package/.gitattributes

@@ -1 +1 @@
-packages/selector/assets/** -text
+packages/selector/assets/** -text

package/.github/workflows/ci.yml

@@ -18,18 +18,12 @@ jobs:
           version: 11.7.0
       - uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4
         with:
-          node-version: 22.19.0
+          node-version: 24.0.0
           cache: pnpm
       - run: pnpm install --frozen-lockfile
       - run: pnpm lint
       - run: pnpm typecheck
       - run: pnpm build
-      # scripts/ is compiled to the gitignored scripts-dist/, and nothing above this
-      # point builds it. Without this step verify:release and test:e2e:packed both
-      # die with MODULE_NOT_FOUND on a clean checkout — which is what kept this
-      # workflow red on every push to main while the same gates passed locally,
-      # where scripts-dist/ had been built by hand once.
-      - run: pnpm build:scripts
       - run: pnpm test
       - run: pnpm --filter dsh-context-compression-improved test
       - run: pnpm test:built

package/CHANGELOG.ja.md

@@ -2,24 +2,27 @@
 
 > 完全な履歴（アップストリーム 0.1.0 以前を含む）は [CHANGELOG.md](CHANGELOG.md) を参照。このファイルはフォークの追加エントリーのみを翻訳したものです。 · [English](CHANGELOG.md) · [中文](CHANGELOG.zh.md) · [한국어](CHANGELOG.ko.md)
 
-## 0.1.1
-
-### 追加
-
-- `scripts/` の TypeScript ツールチェーン：`verify-release`、`packed-components-smoke`、`packed-install-e2e` が `.ts` ソースになり、`tsc` で `scripts-dist/` にコンパイルされます。リポジトリ内の最後の3つの非 TS ヽースファイルが排除されました。
-
-### 変更
-
-- `package.json` スクリプト `test:e2e:packed` と `verify:release` が `scripts-dist/` のコンパイル成果物を実行するようになりました。
-- エスティメーターカタログルート登録が硬化：`asWebServer` がサービス自体を返すように修正（D7 修正）、エステーター UI が非アクティブ時にセクション見出しを保持するように修正（U1 修正）。
-- フレームワークドキュメント修正：行レベル `inject: [webServer]` は負荷担うものではない（Y22）；DSH 全パッケージに `isolate()` なし。
+## Unreleased（未リリース）
+### Changed（0.1.5 互換 / compat/0.1.5 ブランチ）
+
+- runtime パッケージを selector パッケージへ統合しました。1 回のインストールでスタック全体が入り、
+  リポジトリのルートがインストール面になります（`name`、`main`、`types`、`./pruner` と
+  `./invariant` を含む `exports`、`dependencies`、`dsh`）。ツールチェーン・スクリプト・CI も
+  単一パッケージへ揃えました。実機で検証済みの estimator-catalog ルート登録（二重プレフィックス、
+  保護された二経路の有効化、リクエスト毎のサービス解決、可観測なライフサイクルログ）を本ラインへ
+  再適用し、ホスト側のガードを追加しました。`ab2175a` で `z.any()` に落とされていた settings
+  スキーマを復元し、Custom の既定値が再び公開されます。
+- ブランチ上で公式 DeepSeek Harness `v0.1.5-rc.2` に適応。`@deepseek-ai/dsh-*` 全開発依存と e2e 公式ホスト一覧を `0.1.1-rc.2` から `0.1.5-rc.2` へ更新（cordis `4.0.2`、schemastery `3.18.2`、新分割パッケージ群と `dsh-client-store` クライアントスタックを含む）。
+- surface 置換は v3 の `startSeq`/`endSeq` 形状とブランド化 `SessionSeq` を使用。surface node のイベント解決は配列インデックスではなく seq 検索に変更。
+- クライアントバンドルは削除された `@deepseek-ai/dsh-client-runtime` を参照しない。settings 型は `@deepseek-ai/dsh-client-ui-settings`、セッション hooks は `@deepseek-ai/dsh-client-ui-session` から取得。`engines.dsh >=0.1.5-alpha.1 <0.2.0-0` を宣言。
+- Harness 0.1.5 はセッション `agentPreset` をブラウザへ公開しないため、クライアント側で Minimal セッションを検出できない。セレクターは選択可能なまま。
+- テストを 0.1.5 のセマンティクスに更新（`.await()`、`SessionProjectionRegistry`、`stream: []`、文字列の settings 名前空間）。
 
 ### 修正
 
-- エスティメーターカタログルートは `asWebServer` が `register` をサービスから切り離したため、最初から一度も登録されなかった（D7）。
-- 非 TokenPilot プロファイル時にエステーターセクションが警告なしに非表示になっていた（U1）。
-
-## Unreleased（未リリース）
+- エスティメーターカードは Harness ホストチャネルで API キーを要求しなくなりました。ホストチャネルを選ぶと、ライブのプロバイダー/モデル ドロップダウンが表示され、実際に使われるルート（明示的な上書き、なければセッション既定モデル）を明示します。キー入力欄と 2 つ目の手入力モデル欄は表示されません — エンドポイント URL、モデルのテキスト欄、書き込み専用キーはダイレクト接続チャネルだけに属します。
+- `presetOptions` の書き込みをパス指定方式に変更しました。従来はセクション全体を置き換えていたため、エスティメーターの 2 つ目のフィールド（プロバイダー、モデル、エンドポイント）に触れると `estimatorMode` と他のすべての上書きが削除され、パネルは保存成功と表示したままエスティメーターが静かにオフへ戻っていました。現在は各フィールドが自分のパスだけを書き込み、`undefined` は指定したフィールドだけを消去し、confirm-on-write はチャネル単独ではなく同じフィールド群を検証します。
+- 回帰カバレッジを追加：`packages/selector/tests/preset-options-write.client.spec.ts`（パス単位の書き込み、兄弟フィールドの保持、明示的な消去、変更なし時の無書き込み、未コミット書き込みの報告）と `packages/selector/tests/estimator-channel.client.spec.tsx`（チャネル別フィールド、カタログのドロップダウン、手入力フォールバック）。
 
 ### 追加
 
@@ -31,9 +34,3 @@
 
 - ESLint フラット設定ベースライン（`pnpm lint`、CI でも強制）と `pnpm test:watch` による TDD ループを追加。デッドインポートを整理し、lint ベースラインで浮かび上がった 2 つのエラー経路を強化しました。
 - 本リポジトリは `WilliamShi666/dsh-context-compression-selector` の改良フォークとして管理されます。ドキュメントは英語・簡体字中国語・日本語・韓国語で提供されます。
-
-### 修正
-
-- エスティメーターカードは Harness ホストチャネルで API キーを要求しなくなりました。ホストチャネルを選ぶと、ライブのプロバイダー/モデル ドロップダウンが表示され、実際に使われるルート（明示的な上書き、なければセッション既定モデル）を明示します。キー入力欄と 2 つ目の手入力モデル欄は表示されません — エンドポイント URL、モデルのテキスト欄、書き込み専用キーはダイレクト接続チャネルだけに属します。
-- `presetOptions` の書き込みが兄弟フィールドを保持するようになりました。`settingsScope.set('presetOptions', patch)` はセクション全体を置き換えるため、エスティメーターの 2 つ目のフィールド（プロバイダー、モデル、エンドポイント）に触れると `estimatorMode` と他のすべての上書きが削除され、パネルは保存成功と表示したままエスティメーターが静かにオフへ戻っていました。現在はパッチを保存済みセクションへマージし、`undefined` は指定したフィールドだけを消去し、変更なしのパッチは書き込まず、confirm-on-write はチャネル単独ではなく同じフィールド群を検証します。
-- 回帰カバレッジを追加：`packages/selector/tests/preset-options-write.client.spec.ts`（マージ書き込み、兄弟フィールドの保持、明示的な消去、変更なし時の無書き込み、未コミット書き込みの報告）と `packages/selector/tests/estimator-channel.client.spec.tsx`（チャネル別フィールド、カタログのドロップダウン、手入力フォールバック）。

package/CHANGELOG.ko.md

@@ -2,24 +2,26 @@
 
 > 전체 히스토리(업스트림 0.1.0 이전 포함)는 [CHANGELOG.md](CHANGELOG.md)를 참고하세요. 이 파일은 포크의 추가 항목만 번역한 것입니다. · [English](CHANGELOG.md) · [中文](CHANGELOG.zh.md) · [日本語](CHANGELOG.ja.md)
 
-## 0.1.1
-
-### 추가
-
-- `scripts/`의 TypeScript 도구 체인: `verify-release`, `packed-components-smoke`, `packed-install-e2e`가 `.ts` 소스가 되어 `tsc`로 `scripts-dist/`에 컴파일됩니다. 저장소의 마지막 3개 비-TS 소스 파일이 제거되었습니다.
-
-### 변경
-
-- `package.json` 스크립트 `test:e2e:packed`와 `verify:release`가 `scripts-dist/`의 컴파일 결과물을 실행합니다.
-- 추정기 카탈로그 라우트 등록이 강화됨: `asWebServer`가 서비스 자체를 반환하도록 수정(D7 수정), 추정기 UI가 비활성 시 섹션 제목을 유지하도록 수정(U1 수정).
-- 프레임워크 문서 정정: 행 수준 `inject: [webServer]`는 부담을 지지 않음(Y22); DSH 모든 패키지에 `isolate()` 없음.
+## Unreleased(미출시)
+### Changed(0.1.5 호환 / compat/0.1.5 브랜치)
+
+- runtime 패키지를 selector 패키지로 통합했습니다. 한 번의 설치로 전체 스택이 들어오고,
+  저장소 루트가 설치면이 됩니다(`name`, `main`, `types`, `./pruner`와 `./invariant`를 포함한
+  `exports`, `dependencies`, `dsh`). 툴체인, 스크립트, CI도 단일 패키지로 정리했습니다.
+  실기에서 검증한 estimator-catalog 라우트 등록(이중 접두사, 보호된 이중 채널 활성화, 요청별
+  서비스 해석, 관측 가능한 수명주기 로그)을 이 라인에 재적용하고 호스트 측 가드를 추가했습니다.
+  `ab2175a`에서 `z.any()`로 낮춰졌던 settings 스키마를 복원해 Custom 기본값이 다시 게시됩니다.
+- 이 브랜치에서 공식 DeepSeek Harness `v0.1.5-rc.2`에 적응. 모든 `@deepseek-ai/dsh-*` 개발 의존성과 e2e 공식 호스트 목록을 `0.1.1-rc.2`에서 `0.1.5-rc.2`로 업데이트(cordis `4.0.2`, schemastery `3.18.2`, 새 분할 패키지들과 `dsh-client-store` 클라이언트 스택 포함).
+- surface 치환은 v3의 `startSeq`/`endSeq` 형태와 브랜딩된 `SessionSeq` 사용. surface node의 이벤트 해석을 배열 인덱스에서 seq 조회로 변경.
+- 클라이언트 번들은 제거된 `@deepseek-ai/dsh-client-runtime`을 참조하지 않음. settings 타입은 `@deepseek-ai/dsh-client-ui-settings`, 세션 hooks는 `@deepseek-ai/dsh-client-ui-session`에서 가져옴. `engines.dsh >=0.1.5-alpha.1 <0.2.0-0` 선언.
+- Harness 0.1.5는 세션 `agentPreset`을 브라우저에 노출하지 않으므로 클라이언트에서 Minimal 세션을 감지할 수 없음. 셀렉터는 선택 가능한 상태 유지.
+- 테스트를 0.1.5 시맨틱에 맞춰 업데이트(`.await()`, `SessionProjectionRegistry`, `stream: []`, 문자열 settings 네임스페이스).
 
 ### 수정
 
-- 추정기 카탈로그 라우트는 `asWebServer`가 `register`를 서비스에서 분리한导致로 처음부터 한 번도 등록되지 않았음(D7).
-- 비-TokenPilot 프로필에서 추정기 섹션이 경고 없이 사라졌음(U1).
-
-## Unreleased(미출시)
+- 추정기 카드가 Harness 호스트 채널에서 더 이상 API 키를 요구하지 않습니다. 호스트 채널을 선택하면 라이브 프로바이더/모델 드롭다운이 표시되고 실제로 사용될 라우트(명시적 재정의, 없으면 세션 기본 모델)를 알려줍니다. 키 입력란과 두 번째 수동 모델 입력란은 렌더링되지 않습니다 — 엔드포인트 URL, 모델 텍스트 필드, 쓰기 전용 키는 직접 연결 채널에만 속합니다.
+- `presetOptions` 쓰기를 경로 지정 방식으로 변경했습니다. 기존에는 섹션 전체를 교체했기 때문에 추정기의 두 번째 필드(프로바이더, 모델, 엔드포인트)를 건드리면 `estimatorMode`와 다른 모든 재정의가 삭제되어, 패널은 저장 성공을 보고하는데도 추정기가 조용히 꺼졌습니다. 이제 각 필드는 자기 경로만 쓰고, `undefined`는 지목한 필드만 지우며, confirm-on-write는 채널 하나가 아니라 같은 필드 집합을 검증합니다.
+- 회귀 커버리지 추가: `packages/selector/tests/preset-options-write.client.spec.ts`(경로 단위 쓰기, 형제 필드 보존, 명시적 삭제, 변경 없음 시 무쓰기, 미커밋 쓰기 보고)와 `packages/selector/tests/estimator-channel.client.spec.tsx`(채널별 필드, 카탈로그 드롭다운, 수동 폴백).
 
 ### 추가
 
@@ -31,9 +33,3 @@
 
 - ESLint 플랫 설정 베이스라인(`pnpm lint`, CI에서도 강제)과 `pnpm test:watch` TDD 루프를 추가. 죽은 임포트를 정리하고, lint 베이스라인에서 드러난 두 오류 경로를 보강했습니다.
 - 이 저장소는 이제 `WilliamShi666/dsh-context-compression-selector`의 개선 포크로 관리됩니다. 문서는 영어·중국어(간체)·일본어·한국어로 제공됩니다.
-
-### 수정
-
-- 추정기 카드가 Harness 호스트 채널에서 더 이상 API 키를 요구하지 않습니다. 호스트 채널을 선택하면 라이브 프로바이더/모델 드롭다운이 표시되고 실제로 사용될 라우트(명시적 재정의, 없으면 세션 기본 모델)를 알려줍니다. 키 입력란과 두 번째 수동 모델 입력란은 렌더링되지 않습니다 — 엔드포인트 URL, 모델 텍스트 필드, 쓰기 전용 키는 직접 연결 채널에만 속합니다.
-- `presetOptions` 쓰기가 형제 필드를 보존합니다. `settingsScope.set('presetOptions', patch)`는 섹션 전체를 교체하므로 추정기의 두 번째 필드(프로바이더, 모델, 엔드포인트)를 건드리면 `estimatorMode`와 다른 모든 재정의가 삭제되어, 패널은 저장 성공을 보고하는데도 추정기가 조용히 꺼졌습니다. 이제 패치는 저장된 섹션 위에 병합되고, `undefined`는 지목한 필드만 지우며, 변경 없는 패치는 쓰지 않고, confirm-on-write는 채널 하나가 아니라 같은 필드 집합을 검증합니다.
-- 회귀 커버리지 추가: `packages/selector/tests/preset-options-write.client.spec.ts`(병합 쓰기, 형제 필드 보존, 명시적 삭제, 변경 없음 시 무쓰기, 미커밋 쓰기 보고)와 `packages/selector/tests/estimator-channel.client.spec.tsx`(채널별 필드, 카탈로그 드롭다운, 수동 폴백).

package/CHANGELOG.md

@@ -2,24 +2,29 @@
 
 All notable changes use this file. The project follows semantic versioning after `0.1.0`.
 
-## 0.1.1
-
-### Added
-
-- TypeScript toolchain for `scripts/`: `verify-release`, `packed-components-smoke`, and `packed-install-e2e` are now `.ts` sources compiled to `scripts-dist/` via `tsc`, eliminating the last three non-TS source files in the repository.
+## Unreleased (compat/0.1.5)
 
 ### Changed
 
-- `package.json` scripts `test:e2e:packed` and `verify:release` now run compiled outputs from `scripts-dist/`.
-- Estimator catalog route registration hardened: `asWebServer` returns the service itself (D7 fix), and the estimator UI preserves its section heading when inactive instead of hiding behind an invisible gate (U1 fix).
-- Framework documentation corrected: row-level `inject: [webServer]` is not load-bearing (Y22); `isolate()` does not exist in any DSH package.
+- The runtime package is merged into the selector package: one install brings the whole
+  stack, the repository root is the install surface (`name`, `main`, `types`, `exports` with
+  `./pruner` and `./invariant`, `dependencies`, `dsh`), and the toolchain, scripts and CI were
+  swept to the single package. The verified estimator-catalog registration (dual prefix, guarded
+  two-channel activation, per-request service resolution, visible lifecycle lines) was replayed
+  onto this line with a host-side guard; the settings schema that `ab2175a` had downgraded to
+  `z.any()` is restored, so the daily Custom defaults are published again.
+- Adapt to the official DeepSeek Harness `v0.1.5-rc.2` on this branch. All `@deepseek-ai/dsh-*` dev dependencies and the pinned e2e host set move from `0.1.1-rc.2` to `0.1.5-rc.2` (cordis `4.0.2`, schemastery `3.18.2`), including the new split packages (`dsh-session-projection`, `dsh-session-persistence`, `dsh-atomic-write`, `dsh-home-paths`, `dsh-sandbox`, and related) and the `dsh-client-store` client stack.
+- Surface replace operations now use the v3 `startSeq`/`endSeq` shape with branded `SessionSeq` values; `compaction/prune` manifests keep the durable `start`/`end` fields. Events are resolved from surface nodes by seq lookup instead of array indexing.
+- The client bundle no longer imports the removed `@deepseek-ai/dsh-client-runtime`: settings types now come from `@deepseek-ai/dsh-client-ui-settings` and the session hooks merge from `@deepseek-ai/dsh-client-ui-session`. `engines.dsh >=0.1.5-alpha.1 <0.2.0-0` is declared in both package manifests and `dsh.plugin.json`.
+- Harness 0.1.5 no longer exposes the session `agentPreset` to the browser, so the client can no longer detect Minimal-only sessions; the selector stays selectable and the old unavailable banner is unreachable.
+- Test batteries updated for 0.1.5 semantics: cordis plugin starts require `.await()`, the Token Meter requires a mounted `SessionProjectionRegistry`, assistant events carry `stream: []`, and settings namespaces are plain strings.
 
 ### Fixed
 
-- The estimator catalog route was never registered since day one because `asWebServer` detached `register` from its service (D7).
-- The estimator section silently disappeared when a non-TokenPilot profile was active, with no hint about why or how to enable it (U1).
+- The estimator card no longer demands an API key on the Harness host channel. Selecting the host channel shows the live provider/model dropdowns, names the route that would actually run (explicit override, else the session default), and renders neither a key field nor a second manual model input: the base URL, the model text field, and the write-only key belong to the direct endpoint channel alone.
+- `presetOptions` writes are path-addressed. Writing the whole section replaced it, so touching any second estimator field (a provider, a model, an endpoint) deleted `estimatorMode` and every sibling override — silently switching the estimator back off while the panel still reported a successful save. Each field now writes only itself, `undefined` clears exactly the field it names, and the confirmation read validates the same field set instead of the mode alone.
+- New coverage: `packages/selector/tests/preset-options-write.client.spec.ts` (path-scoped writes, sibling preservation, explicit clears, no-op patches, uncommitted-write reporting) and `packages/selector/tests/estimator-channel.client.spec.tsx` (per-channel fields, catalog dropdowns, manual fallback).
 
-## Unreleased
 
 ### Added
 
@@ -42,12 +47,6 @@ All notable changes use this file. The project follows semantic versioning after
 - Added an ESLint flat-config baseline (`pnpm lint`, enforced in CI) and a `pnpm test:watch` TDD loop; removed dead imports and hardened two error paths surfaced by the lint baseline.
 - This repository is now maintained as an improved fork of `WilliamShi666/dsh-context-compression-selector`; documentation ships in English, Simplified Chinese, Japanese, and Korean.
 
-### Fixed
-
-- The estimator card no longer demands an API key on the Harness host channel. Selecting the host channel shows the live provider/model dropdowns, names the route that would actually run (explicit override, else the session default), and renders neither a key field nor a second manual model input: the base URL, the model text field, and the write-only key belong to the direct endpoint channel alone.
-- `presetOptions` writes preserve their siblings. `settingsScope.set('presetOptions', patch)` replaces the whole section, so touching any second estimator field (a provider, a model, an endpoint) deleted `estimatorMode` and every other override — silently switching the estimator back off while the panel still reported a successful save. The patch is now merged over the stored section, `undefined` clears exactly the field it names, an unchanged patch writes nothing, and the confirmation read compares the same fields instead of the channel alone.
-- New coverage: `packages/selector/tests/preset-options-write.client.spec.ts` (merged writes, sibling preservation, explicit clears, no-op patches, uncommitted-write reporting) and `packages/selector/tests/estimator-channel.client.spec.tsx` (per-channel fields, catalog dropdowns, manual fallback).
-
 ## 0.1.0 - 2026-09-03
 
 ### Added

package/CHANGELOG.zh.md

@@ -2,24 +2,27 @@
 
 > 完整历史（含上游 0.1.0 及更早版本）见 [CHANGELOG.md](CHANGELOG.md)。本文件只翻译本 fork 的新增条目。 · [English](CHANGELOG.md) · [日本語](CHANGELOG.ja.md) · [한국어](CHANGELOG.ko.md)
 
-## 0.1.1
+## Unreleased（compat/0.1.5 分支）
 
-### 新增
-
-- `scripts/` 的 TypeScript 工具链：`verify-release`、`packed-components-smoke` 和 `packed-install-e2e` 现为 `.ts` 源文件，通过 `tsc` 编译至 `scripts-dist/`，消除仓库中最后三个非 TS 源文件。
+### Changed
 
-### 变更
-
-- `package.json` 脚本 `test:e2e:packed` 和 `verify:release` 现运行 `scripts-dist/` 中的编译产物。
-- 估计器目录路由注册加固：`asWebServer` 直接返回 service 本身（D7 修复），估计器 UI 在未激活时保留区块标题而非隐藏（U1 修复）。
-- 框架文档更正：行级 `inject: [webServer]` 非承载性（Y22）；DSH 中无 `isolate()` 实例。
+- runtime 包并入 selector 包：一次安装即可获得完整栈，仓库根目录即为安装面
+  （`name`、`main`、`types`、`exports`（含 `./pruner`、`./invariant`）、`dependencies`、`dsh`），
+  工具链、脚本与 CI 一并收敛为单包。已真机验证的 estimator-catalog 路由注册（双前缀、受保护的
+  双通道激活、按请求解析服务、可检索的生命周期日志）重放到本线，并新增宿主侧守门；`ab2175a`
+  降级为 `z.any()` 的 settings schema 已还原，每日 Custom 默认值重新下发。
+- 在本分支适配官方 DeepSeek Harness `v0.1.5-rc.2`。全部 `@deepseek-ai/dsh-*` 开发依赖与 e2e 官方宿主清单从 `0.1.1-rc.2` 升至 `0.1.5-rc.2`（cordis `4.0.2`、schemastery `3.18.2`），含新的拆分包（`dsh-session-projection`、`dsh-session-persistence`、`dsh-atomic-write`、`dsh-home-paths`、`dsh-sandbox` 等）与 `dsh-client-store` 客户端栈。
+- Surface 替换操作改用 v3 的 `startSeq`/`endSeq` 形状与品牌化 `SessionSeq`；`compaction/prune` 清单保留持久化的 `start`/`end` 字段。surface node 事件改为按 seq 查找而非数组下标。
+- 客户端 bundle 不再引用已移除的 `@deepseek-ai/dsh-client-runtime`：settings 类型改自 `@deepseek-ai/dsh-client-ui-settings`，会话 hooks 合并自 `@deepseek-ai/dsh-client-ui-session`。两份 package manifest 与 `dsh.plugin.json` 声明 `engines.dsh >=0.1.5-alpha.1 <0.2.0-0`。
+- Harness 0.1.5 不再向浏览器暴露会话 `agentPreset`，客户端无法再识别 Minimal 会话；选择器保持可选，旧的不可用横幅不再出现。
+- 测试套件按 0.1.5 语义更新：cordis 插件启动需要 `.await()`，Token Meter 需要预先挂载 `SessionProjectionRegistry`，assistant 事件携带 `stream: []`，settings 命名空间为普通字符串。
 
 ### 修复
 
-- 估计器目录路由自始至终从未注册，因 `asWebServer` 使 `register` 脱离 service（D7）。
-- 非 TokenPilot Profile 下估计器区块静默消失，无任何启用提示（U1）。
+- 估计器卡片在 Harness 宿主通道上不再要求 API Key。选择宿主通道后只显示实时供应商/模型下拉框，并标出当前真正生效的路由（显式覆盖优先，否则跟随会话默认模型）；既不显示密钥输入框，也不再有第二个手填模型输入——端点地址、模型文本框与只写密钥均只属于直连端点通道。
+- `presetOptions` 改为按路径写入。此前整段写入会替换整个分节，导致再改动估计器的任何一个字段（供应商、模型、端点）都会删掉 `estimatorMode` 及其余全部覆盖值——估计器被静默关回关闭状态，而面板却报告保存成功。现在每个字段只写自己，`undefined` 只清除指名的那一个字段，且 confirm-on-write 校验的是同一组字段而非仅校验通道。
+- 新增回归覆盖：`packages/selector/tests/preset-options-write.client.spec.ts`（按路径写入、保留同级字段、显式清除、空改动不写、未提交写入的报错）与 `packages/selector/tests/estimator-channel.client.spec.tsx`（各通道字段、目录下拉框、手填回退）。
 
-## Unreleased（未发布）
 
 ### 新增
 
@@ -31,9 +34,3 @@
 
 - 新增 ESLint 平铺配置基线（`pnpm lint`，CI 同步强制）与 `pnpm test:watch` TDD 环路；清理死导入，并修复 lint 基线暴露的两处错误处理路径。
 - 本仓库现为 `WilliamShi666/dsh-context-compression-selector` 的改进版 fork；文档提供英、简中、日、韩四种语言。
-
-### 修复
-
-- 估计器卡片在 Harness 宿主通道上不再要求 API Key。选择宿主通道后只显示实时供应商/模型下拉框，并标出当前真正生效的路由（显式覆盖优先，否则跟随会话默认模型）；既不显示密钥输入框，也不再有第二个手填模型输入——端点地址、模型文本框与只写密钥均只属于直连端点通道。
-- `presetOptions` 写入改为保留同级字段。`settingsScope.set('presetOptions', patch)` 会替换整个分节，导致再改动估计器的任何一个字段（供应商、模型、端点）都会删掉 `estimatorMode` 及其余全部覆盖值——估计器被静默关回关闭状态，而面板却报告保存成功。现在补丁会合并到已存分节之上，`undefined` 只清除指名的那一个字段，空改动不写盘，且 confirm-on-write 校验同一组字段而非仅校验通道。
-- 新增回归覆盖：`packages/selector/tests/preset-options-write.client.spec.ts`（合并写入、保留同级字段、显式清除、空改动不写、未提交写入的报错）与 `packages/selector/tests/estimator-channel.client.spec.tsx`（各通道字段、目录下拉框、手填回退）。

package/CONTRIBUTING.md

@@ -17,6 +17,6 @@ Thank you for helping improve this community plugin.
    ```
 
 5. Never commit API keys, `.env` files, real Session logs, prompts/tool results, user paths, generated tarballs, or NPM tokens.
-6. Read [`docs/repair-log.md`](docs/repair-log.md) before starting a new branch or version. It is the cross-version ledger of install/boot defects; a class recorded there must be re-checked on every new line instead of being rediscovered. Note in particular that `lib/` is committed, so a built chunk an entry imports must be committed in the same change — `pnpm verify:release` enforces it.
+6. Read [`docs/repair-log.md`](docs/repair-log.md) before starting a new branch or version. It is the cross-version ledger of install/boot defects; a class recorded there must be re-checked on every new line instead of being rediscovered. Note in particular that `lib/` is committed, so a built chunk an entry imports must be committed in the same change — `pnpm verify:release` enforces it — and that the tokenizer assets are content-addressed, so a checkout that rewrites their line endings breaks every consumer (the release gate now fails on CR bytes).
 
 Pull requests should explain the evidence for “triggered”, “enabled but skipped”, and fail-open behavior separately. A code path existing is not runtime proof. Changes to tokenizer/model compatibility require an official source, pinned revision, license, byte length, SHA-256, and negative tests.

package/README.ja.md

@@ -39,29 +39,11 @@
 - **セッション凍結**：他のセレクター設定と同様、変更は新しく観測されたセッションにのみ適用されます。
 - **厳格なパース**：`codeSkeleton` は正確に `{ enabled: boolean }` である必要があります。不正な値はランタイム側でスローされ、ブラウザー UI 側では読み取り不能として表示されます。
 
-### 出典、そしてこの数値は誰のものか
-
-スケルトン化のアプローチは **[Headroom](https://github.com/headroomlabs-ai/headroom)**
-（Apache-2.0）から借用しています。AI エージェント向けのコンテキスト圧縮レイヤーで、JSON・
-ソースコード・散文をそれぞれ別の圧縮器に振り分け（JSON は `SmartCrusher`、コードは
-`CodeCompressor`）、スケルトン変換は
-`crates/headroom-core/src/transforms/live_zone.rs` と `smart_crusher/planning.rs` にあります。
-
-**削減率は Headroom のものであり、本プラグインのものではありません。** Headroom が公開している
-公式な表現は次のとおりです。
-
-> 20% fewer tokens for coding agents, **60–95% fewer tokens for JSON**, same answers.
-
-**最大 95% 削減**という数字はこの一文によるもので、口径は JSON ペイロード、Headroom 自身の
-圧縮器が Headroom 自身のベンチマークで測定した値です。本ゲートの機構はここに同源があります。
-本リポジトリは**独自のベンチマークを一切持たない**ため、**独自の削減率を主張しません**。
-数値が必要な場合は出典で確認してください。
-
 ## 設定 UI
 
 同じ設定セクションで、圧縮プロファイルの選択、Auto Compact トリガーレベルの調整、コードスケルトン圧縮のトグルが行えます。トグルは変更時に即保存され、再読み込み時には保存済みの状態が表示されます。
 
-![Context Compression Selector 設定 UI](packages/selector/assets/screenshots/context-compression-selector-settings.png)
+![Context Compression Selector 設定 UI](docs/assets/context-compression-selector-settings.png)
 
 ## インストール
 
@@ -100,5 +82,4 @@ pnpm verify:release
 
 - アップストリームのプロジェクトと既存のすべての成果：[WilliamShi666/dsh-context-compression-selector](https://github.com/WilliamShi666/dsh-context-compression-selector)（作者 WilliamShi666、MIT）。
 - フォークによる追加（コードスケルトンゲート、ツールチェーン、多言語ドキュメント）：drscrewdriver。
-- コードスケルトン機構の出典：[Headroom](https://github.com/headroomlabs-ai/headroom)（Apache-2.0）——上記「出典、そしてこの数値は誰のものか」を参照。
 - MIT——[LICENSE](LICENSE)（アップストリームの著作権表示を保持）を参照。同梱トークナイザーの出所は [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。

package/README.ko.md

@@ -1,22 +1,22 @@
 # dsh-context-compression-improved
 
-> [dsh-context-compression-selector](https://github.com/WilliamShi666/dsh-context-compression-selector)의 개선 포크——DeepSeek Harness용 감사 가능한 도구 결과 컨텍스트 압축 셀렉터에, 직교하는 **코드 스켈레톤 압축 게이트**를 추가했습니다.
+> [dsh-context-compression-selector](https://github.com/WilliamShi666/dsh-context-compression-selector)의 개선 포크——DeepSeek Harness용 감사 가능한 도구 결과 컨텍스트 압축 셀렉터에, 직교하는 **코드 스켈레톤 압축 게이트*를추가했습니다.
 
 [English](README.md) · [中文说明](README.zh.md) · [日本語](README.ja.md) · [변경 로그](CHANGELOG.ko.md) · [설치 가이드](docs/installation.ko.md)
 
 > [!NOTE]
-> **이 포크가 업스트림 0.1.0에 추가한 것:**
+> **이 포크가 업스트림 0.1.0에 추가한것**
 >
-> - 직교하는 **코드 스켈레톤 압축 게이트**(`codeSkeleton.enabled`, 기본값 off): 매우 큰 소스코드 도구 결과가 처음 노출될 때, 일반 리듀서로 넘어가기 전에 임포트와 선언부의 스켈레톤을 보존할 수 있습니다(함수 본문은 생략, 에러 라인은 유지).
+> - 직교하는 **코드 스켈레톤 압축 게이트**(`codeSkeleton.enabled`, 기본값 off): 매우 큰 소스코드 도구 결과가 처음 노출될때 일반 리듀서로 넘어가기 전에 임포트와 선언부의 스켈레톤을 보존할수있습니다(함수 본문은 생략, 에러 라인은 유지).
 > - 동일한 셀렉터 설정 섹션에 모든 압축 프로파일과 독립적인 이 게이트의 토글을 추가.
 > - CI에 통합된 ESLint 베이스라인, `test:watch` TDD 루프, 영어/중국어(간체)/일본어/한국어 문서.
 
 > [!IMPORTANT]
-> 이 프로젝트는 **DeepSeek 모델만** 지원합니다. 손실 없는 측정과 손실 압축은 번들된 DeepSeek 공식 토크나이저(`deepseek-v4-flash`, `deepseek-v4-pro`, `deepseek-v4-flash-vision-exp`)에 의존합니다. 그 외의 경우 fail-open으로 동작하며 원본 도구 결과를 유지합니다. 전체 안전 모델은 [업스트림 README](https://github.com/WilliamShi666/dsh-context-compression-selector#model-support-and-safety)를 참고하세요.
+> 이 프로젝트는 **DeepSeek 모델만** 지원합니다. 손실 없는 측정과 손실 압축은 번들된 DeepSeek 공식 토크나이저(`deepseek-v4-flash`, `deepseek-v4-pro`, `deepseek-v4-flash-vision-exp`)에 의존합니다. 그외의 경우 fail-open으로 동작하며 원본 도구 결과를 유지합니다. 전체 안전 모델은 [업스트림 README](https://github.com/WilliamShi666/dsh-context-compression-selector#model-support-and-safety)를 참고하세요.
 
 ## 이것은 무엇인가
 
-장시간 실행되는 에이전트 작업은 대량의 도구 출력을 축적합니다. 이 커뮤니티 플러그인은 DeepSeek Harness 코어를 수정하지 않고, 선택 가능하고 감사 가능한 도구 결과 컨텍스트 압축 정책을 제공합니다:
+장시간 실행되는 에이전트 작업은 대량의 도구 출력을 축적합니다. 이커뮤니티 플러그인은 DeepSeek Harness 코어를 수정하지 않고, 선택 가능하고 감사 가능한 도구 결과 컨텍스트 압축 정책을 제공합니다:
 
 - **Fresh**: 모델이 받기 전에 새로 커진 도구 결과 세그먼트를 사전 압축합니다.
 - **Aggregate**: Fresh 압축 후에도 예산을 초과하면 다시 압축합니다.
@@ -29,42 +29,25 @@
 
 ## 코드 스켈레톤 게이트(신규)
 
-게이트를 활성화하면 매우 큰 **소스코드 도구 결과**(예: 큰 `read_file`)에 대해 먼저 스켈레톤 축소를 시도합니다: 임포트와 타입/함수/클래스 선언을 유지하고, 함수 본문은 마커와 함께 생략하며, 생략된 본문 안의 에러 라인은 보존합니다. 스켈레톤을 생성하거나 검증할 수 없으면 원래의 head 트리밍으로 폴백합니다——이 게이트가 컨텍스트를 악화시킬 수는 없습니다.
+게이트를 활성화하면 매우 큰 **소스코드 도구 결과**(예: 큰`read_file`)에 대해 먼저 스켈레톤 축소를 시도합니다: 임포트와 타입/함수/클래스 선언을 유지하고, 함수 본문은 마커와 함께 생략하며, 생략된 본문 안의 에러 라인은 보존합니다. 스켈레톤을 생성하거나 검증할 수 없으면 원래의 head 트리밍으로 폴백합니다——이 게이트가 컨텍스트를 악화시킬 수는 없습니다.
 
 특성:
 
-- **직교**: 선택된 프로파일(`balanced`, `savings`, `cache-strict`, `adaptive`, `custom`, `off`, `native`)과 독립적입니다. 모든 프로파일이 이 게이트를 받습니다.
+- **직교**: 선택된 프로파일(`balanced`, `savings`, `cache-strict`, `adaptive`, `custom`, `off`, `native`)과 독립적입니다. 모든 프로파일이이게이트를 받습니다.
 - **기본값 off**: `codeSkeleton: { enabled: false }`이며, 직접 켜기 전까지는 동작하지 않습니다.
-- **측정이 선행**: 정확한 DeepSeek 토크나이저가 필요하며, 사용할 수 없으면 fail-open합니다.
+- **측정이 선행**: 정확한 DeepSeek 토크나이저가 필요하며, 사용할수없으면 fail-open합니다.
 - **세션 고정**: 다른 셀렉터 설정과 마찬가지로 변경 사항은 새로 관찰된 세션에만 적용됩니다.
 - **엄격한 파싱**: `codeSkeleton`은 정확히 `{ enabled: boolean }`이어야 합니다. 잘못된 값은 런타임 쪽에서 예외를 던지고, 브라우저 UI에서는 읽을 수 없음으로 표시됩니다.
 
-### 출처, 그리고 이 수치는 누구의 것인가
-
-스켈레톤화 접근은 **[Headroom](https://github.com/headroomlabs-ai/headroom)**(Apache-2.0)에서
-차용했습니다. AI 에이전트용 컨텍스트 압축 계층으로, JSON·소스 코드·산문을 각각 다른 압축기로
-분기하며(JSON은 `SmartCrusher`, 코드는 `CodeCompressor`), 스켈레톤 변환은
-`crates/headroom-core/src/transforms/live_zone.rs`와 `smart_crusher/planning.rs`에 있습니다.
-
-**감축 수치는 Headroom의 것이며 이 플러그인의 것이 아닙니다.** Headroom이 공개한 공식 표현은
-다음과 같습니다.
-
-> 20% fewer tokens for coding agents, **60–95% fewer tokens for JSON**, same answers.
-
-**최대 95% 감축**이라는 수치는 이 문장에서 나온 것이며, 기준은 JSON 페이로드이고 Headroom 자체
-압축기가 Headroom 자체 벤치마크에서 측정한 값입니다. 이 게이트의 메커니즘은 여기에 동원(同源)을
-둡니다. 이 저장소는 **자체 벤치마크가 전혀 없으므로 자체 감축률을 주장하지 않습니다.** 수치가
-필요하면 출처에서 확인하십시오.
-
 ## 설정 UI
 
-동일한 설정 섹션에서 압축 프로파일 선택, Auto Compact 트리거 레벨 조정, 코드 스켈레톤 압축 토글을 모두 처리할 수 있습니다. 토글은 변경 시 즉시 저장되며, 다시 불러올 때 저장된 상태가 표시됩니다.
+동일한 설정 섹션에서 압축 프로파일 선택, Auto Compact 트리거 레벨 조정, 코드 스켈레톤 압축 토글을 모두 처리할수있습니다. 토글은 변경시즉시 저장되며, 다시 불러올때저장된 상태가 표시됩니다.
 
-![Context Compression Selector 설정 UI](packages/selector/assets/screenshots/context-compression-selector-settings.png)
+![Context Compression Selector 설정 UI](docs/assets/context-compression-selector-settings.png)
 
 ## 설치
 
-소스에서 빌드하여 설치합니다(이 포크는 아직 npm에 게시되지 않았습니다. 내부 패키지 이름은 의도적으로 업스트림과 동일하게 유지됩니다):
+소스에서 빌드하여 설치합니다이포크는 아직 npm에 게시되지 않았습니다. 내부 패키지 이름은 의도적으로 업스트림과 동일하게 유지됩니다):
 
 ```sh
 git clone https://github.com/drscrewdriver/dsh-context-compression-improved.git
@@ -98,6 +81,5 @@ pnpm verify:release
 ## 크레딧과 라이선스
 
 - 업스트림 프로젝트와 기존의 모든 작업: [WilliamShi666/dsh-context-compression-selector](https://github.com/WilliamShi666/dsh-context-compression-selector), 작성자 WilliamShi666(MIT).
-- 포크에서 추가된 것(코드 스켈레톤 게이트, 툴체인, 다국어 문서): drscrewdriver.
-- 코드 스켈레톤 메커니즘 출처: [Headroom](https://github.com/headroomlabs-ai/headroom) (Apache-2.0) — 위의 "출처, 그리고 이 수치는 누구의 것인가"를 참조하십시오.
+- 포크에서 추가된것코드 스켈레톤 게이트, 툴체인, 다국어 문서): drscrewdriver.
 - MIT——[LICENSE](LICENSE)(업스트림 저작권 표기 유지) 참고. 번들된 토크나이저의 출처는 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).

package/README.md

@@ -39,28 +39,11 @@ Properties:
 - **Session-frozen**: like all selector settings, changes affect newly observed sessions only.
 - **Strictly parsed**: `codeSkeleton` must be exactly `{ enabled: boolean }`; malformed values throw on the runtime side and show as unreadable in the browser UI.
 
-### Provenance, and whose numbers these are
-
-The skeletonization approach is borrowed from **[Headroom](https://github.com/headroomlabs-ai/headroom)**
-(Apache-2.0) — a context-compression layer for AI agents that routes JSON, source code and prose
-through separate compressors (`SmartCrusher` for JSON, `CodeCompressor` for code), with its
-skeleton transform living in `crates/headroom-core/src/transforms/live_zone.rs` and
-`smart_crusher/planning.rs`.
-
-**The reduction figures are Headroom's, not this plugin's.** Headroom's published claim, verbatim:
-
-> 20% fewer tokens for coding agents, **60–95% fewer tokens for JSON**, same answers.
-
-The headline — **up to 95% fewer tokens** — comes from that sentence: JSON payloads, measured by
-Headroom's own compressors on Headroom's own benchmarks. That is the same source this gate draws
-its mechanism from. This repository ships **no benchmark of its own**, so it claims **no reduction
-percentage of its own**; read the measurements at the source.
-
 ## Settings UI
 
 Choose a compression profile, set the Auto Compact trigger level, and toggle code-skeleton compression in the same settings section. The toggle saves on change and shows the saved state on reload.
 
-![Context Compression Selector settings UI](packages/selector/assets/screenshots/context-compression-selector-settings.png)
+![Context Compression Selector settings UI](docs/assets/context-compression-selector-settings.png)
 
 ## Install
 
@@ -99,5 +82,4 @@ Contributions follow the upstream discipline: add the failing regression first,
 
 - Upstream project and all prior work: [WilliamShi666/dsh-context-compression-selector](https://github.com/WilliamShi666/dsh-context-compression-selector) by WilliamShi666 (MIT).
 - Fork additions (code-skeleton gate, tooling, localized docs): drscrewdriver.
-- Code-skeleton mechanism: [Headroom](https://github.com/headroomlabs-ai/headroom) (Apache-2.0) — see "Provenance, and whose numbers these are" above.
 - MIT — see [LICENSE](LICENSE) (upstream copyright notice retained) and [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md) for bundled tokenizer provenance.

package/README.zh.md

@@ -1,15 +1,15 @@
 # dsh-context-compression-improved
 
-> [dsh-context-compression-selector](https://github.com/WilliamShi666/dsh-context-compression-selector) 的改进版 fork——面向 DeepSeek Harness 的可审计工具结果上下文压缩选择器，新增正交的**代码骨架压缩门**。
+> [dsh-context-compression-selector](https://github.com/WilliamShi666/dsh-context-compression-selector) 的改进版 fork——面向 DeepSeek Harness 的可审计工具结果上下文压缩选择器，新增正交的**代码骨架压缩门*。
 
 [English](README.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [更新日志](CHANGELOG.zh.md) · [安装教程](docs/installation.zh.md)
 
 > [!NOTE]
-> **本 fork 在上游 0.1.0 之上新增：**
+> **本fork 在上游 0.1.0 之上新增：*
 >
 > - 正交的**代码骨架压缩门**（`codeSkeleton.enabled`，默认关闭）：超大源码类工具结果首次曝光时，可先保留导入与声明的骨架——省略函数体并保留错误行——再进入常规 reducer。
 > - 同一选择器设置区内新增该门的开关，独立于所有压缩 Profile。
-> - 接入 CI 的 ESLint 基线、`test:watch` TDD 环路，以及英/中/日/韩四语文档。
+> - 接入 CI 的 ESLint 基线、`test:watch` TDD 环路，以及英/中日韩四语文档。
 
 > [!IMPORTANT]
 > 本项目仅支持 **DeepSeek 模型**。无损测量与有损压缩依赖内置的 DeepSeek 官方 tokenizer（`deepseek-v4-flash`、`deepseek-v4-pro`、`deepseek-v4-flash-vision-exp`）。其余模型一律 fail-open 并保留原始工具结果。完整安全模型见[上游 README](https://github.com/WilliamShi666/dsh-context-compression-selector#model-support-and-safety)。
@@ -22,7 +22,7 @@
 - **Aggregate**：当 Fresh 压缩后仍超出预算时再次预压缩。
 - **History / micro-compact**：在保护近期工作上下文的前提下替换符合条件的旧工具结果。
 - **TailTrim**：仅在 Custom 下可选的尾窗收缩路径。
-- **Native**：把 Harness 原生头/中/尾裁剪保留为一个显式 Profile。
+- **Native**：把 Harness 原生头中尾裁剪保留为一个显式 Profile。
 - **代码骨架（新增，正交门）**——见下节。
 
 每个决策都会留痕：阶段、reducer、触发原因、跳过原因，以及可得时的精确 token 数。
@@ -39,26 +39,11 @@
 - **会话冻结**：与所有选择器设置一致，修改只影响新观察的会话。
 - **严格解析**：`codeSkeleton` 必须恰好是 `{ enabled: boolean }`；畸形输入在运行时侧抛错、浏览器侧显示不可读。
 
-### 出处，以及这些数字是谁的
-
-骨架化思路借鉴自 **[Headroom](https://github.com/headroomlabs-ai/headroom)**（Apache-2.0）——
-一个面向 AI Agent 的上下文压缩层，把 JSON、源码与散文分别交给不同压缩器（JSON 走
-`SmartCrusher`，代码走 `CodeCompressor`），其骨架化变换位于
-`crates/headroom-core/src/transforms/live_zone.rs` 与 `smart_crusher/planning.rs`。
-
-**降幅数字是 Headroom 的，不是本插件的。** Headroom 公开的官方口径原文如下：
-
-> 20% fewer tokens for coding agents, **60–95% fewer tokens for JSON**, same answers.
-
-其中 **最高降 95%** 即出自这一句：口径为 JSON 载荷，由 Headroom 自家压缩器在其自家基准上测得，
-也正是本门机制的同源出处。本仓库**不含任何自己的 benchmark**，因此**不自称任何降幅百分比**；
-要数字，请到源头读。
-
 ## 设置界面
 
 在同一设置区内选择压缩 Profile、调整 Auto Compact 触发水位，并开关代码骨架压缩。开关即改即存，刷新后显示已保存状态。
 
-![Context Compression Selector 设置界面](packages/selector/assets/screenshots/context-compression-selector-settings.png)
+![Context Compression Selector 设置界面](docs/assets/context-compression-selector-settings.png)
 
 ## 安装
 
@@ -97,5 +82,4 @@ pnpm verify:release
 
 - 上游项目与全部既有工作：[WilliamShi666/dsh-context-compression-selector](https://github.com/WilliamShi666/dsh-context-compression-selector)，作者 WilliamShi666（MIT）。
 - fork 新增内容（代码骨架门、工具链、多语文档）：drscrewdriver。
-- 代码骨架机制来源：[Headroom](https://github.com/headroomlabs-ai/headroom)（Apache-2.0）——见上文「出处，以及这些数字是谁的」。
 - MIT——见 [LICENSE](LICENSE)（保留上游版权声明）；内置 tokenizer 来源见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。

package/THIRD_PARTY_NOTICES.md

@@ -4,8 +4,8 @@ This community project contains code adapted from the MIT-licensed [DeepSeek Har
 
 The runtime package distributes tokenizer assets from these pinned official repositories, both under the MIT license:
 
-- [deepseek-ai/DeepSeek-V4-Pro](https://huggingface.co/deepseek-ai/DeepSeek-V4-Pro) at revision `0e1a0e5e52aea73055f50fef6f2423db370265b6`, recorded in `packages/runtime/assets/deepseek-v4/manifest.json`.
-- [deepseek-ai/DeepSeek-V4-Flash-Vision-Exp](https://huggingface.co/deepseek-ai/DeepSeek-V4-Flash-Vision-Exp) at revision `6821d6ad3681a4b137b066b76094fa82ebd0a380`, recorded in `packages/runtime/assets/deepseek-v4-vision-exp/manifest.json`. The vision model is served by this distinct tokenizer, never as an alias of the text tokenizer.
+- [deepseek-ai/DeepSeek-V4-Pro](https://huggingface.co/deepseek-ai/DeepSeek-V4-Pro) at revision `0e1a0e5e52aea73055f50fef6f2423db370265b6`, recorded in `packages/selector/assets/deepseek-v4/manifest.json`.
+- [deepseek-ai/DeepSeek-V4-Flash-Vision-Exp](https://huggingface.co/deepseek-ai/DeepSeek-V4-Flash-Vision-Exp) at revision `6821d6ad3681a4b137b066b76094fa82ebd0a380`, recorded in `packages/selector/assets/deepseek-v4-vision-exp/manifest.json`. The vision model is served by this distinct tokenizer, never as an alias of the text tokenizer.
 
 Exact file sizes and SHA-256 values are recorded in each directory's `manifest.json`; the upstream license text ships beside the assets.
 

package/docs/compat-0.1.5-report.md

@@ -0,0 +1,77 @@
+# dsh-context-compression-improved · DSH v0.1.5-rc.2 适配报告
+
+> 分支：`compat/0.1.5`（基于 `feat/ctx-preset-v2`，2026-09-14 完成）
+> 提交：`b5428cf`（依赖与代码适配）→ `4c11289`（测试与 CHANGELOG）→ `93e47c2`（e2e release-gate 适配）
+> 参照：`dsh-docs-deliverables/plugin-framework`（v0.1.5-migration / compatibility-guide §二十 / upgrade-pitfalls §七 / distribution-strategy §1.1）
+
+## 一、结论
+
+compaction 深度插件（直接依赖 tokenMeter / session surface 写路径）从 0.1.1-rc.2 适配到 0.1.5-rc.2 完成。typecheck 0 错误、lint 0、unit 338/341（2 个 Windows 环境抖动）、built ✅、verify:release ✅、packed-e2e dev 模式全绿（release 模式需发布 npm 前版后执行）。
+
+迁移指南逐章核对结果：Inbox / Permission Presets / Sidebar Slot / LLM Adapter 四个高危变更本插件均不涉及；实际工作量集中在 **客户端包重构、Session V3 surface 语义、cordis 启动语义、semver peer 规则** 四块——其中后两类是迁移指南未覆盖的实测新坑，已回填 framework 文档（pitfalls §7、compatibility-guide §二十）。
+
+## 二、适配清单
+
+### 2.1 依赖与清单
+- 全部 `@deepseek-ai/dsh-*` devDependencies `0.1.1-rc.2` → `0.1.5-rc.2`（cordis `4.0.2`、schemastery `3.18.2`）。
+- 新增 0.1.5 拆分包 devDeps（session-projection、session-persistence、atomic-write、home-paths、sandbox、user-approval、llm-retry 等 13 个），pnpm overrides 钉版本（注意 pnpm 11 的 overrides 要写在 `pnpm-workspace.yaml`，package.json 的 `pnpm` 字段无效）。
+- peer 范围 `>=0.1.1-rc.2 <0.2.0` → `>=0.1.5-rc.2 <0.2.0-0`。**根因**：strict semver 下 `0.1.5-rc.2` 不满足旧范围（预发布只匹配同元组），与官方包 `^0.1.5-rc.2` 求交为空导致 consumer 安装失败。
+- `engines.dsh >=0.1.5-alpha.1 <0.2.0-0` 写入两份 package.json 与 `dsh.plugin.json`。
+- CI workflow：Node 22 → 24，旧 fork 包名更正。
+
+### 2.2 客户端（selector）
+- `dsh-client-runtime`（已删除）→ `dsh-client-store`；inject/peer/import 三处迁移。
+- 类型换位：`ClientContext` = cordis `Context`；`SettingsScope` 来自 `dsh-client-ui-settings/client`；`useSessions` 由 `dsh-client-ui-session` 模块扩充合并（type-only 引入 + inject 声明）。
+- `ctx.slots` 无公开类型包，按官方模板自声明 `SlotsService`（`Pick<SlotCore,'register'>` + 手写 `inject`）。
+- 行为降级：0.1.5 浏览器摘要不再带 `agentPreset`，Minimal 门控失效——选择器保持可选，横幅不可达，CHANGELOG 四语言记录。
+
+### 2.3 运行时（runtime）
+- surface 替换 → `{ op: 'replace', startSeq, endSeq }` + `SessionSeq()` 品牌化；`compaction/prune` 数据字段名不变（`start/end`）——两处不对称。
+- surface node → 事件由数组下标 `events[node.seq]` 改为按 seq 查找（新增 `eventBySeq` 帮助函数，measurement + index 四处调用点）。
+- `CallId` → `ToolCallId`；`session.events` → `snapshotEvents()`（保留 rc.2 双路径层，仅限本分支）。
+- **Native auto-compact 审计**：0.1.5 通过会话 seed-reopen 落盘，seed 不进 firehose → 新增快照扫描（`pruneSession` 入口 + pre-step `next()` 之后），按 manifest seq 去重补发 `native-auto-compact` 审计。这是本次唯一的行为级适配。
+
+### 2.4 测试与 e2e 基建
+- 所有插件挂载 `.await()`；SessionProjectionRegistry 先于 TokenMeter（`mountAgentLoopTestDependencies` 已内置，勿重复）。
+- assistant/message 事件补 `stream: []`；断言改 `startSeq/endSeq`、`firstLiveSeq`（数值 0 = 无 seed）。
+- e2e：官方宿主清单从根 devDeps 动态生成（覆盖 0.1.5 peer 闭包）；consumer 写独立 `pnpm-workspace.yaml` 阻断祖先工作区吸收；`spawn` Windows 兼容；`settingsNamespace()` → 字符串。
+- `.gitattributes` 标记 tokenizer 资产 `-text`（autocrlf 曾静默损坏 SHA-256 字节校验）。
+
+## 三、验证结果
+
+| 门禁 | 结果 |
+|---|---|
+| `pnpm typecheck` / `pnpm lint` | ✅ 0 错误 |
+| `pnpm test:unit` | 338/341；2 个失败为 standing-stamp 窗口测试的 Windows mtime 抖动（基线同期同样失败，Linux CI 稳定） |
+| `pnpm test:built` | ✅ |
+| `pnpm verify:release` | ✅ OK |
+| `pnpm test:e2e:packed`（dev） | ✅ EXIT=0；upgrade leg 与 official-clone leg 因 npm 前版未发布 / clone 不可达按设计跳过并输出标记 |
+
+### 三补、本机 0.1.5 静态装载核查（2026-09-17，实测）
+
+真机 0.1.5 宿主装载在本机**不可达**（本机宿主为 0.1.2-rc.1），故改为在源码层面取证：
+
+| 检查项 | 结果 | 证据 |
+|---|---|---|
+| 提交的 `lib/**` 非陈旧 | ✅ | `pnpm run build` 后 `git status --porcelain` 为空；两次独立 `npm pack` 的 shasum 相同（`424bd137…`）→ 构建可复现 |
+| `lib/*.js` 的依赖面 vs 0.1.5 提供的包 | ✅ 零缺失 | 实拉 0.1.5-rc.2 tarball 解包，从 `super(ctx,"…")` 提取服务名；插件注入/读取的 `settings`/`tokenMeter`/`invariants`/`sessions`/`tools`/`systemPrompt`/`llm`/`agentPresets`/`agents`/`webServer`/`settingsScope` 全部存在 |
+| `dsh-client-runtime` 是否残留 | ✅ 0 次 | registry 上该包最新版止于 `0.1.1-rc.2`，0.1.5 确已移除 |
+| `cordis.patch.yml` / `dsh.plugin.json` 引用的服务 | ✅ | `inject: [webServer]` 独立成行，`webServer` 缺席时只丢 HTTP 路由、压缩栈照常装载（刻意降级） |
+| 全部 peer 区间在 registry 可解析 | ✅ | 19 个 `@deepseek-ai/dsh-*` 均解析到 `0.1.5-rc.2` |
+| `pnpm test:built` | ✅ | `vitest.built.config.ts` 真正 `Function(code)()` 执行 `lib/client.js` |
+| **真机 0.1.5 宿主装载** | **未验证** | 本机无 0.1.5 宿主 |
+
+`pnpm test` 连跑 4 次：1 次全绿、3 次失败，**失败 100% 集中在 `standing-generation.host.spec.ts`**（`:333` 整秒 mtime 竞态、`:580`/`:595` 5s 超时、`EPERM rename`）——Windows 环境性竞态，非 0.1.5 适配引入。
+
+## 四、已知问题与后续项
+
+1. **release 模式 e2e**：official clone tag 与三连断言已改钉 `dsh-v0.1.5-rc.2`（commit `fb2c4b9e`、tree `bd7dd6d9`），客户端 peer 清单里的 `dsh-client-runtime` 已换成 `dsh-client-store`——此前这条腿**从未真正跑过**：它拿 `dsh-v0.1.1-rc.2` 宿主去验证一条声明只兼容 `>=0.1.5-rc.2` 的插件线，且 `proveBuiltClientPeersLoad()` 无条件解析已被移除的 `dsh-client-runtime`，必然抛错。仍需先发布一个前版（或调整脚本的前版基线）才能跑完 release 模式。
+2. **stamp 窗口测试抖动**：Windows mtime 精度所致，可考虑在测试内跳过 win32 或提高窗口粒度。
+3. **Minimal 门控降级**：待官方恢复浏览器侧 preset 暴露后恢复。
+4. 0.1.1-rc.2 兼容 shim（session-events 双路径）仅保留在本分支，合主线时按主线支持的宿主范围决定去留。
+
+## 五、经验回填
+
+- `plugin-framework/upgrade-pitfalls.md` §七（7.1 cordis `.await()` 启动语义；7.2 firehose/seed-reopen；7.3 semver 预发布 peer 规则；7.4 autocrlf 资产损坏；7.5 workspace 向上吸收；7.6 Windows 环境差异；7.7 API 变更速查）
+- `plugin-framework/compatibility-guide.md` §十二（客户端包迁移、类型换位、`ctx.slots` 自声明、`agentPreset` 降级、运行时 API 变更表、e2e 基建要点）
+- `plugin-framework/distribution-strategy.md` §1.1/§1.2/§2.2（0.1.5 拆分闭包、本插件实证行、`-0` 上界规范）