dsh-manage-session 2.0.3 → 2.0.5

package/INSTALL.zh.md

@@ -1,164 +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)
-- [中文 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 范围：`engines.dsh` 的逐 rc 枚举白名单（`0.1.0-rc.2` … `0.2.1-rc.3`，逐版本实测）。**
->
-> 该范围同时写在 `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@1.0.0 -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@1.0.0
-```
-
-## 2. 重启宿主
-
-**安装或升级后必须重启 DSH。** 仅刷新浏览器页面无效：宿主半身在启动时注册 `/manage-session/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` 可用，设置区使用 `manage-session` 命名空间。请确认：
-
-1. 两个开关均开启时，**养老院**与**体检**两个页签都会渲染。
-2. 关闭 `historyFiles` 后「养老院」页签消失，且所有 `session-history-*` 调用返回显式的 disabled 错误。
-3. 关闭 `healthCheck` 后「体检」页签消失，且所有 `session-health-*` 调用返回显式的 disabled 错误。
-4. 对 `/manage-session/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 范围：`engines.dsh` 的逐 rc 枚举白名单（`0.1.0-rc.2` … `0.2.1-rc.3`，逐版本实测）。**
+>
+> 该范围同时写在 `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@1.0.0 -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@1.0.0
+```
+
+## 2. 重启宿主
+
+**安装或升级后必须重启 DSH。** 仅刷新浏览器页面无效：宿主半身在启动时注册 `/manage-session/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` 可用，设置区使用 `manage-session` 命名空间。请确认：
+
+1. 两个开关均开启时，**养老院**与**体检**两个页签都会渲染。
+2. 关闭 `historyFiles` 后「养老院」页签消失，且所有 `session-history-*` 调用返回显式的 disabled 错误。
+3. 关闭 `healthCheck` 后「体检」页签消失，且所有 `session-health-*` 调用返回显式的 disabled 错误。
+4. 对 `/manage-session/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,64 +1,78 @@
-# dsh-manage-session (Session Manager)
-
-> **Former name**: `dsh-session-steward` (Session Steward). Renamed to `dsh-manage-session` at 2.0.0;
-> search/indexing moved back to [`dsh-search-index`](https://github.com/drscrewdriver/dsh-search-index).
-
-A DSH web plugin: **one console over active and archived sessions + a four-gate checkup**.
-
-- **Manage (main page)** — sessions grouped by workspace, **active + archived**: domain filter
-  (all / active / archived), title filter, favorites, and batch archive / unarchive / purge
-  (real deletion, irreversible).
-- **Checkup (secondary tab)** — four gates → prescription → discharge (reversible repair).
-
-> Reversible operations only. **No search or index of its own, and no DRS dependency**:
-> retrieval (title/content FTS5) belongs to `dsh-search-index`; the manage console builds its
-> corpus from the host `sessionQuery` service plus the official archive set (`session-catalog`).
-
-## Where the entry lives (top tool slot / footer fallback)
-
-| Host capability | Entry form |
-|---|---|
-| Sidebar declares the top tool row (`sidebar.panellist` + the `main` page slot — the Plugins / More row of 0.1.7+/0.2.x) | A **panel row** right after Plugins and before More (order 6), icon + label left-aligned; clicking opens a **full page**, Close returns to the conversation |
-| No such slot (older lines / reduced layouts) | Falls back to the sidebar **footer** (`sidebar.footer.action`) with a floating dialog |
-
+# dsh-manage-session (Session Manager)
+
+> **Former name**: `dsh-session-steward` (Session Steward). Renamed to `dsh-manage-session` at 2.0.0;
+> search/indexing moved back to [`dsh-search-index`](https://github.com/drscrewdriver/dsh-search-index).
+
+A DSH web plugin: **one console over active and archived sessions + a four-gate checkup**.
+
+- **Manage (main page)** — sessions grouped by workspace, **active + archived**: domain filter
+  (all / active / archived), title filter, favorites, and batch archive / unarchive / purge
+  (real deletion, irreversible).
+- **Checkup (secondary tab)** — four gates → prescription → discharge (reversible repair).
+
+> Reversible operations only. **No search or index of its own, and no DRS dependency**:
+> retrieval (title/content FTS5) belongs to `dsh-search-index`; the manage console builds its
+> corpus from the host `sessionQuery` service plus the official archive set (`session-catalog`).
+
+## Where the entry lives (top tool slot / footer fallback)
+
+| Host capability | Entry form |
+|---|---|
+| Sidebar declares the top tool row (`sidebar.panellist` + the `main` page slot — the Plugins / More row of 0.1.7+/0.2.x) | A **panel row** right after Plugins and before More (order 6), icon + label left-aligned; clicking opens a **full page**, Close returns to the conversation |
+| No such slot (older lines / reduced layouts) | Falls back to the sidebar **footer** (`sidebar.footer.action`) with a floating dialog |
+
 <!-- 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, 0.2.1-rc.3 (enumerated peers — a per-rc tested whitelist; alpha/beta releases are out of scope).
-<!-- hosts-sync:end -->
-
-## Install
-
-```bash
-dsh plugin --profile web add dsh-manage-session
-```
-
-Restart the host process afterwards.
-
-## Routes
-
-Prefix `/manage-session/api`, methods named `session-*`:
-`session-catalog`, `session-history-list|archive|prune|purge`, `session-history-favorites-list` /
-`-favorite-set`, `session-health-status|scan|session|repair|source-migrate`.
-
-## Settings
-
-Namespace `manage-session`: `enabled`, `historyFiles`, `healthCheck`, `directDelete`.
-
-## Storage
-
-- `~/.dsh/storages/manage-session-favorites.json` — favorites
-- `~/.dsh/storages/workspace.json` — host-owned archive array + workspace membership (backed up before writes)
-
-## Development
-
-```bash
-pnpm install
-pnpm typecheck
-pnpm test          # host half
-pnpm test:client   # client half (build first)
-pnpm build
-```
-
-## License
-
-MIT
+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, 0.2.1-rc.3, 0.2.1-rc.4, 0.2.1-rc.5 (enumerated peers — a per-rc tested whitelist; alpha/beta releases are out of scope).
+<!-- hosts-sync:end -->
+
+## Screenshots
+
+**Current form** — the entry sits in the sidebar's top tool row (after Plugins, before More) and opens the
+session console: three-column cards grouped by workspace, workspace / domain (all · active · archived)
+filters, favorites, and batch archive · unarchive · purge on the selection (destructive steps ask twice):
+
+![Session console](assets/new-manager.png)
+
+**Historical forms** (for lineage only, not the current UI):
+
+| Merged package era (1.x: search included, two-tab dialog, retired) | Earlier (≤0.5.7: entry at the sidebar foot) |
+|---|---|
+| ![Old two-tab dialog](assets/old-archive.png) | ![Old sidebar footer entry](assets/left-sidebar-old.png) |
+
+## Install
+
+```bash
+dsh plugin --profile web add dsh-manage-session
+```
+
+Restart the host process afterwards.
+
+## Routes
+
+Prefix `/manage-session/api`, methods named `session-*`:
+`session-catalog`, `session-history-list|archive|prune|purge`, `session-history-favorites-list` /
+`-favorite-set`, `session-health-status|scan|session|repair|source-migrate`.
+
+## Settings
+
+Namespace `manage-session`: `enabled`, `historyFiles`, `healthCheck`, `directDelete`.
+
+## Storage
+
+- `~/.dsh/storages/manage-session-favorites.json` — favorites
+- `~/.dsh/storages/workspace.json` — host-owned archive array + workspace membership (backed up before writes)
+
+## Development
+
+```bash
+pnpm install
+pnpm typecheck
+pnpm test          # host half
+pnpm test:client   # client half (build first)
+pnpm build
+```
+
+## License
+
+MIT

package/README.ja.md

@@ -1,39 +1,53 @@
-# dsh-manage-session（セッションマネージャー）
-
-> **旧名**：`dsh-session-steward`（セッション・スチュワード）。2.0.0 で `dsh-manage-session` に改名し、
-> 検索／索引は [`dsh-search-index`](https://github.com/drscrewdriver/dsh-search-index) に戻しました。
-
-DSH Web プラグイン：**アクティブ／アーカイブ済みセッションの統合管理台＋セッション健診**。
-
-- **管理（メインページ）** — ワークスペース別に活性＋アーカイブのセッションを一覧。ドメイン
-  フィルタ（すべて／アクティブ／アーカイブ）、タイトル絞り込み、お気に入り、一括のアーカイブ／
-  解除／実体削除（不可逆）。
-- **健診（補助タブ）** — 四つのゲート → 処方 → 退院（可逆な処置）。
-
-> **検索・索引は本パッケージに含まず、DRS 依存もありません**：検索は `dsh-search-index` が担当。
-> 管理台の語料はホストの `sessionQuery` と公式アーカイブ集合から `session-catalog` が組み立てます。
-
-## 入口の位置（上部ツール枠 / 下部フォールバック）
-
-| ホストの能力 | 入口の形 |
-|---|---|
-| 上部ツール行（`sidebar.panellist` + `main`）を宣言 | 「プラグイン」の直後、「その他」の手前（order 6）に**パネル行**。クリックでメイン列に全ページ表示 |
-| 枠が無いホスト | サイドバー下部（`sidebar.footer.action`）にフォールバックし、ダイアログを開く |
-
-<!-- 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, 0.2.1-rc.3 (enumerated peers — a per-rc tested whitelist; alpha/beta releases are out of scope).
-<!-- hosts-sync:end -->
-
-## インストール／設定／開発
-
-```bash
-dsh plugin --profile web add dsh-manage-session   # インストール後に再起動
-pnpm install && pnpm typecheck && pnpm test && pnpm build
-```
-
-設定名前空間 `manage-session`：`enabled`、`historyFiles`、`healthCheck`、`directDelete`。
-
-## ライセンス
-
-MIT
+# dsh-manage-session（セッションマネージャー）
+
+> **旧名**：`dsh-session-steward`（セッション・スチュワード）。2.0.0 で `dsh-manage-session` に改名し、
+> 検索／索引は [`dsh-search-index`](https://github.com/drscrewdriver/dsh-search-index) に戻しました。
+
+DSH Web プラグイン：**アクティブ／アーカイブ済みセッションの統合管理台＋セッション健診**。
+
+- **管理（メインページ）** — ワークスペース別に活性＋アーカイブのセッションを一覧。ドメイン
+  フィルタ（すべて／アクティブ／アーカイブ）、タイトル絞り込み、お気に入り、一括のアーカイブ／
+  解除／実体削除（不可逆）。
+- **健診（補助タブ）** — 四つのゲート → 処方 → 退院（可逆な処置）。
+
+> **検索・索引は本パッケージに含まず、DRS 依存もありません**：検索は `dsh-search-index` が担当。
+> 管理台の語料はホストの `sessionQuery` と公式アーカイブ集合から `session-catalog` が組み立てます。
+
+## 入口の位置（上部ツール枠 / 下部フォールバック）
+
+| ホストの能力 | 入口の形 |
+|---|---|
+| 上部ツール行（`sidebar.panellist` + `main`）を宣言 | 「プラグイン」の直後、「その他」の手前（order 6）に**パネル行**。クリックでメイン列に全ページ表示 |
+| 枠が無いホスト | サイドバー下部（`sidebar.footer.action`）にフォールバックし、ダイアログを開く |
+
+<!-- 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, 0.2.1-rc.3 (enumerated peers — a per-rc tested whitelist; alpha/beta releases are out of scope).
+<!-- hosts-sync:end -->
+
+## スクリーンショット
+
+**現在の形** —— 入口はサイドバー上部のツール行（「プラグイン」の後、「その他」の前）。開くとセッション管理台：
+ワークスペース別の 3 列カード、ワークスペース／検索域（すべて・アクティブ・アーカイブ）の絞り込み、お気に入り、
+選択行の一括アーカイブ・解除・整理（不可逆な操作は 2 回確認）：
+
+![セッション管理台](assets/new-manager.png)
+
+**過去の形**（沿革の参照用。現行 UI ではありません）：
+
+| 統合パッケージ期（1.x：検索同梱・2 タブダイアログ・終了） | さらに以前（≤0.5.7：入口はサイドバー下部） |
+|---|---|
+| ![旧 2 タブダイアログ](assets/old-archive.png) | ![旧サイドバー下部入口](assets/left-sidebar-old.png) |
+
+## インストール／設定／開発
+
+```bash
+dsh plugin --profile web add dsh-manage-session   # インストール後に再起動
+pnpm install && pnpm typecheck && pnpm test && pnpm build
+```
+
+設定名前空間 `manage-session`：`enabled`、`historyFiles`、`healthCheck`、`directDelete`。
+
+## ライセンス
+
+MIT