dsh-manage-session 0.0.0-stage → 2.0.3

package/INSTALL.zh.md

@@ -0,0 +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

package/LICENSE

@@ -0,0 +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.

package/README.en.md

@@ -0,0 +1,64 @@
+# 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

package/README.ja.md

@@ -0,0 +1,39 @@
+# 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

package/README.ko.md

@@ -0,0 +1,38 @@
+# dsh-manage-session (세션 매니저)
+
+> **이전 이름**: `dsh-session-steward`(세션 스튜어드). 2.0.0에서 `dsh-manage-session`로 개명했고,
+> 검색/색인은 [`dsh-search-index`](https://github.com/drscrewdriver/dsh-search-index)로 되돌렸습니다.
+
+DSH 웹 플러그인: **활성·보관 세션 통합 관리대 + 세션 건강 점검**.
+
+- **관리(메인 페이지)** — 워크스페이스별 활성+보관 세션 목록, 도메인 필터, 제목 필터, 즐겨찾기,
+  일괄 보관/해제/실제 삭제(되돌릴 수 없음).
+- **점검(보조 탭)** — 네 게이트 → 처방 → 퇴원(되돌릴 수 있는 조치).
+
+> **검색·색인은 이 패키지에 없고 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

package/README.md

@@ -1,3 +1,101 @@
-# Temporary Holding Version
+# dsh-manage-session（会话管理台 / Session Manager）
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+> **原名**：`dsh-session-steward`（会话管家）。本仓库自 2.0.0 起改名为 `dsh-manage-session`，
+> 并把搜索/索引能力拆回 [`dsh-search-index`](https://github.com/drscrewdriver/dsh-search-index)。
+
+DSH Web 插件：**活跃与归档会话的统一管理台 + 四门体检**。
+
+- **管理（主页面）** —— 按工作区分组列出**活跃 + 归档**会话：域筛选（全部 / 活跃 / 归档）、
+  标题过滤、收藏，勾选后批量执行三个**互不等价**的操作 —— 归档、取消归档、
+  清理归档文件（真删磁盘，不可逆）。每行给出标题、工作区与时间。
+- **体检（备用页签）** —— 四门体检 → 处方（命令清单）→ 出院（可逆处置 + before/after）。
+
+> 只做**可逆处置**：不改写会话日志、不改历史数据、不静默丢字段。
+>
+> **本包不含搜索/索引，也不依赖 DRS**：会话检索（标题 / 内容 FTS5、命中定位）由
+> `dsh-search-index` 提供，DRS（`dsh-reference-session-collector`）依赖也在那边。
+> 管理台的语料由 `session-catalog` 现场从宿主 `sessionQuery` + 官方归档集合拼装。
+
+## 入口位次（顶栏工具槽 / 底栏回落）
+
+| 宿主能力 | 入口形态 |
+|---|---|
+| 侧栏声明了顶部工具行槽位（`sidebar.panellist` 面板行 + `main` 整页槽，0.1.7+/0.2.x 的「插件 / 更多」工具行） | 入口作为**面板行**落在「插件」行之后、「更多」启动器之前（order 6），行内 icon + 文案默认左对齐；点击在主栏**整页**打开，页内「关闭」回到会话 |
+| 宿主没有该槽位（老线 / 精简布局） | 回落侧栏**底栏** `sidebar.footer.action`，点击开浮动对话框 |
+
+判定在装载时做（`inject` 探测两席位是否已声明）；宿主稍后才声明槽位时，底栏入口会就地撤下
+并切换到顶栏，不会两份并存。两路都受设置开关驱动，开关翻转即时生效。
+
+<!-- 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、0.2.1-rc.3（枚举 peer，逐 rc 实测白名单；alpha/beta 不在支持范围）。
+<!-- hosts-sync:end -->
+
+## 安装
+
+```bash
+dsh plugin --profile web add dsh-manage-session
+# 或本地 tgz
+dsh plugin --profile web add "file:E:/test/rewrite-agently/mine-dsh-plugins/dsh-manage-session/dsh-manage-session-2.0.0.tgz"
+```
+
+安装后**必须重启宿主进程**（仅刷新页面无效）。
+
+## 路由契约
+
+前缀 `/manage-session/api`，方法名一律 `session-*`；未识别的方法返回显式错误，绝不静默。
+
+| 方法 | 作用 |
+|---|---|
+| `session-catalog` | 管理台语料（活跃 + 归档同表；`sessionQuery` + 归档集合现场拼装） |
+| `session-history-list` | 列出归档集合（存储文件优先；含来源、降级、按行体积与 `pendingRestart`） |
+| `session-history-archive` | 批量归档（内存 API 优先，文件降级） |
+| `session-history-prune` | **取消归档状态**：从归档数组批量移除 id（可逆，需重启） |
+| `session-history-purge` | **清理归档文件**：真删转录目录 + 投影缓存 + 两处 id（**不可逆**） |
+| `session-history-favorites-list` / `-favorite-set` | 收藏集合读写（JSON 域） |
+| `session-health-status` | 开关状态与方法表（面板与删除行探针用，含 `directDelete`） |
+| `session-health-scan` / `-session` / `-repair` / `-source-migrate` | 批量体检、单会话报告、可逆处置、署名迁移 |
+
+## 设置
+
+命名空间：`manage-session`。
+
+| 开关 | 字段 | 关闭效果 |
+|---|---|---|
+| 启用插件 | `enabled`（默认 true） | 不注册任何接口，入口整体消失 |
+| 会话历史文件 | `historyFiles`（默认 true） | 不注册 `session-history-*` |
+| 健康检查 | `healthCheck`（默认 true） | 不注册 `session-health-*`，不渲染「体检」页签 |
+| 行内删除 | `directDelete`（默认 false） | 侧栏会话菜单不出现「删除」行（破坏性入口默认关） |
+
+## 存储
+
+| 路径 | 内容 |
+|---|---|
+| `~/.dsh/storages/manage-session-favorites.json` | 收藏集合（按 sessionId） |
+| `~/.dsh/storages/workspace.json` | 归档数组与工作区成员表（**宿主文件**，本插件写入前自动备份） |
+
+## 四门体检
+
+| gate | 判据 | level |
+|---|---|---|
+| `log-integrity` | zstd 多帧扫描 → provenance 展开 → 打包行解包；seq 连续、无撕裂尾帧 | 有读取问题 `fail`；仅撕裂尾帧 `warn` |
+| `projection-cache` | `~/.dsh/storages/session_projcache/sessions/<id>.json` 的 `minSeq` 与日志末 seq 的 lag + 未结算字段 | 滞后且未结算 `fail`；任一 `warn` |
+| `lossless-json` | 热态 `sessionProjections.checkpoint(session)` 逐行判定无损 JSON | 命中 `fail`，并给出投影 key → 归属包 |
+| `cold-read` | 最后 `turn/end` 的原因、是否存在未收尾 open step | open step `fail`；interrupted/无 turn/end `warn` |
+
+**处方**只给三件可逆的事：① 隔离损坏的投影缓存记录（先备份）② 含未结算 step 时提示等待宿主结算
+③ 输出可执行命令清单。**禁止**：改写会话日志、改历史数据、静默丢弃字段。
+
+## 开发
+
+```bash
+pnpm install
+pnpm typecheck     # tsc -b --pretty false
+pnpm test          # vitest run（宿主半）
+pnpm test:client   # 浏览器半身注册 / 字典断言（需先 build）
+pnpm build         # tsc -b && tsdown → lib/index.js + lib/client.js
+```
+
+## 许可
+
+MIT

package/cordis.patch.yml

@@ -0,0 +1,19 @@
+# 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/ 备查。
+#
+# 客户端口不使用本补丁: 入口位次由客户端半身自行判定(宿主声明
+# `sidebar.panellist` + `main` 两个席位 → 顶栏面板行;否则回落底栏)。
+- insert:
+    - id: dsh-manage-session
+      name: 'dsh-manage-session'

package/dsh.plugin.json

@@ -0,0 +1,22 @@
+{
+  "id": "dsh-manage-session",
+  "name": "dsh-manage-session",
+  "version": "2.0.3",
+  "description": {
+    "en": "Session Manager: one console over active and archived sessions (browse, filter, favorite, archive/unarchive, batch purge, delete) plus a four-gate session health checkup. The entry sits in the sidebar top tool slot right after the Plugins row when the host provides one, and falls back to the footer otherwise. No index of its own and no DRS dependency — search lives in dsh-search-index. Never rewrites session logs. (formerly dsh-session-steward)",
+    "zh": "会话管理台：一屏管理活跃与归档会话（列表、筛选、收藏、归档与取消归档、批量清理、删除），外加四门会话体检。宿主提供侧栏顶部工具槽位时入口落在「插件」行之后，否则回落底栏。不自建索引、不依赖 DRS——搜索能力在 dsh-search-index。不改写会话日志。（原名 dsh-session-steward）"
+  },
+  "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.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"
+  },
+  "components": {
+    "host": "lib/index.js",
+    "client": "lib/client.js"
+  }
+}