dsh-manage-session 2.0.3 → 2.0.4

package/CHANGELOG.ja.md

@@ -1,33 +1,33 @@
-# Changelog
-
-## 1.0.0
-
-`dsh-session-steward` 0.5.7 から複製・改名した独立パッケージの初版です（旧パッケージの履歴は
-そのリポジトリの CHANGELOG を参照）。本パッケージの位置づけは**セッションマネージャー**：
-アクティブ／アーカイブ済みセッションの統合管理と全文検索。
-
-### 位置づけと命名
-
-- パッケージ名 / プラグイン id：`dsh-session-steward` → `dsh-manage-session`。表示名：セッション管理（9 言語同期）。
-- 設定名前空間：`session-steward` → `manage-session`、`switch-search` → `manage-session-search`。
-- ルート接頭辞：`/session-steward/api` → `/manage-session/api`、`/switch-search/api` → `/manage-session-search/api`。
-- ストレージ：索引・墓碑の既定ディレクトリ `~/.dsh-switch-search` → `~/.dsh-manage-session-index`、
-  お気に入り `session-steward-favorites.json` → `manage-session-favorites.json`（旧パッケージと干渉しません）。
-- スタイル接頭辞 `dss_`/`dsws_` → `dms_`/`dmss_`。スタイルシート id と data 属性も改名。
-
-### 新規：入口の位置（上部ツール枠 / 下部フォールバック）
-
-- ホストが上部ツール行（`sidebar.panellist` パネル行 + `main` ページ枠）を宣言している場合、
-  検索と管理の 2 つの入口を**パネル行**として「プラグイン」行の直後、「その他」ランチャーの手前
-  （order 5 / 6）に配置し、クリックでメイン列に全ページ表示。ページ内「閉じる」で会話に戻ります。
-- その枠が無いホスト（旧ライン／簡易レイアウト）ではサイドバー下部（`sidebar.footer.action`）に
-  フォールバックし、フローティングダイアログを開きます。
-- 判定はロード時（`slots.specDynamic` で両席を確認）。枠が後から現れた場合は下部入口を外して上部へ切替。
-- パネル行／ページは設定スイッチ（`enabled` / `search` / `healthCheck`）に連動し、切替は即時反映。
-
-### 付随変更
-
-- パネルに全ページ形態（`variant: 'page'`）を追加：遮罩と浮動配置を外しメイン列を埋めます。ダイアログ形態は不変。
-- ドキュメント刷新：README / INSTALL を 4 言語で同期（位置づけ・入口・ルート・設定表）。互換節は
-  `scripts/sync-hosts.mjs` の単一ソース生成のまま。
-- 対応ホストのホワイトリストは不変：`engines.dsh` は 0.1.0-rc.2 〜 0.2.1-rc.3 の rc 列挙。
+# Changelog
+
+## 1.0.0
+
+`dsh-session-steward` 0.5.7 から複製・改名した独立パッケージの初版です（旧パッケージの履歴は
+そのリポジトリの CHANGELOG を参照）。本パッケージの位置づけは**セッションマネージャー**：
+アクティブ／アーカイブ済みセッションの統合管理と全文検索。
+
+### 位置づけと命名
+
+- パッケージ名 / プラグイン id：`dsh-session-steward` → `dsh-manage-session`。表示名：セッション管理（9 言語同期）。
+- 設定名前空間：`session-steward` → `manage-session`、`switch-search` → `manage-session-search`。
+- ルート接頭辞：`/session-steward/api` → `/manage-session/api`、`/switch-search/api` → `/manage-session-search/api`。
+- ストレージ：索引・墓碑の既定ディレクトリ `~/.dsh-switch-search` → `~/.dsh-manage-session-index`、
+  お気に入り `session-steward-favorites.json` → `manage-session-favorites.json`（旧パッケージと干渉しません）。
+- スタイル接頭辞 `dss_`/`dsws_` → `dms_`/`dmss_`。スタイルシート id と data 属性も改名。
+
+### 新規：入口の位置（上部ツール枠 / 下部フォールバック）
+
+- ホストが上部ツール行（`sidebar.panellist` パネル行 + `main` ページ枠）を宣言している場合、
+  検索と管理の 2 つの入口を**パネル行**として「プラグイン」行の直後、「その他」ランチャーの手前
+  （order 5 / 6）に配置し、クリックでメイン列に全ページ表示。ページ内「閉じる」で会話に戻ります。
+- その枠が無いホスト（旧ライン／簡易レイアウト）ではサイドバー下部（`sidebar.footer.action`）に
+  フォールバックし、フローティングダイアログを開きます。
+- 判定はロード時（`slots.specDynamic` で両席を確認）。枠が後から現れた場合は下部入口を外して上部へ切替。
+- パネル行／ページは設定スイッチ（`enabled` / `search` / `healthCheck`）に連動し、切替は即時反映。
+
+### 付随変更
+
+- パネルに全ページ形態（`variant: 'page'`）を追加：遮罩と浮動配置を外しメイン列を埋めます。ダイアログ形態は不変。
+- ドキュメント刷新：README / INSTALL を 4 言語で同期（位置づけ・入口・ルート・設定表）。互換節は
+  `scripts/sync-hosts.mjs` の単一ソース生成のまま。
+- 対応ホストのホワイトリストは不変：`engines.dsh` は 0.1.0-rc.2 〜 0.2.1-rc.3 の rc 列挙。

package/CHANGELOG.ko.md

@@ -1,33 +1,33 @@
-# Changelog
-
-## 1.0.0
-
-`dsh-session-steward` 0.5.7에서 복제·개명한 독립 패키지의 첫 버전입니다(구 패키지 이력은 해당
-저장소 CHANGELOG 참조). 이 패키지의 정체성은 **세션 매니저**: 활성·보관 세션의 통합 관리와 전문 검색.
-
-### 정체성과 이름
-
-- 패키지명 / 플러그인 id: `dsh-session-steward` → `dsh-manage-session`. 표시 이름: 세션 관리(9개 언어 동기화).
-- 설정 네임스페이스: `session-steward` → `manage-session`, `switch-search` → `manage-session-search`.
-- 라우트 접두사: `/session-steward/api` → `/manage-session/api`, `/switch-search/api` → `/manage-session-search/api`.
-- 저장소: 색인·묘비 기본 디렉터리 `~/.dsh-switch-search` → `~/.dsh-manage-session-index`,
-  즐겨찾기 `session-steward-favorites.json` → `manage-session-favorites.json`(구 패키지와 충돌 없음).
-- 스타일 접두사 `dss_`/`dsws_` → `dms_`/`dmss_`. 스타일시트 id와 data 속성도 개명.
-
-### 신규: 진입점 위치(상단 도구 슬롯 / 하단 대체)
-
-- 호스트가 상단 도구 행(`sidebar.panellist` 패널 행 + `main` 페이지 슬롯)을 선언하면 검색·관리 두
-  진입점이 **패널 행**으로 「플러그인」 행 바로 뒤, 「더 보기」 런처 앞(order 5/6)에 놓이고 클릭 시
-  메인 열에 전체 페이지로 열립니다. 페이지의 「닫기」는 대화로 복귀합니다.
-- 해당 슬롯이 없는 호스트(구버전/간소 레이아웃)는 사이드바 하단(`sidebar.footer.action`)으로 대체되어
-  플로팅 대화상자를 엽니다.
-- 판정은 로드 시점(`slots.specDynamic`로 두 좌석 확인). 슬롯이 늦게 생기면 하단 진입점을 제거하고 상단 전환.
-- 패널 행/페이지는 설정 스위치(`enabled` / `search` / `healthCheck`)와 연동되어 즉시 반영됩니다.
-
-### 부수 변경
-
-- 패널에 전체 페이지 형태(`variant: 'page'`) 추가: 오버레이·부동 배치를 제거하고 메인 열을 채웁니다.
-  대화상자 형태는 그대로입니다.
-- 문서 개편: README / INSTALL 4개 언어 동기화(정체성·진입점·라우트·설정 표). 호환 절은
-  `scripts/sync-hosts.mjs` 단일 소스 생성 유지.
-- 지원 호스트 화이트리스트 불변: `engines.dsh`는 0.1.0-rc.2 ~ 0.2.1-rc.3 rc 열거.
+# Changelog
+
+## 1.0.0
+
+`dsh-session-steward` 0.5.7에서 복제·개명한 독립 패키지의 첫 버전입니다(구 패키지 이력은 해당
+저장소 CHANGELOG 참조). 이 패키지의 정체성은 **세션 매니저**: 활성·보관 세션의 통합 관리와 전문 검색.
+
+### 정체성과 이름
+
+- 패키지명 / 플러그인 id: `dsh-session-steward` → `dsh-manage-session`. 표시 이름: 세션 관리(9개 언어 동기화).
+- 설정 네임스페이스: `session-steward` → `manage-session`, `switch-search` → `manage-session-search`.
+- 라우트 접두사: `/session-steward/api` → `/manage-session/api`, `/switch-search/api` → `/manage-session-search/api`.
+- 저장소: 색인·묘비 기본 디렉터리 `~/.dsh-switch-search` → `~/.dsh-manage-session-index`,
+  즐겨찾기 `session-steward-favorites.json` → `manage-session-favorites.json`(구 패키지와 충돌 없음).
+- 스타일 접두사 `dss_`/`dsws_` → `dms_`/`dmss_`. 스타일시트 id와 data 속성도 개명.
+
+### 신규: 진입점 위치(상단 도구 슬롯 / 하단 대체)
+
+- 호스트가 상단 도구 행(`sidebar.panellist` 패널 행 + `main` 페이지 슬롯)을 선언하면 검색·관리 두
+  진입점이 **패널 행**으로 「플러그인」 행 바로 뒤, 「더 보기」 런처 앞(order 5/6)에 놓이고 클릭 시
+  메인 열에 전체 페이지로 열립니다. 페이지의 「닫기」는 대화로 복귀합니다.
+- 해당 슬롯이 없는 호스트(구버전/간소 레이아웃)는 사이드바 하단(`sidebar.footer.action`)으로 대체되어
+  플로팅 대화상자를 엽니다.
+- 판정은 로드 시점(`slots.specDynamic`로 두 좌석 확인). 슬롯이 늦게 생기면 하단 진입점을 제거하고 상단 전환.
+- 패널 행/페이지는 설정 스위치(`enabled` / `search` / `healthCheck`)와 연동되어 즉시 반영됩니다.
+
+### 부수 변경
+
+- 패널에 전체 페이지 형태(`variant: 'page'`) 추가: 오버레이·부동 배치를 제거하고 메인 열을 채웁니다.
+  대화상자 형태는 그대로입니다.
+- 문서 개편: README / INSTALL 4개 언어 동기화(정체성·진입점·라우트·설정 표). 호환 절은
+  `scripts/sync-hosts.mjs` 단일 소스 생성 유지.
+- 지원 호스트 화이트리스트 불변: `engines.dsh`는 0.1.0-rc.2 ~ 0.2.1-rc.3 rc 열거.

package/CHANGELOG.md

@@ -1,33 +1,33 @@
-# Changelog / 变更日志
-
-## 2.0.0
-
-**重定位：纯会话管理台。** 搜索/索引子域整体拆回 `dsh-search-index`，本包不再自建索引、
-不再依赖 DRS（`dsh-reference-session-collector`）。
-
-### 破坏性变化
-
-- 删除搜索子域：`/manage-session-search/api` 路由、FTS5 索引引擎/水位同步/重建/快照、
-  DRS 语料源、搜索面板与搜索设置卡、搜索入口与搜索页全部移除。
-- 依赖：移除 `dsh-reference-session-collector`（dependencies + pluginDependencies）与
-  `better-sqlite3`（optional）。
-- 设置：命名空间只剩 `manage-session`；字段删 `search` / `defaultMode` / `autoSync` /
-  `syncIntervalMs` / `archiveKeep` / `indexDir` / `corpusSource` / `drsBaseUrl`。
-- 新方法 `session-catalog`：管理台语料改由宿主 `sessionQuery` + 官方归档集合现场拼装
-  （活跃/归档同表，归档标记 = 归档集合成员）。
-- `session-health-status` 的 switches 增补 `directDelete`（会话菜单删除行的探针面）。
-
-### 入口位次
-
-- 顶栏工具行（`sidebar.panellist` + `main`）→ 单枚面板行 order 6，落在「插件」之后、
-  「更多」之前，点击在主栏整页打开；无该槽位 → 回落底栏对话框。
-- 席位能力用 `inject` 探测（不依赖 `specDynamic`，避免服务面不暴露/装载序问题）。
-
-### 配套
-
-- 字典：`manage-locales.ts` 只保留管理台键集（9 语，含 star.on/star.off）。
-- 文档：README 四语重写；INSTALL 命令不变；兼容句仍由 `scripts/sync-hosts.mjs` 单源生成。
-
-## 1.0.1 / 1.0.0
-
-独立包首发（由 `dsh-session-steward` 0.5.7 复制改名而来），当时仍为合并包（含搜索子域）。
+# Changelog / 变更日志
+
+## 2.0.0
+
+**重定位：纯会话管理台。** 搜索/索引子域整体拆回 `dsh-search-index`，本包不再自建索引、
+不再依赖 DRS（`dsh-reference-session-collector`）。
+
+### 破坏性变化
+
+- 删除搜索子域：`/manage-session-search/api` 路由、FTS5 索引引擎/水位同步/重建/快照、
+  DRS 语料源、搜索面板与搜索设置卡、搜索入口与搜索页全部移除。
+- 依赖：移除 `dsh-reference-session-collector`（dependencies + pluginDependencies）与
+  `better-sqlite3`（optional）。
+- 设置：命名空间只剩 `manage-session`；字段删 `search` / `defaultMode` / `autoSync` /
+  `syncIntervalMs` / `archiveKeep` / `indexDir` / `corpusSource` / `drsBaseUrl`。
+- 新方法 `session-catalog`：管理台语料改由宿主 `sessionQuery` + 官方归档集合现场拼装
+  （活跃/归档同表，归档标记 = 归档集合成员）。
+- `session-health-status` 的 switches 增补 `directDelete`（会话菜单删除行的探针面）。
+
+### 入口位次
+
+- 顶栏工具行（`sidebar.panellist` + `main`）→ 单枚面板行 order 6，落在「插件」之后、
+  「更多」之前，点击在主栏整页打开；无该槽位 → 回落底栏对话框。
+- 席位能力用 `inject` 探测（不依赖 `specDynamic`，避免服务面不暴露/装载序问题）。
+
+### 配套
+
+- 字典：`manage-locales.ts` 只保留管理台键集（9 语，含 star.on/star.off）。
+- 文档：README 四语重写；INSTALL 命令不变；兼容句仍由 `scripts/sync-hosts.mjs` 单源生成。
+
+## 1.0.1 / 1.0.0
+
+独立包首发（由 `dsh-session-steward` 0.5.7 复制改名而来），当时仍为合并包（含搜索子域）。

package/INSTALL.ja.md

@@ -1,164 +1,164 @@
-# インストールガイド（公式 DSH CLI）
-
-本ガイドは公式 DSH の `dsh plugin` コマンドのみを使用します。このコマンドは依存関係を profile にインストールし、`dsh.profile.bundles` を同期します。素の `npm install`、profile 内での直接の `pnpm add`、profile マニフェストの手動編集で置き換えないでください。
-
-- [英語インストールガイド](./INSTALL.md)
-- [中国語インストールガイド](./INSTALL.zh.md)
-- [日本語インストールガイド](./INSTALL.ja.md)
-- [韓国語インストールガイド](./INSTALL.ko.md)
-- [中国語 README](./README.md)
-- [英語 README](./README.en.md)
-- [日本語 README](./README.ja.md)
-- [韓国語 README](./README.ko.md)
-- [変更履歴](./CHANGELOG.md)
-- [日本語の変更履歴](./CHANGELOG.ja.md)
-- [韓国語の変更履歴](./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 が `web` のように pnpm ワークスペースのルートである場合、`-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` ルートと設定名前空間を登録し、またアーカイブの取得元を再読み込みしない限り整理（prune）の結果は反映されません。
-
-## 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 の `dsh plugin` コマンドのみを使用します。このコマンドは依存関係を profile にインストールし、`dsh.profile.bundles` を同期します。素の `npm install`、profile 内での直接の `pnpm add`、profile マニフェストの手動編集で置き換えないでください。
+
+- [英語インストールガイド](./INSTALL.md)
+- [中国語インストールガイド](./INSTALL.zh.md)
+- [日本語インストールガイド](./INSTALL.ja.md)
+- [韓国語インストールガイド](./INSTALL.ko.md)
+- [中国語 README](./README.md)
+- [英語 README](./README.en.md)
+- [日本語 README](./README.ja.md)
+- [韓国語 README](./README.ko.md)
+- [変更履歴](./CHANGELOG.md)
+- [日本語の変更履歴](./CHANGELOG.ja.md)
+- [韓国語の変更履歴](./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 が `web` のように pnpm ワークスペースのルートである場合、`-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` ルートと設定名前空間を登録し、またアーカイブの取得元を再読み込みしない限り整理（prune）の結果は反映されません。
+
+## 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