dsh-manage-session 0.5.7 → 2.0.4

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 范围：`>=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 范围：`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,34 +1,44 @@
-# dsh-manage-session (Session Steward)
+# dsh-manage-session (Session Manager)
 
-A DSH web plugin for the **session management console** and **session health checks**. It never touches session data itself.
+> **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).
 
-- **Manage (session console, main tab)** — all sessions grouped by workspace with an
-  archived-domain filter; select rows to batch archive, un-archive (array-only, reversible)
-  or purge (deletes on-disk entities, irreversible; backup + atomic replace, a DSH restart
-  is required for the host to reload the store file).
-  (2026-10-20 UI change: the former standalone "Retirement Home" tab was merged into this page.)
-- **Checkup (health, secondary tab)** — four gates → prescription (command list) → discharge (reversible repair with a
-  before/after comparison).
+A DSH web plugin: **one console over active and archived sessions + a four-gate checkup**.
 
-> 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.
+- **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 -->
-## Screenshots
+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 (enumerated peers — a per-rc tested whitelist; alpha/beta releases are out of scope).
+<!-- hosts-sync:end -->
 
-A **Session Steward** entry sits next to Search and Settings at the bottom of the sidebar:
+## Screenshots
 
-![Sidebar entry](assets/left-sidebar.png)
+**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):
 
-**Manage (main tab)** — sessions grouped by workspace with active/archived/favorite filters, each row
-carrying its size and whether the on-disk entity still exists; select rows to batch archive, un-archive or purge:
+![Session console](assets/new-manager.png)
 
-**Checkup (secondary tab)** — the entry point of the four-gate checkup, which ends in a reversible prescription:
+**Historical forms** (for lineage only, not the current UI):
 
-![Checkup](assets/doctor.png)
+| 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
 
@@ -36,45 +46,30 @@ carrying its size and whether the on-disk entity still exists; select rows to ba
 dsh plugin --profile web add dsh-manage-session
 ```
 
-Restart the host process afterwards (refreshing the page is not enough).
+Restart the host process afterwards.
 
 ## 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)
+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`.
 
-| Switch | Field | When off |
-|---|---|---|
-| Session history files | `historyFiles` (default true) | `session-history-*` is not registered (the UI tab was merged into Manage on 2026-10-20 and no longer gates a tab) |
-| Health check | `healthCheck` (default true) | `session-health-*` is not registered and the Checkup tab is not rendered |
+## Settings
 
-Closed domains return `{ ok: false, error: '子域已关闭（…=false）：<method> 未注册' }` — no empty shells.
+Namespace `manage-session`: `enabled`, `historyFiles`, `healthCheck`, `directDelete`.
 
-## Contract with `dsh-search-index`
+## Storage
 
-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`.
+- `~/.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
+pnpm test          # host half
+pnpm test:client   # client half (build first)
 pnpm build
 ```
 

package/README.ja.md

@@ -1,77 +1,53 @@
-# dsh-manage-session（セッション・スチュワード）
+# dsh-manage-session（セッションマネージャー）
 
-**セッション履歴ファイル**と**セッション健康チェック**のための DSH Web プラグインです。セッションデータそのものには一切触れません。
+> **旧名**：`dsh-session-steward`（セッション・スチュワード）。2.0.0 で `dsh-manage-session` に改名し、
+> 検索／索引は [`dsh-search-index`](https://github.com/drscrewdriver/dsh-search-index) に戻しました。
 
-- **カルテ室（履歴ファイル）** — 公式アーカイブ集合を閲覧し、ID を一括整理します
-  （バックアップ + アトミック置換。ホストに再読み込みさせるには DSH の再起動が必要です）。
-- **健診（健康チェック）** — 四つのゲート → 処方（コマンド一覧）→ 退院（before/after 比較を伴う
-  可逆的な修復）。
+DSH Web プラグイン：**アクティブ／アーカイブ済みセッションの統合管理台＋セッション健診**。
 
-> 命名の境界：**本パッケージは検索・インデックス機能を一切提供しません**。検索／インデックスは
-> `dsh-search-index` に属し、双方が相手のフィールドに言及したり再解釈したりすることはありません。
+- **管理（メインページ）** — ワークスペース別に活性＋アーカイブのセッションを一覧。ドメイン
+  フィルタ（すべて／アクティブ／アーカイブ）、タイトル絞り込み、お気に入り、一括のアーカイブ／
+  解除／実体削除（不可逆）。
+- **健診（補助タブ）** — 四つのゲート → 処方 → 退院（可逆な処置）。
 
-## スクリーンショット
-
-サイドバー下部に **「会话管家」**（セッション・スチュワード）のエントリが追加され、検索・設定と並びます：
-
-![サイドバーのエントリ](assets/left-sidebar.png)
-
-**カルテ室（履歴ファイル）** — 公式アーカイブ集合の一覧。各行にサイズとディスク上の実体の有無を表示し、選択してアーカイブ解除または整理ができます：
+> **検索・索引は本パッケージに含まず、DRS 依存もありません**：検索は `dsh-search-index` が担当。
+> 管理台の語料はホストの `sessionQuery` と公式アーカイブ集合から `session-catalog` が組み立てます。
 
-![カルテ室](assets/archive.png)
+## 入口の位置（上部ツール枠 / 下部フォールバック）
 
-**健診** — 四つのゲートによる健診の入口。スキャン後に可逆的な処方を提示します：
+| ホストの能力 | 入口の形 |
+|---|---|
+| 上部ツール行（`sidebar.panellist` + `main`）を宣言 | 「プラグイン」の直後、「その他」の手前（order 6）に**パネル行**。クリックでメイン列に全ページ表示 |
+| 枠が無いホスト | サイドバー下部（`sidebar.footer.action`）にフォールバックし、ダイアログを開く |
 
-![健診](assets/doctor.png)
-
-## インストール
-
-```bash
-dsh plugin --profile web add dsh-manage-session
-```
+<!-- 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 -->
 
-その後、ホストプロセスを再起動してください（ページの再読み込みでは不十分です）。
-
-## ルート
-
-プレフィックスは `/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-*` は登録されず、健診タブも描画されない |
+**現在の形** —— 入口はサイドバー上部のツール行（「プラグイン」の後、「その他」の前）。開くとセッション管理台：
+ワークスペース別の 3 列カード、ワークスペース／検索域（すべて・アクティブ・アーカイブ）の絞り込み、お気に入り、
+選択行の一括アーカイブ・解除・整理（不可逆な操作は 2 回確認）：
 
-閉じられたドメインは `{ ok: false, error: '子域已关闭（…=false）：<method> 未注册' }` を返します — 空の殻は残しません。
+![セッション管理台](assets/new-manager.png)
 
-## `dsh-search-index` との契約
+**過去の形**（沿革の参照用。現行 UI ではありません）：
 
-アーカイブファイル形式（`~/.dsh/storages/workspace.json` の `global.archivedSessionIds`）は、
-**本プラグインが書き込み、検索インデックスプラグインは読み取りのみ**です。詳細は
-`dsh-docs-deliverables/dsh-归档文件格式契约-20260914.md` を参照してください。
+| 統合パッケージ期（1.x：検索同梱・2 タブダイアログ・終了） | さらに以前（≤0.5.7：入口はサイドバー下部） |
+|---|---|
+| ![旧 2 タブダイアログ](assets/old-archive.png) | ![旧サイドバー下部入口](assets/left-sidebar-old.png) |
 
-## 開発
+## インストール／設定／開発
 
 ```bash
-pnpm install
-pnpm typecheck
-pnpm test
-pnpm build
+dsh plugin --profile web add dsh-manage-session   # インストール後に再起動
+pnpm install && pnpm typecheck && pnpm test && pnpm build
 ```
 
+設定名前空間 `manage-session`：`enabled`、`historyFiles`、`healthCheck`、`directDelete`。
+
 ## ライセンス
 
 MIT