dsh-manage-session 0.1.0-alpha.0 → 0.2.3

package/INSTALL.zh.md

@@ -44,7 +44,7 @@ dsh plugin --profile <profile> add dsh-manage-session -w
 显式安装指定版本：
 
 ```bash
-dsh plugin --profile <profile> add dsh-manage-session@0.1.0-alpha.0 -w
+dsh plugin --profile <profile> add dsh-manage-session@0.1.0-alpha.6 -w
 ```
 
 官方 CLI 会自动更新 profile 依赖、锁文件与 `dsh.profile.bundles`。不要手工添加 YAML 行。
@@ -55,7 +55,7 @@ DSH 运行时使用 pnpm 11，其 `minimumReleaseAge` 策略可能拦截刚发
 
 ```yaml
 minimumReleaseAgeExclude:
-  - dsh-manage-session@0.1.0-alpha.0
+  - dsh-manage-session@0.1.0-alpha.6
 ```
 
 ## 2. 重启宿主
@@ -128,8 +128,8 @@ dsh --profile <profile> --dump-default-config
 
 重启后，侧边栏入口 `dsh-manage-session` 可用，设置区使用 `session-steward` 命名空间。请确认：
 
-1. 两个开关均开启时，**病案室**与**体检**两个页签都会渲染。
-2. 关闭 `historyFiles` 后「病案室」页签消失，且所有 `session-history-*` 调用返回显式的 disabled 错误。
+1. 两个开关均开启时，**养老院**与**体检**两个页签都会渲染。
+2. 关闭 `historyFiles` 后「养老院」页签消失，且所有 `session-history-*` 调用返回显式的 disabled 错误。
 3. 关闭 `healthCheck` 后「体检」页签消失，且所有 `session-health-*` 调用返回显式的 disabled 错误。
 4. 对 `/session-steward/api` 调用未识别的方法时返回显式错误，而不是静默成功。
 

package/README.en.md

@@ -1,63 +1,63 @@
-# dsh-manage-session (Session Steward)
-
-A DSH web plugin for **session history files** and **session health checks**. It never touches session data itself.
-
-- **Records Room (history files)** — browse the official archive set and prune ids in bulk
-  (backup + atomic replace; a DSH restart is required for the host to reload it).
-- **Checkup (health)** — four gates → prescription (command list) → discharge (reversible repair with a
-  before/after comparison).
-
-> Naming boundary: **this package ships no search or index features**. Search/indexing belongs to
-> `dsh-search-index`; neither side mentions or re-interprets the other's fields.
-
-## Install
-
-```bash
-dsh plugin --profile web add dsh-manage-session
-```
-
-Restart the host process afterwards (refreshing the page is not enough).
-
-## Routes
-
-Prefix `/session-steward/api`; every method name is `session-*` (never `index-*`), and an unrecognized
-method returns an explicit error instead of failing silently.
-
-| Method | Domain | Purpose |
-|---|---|---|
-| `session-history-list` | history | list the official archive set (with source and degradation notes) |
-| `session-history-prune` | history | bulk-remove ids from the archive array (auto backup, restart required) |
-| `session-health-status` | health | switch state and method table (panel polling) |
-| `session-health-scan` | health | batch checkup (defaults to non-ok sessions only) |
-| `session-health-session` | health | one session's four-gate report plus prescription |
-| `session-health-repair` | health | reversible repair (quarantine the projection-cache record) with before/after |
-
-Settings namespace `session-steward`; sidebar entry id `dsh-manage-session`.
-
-## Switches (feature gates)
-
-| Switch | Field | When off |
-|---|---|---|
-| Session history files | `historyFiles` (default true) | `session-history-*` is not registered and the Records Room tab is not rendered |
-| Health check | `healthCheck` (default true) | `session-health-*` is not registered and the Checkup tab is not rendered |
-
-Closed domains return `{ ok: false, error: '子域已关闭（…=false）：<method> 未注册' }` — no empty shells.
-
-## Contract with `dsh-search-index`
-
-The archive file format (`global.archivedSessionIds` of `~/.dsh/storages/workspace.json`):
-**this plugin writes, the search-index plugin reads only**. See
-`dsh-docs-deliverables/dsh-归档文件格式契约-20260914.md`.
-
-## Development
-
-```bash
-pnpm install
-pnpm typecheck
-pnpm test
-pnpm build
-```
-
-## License
-
-MIT
+# dsh-manage-session (Session Steward)
+
+A DSH web plugin for **session history files** and **session health checks**. It never touches session data itself.
+
+- **Retirement Home (history files)** — browse the official archive set and prune ids in bulk
+  (backup + atomic replace; a DSH restart is required for the host to reload it).
+- **Checkup (health)** — four gates → prescription (command list) → discharge (reversible repair with a
+  before/after comparison).
+
+> Naming boundary: **this package ships no search or index features**. Search/indexing belongs to
+> `dsh-search-index`; neither side mentions or re-interprets the other's fields.
+
+## Install
+
+```bash
+dsh plugin --profile web add dsh-manage-session
+```
+
+Restart the host process afterwards (refreshing the page is not enough).
+
+## Routes
+
+Prefix `/session-steward/api`; every method name is `session-*` (never `index-*`), and an unrecognized
+method returns an explicit error instead of failing silently.
+
+| Method | Domain | Purpose |
+|---|---|---|
+| `session-history-list` | history | list the official archive set (with source and degradation notes) |
+| `session-history-prune` | history | bulk-remove ids from the archive array (auto backup, restart required) |
+| `session-health-status` | health | switch state and method table (panel polling) |
+| `session-health-scan` | health | batch checkup (defaults to non-ok sessions only) |
+| `session-health-session` | health | one session's four-gate report plus prescription |
+| `session-health-repair` | health | reversible repair (quarantine the projection-cache record) with before/after |
+
+Settings namespace `session-steward`; sidebar entry id `dsh-manage-session`.
+
+## Switches (feature gates)
+
+| Switch | Field | When off |
+|---|---|---|
+| Session history files | `historyFiles` (default true) | `session-history-*` is not registered and the Retirement Home tab is not rendered |
+| Health check | `healthCheck` (default true) | `session-health-*` is not registered and the Checkup tab is not rendered |
+
+Closed domains return `{ ok: false, error: '子域已关闭（…=false）：<method> 未注册' }` — no empty shells.
+
+## Contract with `dsh-search-index`
+
+The archive file format (`global.archivedSessionIds` of `~/.dsh/storages/workspace.json`):
+**this plugin writes, the search-index plugin reads only**. See
+`dsh-docs-deliverables/dsh-归档文件格式契约-20260914.md`.
+
+## Development
+
+```bash
+pnpm install
+pnpm typecheck
+pnpm test
+pnpm build
+```
+
+## License
+
+MIT

package/README.ja.md

@@ -1,63 +1,63 @@
-# dsh-manage-session（セッション・スチュワード）
-
-**セッション履歴ファイル**と**セッション健康チェック**のための DSH Web プラグインです。セッションデータそのものには一切触れません。
-
-- **カルテ室（履歴ファイル）** — 公式アーカイブ集合を閲覧し、ID を一括整理します
-  （バックアップ + アトミック置換。ホストに再読み込みさせるには DSH の再起動が必要です）。
-- **健診（健康チェック）** — 四つのゲート → 処方（コマンド一覧）→ 退院（before/after 比較を伴う
-  可逆的な修復）。
-
-> 命名の境界：**本パッケージは検索・インデックス機能を一切提供しません**。検索／インデックスは
-> `dsh-search-index` に属し、双方が相手のフィールドに言及したり再解釈したりすることはありません。
-
-## インストール
-
-```bash
-dsh plugin --profile web add dsh-manage-session
-```
-
-その後、ホストプロセスを再起動してください（ページの再読み込みでは不十分です）。
-
-## ルート
-
-プレフィックスは `/session-steward/api`。メソッド名はすべて `session-*`（`index-*` は使いません）で、
-未知のメソッドは黙って失敗せず明示的なエラーを返します。
-
-| メソッド | ドメイン | 用途 |
-|---|---|---|
-| `session-history-list` | history | 公式アーカイブ集合を一覧表示（取得元と縮退の注記付き） |
-| `session-history-prune` | history | アーカイブ配列から ID を一括削除（自動バックアップ、再起動が必要） |
-| `session-health-status` | health | スイッチの状態とメソッド一覧（パネルのポーリング用） |
-| `session-health-scan` | health | 一括健診（既定では非 ok のセッションのみ） |
-| `session-health-session` | health | 1 セッションの四ゲートレポートと処方 |
-| `session-health-repair` | health | 可逆的な修復（プロジェクションキャッシュのレコードを隔離）と before/after 対照 |
-
-設定名前空間は `session-steward`、サイドバーエントリ ID は `dsh-manage-session`。
-
-## スイッチ（フィーチャーゲート）
-
-| スイッチ | フィールド | オフのとき |
-|---|---|---|
-| セッション履歴ファイル | `historyFiles`（既定 true） | `session-history-*` は登録されず、カルテ室タブも描画されない |
-| 健康チェック | `healthCheck`（既定 true） | `session-health-*` は登録されず、健診タブも描画されない |
-
-閉じられたドメインは `{ ok: false, error: '子域已关闭（…=false）：<method> 未注册' }` を返します — 空の殻は残しません。
-
-## `dsh-search-index` との契約
-
-アーカイブファイル形式（`~/.dsh/storages/workspace.json` の `global.archivedSessionIds`）は、
-**本プラグインが書き込み、検索インデックスプラグインは読み取りのみ**です。詳細は
-`dsh-docs-deliverables/dsh-归档文件格式契约-20260914.md` を参照してください。
-
-## 開発
-
-```bash
-pnpm install
-pnpm typecheck
-pnpm test
-pnpm build
-```
-
-## ライセンス
-
-MIT
+# dsh-manage-session（セッション・スチュワード）
+
+**セッション履歴ファイル**と**セッション健康チェック**のための DSH Web プラグインです。セッションデータそのものには一切触れません。
+
+- **カルテ室（履歴ファイル）** — 公式アーカイブ集合を閲覧し、ID を一括整理します
+  （バックアップ + アトミック置換。ホストに再読み込みさせるには DSH の再起動が必要です）。
+- **健診（健康チェック）** — 四つのゲート → 処方（コマンド一覧）→ 退院（before/after 比較を伴う
+  可逆的な修復）。
+
+> 命名の境界：**本パッケージは検索・インデックス機能を一切提供しません**。検索／インデックスは
+> `dsh-search-index` に属し、双方が相手のフィールドに言及したり再解釈したりすることはありません。
+
+## インストール
+
+```bash
+dsh plugin --profile web add dsh-manage-session
+```
+
+その後、ホストプロセスを再起動してください（ページの再読み込みでは不十分です）。
+
+## ルート
+
+プレフィックスは `/session-steward/api`。メソッド名はすべて `session-*`（`index-*` は使いません）で、
+未知のメソッドは黙って失敗せず明示的なエラーを返します。
+
+| メソッド | ドメイン | 用途 |
+|---|---|---|
+| `session-history-list` | history | 公式アーカイブ集合を一覧表示（取得元と縮退の注記付き） |
+| `session-history-prune` | history | アーカイブ配列から ID を一括削除（自動バックアップ、再起動が必要） |
+| `session-health-status` | health | スイッチの状態とメソッド一覧（パネルのポーリング用） |
+| `session-health-scan` | health | 一括健診（既定では非 ok のセッションのみ） |
+| `session-health-session` | health | 1 セッションの四ゲートレポートと処方 |
+| `session-health-repair` | health | 可逆的な修復（プロジェクションキャッシュのレコードを隔離）と before/after 対照 |
+
+設定名前空間は `session-steward`、サイドバーエントリ ID は `dsh-manage-session`。
+
+## スイッチ（フィーチャーゲート）
+
+| スイッチ | フィールド | オフのとき |
+|---|---|---|
+| セッション履歴ファイル | `historyFiles`（既定 true） | `session-history-*` は登録されず、カルテ室タブも描画されない |
+| 健康チェック | `healthCheck`（既定 true） | `session-health-*` は登録されず、健診タブも描画されない |
+
+閉じられたドメインは `{ ok: false, error: '子域已关闭（…=false）：<method> 未注册' }` を返します — 空の殻は残しません。
+
+## `dsh-search-index` との契約
+
+アーカイブファイル形式（`~/.dsh/storages/workspace.json` の `global.archivedSessionIds`）は、
+**本プラグインが書き込み、検索インデックスプラグインは読み取りのみ**です。詳細は
+`dsh-docs-deliverables/dsh-归档文件格式契约-20260914.md` を参照してください。
+
+## 開発
+
+```bash
+pnpm install
+pnpm typecheck
+pnpm test
+pnpm build
+```
+
+## ライセンス
+
+MIT

package/README.ko.md

@@ -1,61 +1,61 @@
-# dsh-manage-session (세션 스튜어드)
-
-**세션 히스토리 파일**과 **세션 상태 점검**을 위한 DSH 웹 플러그인입니다. 세션 데이터 자체는 건드리지 않습니다.
-
-- **기록 보관소(히스토리 파일)** — 공식 아카이브 집합을 조회하고 id를 일괄 정리합니다
-  (백업 + 원자적 교체, 호스트가 다시 로드하려면 DSH 재시작이 필요합니다).
-- **점검(상태)** — 네 개의 gate → 처방(명령 목록) → 퇴원(전후 비교가 포함된 되돌릴 수 있는 복구).
-
-> 이름 경계: **이 패키지는 검색이나 인덱스 기능을 제공하지 않습니다**. 검색/인덱싱은
-> `dsh-search-index`에 속하며, 어느 쪽도 상대방의 필드를 언급하거나 재해석하지 않습니다.
-
-## 설치
-
-```bash
-dsh plugin --profile web add dsh-manage-session
-```
-
-이후 호스트 프로세스를 재시작하세요(페이지 새로고침만으로는 부족합니다).
-
-## 라우트
-
-접두사 `/session-steward/api`; 모든 메서드 이름은 `session-*`이며(`index-*`는 결코 아닙니다), 인식되지 않는
-메서드는 조용히 실패하지 않고 명시적인 오류를 반환합니다.
-
-| 메서드 | 도메인 | 목적 |
-|---|---|---|
-| `session-history-list` | history | 공식 아카이브 집합 조회(출처 및 성능 저하 관련 주석 포함) |
-| `session-history-prune` | history | 아카이브 배열에서 id 일괄 제거(자동 백업, 재시작 필요) |
-| `session-health-status` | health | 스위치 상태와 메서드 표(패널 폴링) |
-| `session-health-scan` | health | 일괄 점검(기본값은 비정상 세션만) |
-| `session-health-session` | health | 단일 세션의 4-gate 리포트와 처방 |
-| `session-health-repair` | health | 되돌릴 수 있는 복구(프로젝션 캐시 레코드 격리)와 전후 비교 |
-
-설정 네임스페이스 `session-steward`; 사이드바 항목 id `dsh-manage-session`.
-
-## 스위치(기능 게이트)
-
-| 스위치 | 필드 | 꺼져 있을 때 |
-|---|---|---|
-| 세션 히스토리 파일 | `historyFiles`(기본값 true) | `session-history-*`가 등록되지 않고 기록 보관소 탭이 렌더링되지 않습니다 |
-| 상태 점검 | `healthCheck`(기본값 true) | `session-health-*`가 등록되지 않고 점검 탭이 렌더링되지 않습니다 |
-
-닫힌 도메인은 `{ ok: false, error: '子域已关闭（…=false）：<method> 未注册' }`를 반환합니다 — 빈 껍데기는 남지 않습니다.
-
-## `dsh-search-index`와의 계약
-
-아카이브 파일 형식(`~/.dsh/storages/workspace.json`의 `global.archivedSessionIds`):
-**이 플러그인이 쓰고, search-index 플러그인은 읽기만 합니다**. `dsh-docs-deliverables/dsh-归档文件格式契约-20260914.md`를 참고하세요.
-
-## 개발
-
-```bash
-pnpm install
-pnpm typecheck
-pnpm test
-pnpm build
-```
-
-## 라이선스
-
-MIT
+# dsh-manage-session (세션 스튜어드)
+
+**세션 히스토리 파일**과 **세션 상태 점검**을 위한 DSH 웹 플러그인입니다. 세션 데이터 자체는 건드리지 않습니다.
+
+- **기록 보관소(히스토리 파일)** — 공식 아카이브 집합을 조회하고 id를 일괄 정리합니다
+  (백업 + 원자적 교체, 호스트가 다시 로드하려면 DSH 재시작이 필요합니다).
+- **점검(상태)** — 네 개의 gate → 처방(명령 목록) → 퇴원(전후 비교가 포함된 되돌릴 수 있는 복구).
+
+> 이름 경계: **이 패키지는 검색이나 인덱스 기능을 제공하지 않습니다**. 검색/인덱싱은
+> `dsh-search-index`에 속하며, 어느 쪽도 상대방의 필드를 언급하거나 재해석하지 않습니다.
+
+## 설치
+
+```bash
+dsh plugin --profile web add dsh-manage-session
+```
+
+이후 호스트 프로세스를 재시작하세요(페이지 새로고침만으로는 부족합니다).
+
+## 라우트
+
+접두사 `/session-steward/api`; 모든 메서드 이름은 `session-*`이며(`index-*`는 결코 아닙니다), 인식되지 않는
+메서드는 조용히 실패하지 않고 명시적인 오류를 반환합니다.
+
+| 메서드 | 도메인 | 목적 |
+|---|---|---|
+| `session-history-list` | history | 공식 아카이브 집합 조회(출처 및 성능 저하 관련 주석 포함) |
+| `session-history-prune` | history | 아카이브 배열에서 id 일괄 제거(자동 백업, 재시작 필요) |
+| `session-health-status` | health | 스위치 상태와 메서드 표(패널 폴링) |
+| `session-health-scan` | health | 일괄 점검(기본값은 비정상 세션만) |
+| `session-health-session` | health | 단일 세션의 4-gate 리포트와 처방 |
+| `session-health-repair` | health | 되돌릴 수 있는 복구(프로젝션 캐시 레코드 격리)와 전후 비교 |
+
+설정 네임스페이스 `session-steward`; 사이드바 항목 id `dsh-manage-session`.
+
+## 스위치(기능 게이트)
+
+| 스위치 | 필드 | 꺼져 있을 때 |
+|---|---|---|
+| 세션 히스토리 파일 | `historyFiles`(기본값 true) | `session-history-*`가 등록되지 않고 기록 보관소 탭이 렌더링되지 않습니다 |
+| 상태 점검 | `healthCheck`(기본값 true) | `session-health-*`가 등록되지 않고 점검 탭이 렌더링되지 않습니다 |
+
+닫힌 도메인은 `{ ok: false, error: '子域已关闭（…=false）：<method> 未注册' }`를 반환합니다 — 빈 껍데기는 남지 않습니다.
+
+## `dsh-search-index`와의 계약
+
+아카이브 파일 형식(`~/.dsh/storages/workspace.json`의 `global.archivedSessionIds`):
+**이 플러그인이 쓰고, search-index 플러그인은 읽기만 합니다**. `dsh-docs-deliverables/dsh-归档文件格式契约-20260914.md`를 참고하세요.
+
+## 개발
+
+```bash
+pnpm install
+pnpm typecheck
+pnpm test
+pnpm build
+```
+
+## 라이선스
+
+MIT

package/README.md

@@ -1,75 +1,96 @@
-# dsh-manage-session（会话管家 / Session Steward）
-
-DSH Web 插件：**会话历史文件 + 会话健康检查**。它只做两件事，且都不碰会话数据本身：
-
-- **病案室（会话历史文件）**：浏览官方归档集合、批量清理（备份 + 原子替换，需重启宿主生效）。
-- **体检（健康检查 / 会话医生）**：四门体检 → 处方（命令清单）→ 出院（可逆处置 + before/after 对照）。
-
-> 命名边界：**本插件不提供搜索与索引**。搜索/独立索引属于另一片（`dsh-search-index`），
-> 两侧互不出现对方的子域字眼，也不互相解释对方字段。
-
-## 安装
-
-```bash
-dsh plugin --profile web add dsh-manage-session
-# 或本地开发目录
-dsh plugin --profile web add "link:E:/test/rewrite-agently/mine-dsh-plugins/dsh-manage-session"
-```
-
-安装后**必须重启宿主进程**（仅刷新页面无效）。
-
-## 路由契约
-
-前缀 `/session-steward/api`，方法名一律 `session-*`（**不得**与搜索索引的 `index-*` 混用）；
-未识别的方法返回显式错误，绝不静默。
-
-| 方法 | 子域 | 作用 |
-|---|---|---|
-| `session-history-list` | history | 列出官方归档集合（含来源与降级标注） |
-| `session-history-prune` | history | 从归档数组批量移除 id（自动备份，需重启） |
-| `session-health-status` | health | 开关状态与方法表（面板轮询用） |
-| `session-health-scan` | health | 批量体检（默认只返回非 ok 的会话） |
-| `session-health-session` | health | 单会话四门报告 + 处方 |
-| `session-health-repair` | health | 可逆处置（隔离投影缓存记录）+ before/after |
-
-设置命名空间：`session-steward`；侧边栏入口 id：`dsh-manage-session`。
-
-## 两个开关（feature gate）
-
-| 开关 | 字段 | 关闭效果 |
-|---|---|---|
-| 会话历史文件 | `historyFiles`（默认 true） | 不注册 `session-history-*`，不渲染「病案室」页签 |
-| 健康检查 | `healthCheck`（默认 true） | 不注册 `session-health-*`，不渲染「体检」页签 |
-
-关闭时对应方法返回 `{ ok: false, error: '子域已关闭（…=false）：<method> 未注册' }`，**不留空壳**。
-
-## 四门体检
-
-| gate | 判据 | level |
-|---|---|---|
-| `log-integrity` | zstd 多帧扫描 → provenance 展开 → 打包行解包；seq 连续、无撕裂尾帧 | 有读取问题 `fail`；仅撕裂尾帧 `warn` |
-| `projection-cache` | `~/.dsh/storages/session_projcache/sessions/<id>.json` 的 `minSeq` 与日志末 seq 的 lag + 未结算字段（openStep / activeStep.active / pendingTurnStart / turnBoundary=start） | 滞后且未结算 `fail`；任一 `warn` |
-| `lossless-json` | 热态 `sessionProjections.checkpoint(session)` 逐行判定无损 JSON（undefined / 非有限数 / -0 / 稀疏洞 / 非普通原型 / 函数·Symbol·BigInt / 环） | 命中 `fail`，并给出投影 key → 归属包 |
-| `cold-read` | 最后 `turn/end` 的原因、是否存在未收尾 open step、最后 user 消息之后是否还有 assistant 输出 | open step `fail`；interrupted/无 turn/end `warn` |
-
-**处方**只给三件可逆的事：① 隔离损坏的投影缓存记录（先备份）② 含未结算 step 时提示等待宿主结算 ③ 输出可执行命令清单。
-**禁止**：改写会话日志、改历史数据、静默丢弃字段。
-
-## 与 `dsh-search-index` 的唯一契约
-
-归档文件格式（`~/.dsh/storages/workspace.json` 的 `global.archivedSessionIds`）：
-**本插件写、搜索索引只读**。格式说明见
-`dsh-docs-deliverables/dsh-归档文件格式契约-20260914.md`。
-
-## 开发
-
-```bash
-pnpm install
-pnpm typecheck     # tsc -b --pretty false
-pnpm test          # vitest run
-pnpm build         # tsc -b && tsdown → lib/index.js + lib/client.js
-```
-
-## 许可
-
-MIT
+# dsh-manage-session（会话管家 / Session Steward）
+
+DSH Web 插件：**会话历史文件 + 会话健康检查**。
+
+- **养老院（会话历史文件）**：浏览官方归档集合，两个**独立**操作 ——
+  **取消归档状态**（只改数组，可逆）与 **清理归档文件**（真删磁盘实体，不可逆）。
+
+> **两个操作不可互换，也不能合并**：
+>
+> | | 取消归档状态 | 清理归档文件 |
+> |---|---|---|
+> | 路由 | `session-history-prune` | `session-history-purge` |
+> | 改什么 | 只改 `global.archivedSessionIds` | 删磁盘实体 + 改归档数组 + 改工作区成员表 |
+> | 会话去向 | 回到侧边栏原工作区 | 从世界上消失 |
+> | 可逆 | ✅ | ❌ |
+>
+> **清理必然连带取消归档** —— 否则会留下「侧边栏看不见、一取消归档就变成空会话」的僵尸 id。
+> 体积**按行**显示（实测单条可从 0 到 23 MB），按钮给所选小计。
+>
+> **两条硬约束**（照做，否则操作会白做）：
+> 1. **列表与写入同源** —— 都认存储文件 `~/.dsh/storages/workspace.json`。宿主内存里的
+>    `workspaceRegistry` 是启动快照，改文件写不到它，只作为「已出文件、仍生效」的诊断面
+>    （`pendingRestart`）。
+> 2. **操作后立刻重启 DSH** —— 存储层是全量重写、内存为准：宿主退出前**任何**归档或
+>    工作区改动都会把旧状态整份写回，本次操作归零。
+- **体检（健康检查 / 会话医生）**：四门体检 → 处方（命令清单）→ 出院（可逆处置 + before/after 对照）。
+
+> 命名边界：**本插件不提供搜索与索引**。搜索/独立索引属于另一片（`dsh-search-index`），
+> 两侧互不出现对方的子域字眼，也不互相解释对方字段。
+
+## 安装
+
+```bash
+dsh plugin --profile web add dsh-manage-session
+# 或本地开发目录
+dsh plugin --profile web add "link:E:/test/rewrite-agently/mine-dsh-plugins/dsh-manage-session"
+```
+
+安装后**必须重启宿主进程**（仅刷新页面无效）。
+
+## 路由契约
+
+前缀 `/session-steward/api`，方法名一律 `session-*`（**不得**与搜索索引的 `index-*` 混用）；
+未识别的方法返回显式错误，绝不静默。
+
+| 方法 | 子域 | 作用 |
+|---|---|---|
+| `session-history-list` | history | 列出归档集合（存储文件优先；含来源、降级、按行体积与 `pendingRestart` 标注） |
+| `session-history-prune` | history | **取消归档状态**：从归档数组批量移除 id（自动备份，需重启） |
+| `session-history-purge` | history | **清理归档文件**：真删转录目录 + 投影缓存 + 两处 id（**不可逆**） |
+| `session-health-status` | health | 开关状态与方法表（面板轮询用） |
+| `session-health-scan` | health | 批量体检（默认只返回非 ok 的会话） |
+| `session-health-session` | health | 单会话四门报告 + 处方 |
+| `session-health-repair` | health | 可逆处置（隔离投影缓存记录）+ before/after |
+
+设置命名空间：`session-steward`；侧边栏入口 id：`dsh-manage-session`。
+
+## 两个开关（feature gate）
+
+| 开关 | 字段 | 关闭效果 |
+|---|---|---|
+| 会话历史文件 | `historyFiles`（默认 true） | 不注册 `session-history-*`，不渲染「养老院」页签 |
+| 健康检查 | `healthCheck`（默认 true） | 不注册 `session-health-*`，不渲染「体检」页签 |
+
+关闭时对应方法返回 `{ ok: false, error: '子域已关闭（…=false）：<method> 未注册' }`，**不留空壳**。
+
+## 四门体检
+
+| gate | 判据 | level |
+|---|---|---|
+| `log-integrity` | zstd 多帧扫描 → provenance 展开 → 打包行解包；seq 连续、无撕裂尾帧 | 有读取问题 `fail`；仅撕裂尾帧 `warn` |
+| `projection-cache` | `~/.dsh/storages/session_projcache/sessions/<id>.json` 的 `minSeq` 与日志末 seq 的 lag + 未结算字段（openStep / activeStep.active / pendingTurnStart / turnBoundary=start） | 滞后且未结算 `fail`；任一 `warn` |
+| `lossless-json` | 热态 `sessionProjections.checkpoint(session)` 逐行判定无损 JSON（undefined / 非有限数 / -0 / 稀疏洞 / 非普通原型 / 函数·Symbol·BigInt / 环） | 命中 `fail`，并给出投影 key → 归属包 |
+| `cold-read` | 最后 `turn/end` 的原因、是否存在未收尾 open step、最后 user 消息之后是否还有 assistant 输出 | open step `fail`；interrupted/无 turn/end `warn` |
+
+**处方**只给三件可逆的事：① 隔离损坏的投影缓存记录（先备份）② 含未结算 step 时提示等待宿主结算 ③ 输出可执行命令清单。
+**禁止**：改写会话日志、改历史数据、静默丢弃字段。
+
+## 与 `dsh-search-index` 的唯一契约
+
+归档文件格式（`~/.dsh/storages/workspace.json` 的 `global.archivedSessionIds`）：
+**本插件写、搜索索引只读**。格式说明见
+`dsh-docs-deliverables/dsh-归档文件格式契约-20260914.md`。
+
+## 开发
+
+```bash
+pnpm install
+pnpm typecheck     # tsc -b --pretty false
+pnpm test          # vitest run
+pnpm build         # tsc -b && tsdown → lib/index.js + lib/client.js
+```
+
+## 许可
+
+MIT

package/dsh.plugin.json

@@ -1,22 +1,22 @@
-{
-  "id": "dsh-manage-session",
-  "name": "dsh-manage-session",
-  "version": "0.1.0-alpha.0",
-  "description": {
-    "en": "Session Steward: browse and bulk-prune the official session archive set, and run a four-gate session health checkup that ends in a reversible, backup-first prescription. Never rewrites session logs.",
-    "zh": "会话管家：浏览并批量清理官方会话归档集合，并对会话做四门体检，最终给出可逆、先备份的处方。不改写会话日志。"
-  },
-  "homepage": "https://github.com/drscrewdriver/dsh-manage-session",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/drscrewdriver/dsh-manage-session.git"
-  },
-  "license": "MIT",
-  "engines": {
-    "dsh": ">=0.1.0-rc.6 <0.2.0-0"
-  },
-  "components": {
-    "host": "lib/index.js",
-    "client": "lib/client.js"
-  }
-}
+{
+  "id": "dsh-manage-session",
+  "name": "dsh-manage-session",
+  "version": "0.2.3",
+  "description": {
+    "en": "Session Steward: browse and bulk-prune the official session archive set, and run a four-gate session health checkup that ends in a reversible, backup-first prescription. Never rewrites session logs.",
+    "zh": "会话管家：浏览并批量清理官方会话归档集合，并对会话做四门体检，最终给出可逆、先备份的处方。不改写会话日志。"
+  },
+  "homepage": "https://github.com/drscrewdriver/dsh-manage-session",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/drscrewdriver/dsh-manage-session.git"
+  },
+  "license": "MIT",
+  "engines": {
+    "dsh": ">=0.1.2-rc.1 <0.1.3-0"
+  },
+  "components": {
+    "host": "lib/index.js",
+    "client": "lib/client.js"
+  }
+}