dsh-manage-session 0.3.3 → 0.5.1

package/INSTALL.zh.md

@@ -1,164 +1,179 @@
-# 安装指南（官方 DSH CLI）
-
-本指南只使用官方 `dsh plugin` 命令。该命令会把依赖装入 profile 并同步 `dsh.profile.bundles`。请勿改用裸 `npm install`、在 profile 里直接 `pnpm add`，或手工编辑 profile 清单。
-
-- [English installation guide](./INSTALL.md)
-- [中文安装指南](./INSTALL.zh.md)
-- [日本語インストールガイド](./INSTALL.ja.md)
-- [한국어 설치 안내](./INSTALL.ko.md)
-- [中文 README](./README.md)
-- [English README](./README.en.md)
-- [日本語 README](./README.ja.md)
-- [한국어 README](./README.ko.md)
-- [Changelog](./CHANGELOG.md)
-- [日本語 changelog](./CHANGELOG.ja.md)
-- [한국어 changelog](./CHANGELOG.ko.md)
-
-本指南中的占位符：
-
-- `<profile>`：要改动的 DSH profile，通常是 `web`；
-- `dsh-manage-session`：npm 包名，同时也是运行时插件 ID。
-
-> **支持的 DSH 范围：`>=0.1.0-rc.6 <0.2.0-0`。**
->
-> 该范围同时写在 `package.json` 与 `dsh.plugin.json` 的 `engines.dsh` 中，也与本插件为其 `@deepseek-ai/dsh-client-ui-slots` 依赖已经声明的 `^0.1.0-rc.6` 下界一致。安装前先用 `dsh --version` 确认当前版本。
-
-## 0. 前置条件与 profile 探查
-
-```bash
-echo "DSH_HOME=${DSH_HOME:-$HOME/.dsh}"
-dsh --version
-ls "${DSH_HOME:-$HOME/.dsh}/profiles"
-```
-
-请使用正在运行的 DSH 进程所使用的那个 profile。`web` 很常见，但以实际生效的 `--profile` 参数为准。
-
-## 1. 官方安装
-
-```bash
-dsh plugin --profile <profile> add dsh-manage-session -w
-```
-
-（当 profile 是 pnpm workspace 根时，如 `web`，`-w` 是必需的。）
-
-显式安装指定版本：
-
-```bash
-dsh plugin --profile <profile> add dsh-manage-session@0.1.0-alpha.6 -w
-```
-
-官方 CLI 会自动更新 profile 依赖、锁文件与 `dsh.profile.bundles`。不要手工添加 YAML 行。
-
-### 供应链冷却期
-
-DSH 运行时使用 pnpm 11，其 `minimumReleaseAge` 策略可能拦截刚发布的版本并报 `ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION`。把该版本加入 `~/.dsh/profiles/<profile>/pnpm-workspace.yaml` 的 `minimumReleaseAgeExclude`：
-
-```yaml
-minimumReleaseAgeExclude:
-  - dsh-manage-session@0.1.0-alpha.6
-```
-
-## 2. 重启宿主
-
-**安装或升级后必须重启 DSH。** 仅刷新浏览器页面无效：宿主半身在启动时注册 `/session-steward/api` 路由与设置命名空间，且归档来源需要在宿主重启后才会反映清理结果。
-
-## 3. 升级
-
-```bash
-dsh plugin --profile <profile> update dsh-manage-session -w
-```
-
-升级后重启 DSH。
-
-## 4. 本地路径 / `link:` 注册（备选）
-
-用于开发或离线安装，可从本地检出注册：
-
-```bash
-#    ~/.dsh/profiles/<profile>/package.json dependencies:
-#      "dsh-manage-session": "link:<absolute path to dsh-manage-session>"
-#    ~/.dsh/profiles/<profile>/cordis.patch.yml:
-#      - insert:
-#          - id: dsh-manage-session
-#            name: dsh-manage-session
-cd ~/.dsh/profiles/<profile> && pnpm install && dsh web
-```
-
-或用官方 CLI 直接指定本地路径（无需联网）：
-
-```bash
-dsh plugin --profile <profile> add /absolute/path/to/dsh-manage-session -w
-```
-
-从源码检出构建时用以下脚本：
-
-```bash
-pnpm install
-pnpm typecheck     # tsc -b --pretty false
-pnpm test          # vitest run
-pnpm build         # tsc -b && tsdown → lib/index.js + lib/index.d.ts + lib/client.js
-```
-
-`lib/` 不入库，因此源码检出必须先构建才能按路径注册。发布时由 `prepublishOnly` 钩子自动构建。
-
-## 5. 校验安装
-
-检查依赖与已安装版本：
-
-```bash
-grep -n "dsh-manage-session" \
-  "${DSH_HOME:-$HOME/.dsh}/profiles/<profile>/package.json"
-node -p "require('${DSH_HOME:-$HOME/.dsh}/profiles/<profile>/node_modules/dsh-manage-session/package.json').version"
-```
-
-检查官方装配：
-
-```bash
-dsh --profile <profile> --dump-default-config
-```
-
-其中必须包含：
-
-```yaml
-- id: dsh-manage-session
-  name: dsh-manage-session
-```
-
-## 6. 验证插件
-
-重启后，侧边栏入口 `dsh-manage-session` 可用，设置区使用 `session-steward` 命名空间。请确认：
-
-1. 两个开关均开启时，**养老院**与**体检**两个页签都会渲染。
-2. 关闭 `historyFiles` 后「养老院」页签消失，且所有 `session-history-*` 调用返回显式的 disabled 错误。
-3. 关闭 `healthCheck` 后「体检」页签消失，且所有 `session-health-*` 调用返回显式的 disabled 错误。
-4. 对 `/session-steward/api` 调用未识别的方法时返回显式错误，而不是静默成功。
-
-关闭的子域返回 `{ ok: false, error: '子域已关闭（…=false）：<method> 未注册' }` —— 本插件不留空壳。
-
-## 7. 故障排查
-
-| 现象 | 处理 |
-| --- | --- |
-| 找不到 `dsh` | 安装或启用官方 DSH CLI。 |
-| `ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION` | 把该版本加入该 profile 的 `pnpm-workspace.yaml` 中的 `minimumReleaseAgeExclude`。 |
-| 安装后页签或路由缺失 | 重启宿主进程——刷新页面不会重新注册路由。 |
-| 归档集合的改动不可见 | 重启宿主；归档来源在启动时读取。 |
-| `session-history-*` 返回 disabled 错误 | `historyFiles` 开关已关闭，在插件设置中重新开启。 |
-| `session-health-*` 返回 disabled 错误 | `healthCheck` 开关已关闭，在插件设置中重新开启。 |
-| 升级后客户端包陈旧 | 强制刷新浏览器（Ctrl+Shift+R）。 |
-
-## 8. 卸载
-
-```bash
-dsh plugin --profile <profile> remove dsh-manage-session
-```
-
-卸载后重启 DSH。
-
-## 卸载不会撤销已执行的处置
-
-本插件从不改写会话日志、不修改历史数据、不静默丢弃字段。它唯一看起来不可逆的动作——隔离损坏的投影缓存记录——会先复制备份，并把隔离目录留在磁盘上供你恢复。因此卸载插件不会撤销你主动请求过的隔离；如需还原状态请手工恢复。
-
-## 许可
-
-MIT
+# 安装指南（官方 DSH CLI）
+
+本指南只使用官方 `dsh plugin` 命令。该命令会把依赖装入 profile 并同步 `dsh.profile.bundles`。请勿改用裸 `npm install`、在 profile 里直接 `pnpm add`，或手工编辑 profile 清单。
+
+- [English installation guide](./INSTALL.md)
+- [中文安装指南](./INSTALL.zh.md)
+- [日本語インストールガイド](./INSTALL.ja.md)
+- [한국어 설치 안내](./INSTALL.ko.md)
+- [Guide d'installation en français](./INSTALL.fr.md)
+- [Installationsanleitung auf Deutsch](./INSTALL.de.md)
+- [Guida all'installazione in italiano](./INSTALL.it.md)
+- [Руководство по установке на русском](./INSTALL.ru.md)
+- [Guía de instalación en español](./INSTALL.es.md)
+- [中文 README](./README.md)
+- [English README](./README.en.md)
+- [日本語 README](./README.ja.md)
+- [한국어 README](./README.ko.md)
+- [Français README](./README.fr.md)
+- [Deutsch README](./README.de.md)
+- [Italiano README](./README.it.md)
+- [Русский README](./README.ru.md)
+- [Español README](./README.es.md)
+- [Changelog](./CHANGELOG.md)
+- [日本語 changelog](./CHANGELOG.ja.md)
+- [한국어 changelog](./CHANGELOG.ko.md)
+- [Français changelog](./CHANGELOG.fr.md)
+- [Deutsch changelog](./CHANGELOG.de.md)
+- [Italiano changelog](./CHANGELOG.it.md)
+- [Русский changelog](./CHANGELOG.ru.md)
+- [Español changelog](./CHANGELOG.es.md)
+
+本指南中的占位符：
+
+- `<profile>`：要改动的 DSH profile，通常是 `web`；
+- `dsh-manage-session`：npm 包名，同时也是运行时插件 ID。
+
+> **支持的 DSH 范围：`>=0.1.0-rc.6 <0.2.0-0`。**
+>
+> 该范围同时写在 `package.json` 与 `dsh.plugin.json` 的 `engines.dsh` 中，也与本插件为其 `@deepseek-ai/dsh-client-ui-slots` 依赖已经声明的 `^0.1.0-rc.6` 下界一致。安装前先用 `dsh --version` 确认当前版本。
+
+## 0. 前置条件与 profile 探查
+
+```bash
+echo "DSH_HOME=${DSH_HOME:-$HOME/.dsh}"
+dsh --version
+ls "${DSH_HOME:-$HOME/.dsh}/profiles"
+```
+
+请使用正在运行的 DSH 进程所使用的那个 profile。`web` 很常见，但以实际生效的 `--profile` 参数为准。
+
+## 1. 官方安装
+
+```bash
+dsh plugin --profile <profile> add dsh-manage-session -w
+```
+
+（当 profile 是 pnpm workspace 根时，如 `web`，`-w` 是必需的。）
+
+显式安装指定版本：
+
+```bash
+dsh plugin --profile <profile> add dsh-manage-session@0.1.0-alpha.6 -w
+```
+
+官方 CLI 会自动更新 profile 依赖、锁文件与 `dsh.profile.bundles`。不要手工添加 YAML 行。
+
+### 供应链冷却期
+
+DSH 运行时使用 pnpm 11，其 `minimumReleaseAge` 策略可能拦截刚发布的版本并报 `ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION`。把该版本加入 `~/.dsh/profiles/<profile>/pnpm-workspace.yaml` 的 `minimumReleaseAgeExclude`：
+
+```yaml
+minimumReleaseAgeExclude:
+  - dsh-manage-session@0.1.0-alpha.6
+```
+
+## 2. 重启宿主
+
+**安装或升级后必须重启 DSH。** 仅刷新浏览器页面无效：宿主半身在启动时注册 `/session-steward/api` 路由与设置命名空间，且归档来源需要在宿主重启后才会反映清理结果。
+
+## 3. 升级
+
+```bash
+dsh plugin --profile <profile> update dsh-manage-session -w
+```
+
+升级后重启 DSH。
+
+## 4. 本地路径 / `link:` 注册（备选）
+
+用于开发或离线安装，可从本地检出注册：
+
+```bash
+#    ~/.dsh/profiles/<profile>/package.json dependencies:
+#      "dsh-manage-session": "link:<absolute path to dsh-manage-session>"
+#    ~/.dsh/profiles/<profile>/cordis.patch.yml:
+#      - insert:
+#          - id: dsh-manage-session
+#            name: dsh-manage-session
+cd ~/.dsh/profiles/<profile> && pnpm install && dsh web
+```
+
+或用官方 CLI 直接指定本地路径（无需联网）：
+
+```bash
+dsh plugin --profile <profile> add /absolute/path/to/dsh-manage-session -w
+```
+
+从源码检出构建时用以下脚本：
+
+```bash
+pnpm install
+pnpm typecheck     # tsc -b --pretty false
+pnpm test          # vitest run
+pnpm build         # tsc -b && tsdown → lib/index.js + lib/index.d.ts + lib/client.js
+```
+
+`lib/` 不入库，因此源码检出必须先构建才能按路径注册。发布时由 `prepublishOnly` 钩子自动构建。
+
+## 5. 校验安装
+
+检查依赖与已安装版本：
+
+```bash
+grep -n "dsh-manage-session" \
+  "${DSH_HOME:-$HOME/.dsh}/profiles/<profile>/package.json"
+node -p "require('${DSH_HOME:-$HOME/.dsh}/profiles/<profile>/node_modules/dsh-manage-session/package.json').version"
+```
+
+检查官方装配：
+
+```bash
+dsh --profile <profile> --dump-default-config
+```
+
+其中必须包含：
+
+```yaml
+- id: dsh-manage-session
+  name: dsh-manage-session
+```
+
+## 6. 验证插件
+
+重启后，侧边栏入口 `dsh-manage-session` 可用，设置区使用 `session-steward` 命名空间。请确认：
+
+1. 两个开关均开启时，**养老院**与**体检**两个页签都会渲染。
+2. 关闭 `historyFiles` 后「养老院」页签消失，且所有 `session-history-*` 调用返回显式的 disabled 错误。
+3. 关闭 `healthCheck` 后「体检」页签消失，且所有 `session-health-*` 调用返回显式的 disabled 错误。
+4. 对 `/session-steward/api` 调用未识别的方法时返回显式错误，而不是静默成功。
+
+关闭的子域返回 `{ ok: false, error: '子域已关闭（…=false）：<method> 未注册' }` —— 本插件不留空壳。
+
+## 7. 故障排查
+
+| 现象 | 处理 |
+| --- | --- |
+| 找不到 `dsh` | 安装或启用官方 DSH CLI。 |
+| `ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION` | 把该版本加入该 profile 的 `pnpm-workspace.yaml` 中的 `minimumReleaseAgeExclude`。 |
+| 安装后页签或路由缺失 | 重启宿主进程——刷新页面不会重新注册路由。 |
+| 归档集合的改动不可见 | 重启宿主；归档来源在启动时读取。 |
+| `session-history-*` 返回 disabled 错误 | `historyFiles` 开关已关闭，在插件设置中重新开启。 |
+| `session-health-*` 返回 disabled 错误 | `healthCheck` 开关已关闭，在插件设置中重新开启。 |
+| 升级后客户端包陈旧 | 强制刷新浏览器（Ctrl+Shift+R）。 |
+
+## 8. 卸载
+
+```bash
+dsh plugin --profile <profile> remove dsh-manage-session
+```
+
+卸载后重启 DSH。
+
+## 卸载不会撤销已执行的处置
+
+本插件从不改写会话日志、不修改历史数据、不静默丢弃字段。它唯一看起来不可逆的动作——隔离损坏的投影缓存记录——会先复制备份，并把隔离目录留在磁盘上供你恢复。因此卸载插件不会撤销你主动请求过的隔离；如需还原状态请手工恢复。
+
+## 许可
+
+MIT

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 drscrewdriver
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 drscrewdriver
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.de.md

@@ -0,0 +1,120 @@
+# dsh-manage-session (Session Steward)
+
+- [中文 README](./README.md)
+- [English README](./README.en.md)
+- [日本語 README](./README.ja.md)
+- [한국어 README](./README.ko.md)
+- [Français README](./README.fr.md)
+- [Deutsch README](./README.de.md)
+- [Italiano README](./README.it.md)
+- [Русский README](./README.ru.md)
+- [Español README](./README.es.md)
+
+DSH-Web-Plugin für **Sitzungsverlaufsdateien + Sitzungs-Healthchecks**.
+
+> **Diese Version (0.5.0) macht die DSH-0.2.0-Linie zur Hauptlinie** (peer/engines = `>=0.2.0-rc.1 <0.2.1-0`, npm dist-tag `dsh-0.2.0`, Branch `compat/0.2.0`).
+> Die DSH-0.1.7-Linie wird weiterhin von 0.4.8 bedient (dist-tag `dsh-0.1.7`, Branch `compat/0.1.7`) und entwickelt sich nicht mehr mit dieser Linie weiter.
+> Die Host-Flächen, die dieses Plugin konsumiert (Sitzungsformat V4 und die First-Party-Produzentenlisten von `dsh-session-format-v3-to-v4`, die Dekodier-Exports von `dsh-session`, der Archivverzeichnis-Vertrag `session.jsonl.zstd`/`session.v3.jsonl.zstd` in doppelter Ausführung + `storages/session_projcache` + die beiden id-Listen in `workspace.json`), wurden in 0.2.0-rc.1 Punkt für Punkt als **unverändert verifiziert — null Codeänderungen**; diese Version ist eine reine Metadaten-Anpassung (Generationswechsel bei peer/engines, devDependencies exakt auf `0.2.0-rc.1` gepinnt, Release-Disziplin versionsbegleitend aktualisiert).
+
+- **Seniorenheim (Verlaufsdateien)**: den offiziellen Archivbestand durchsehen, mit zwei **unabhängigen** Aktionen —
+  **Archivstatus aufheben** (ändert nur das Array, reversibel) und **Archivdateien endgültig löschen (Purge)** (löscht die Datenträger-Entitäten wirklich, irreversibel).
+
+> **Die beiden Aktionen sind nicht austauschbar und lassen sich nicht zusammenlegen**:
+>
+> | | Archivstatus aufheben | Archivdateien löschen (Purge) |
+> |---|---|---|
+> | Route | `session-history-prune` | `session-history-purge` |
+> | Was geändert wird | nur `global.archivedSessionIds` | löscht Datenträger-Entitäten + ändert das Archiv-Array + ändert die Mitglieder-Tabelle der Arbeitsbereiche |
+> | Verbleib der Sitzung | zurück in den ursprünglichen Arbeitsbereich der Seitenleiste | verschwindet aus der Welt |
+> | Reversibel | ✅ | ❌ |
+>
+> **Der Purge zieht zwangsläufig das Aufheben des Archivstatus nach sich** — sonst blieben Zombie-ids zurück, die „in der Seitenleiste unsichtbar sind und sobald man ihren Archivstatus aufhebt zu einer leeren Sitzung werden“.
+> Die Größe wird **pro Zeile** angezeigt (praktisch gemessen: ein einzelner Eintrag kann von 0 bis 23 MB reichen), der Button zeigt die Teiltsumme der Auswahl.
+>
+> **Zwei harte Randbedingungen** (einhalten, sonst war die Aktion umsonst):
+> 1. **Liste und Schreibzugriff haben dieselbe Quelle** — beide erkennen die Speicherdatei `~/.dsh/storages/workspace.json` an. Der `workspaceRegistry` im Host-Speicher ist ein Snapshot beim Start: Änderungen an der Datei schreiben nicht in ihn zurück; er dient nur als Diagnosefläche für „bereits aus der Datei hinaus, in diesem Prozess weiterhin wirksam“ (`pendingRestart`).
+> 2. **Direkt nach der Aktion DSH neu starten** — die Speicherschicht schreibt vollständig neu, der Speicher ist maßgeblich: Vor dem Beenden des Hosts schreibt **jede** Archiv- oder Arbeitsbereichsänderung den alten Zustand vollständig zurück und macht die soeben durchgeführte Aktion zunichte.
+- **Check-up (Gesundheitsprüfung / Sitzungsarzt)**: Vier-Gates-Check-up → Verordnung (Befehlsliste) → Entlassung (reversibler Eingriff + Vorher/Nachher-Vergleich).
+
+> Namensgrenze: **Dieses Paket bietet weder Suche noch Indizierung.** Suche/eigenständige Indizierung gehören in ein anderes Revier (`dsh-search-index`); keine der beiden Seiten verwendet die Unterdomänen-Begriffe der anderen, und keine interpretiert die Felder der anderen.
+
+## Oberflächen-Vorschau
+
+Ein Eintrag **„Session Steward“** erscheint unten in der Seitenleiste, neben Suche und Einstellungen:
+
+![Eintrag in der Seitenleiste](assets/left-sidebar.png)
+
+**Seniorenheim (Verlaufsdateien)** — Überblick über den offiziellen Archivbestand; jede Zeile zeigt ihre Größe und den Zustand der Datenträger-Entität; Zeilen auswählen, um den Archivstatus aufzuheben oder zu löschen (Purge):
+
+![Seniorenheim (alles zusammengeführt)](assets/archive.png)
+
+**Check-up** — der Einstiegspunkt des Vier-Gates-Check-ups, der in einer reversiblen Verordnung endet:
+
+![Check-up](assets/doctor.png)
+
+## Installation
+
+```bash
+dsh plugin --profile web add dsh-manage-session
+# oder ein lokales Entwicklungsverzeichnis
+dsh plugin --profile web add "link:E:/test/rewrite-agently/mine-dsh-plugins/dsh-manage-session"
+```
+
+Nach der Installation **muss der Host-Prozess neu gestartet werden** (ein Neuladen der Seite genügt nicht).
+
+## Routen-Vertrag
+
+Präfix `/session-steward/api`, Methodennamen immer `session-*` (**niemals** mit den `index-*` des Suchindex vermischen);
+eine unbekannte Methode liefert einen expliziten Fehler, niemals Stillschweigen.
+
+| Methode | Subdomäne | Zweck |
+|---|---|---|
+| `session-history-list` | history | den Archivbestand auflisten (Speicherdatei hat Vorrang; mit Quelle, Degradierung, Größe pro Zeile und `pendingRestart`-Vermerk) |
+| `session-history-prune` | history | **Archivstatus aufheben**: ids massenweise aus dem Archiv-Array entfernen (automatische Sicherung, Neustart erforderlich) |
+| `session-history-purge` | history | **Archivdateien endgültig löschen**: Transkript-Verzeichnis + Projektions-Cache + beide id-Listen wirklich löschen (**irreversibel**) |
+| `session-health-status` | health | Schalterzustand und Methodentabelle (für das Polling des Panels) |
+| `session-health-scan` | health | Check-up im Batch (standardmäßig nur nicht-ok-Sitzungen zurückgeben) |
+| `session-health-session` | health | Vier-Gates-Bericht einer einzelnen Sitzung + Verordnung |
+| `session-health-repair` | health | reversibler Eingriff (Quarantäne des Projektions-Cache-Datensatzes) + Vorher/Nachher |
+
+Einstellungs-Namespace: `session-steward`; id des Seitenleisten-Eintrags: `dsh-manage-session`.
+
+## Die beiden Schalter (feature gates)
+
+| Schalter | Feld | Wirkung bei Deaktivierung |
+|---|---|---|
+| Sitzungsverlaufsdateien | `historyFiles` (Standard true) | `session-history-*` wird nicht registriert, der Tab „Seniorenheim“ wird nicht gerendert |
+| Gesundheitsprüfung | `healthCheck` (Standard true) | `session-health-*` wird nicht registriert, der Tab „Check-up“ wird nicht gerendert |
+
+Bei Deaktivierung liefert die entsprechende Methode `{ ok: false, error: '子域已关闭（…=false）：<method> 未注册' }` — **keine leeren Hüllen**.
+
+## Der Vier-Gates-Check-up
+
+| gate | Kriterium | level |
+|---|---|---|
+| `log-integrity` | Multi-Frame-Scan mit zstd → Entfaltung der Provenance → Auspacken der gepackten Zeilen; seq fortlaufend, kein zerrissener Endframe | `fail` bei Leseproblemen; `warn` bei nur zerrissenem Endframe |
+| `projection-cache` | Abstand des `minSeq` von `~/.dsh/storages/session_projcache/sessions/<id>.json` zur letzten seq des Logs + nicht abgeschlossene Felder (openStep / activeStep.active / pendingTurnStart / turnBoundary=start) | `fail` bei Abstand und nicht abgeschlossen; `warn` wenn eines von beiden |
+| `lossless-json` | zeilenweise Prüfung auf verlustfreies JSON durch das hot-state `sessionProjections.checkpoint(session)` (undefined / nicht-endliche Zahlen / -0 / löchrige Sparse-Löcher / nicht-gewöhnlicher Prototyp / Funktionen·Symbol·BigInt / Zyklen) | `fail` bei einem Treffer, mit Projektions-Key → zugeordnetem Paket |
+| `cold-read` | Grund des letzten `turn/end`, ob ein offener open step ohne Abschluss existiert, ob nach der letzten user-Nachricht noch Assistant-Ausgabe folgt | `fail` bei open step; `warn` bei interrupted/fehlendem turn/end |
+
+**Die Verordnung** enthält nur drei reversible Dinge: ① den beschädigten Projektions-Cache-Datensatz in Quarantäne versetzen (zuerst sichern) ② bei nicht abgeschlossenen steps daran erinnern, auf die Abschlusserklärung des Hosts zu warten ③ eine ausführbare Befehlsliste ausgeben.
+**Verboten**: Sitzungslogs umschreiben, historische Daten ändern, Felder stillschweigend verwerfen.
+
+## Der einzige Vertrag mit `dsh-search-index`
+
+Format der Archivdatei (`global.archivedSessionIds` von `~/.dsh/storages/workspace.json`):
+**dieses Plugin schreibt, der Suchindex liest nur**. Formatbeschreibung in
+`dsh-docs-deliverables/dsh-归档文件格式契约-20260914.md`.
+
+## Entwicklung
+
+```bash
+pnpm install
+pnpm typecheck     # tsc -b --pretty false
+pnpm test          # vitest run
+pnpm build         # tsc -b && tsdown → lib/index.js + lib/client.js
+```
+
+## Lizenz
+
+MIT

package/README.en.md

@@ -1,7 +1,19 @@
 # dsh-manage-session (Session Steward)
 
+- [中文 README](./README.md)
+- [English README](./README.en.md)
+- [日本語 README](./README.ja.md)
+- [한국어 README](./README.ko.md)
+- [Français README](./README.fr.md)
+- [Deutsch README](./README.de.md)
+- [Italiano README](./README.it.md)
+- [Русский README](./README.ru.md)
+- [Español README](./README.es.md)
+
 A DSH web plugin for **session history files** and **session health checks**. It never touches session data itself.
 
+> **This release (0.5.0) targets the DSH 0.2.0 line** (peer/engines `>=0.2.0-rc.1 <0.2.1-0`, npm dist-tag `dsh-0.2.0`, branch `compat/0.2.0`). The DSH 0.1.7 line remains served by 0.4.8 (dist-tag `dsh-0.1.7`, branch `compat/0.1.7`). Every host surface this plugin consumes (session V4 format and the `dsh-session-format-v3-to-v4` first-party producer lists, the `dsh-session` decode exports, the archive layout `session.jsonl.zstd`/`session.v3.jsonl.zstd` + `storages/session_projcache` + the two id lists in `workspace.json`) was verified unchanged in 0.2.0-rc.1 — **zero code changes**; this release is metadata-only.
+
 - **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