dsh-manage-session 0.5.1 → 0.5.4

package/INSTALL.zh.md

@@ -1,179 +1,164 @@
-# 安装指南（官方 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
+# 安装指南（官方 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

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.en.md

@@ -1,19 +1,7 @@
 # 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
@@ -22,6 +10,10 @@ A DSH web plugin for **session history files** and **session health checks**. It
 > 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.
 
+<!-- hosts-sync:begin -->
+<!-- Generated by scripts/sync-hosts.mjs; single source in scripts/hosts.mjs -->
+Supports DSH 0.1.0-rc.2, 0.1.0-rc.3, 0.1.0-rc.6, 0.1.0-rc.7, 0.1.0-rc.8, 0.1.1-rc.1, 0.1.1-rc.2, 0.1.2-rc.1, 0.1.5-rc.1, 0.1.5-rc.2, 0.1.5-rc.3, 0.1.7-rc.1, 0.1.7-rc.2, 0.2.0-rc.1, 0.2.0-rc.2, 0.2.1-rc.1, 0.2.1-rc.2 (enumerated peers — a per-rc tested whitelist; alpha/beta releases are out of scope).
+<!-- hosts-sync:end -->
 ## Screenshots
 
 A **Session Steward** entry sits next to Search and Settings at the bottom of the sidebar:

package/README.ja.md

@@ -1,19 +1,7 @@
 # dsh-manage-session（セッション・スチュワード）
 
-- [中文 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 プラグインです。セッションデータそのものには一切触れません。
 
-> **本版（0.5.0）は DSH 0.2.0 線がメインラインです**（peer/engines `>=0.2.0-rc.1 <0.2.1-0`、npm dist-tag `dsh-0.2.0`、ブランチ `compat/0.2.0`）。DSH 0.1.7 線は 0.4.8（dist-tag `dsh-0.1.7`、ブランチ `compat/0.1.7`）が担当します。本プラグインが消費するホスト面（セッション V4 形式と `dsh-session-format-v3-to-v4` の第一方プロデューサ名簿、`dsh-session` のデコード導出面、アーカイブ配置 `session.jsonl.zstd`/`session.v3.jsonl.zstd` + `storages/session_projcache` + `workspace.json` の 2 つの id 名簿）は 0.2.0-rc.1 で変更ないことを検証済み — **コード変更ゼロ**、メタデータのみの対応です。
-
 - **カルテ室（履歴ファイル）** — 公式アーカイブ集合を閲覧し、ID を一括整理します
   （バックアップ + アトミック置換。ホストに再読み込みさせるには DSH の再起動が必要です）。
 - **健診（健康チェック）** — 四つのゲート → 処方（コマンド一覧）→ 退院（before/after 比較を伴う

package/README.ko.md

@@ -1,19 +1,7 @@
 # dsh-manage-session (세션 스튜어드)
 
-- [中文 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 웹 플러그인입니다. 세션 데이터 자체는 건드리지 않습니다.
 
-> **이 버전(0.5.0)은 DSH 0.2.0 라인이 메인입니다**(peer/engines `>=0.2.0-rc.1 <0.2.1-0`, npm dist-tag `dsh-0.2.0`, 브랜치 `compat/0.2.0`). DSH 0.1.7 라인은 0.4.8(dist-tag `dsh-0.1.7`, 브랜치 `compat/0.1.7`)이 계속 지원합니다. 이 플러그인이 소비하는 호스트 표면(세션 V4 포맷과 `dsh-session-format-v3-to-v4`의 퍼스트파티 프로듀서 목록, `dsh-session` 디코드 익스포트, 아카이브 레이아웃 `session.jsonl.zstd`/`session.v3.jsonl.zstd` + `storages/session_projcache` + `workspace.json`의 두 id 목록)이 0.2.0-rc.1에서 변하지 않았음을 검증했습니다 — **코드 변경 없음**, 메타데이터만 갱신되었습니다.
-
 - **기록 보관소(히스토리 파일)** — 공식 아카이브 집합을 조회하고 id를 일괄 정리합니다
   (백업 + 원자적 교체, 호스트가 다시 로드하려면 DSH 재시작이 필요합니다).
 - **점검(상태)** — 네 개의 gate → 처방(명령 목록) → 퇴원(전후 비교가 포함된 되돌릴 수 있는 복구).

package/README.md

@@ -1,21 +1,7 @@
 # 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 插件：**会话历史文件 + 会话健康检查**。
 
-> **本版（0.5.0）以 DSH 0.2.0 为主线**（peer/engines = `>=0.2.0-rc.1 <0.2.1-0`，npm dist-tag `dsh-0.2.0`，分支 `compat/0.2.0`）。
-> DSH 0.1.7 线由 0.4.8（dist-tag `dsh-0.1.7`，分支 `compat/0.1.7`）继续服务，不再随本线演进。
-> 0.2.0-rc.1 对本插件消费的宿主面（会话 V4 格式与 `dsh-session-format-v3-to-v4` 第一方名单、`dsh-session` 解码导出面、归档目录契约 `session.jsonl.zstd`/`session.v3.jsonl.zstd` 双份 + `storages/session_projcache` + `workspace.json` 两处 id 名单）逐项对照核验**未变，代码零修改**；本版为纯元数据适配（peer/engines 换代、devDependencies 精确钉 `0.2.0-rc.1`、发布纪律面随版更新）。
-
 - **养老院（会话历史文件）**：浏览官方归档集合，两个**独立**操作 ——
   **取消归档状态**（只改数组，可逆）与 **清理归档文件**（真删磁盘实体，不可逆）。
 
@@ -42,6 +28,10 @@ DSH Web 插件：**会话历史文件 + 会话健康检查**。
 > 命名边界：**本插件不提供搜索与索引**。搜索/独立索引属于另一片（`dsh-search-index`），
 > 两侧互不出现对方的子域字眼，也不互相解释对方字段。
 
+<!-- hosts-sync:begin -->
+<!-- 由 scripts/sync-hosts.mjs 生成，勿手改；单源在 scripts/hosts.mjs -->
+支持 DSH 0.1.0-rc.2、0.1.0-rc.3、0.1.0-rc.6、0.1.0-rc.7、0.1.0-rc.8、0.1.1-rc.1、0.1.1-rc.2、0.1.2-rc.1、0.1.5-rc.1、0.1.5-rc.2、0.1.5-rc.3、0.1.7-rc.1、0.1.7-rc.2、0.2.0-rc.1、0.2.0-rc.2、0.2.1-rc.1、0.2.1-rc.2（枚举 peer，逐 rc 实测白名单；alpha/beta 不在支持范围）。
+<!-- hosts-sync:end -->
 ## 界面预览
 
 侧边栏底部新增 **「会话管家」** 入口，与搜索、设置并列：

package/cordis.patch.yml

@@ -1,11 +1,16 @@
-# dsh-manage-session bundle patch
-#
-# 通过官方 CLI 安装时 ——
-#
-#   dsh plugin --profile <name> add dsh-manage-session
-#
-# —— 命令会把 `dsh-manage-session` 追加到 bundle 栈，profile 启动时合并本补丁
-# （单个 insert，插入本插件行）。
-- insert:
-    - id: dsh-manage-session
-      name: 'dsh-manage-session'
+# dsh-manage-session bundle patch
+#
+# 通过官方 CLI 安装时 ——
+#
+#   dsh plugin --profile web add dsh-manage-session
+#
+# —— 命令会把 `dsh-manage-session` 追加到 bundle 栈，profile 启动时合并本补丁
+# （单个 insert，插入本插件行）。
+#
+# 注:P1「替换官方 workspace 注册表」已撤编(beta.8-12 实测桌面宿主对用户层
+# 禁用核心服务行会触发 INACTIVE_EFFECT 启动致命)——归档/取消归档的即时生效
+# 不依赖替换(官方 archiveSession/unarchiveSession 内存 API);仅删除保留
+# 文件路径语义(操作后需重启侧栏生效)。子类源码留存 src/host/registry/ 备查。
+- insert:
+    - id: dsh-manage-session
+      name: 'dsh-manage-session'

package/dsh.plugin.json

@@ -1,10 +1,10 @@
 {
   "id": "dsh-manage-session",
   "name": "dsh-manage-session",
-  "version": "0.5.1",
+  "version": "0.5.4",
   "description": {
-    "en": "Session Steward (DSH 0.2.0 line): 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": "会话管家（DSH 0.2.0 专线）：浏览并批量清理官方会话归档集合，并对会话做四门体检，最终给出可逆、先备份的处方。不改写会话日志。"
+    "en": "Session Steward (merged package): archive browsing & cleanup, a four-gate session health checkup with reversible prescriptions, plus an independent FTS5 content-search index (title/content modes, incremental sync, non-destructive rebuild, snapshot export/import). Never rewrites session logs.",
+    "zh": "会话管家（合并包）：归档浏览与清理、四门体检（可逆处方），外加独立 FTS5 会话内容搜索（标题/内容双模式、增量同步、非破坏性整理、快照导入导出）。不改写会话日志。"
   },
   "homepage": "https://github.com/drscrewdriver/dsh-manage-session",
   "repository": {
@@ -13,7 +13,7 @@
   },
   "license": "MIT",
   "engines": {
-    "dsh": ">=0.2.0-rc.1 <0.2.1-0"
+    "dsh": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2"
   },
   "components": {
     "host": "lib/index.js",