dsh-session-guard 0.4.0 → 3.0.0

package/CHANGELOG.ja.md

@@ -6,6 +6,25 @@
 - [日本語 changelog](./CHANGELOG.ja.md)
 - [한국어 changelog](./CHANGELOG.ko.md)
 
+## 0.4.0 — 2026-09-18（誤ったバージョン番号。3.0.0 に置き換え）
+
+### 修正
+
+- **バージョン識別**：本ラインは `0.4.0` として公開されましたが、`dsh.plugin.json` と本変更履歴は
+  すでに `3.0.0` を名乗っており、1 つの成果物に 2 つのバージョン番号が存在していました。
+  `package.json` を `3.0.0` に統一し、パッケージ版・マニフェスト版・変更履歴が一致しました。
+  npm のバージョンは不変のため `0.4.0` は歴史的記録として残します。`3.0.0` 公開後は
+  `dist-tag dsh-0.1.5` を `3.0.0` に向け直すべきです。
+- **ドキュメント**：README/INSTALL（zh/en/ja/ko）が兄弟ラインを `main` にあると説明していたのを
+  修正。0.1.2 ラインのリリースブランチは **`legacy/0.1.2`**（npm dist-tag `dsh-0.1.2`、
+  バージョン `0.3.1`）で、`main` は `0.2.0-beta.1` で凍結されています。INSTALL.zh/ja/ko の
+  重複したブランチ断片を修正し、dist-tag を明示したインストールコマンドを
+  記載。「2.x / 3.x」は**ラインの通称**でありバージョン番号ではないことを明記しました。
+
+### 備考
+
+- **ソース変更なし**（`3.0.0` 比）。`0.4.0` は同一ツリーのパッケージングのみの公開です。
+
 ## 3.0.0 — 2026-09-14
 
 ### 変更

package/CHANGELOG.ko.md

@@ -6,6 +6,25 @@
 - [日本語 changelog](./CHANGELOG.ja.md)
 - [한국어 changelog](./CHANGELOG.ko.md)
 
+## 0.4.0 — 2026-09-18 (잘못된 버전 번호, 3.0.0으로 대체됨)
+
+### 수정
+
+- **버전 식별**: 본 라인은 `0.4.0`으로 배포되었지만 `dsh.plugin.json`과 본 변경 기록은 이미
+  `3.0.0`을 표기하고 있어, 하나의 산출물에 두 개의 버전 번호가 존재했습니다. `package.json`을
+  `3.0.0`으로 통일하여 패키지 버전·매니페스트 버전·변경 기록이 일치합니다. npm 버전은 불변이므로
+  `0.4.0`은 역사적 기록으로 남깁니다. `3.0.0` 배포 후에는 `dist-tag dsh-0.1.5`를 `3.0.0`으로
+  다시 지정해야 합니다.
+- **문서**: README/INSTALL(zh/en/ja/ko)이 형제 라인을 `main`에 있다고 설명하던 것을 수정.
+  0.1.2 라인의 릴리스 브랜치는 **`legacy/0.1.2`**(npm dist-tag `dsh-0.1.2`, 버전 `0.3.1`)이며
+  `main`은 `0.2.0-beta.1`에서 동결되었습니다. INSTALL.zh/ja/ko의 중복된
+  브랜치 조각을 수정하고, dist-tag를 명시한 설치 명령을 기재했습니다.
+  "2.x / 3.x"는 **라인 통칭**이며 버전 번호가 아님을 명시.
+
+### 비고
+
+- **소스 변경 없음**(`3.0.0` 대비). `0.4.0`은 동일 트리의 패키징 전용 배포입니다.
+
 ## 3.0.0 — 2026-09-14
 
 ### 변경

package/CHANGELOG.md

@@ -6,6 +6,25 @@ All notable changes to `dsh-session-guard` are recorded here. Versions follow se
 - [日本語 changelog](./CHANGELOG.ja.md)
 - [한국어 changelog](./CHANGELOG.ko.md)
 
+## 0.4.0 — 2026-09-18 (mis-versioned; superseded by 3.0.0)
+
+### Fixed
+
+- **Version identity.** This line was published as `0.4.0` while `dsh.plugin.json` and this
+  changelog already said `3.0.0` — one artifact with two version numbers. `package.json` is now
+  `3.0.0`, so the package version, the manifest version and the changelog agree. `0.4.0` is kept
+  here as a historical record because npm versions are immutable; `dist-tag dsh-0.1.5` should be
+  repointed to `3.0.0` once it is published.
+- **Docs.** README/INSTALL (zh/en/ja/ko) no longer describe the sibling line as living on `main`.
+  The 0.1.2 line's release branch is **`legacy/0.1.2`** (npm dist-tag `dsh-0.1.2`, version `0.3.1`);
+  `main` is frozen at `0.2.0-beta.1`. The duplicated branch fragment in the INSTALL.zh/ja/ko install
+  command is fixed, explicit dist-tag install commands are documented, and "2.x / 3.x" is
+  now marked as a **line nickname** rather than a version number.
+
+### Notes
+
+- **No source changes** relative to `3.0.0`; `0.4.0` is a packaging-only publish of the same tree.
+
 ## 3.0.0 — 2026-09-14
 
 ### Changed

package/INSTALL.ja.md

@@ -22,11 +22,22 @@ dsh --version
 ## 1. インストール
 
 ```bash
-dsh plugin --profile web add github:drscrewdriver/dsh-session-guard#compat/0.1.5#compat/0.1.5
+dsh plugin --profile web add dsh-session-guard@dsh-0.1.5
+
+# または git ブランチを直接指定
+dsh plugin --profile web add github:drscrewdriver/dsh-session-guard#compat/0.1.5
 ```
 
-`compat/0.1.5` は DSH `0.1.5-rc.x` 専用ライン（3.x、`engines.dsh: >=0.1.5-rc.2 <0.2.0-0`）。`main` は
-引き続き DSH `0.1.0-rc.7` – `0.1.2-rc.1`（2.x / 0.2.x）を担当します。
+`compat/0.1.5` は DSH `0.1.5-rc.x` 専用ラインです：npm パッケージバージョン **`3.0.0`**、
+dist-tag **`dsh-0.1.5`**、`package.json` と `dsh.plugin.json` の `engines.dsh` はいずれも
+`>=0.1.5-rc.2 <0.2.0-0`。
+
+DSH `0.1.2-rc.x` ホストは **`legacy/0.1.2`** ブランチ（npm dist-tag `dsh-0.1.2`、バージョン `0.3.1`）
+を使用してください。`main` は `0.2.0-beta.1` で凍結済みで、**0.1.2 ラインのリリースブランチではありません**。
+
+> ⚠️ 裸のパッケージ名 `dsh-session-guard` に依存しないでください：npm の `latest` タグは
+> 排他的な 2 つのバージョンライン（`engines.dsh` が semver プレリリース照合で排他）を
+> 同時に提供できません。必ず dist-tag を明示してください。
 
 dsh web を再起動し、ページをリフレッシュ。
 

package/INSTALL.ko.md

@@ -22,11 +22,22 @@ dsh --version
 ## 1. 설치
 
 ```bash
-dsh plugin --profile web add github:drscrewdriver/dsh-session-guard#compat/0.1.5#compat/0.1.5
+dsh plugin --profile web add dsh-session-guard@dsh-0.1.5
+
+# 또는 git 브랜치 직접 지정
+dsh plugin --profile web add github:drscrewdriver/dsh-session-guard#compat/0.1.5
 ```
 
-`compat/0.1.5`는 DSH `0.1.5-rc.x` 전용 라인(3.x, `engines.dsh: >=0.1.5-rc.2 <0.2.0-0`)입니다. `main`은
-계속 DSH `0.1.0-rc.7` – `0.1.2-rc.1`(2.x / 0.2.x)을 담당합니다.
+`compat/0.1.5`는 DSH `0.1.5-rc.x` 전용 라인입니다: npm 패키지 버전 **`3.0.0`**,
+dist-tag **`dsh-0.1.5`**, `package.json`과 `dsh.plugin.json`의 `engines.dsh` 모두
+`>=0.1.5-rc.2 <0.2.0-0`.
+
+DSH `0.1.2-rc.x` 호스트는 **`legacy/0.1.2`** 브랜치(npm dist-tag `dsh-0.1.2`, 버전 `0.3.1`)를
+사용하세요. `main`은 `0.2.0-beta.1`에서 동결되었고 **0.1.2 라인의 릴리스 브랜치가 아닙니다**.
+
+> ⚠️ 맨 패키지명 `dsh-session-guard`에 의존하지 마세요: npm `latest` 태그는
+> 상호 배타적인 두 버전 라인(`engines.dsh`가 semver 프리릴리스 매칭상 배타)을
+> 동시에 제공할 수 없습니다. 반드시 dist-tag를 명시하세요.
 
 dsh web을 재시작하고 페이지를 새로고침.
 

package/INSTALL.md

@@ -24,11 +24,23 @@ dsh --version
 ## 1. Install
 
 ```bash
+dsh plugin --profile web add dsh-session-guard@dsh-0.1.5
+
+# or straight from the git branch
 dsh plugin --profile web add github:drscrewdriver/dsh-session-guard#compat/0.1.5
 ```
 
-`compat/0.1.5` is the DSH `0.1.5-rc.x` line (3.x, `engines.dsh: >=0.1.5-rc.2 <0.2.0-0`); `main` keeps
-serving DSH `0.1.0-rc.7` – `0.1.2-rc.1` (2.x / 0.2.x).
+`compat/0.1.5` is the DSH `0.1.5-rc.x` line: npm package version **`3.0.0`**, dist-tag
+**`dsh-0.1.5`**, with `engines.dsh = >=0.1.5-rc.2 <0.2.0-0` in **both** `package.json` and
+`dsh.plugin.json`.
+
+DSH `0.1.2-rc.x` hosts should use the **`legacy/0.1.2`** branch (npm dist-tag `dsh-0.1.2`,
+version `0.3.1`). **`main` is frozen at `0.2.0-beta.1` and is no longer the 0.1.2 line's
+release branch.**
+
+> ⚠️ Do not rely on the bare package name `dsh-session-guard`: npm's `latest` tag cannot
+> serve two mutually exclusive version lines (their `engines.dsh` ranges are exclusive under
+> semver prerelease matching) — always pin the dist-tag explicitly.
 
 Restart dsh web and refresh the page.
 
@@ -58,16 +70,17 @@ npm test
 
 ```bash
 dsh plugin --profile web remove dsh-session-guard
-dsh plugin --profile web add github:drscrewdriver/dsh-session-guard#compat/0.1.5
+dsh plugin --profile web add dsh-session-guard@dsh-0.1.5
 ```
 
 Restart dsh web and refresh the page. Settings live in `$DSH_HOME/settings.yaml` under the
 `session-guard` namespace and survive the upgrade; new keys (`providerGuard`, `deferredMode`, …)
 fall back to their defaults until you touch them.
 
-From `0.1.3`/`0.1.4-beta.1` to `0.1.5-beta.1` the only behavior change is that peak hours now
+From **plugin** `0.1.3` / `0.1.4-beta.1` to **plugin** `0.1.5-beta.1` the only behavior change is that peak hours now
 block **only** official-source targets by default. To restore the old blanket behavior set
 `providerGuard: false` (or `officialProviders` / `officialBaseURLs` to narrow the verdict).
+(Those are plugin versions, not DSH versions — do not confuse them with the host ranges above.)
 
 ## 4. Troubleshooting
 

package/INSTALL.zh.md

@@ -22,11 +22,20 @@ dsh --version
 ## 1. 安装
 
 ```bash
-dsh plugin --profile web add github:drscrewdriver/dsh-session-guard#compat/0.1.5#compat/0.1.5
+dsh plugin --profile web add dsh-session-guard@dsh-0.1.5
+
+# 或直接走 git 分支
+dsh plugin --profile web add github:drscrewdriver/dsh-session-guard#compat/0.1.5
 ```
 
-`compat/0.1.5` 是 DSH `0.1.5-rc.x` 专线（3.x，`engines.dsh: >=0.1.5-rc.2 <0.2.0-0`）；`main` 继续服务
-DSH `0.1.0-rc.7` – `0.1.2-rc.1`（2.x / 0.2.x）。
+`compat/0.1.5` 是 DSH `0.1.5-rc.x` 专线：npm 包版本号 **`3.0.0`**，dist-tag **`dsh-0.1.5`**，
+`package.json` 与 `dsh.plugin.json` 的 `engines.dsh` 均为 `>=0.1.5-rc.2 <0.2.0-0`。
+
+DSH `0.1.2-rc.x` 宿主请改用 **`legacy/0.1.2`** 分支（npm dist-tag `dsh-0.1.2`，版本 `0.3.1`）。
+`main` 已冻结在 `0.2.0-beta.1`，**不再是 0.1.2 线的发布分支**。
+
+> ⚠️ 不要依赖裸包名 `dsh-session-guard`：npm 的 `latest` 标签无法同时服务两条互斥版本线
+> （两条线的 `engines.dsh` 按 semver 预发布规则互斥），必须显式指定 dist-tag。
 
 重启 dsh web 并刷新页面。
 

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 dsh-session-guard contributors
-
-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 dsh-session-guard contributors
+
+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

@@ -82,11 +82,23 @@ A cordis plugin assembled via the `dsh plugin` command and a bundle patch — no
 ## Installation
 
 ```bash
+# DSH 0.1.5-rc.x hosts (this line, dist-tag dsh-0.1.5)
+dsh plugin --profile web add dsh-session-guard@dsh-0.1.5
+
+# or straight from the git branch
 dsh plugin --profile web add github:drscrewdriver/dsh-session-guard#compat/0.1.5
+
+# DSH 0.1.2-rc.x hosts must use the 0.1.2 line instead
+dsh plugin --profile web add dsh-session-guard@dsh-0.1.2
 ```
 
-`compat/0.1.5` is the DSH `0.1.5-rc.x` line (3.x); `main` keeps serving DSH `0.1.0-rc.7` – `0.1.2-rc.1`
-(2.x / 0.2.x).
+`compat/0.1.5` is the DSH `0.1.5-rc.x` line, npm version **`3.0.0`**. DSH `0.1.2-rc.x` hosts must
+use the **`legacy/0.1.2`** branch (npm dist-tag `dsh-0.1.2`, version `0.3.1`). **`main` is frozen at
+`0.2.0-beta.1` and is no longer the 0.1.2 line's release branch.**
+
+> ⚠️ Do not rely on the bare package name `dsh-session-guard`: npm's `latest` tag cannot serve two
+> mutually exclusive version lines (their `engines.dsh` ranges are exclusive under semver
+> prerelease matching) — always pin the dist-tag explicitly.
 
 Restart dsh web and refresh the page after installation.
 

package/README.ja.md

@@ -26,6 +26,29 @@
 
 > **互換性について：** v0.1.1 には日本語（`ja`）と韓国語（`ko`）の辞書が含まれていますが、現在の公式 DSH リリースは `LocaleRuntime` 経由で `zh` と `en` のみを提供しています。純正 DSH で `ja` または `ko` を選択すると `locale "<id>" is not registered` で失敗します。公式 DSH が对应的 locale ID を追加するまで利用できません。上級ユーザーは DSH フォークを保守して更新してください。
 
+> **▼ DSH バージョン適合**
+>
+> | DSH バージョン | ロード | 設定登録 | セッションイベント / ゲート | クライアント側 |
+> | --- | --- | --- | --- | --- |
+> | 0.1.0-rc.7 ~ 0.1.1-rc.x | ➖ 本ライン対象外（`legacy/0.1.2` 以前の歴史バージョン） | `ctx.settings.register(ns, schema, { base })` | ✅ 形状一致 | ✅ プラットフォーム値の import なし |
+> | 0.1.2-alpha.2+ / 0.1.2-rc.1 | ➖ 本ライン対象外 → `legacy/0.1.2`（npm `@dsh-0.1.2`） | `register` は維持（`installSection` 追加） | ✅ 形状一致 | ✅ プラットフォーム値の import なし |
+> | **0.1.5-rc.2** | ✅（**本ライン**、dist-tag `dsh-0.1.5`） | `register` は維持（文字列名前空間） | ✅ イベントは `snapshotEvents()` の二重経路で読み取り | ✅ |
+>
+> **本ラインの識別情報**：ブランチ `compat/0.1.5`、npm バージョン **`3.0.0`**（semver）、
+> dist-tag **`dsh-0.1.5`**。`package.json` と `dsh.plugin.json` の `engines.dsh`、および
+> 3 つの `@deepseek-ai/dsh-client-*` peer の下限は、いずれも `>=0.1.5-rc.2 <0.2.0-0` に統一されています。
+> 過去の README は「2.x / 3.x」を**ラインの呼称**として使っていましたが、それは叙述上の慣習であり、
+> **レジストリから取得できるバージョン番号ではありません**。npm バージョン `0.3.1`（0.1.2 ライン）と
+> `3.0.0`（0.1.5 ライン）を基準にしてください。
+>
+> **他ラインの落点**：DSH `0.1.2-rc.x` ホストはブランチ **`legacy/0.1.2`**（npm dist-tag
+> `dsh-0.1.2`、バージョン `0.3.1`）を使用してください。**`main` は `0.2.0-beta.1` で凍結済みで、
+> 0.1.2 ラインのリリースブランチではありません。** DSH `0.1.0-rc.7` ~ `0.1.1-rc.x` ホストは
+> `0.1.2` 以下の歴史バージョンを使用してください。フィールドソースの正規定義：
+> `mine-dsh-plugins/improve-dsh-plugins/DSH-PLUGIN-VERSION-DISTRIBUTION-STRATEGY.md` §2.2。
+>
+> ドリフトガード：`tools/check-api-drift.ps1`（本ラインは既定で `dsh-v0.1.5-rc.2` に対して必須 API の存在を検証）。
+
 > ピーク課金時間帯に実行中のセッションを自動一時停止し、オフピーク/週末に自動再開。input-traffic の凍結ボタンと連携して**セッション級**ロックを実現。バックエンド**自動リトライ**は凍結/ゲート期間中は譲歩。カスタムセッションゲート（`agent.cancel keepInbox + goals.pause + session/event 安全境界 + followup 再開`）に基づき、dsh-task-control に依存しません。
 
 `dsh plugin` コマンドで组装 + バンドルパッチで装配する cordis プラグイン。dsh ソース変更も PR も不要。
@@ -45,10 +68,23 @@
 ## インストール
 
 ```bash
+# DSH 0.1.5-rc.x ホスト（本ライン、dist-tag dsh-0.1.5）
+dsh plugin --profile web add dsh-session-guard@dsh-0.1.5
+
+# または git ブランチを直接指定
 dsh plugin --profile web add github:drscrewdriver/dsh-session-guard#compat/0.1.5
+
+# DSH 0.1.2-rc.x ホストは 0.1.2 ラインを使用
+dsh plugin --profile web add dsh-session-guard@dsh-0.1.2
 ```
 
-`compat/0.1.5` は DSH `0.1.5-rc.x` 専用ライン（3.x）。`main` は引き続き DSH `0.1.0-rc.7` – `0.1.2-rc.1`（2.x / 0.2.x）を担当します。
+`compat/0.1.5` は DSH `0.1.5-rc.x` 専用ラインで、npm バージョンは **`3.0.0`**。DSH `0.1.2-rc.x`
+ホストは **`legacy/0.1.2`** ブランチ（npm dist-tag `dsh-0.1.2`、バージョン `0.3.1`）を使用してください。
+**`main` は `0.2.0-beta.1` で凍結済みで、0.1.2 ラインのリリースブランチではありません。**
+
+> ⚠️ 裸のパッケージ名 `dsh-session-guard` に依存しないでください：npm の `latest` タグは
+> 排他的な 2 つのバージョンライン（`engines.dsh` が semver プレリリース照合で排他）を
+> 同時に提供できません。必ず dist-tag を明示してください。
 
 インストール後 dsh web を再起動し、ページをリフレッシュ。
 

package/README.ko.md

@@ -26,6 +26,29 @@
 
 > **호환성 참고:** v0.1.1에는 일본어(`ja`)와 한국어(`ko`) 사전이 포함되어 있지만, 현재 공식 DSH 릴리스는 `LocaleRuntime`을 통해 `zh`와 `en`만 제공합니다. 순정 DSH에서 `ja` 또는 `ko`를 선택하면 `locale "<id>" is not registered` 오류가 발생합니다. 공식 DSH가 해당 locale ID를 추가할 때까지 사용할 수 없습니다. 고급 사용자는 DSH 포크를 유지하면서 업데이트하세요.
 
+> **▼ DSH 버전 적합성**
+>
+> | DSH 버전 | 로드 | 설정 등록 | 세션 이벤트 / 게이트 | 클라이언트 측 |
+> | --- | --- | --- | --- | --- |
+> | 0.1.0-rc.7 ~ 0.1.1-rc.x | ➖ 본 라인 대상 아님(`legacy/0.1.2` 이전 역사 버전) | `ctx.settings.register(ns, schema, { base })` | ✅ 형태 동일 | ✅ 플랫폼 값 import 없음 |
+> | 0.1.2-alpha.2+ / 0.1.2-rc.1 | ➖ 본 라인 대상 아님 → `legacy/0.1.2`(npm `@dsh-0.1.2`) | `register` 유지(`installSection` 추가) | ✅ 형태 동일 | ✅ 플랫폼 값 import 없음 |
+> | **0.1.5-rc.2** | ✅(**본 라인**, dist-tag `dsh-0.1.5`) | `register` 유지(문자열 네임스페이스) | ✅ 이벤트는 `snapshotEvents()` 이중 경로로 읽음 | ✅ |
+>
+> **본 라인 식별 정보**: 브랜치 `compat/0.1.5`, npm 버전 **`3.0.0`**(semver),
+> dist-tag **`dsh-0.1.5`**. `package.json`과 `dsh.plugin.json`의 `engines.dsh`, 그리고
+> 3개의 `@deepseek-ai/dsh-client-*` peer 하한은 모두 `>=0.1.5-rc.2 <0.2.0-0`로 통일되어 있습니다.
+> 과거 README는 "2.x / 3.x"를 **라인 호칭**으로 사용했지만, 이는 서술 관습이며
+> **레지스트리에서 받을 수 있는 버전 번호가 아닙니다**. npm 버전 `0.3.1`(0.1.2 라인)과
+> `3.0.0`(0.1.5 라인)을 기준으로 하세요.
+>
+> **다른 라인의 낙점**: DSH `0.1.2-rc.x` 호스트는 브랜치 **`legacy/0.1.2`**(npm dist-tag
+> `dsh-0.1.2`, 버전 `0.3.1`)를 사용하세요. **`main`은 `0.2.0-beta.1`에서 동결되었고
+> 0.1.2 라인의 릴리스 브랜치가 아닙니다.** DSH `0.1.0-rc.7` ~ `0.1.1-rc.x` 호스트는
+> `0.1.2` 이하의 역사 버전을 사용하세요. 필드 소스 정식 정의:
+> `mine-dsh-plugins/improve-dsh-plugins/DSH-PLUGIN-VERSION-DISTRIBUTION-STRATEGY.md` §2.2.
+>
+> 드리프트 가드: `tools/check-api-drift.ps1`(본 라인은 기본적으로 `dsh-v0.1.5-rc.2`에 대해 필수 API 존재를 검증).
+
 > 피크 과금 시간대에 실행 중인 세션을 자동 일시정지하고 오피크/주말에 자동 재개; input-traffic의 동결 버튼과 페어링하여 **세션급** 잠금 구현; 백엔드 **자동 재시도**는 동결/게이트 기간 중 양보. 커스텀 세션 게이트(`agent.cancel keepInbox + goals.pause + session/event 안전 경계 + followup 재개`) 기반, dsh-task-control 의존성 제거.
 
 `dsh plugin` 명령으로 조립 + 번들 패치로 장착하는 cordis 플러그인. dsh 소스 변경이나 PR 필요 없음.
@@ -45,10 +68,23 @@
 ## 설치
 
 ```bash
+# DSH 0.1.5-rc.x 호스트(본 라인, dist-tag dsh-0.1.5)
+dsh plugin --profile web add dsh-session-guard@dsh-0.1.5
+
+# 또는 git 브랜치 직접 지정
 dsh plugin --profile web add github:drscrewdriver/dsh-session-guard#compat/0.1.5
+
+# DSH 0.1.2-rc.x 호스트는 0.1.2 라인 사용
+dsh plugin --profile web add dsh-session-guard@dsh-0.1.2
 ```
 
-`compat/0.1.5`는 DSH `0.1.5-rc.x` 전용 라인(3.x)입니다. `main`은 계속 DSH `0.1.0-rc.7` – `0.1.2-rc.1`(2.x / 0.2.x)을 담당합니다.
+`compat/0.1.5`는 DSH `0.1.5-rc.x` 전용 라인이며 npm 버전은 **`3.0.0`**입니다. DSH `0.1.2-rc.x`
+호스트는 **`legacy/0.1.2`** 브랜치(npm dist-tag `dsh-0.1.2`, 버전 `0.3.1`)를 사용하세요.
+**`main`은 `0.2.0-beta.1`에서 동결되었고 0.1.2 라인의 릴리스 브랜치가 아닙니다.**
+
+> ⚠️ 맨 패키지명 `dsh-session-guard`에 의존하지 마세요: npm `latest` 태그는
+> 상호 배타적인 두 버전 라인(`engines.dsh`가 semver 프리릴리스 매칭상 배타)을
+> 동시에 제공할 수 없습니다. 반드시 dist-tag를 명시하세요.
 
 설치 후 dsh web을 재시작하고 페이지를 새로고침.
 

package/README.md

@@ -32,12 +32,23 @@
 >
 > | DSH 版本 | 加载 | 设置注册 | 会话事件 / 会话门 | 客户端半 |
 > | --- | --- | --- | --- | --- |
-> | 0.1.0-rc.7 ~ 0.1.1-rc.x | ✅（2.x / 0.2.x 线） | `ctx.settings.register(ns, schema, { base })` | ✅ 形状一致 | ✅ 无平台值导入 |
-> | 0.1.2-alpha.2+ / 0.1.2-rc.1 | ✅（2.x / 0.2.x 线） | `register` 仍保留（另加 `installSection`） | ✅ 形状一致 | ✅ 无平台值导入 |
-> | **0.1.5-rc.2** | ✅（**3.x 专线 `compat/0.1.5`**） | `register` 仍在（字符串命名空间） | ✅ 事件经 `snapshotEvents()` 双路径读取 | ✅ |
+> | 0.1.0-rc.7 ~ 0.1.1-rc.x | ➖ 不在本线（`legacy/0.1.2` 之前的历史版本） | `ctx.settings.register(ns, schema, { base })` | ✅ 形状一致 | ✅ 无平台值导入 |
+> | 0.1.2-alpha.2+ / 0.1.2-rc.1 | ➖ 不在本线 → 用 `legacy/0.1.2`（npm `@dsh-0.1.2`） | `register` 仍保留（另加 `installSection`） | ✅ 形状一致 | ✅ 无平台值导入 |
+> | **0.1.5-rc.2** | ✅（**本线**，dist-tag `dsh-0.1.5`） | `register` 仍在（字符串命名空间） | ✅ 事件经 `snapshotEvents()` 双路径读取 | ✅ |
 >
-> **3.x 为 0.1.5 专线**：engines/peer 收窄为 `>=0.1.5-rc.2 <0.2.0-0`，0.1.0-rc.7~0.1.2 宿主请继续使用 2.x / 0.2.x 线（`main`）。
-> **0.1.5 适配（compat/0.1.5 分支，v3.0.0）**：
+> **本线身份**：分支 `compat/0.1.5`，npm 版本号 **`3.0.0`**（semver），dist-tag **`dsh-0.1.5`**。
+> `package.json` 与 `dsh.plugin.json` 的 `engines.dsh` 与三个 `@deepseek-ai/dsh-client-*`
+> peer 下界统一为 `>=0.1.5-rc.2 <0.2.0-0`。
+> 历史上 README 曾用「2.x / 3.x」当**线代号**，那是叙述习惯，**不是注册表里可拉取的版本号** ——
+> 请一律以 npm 版本号 `0.3.1`（0.1.2 线）与 `3.0.0`（0.1.5 线）为准。
+>
+> **其它线的落点**：DSH `0.1.2-rc.x` 宿主请使用分支 **`legacy/0.1.2`**（npm dist-tag
+> `dsh-0.1.2`，版本 `0.3.1`）。**`main` 已冻结在 `0.2.0-beta.1`，不是 0.1.2 线的发布分支。**
+> DSH `0.1.0-rc.7` ~ `0.1.1-rc.x` 宿主请使用 ≤ `0.1.2` 的历史版本。
+> 字段源头定义见
+> `mine-dsh-plugins/improve-dsh-plugins/DSH-PLUGIN-VERSION-DISTRIBUTION-STRATEGY.md` §2.2。
+>
+> **0.1.5 适配（compat/0.1.5 分支，npm 3.0.0）**：
 > ① `agent.followup` 双路径——0.1.5 将 Inbox 改为 agent-loop 只读投影，若 `followup`
 > 不再存在则回退 `agent.send`，两者皆无时 warn 降级不抛错（恢复续跑的兜底）；
 > ② 恢复消息 `source` 补 `form: 'instructions'`（0.1.5 ContextFormed 契约，旧版本忽略）；
@@ -46,17 +57,18 @@
 > 旧数组回退（仅影响 `findToolOutcome` / `lastUserPrompt` 两条辅助路径，事件类型匹配不变）。
 > 已核实 0.1.5 的 `WebRoute`（exact/prefix + SSE）契约不变，客户端
 > `fetch('/session-guard/...')` 无需改 `/api` 前缀。
-> 2.x 线的旧表（一份产物双版本）保留如下。`session/event`、`agent.cancel`、`goals.pause`、
+> 下面这张兼容表跨 0.1.1 / 0.1.2 两代 API，本线只认领 0.1.5 那一行。
+> `session/event`、`agent.cancel`、`goals.pause`、
 > `agent.followup`、`commands.register`、`timer.interval`、`webServer.register`、
 > `agent/request`、`llm.listConfigurableProviders`、`settings.register/get` 在
-> `dsh-v0.1.1-rc.2` 与 `dsh-v0.1.2-rc.1` 之间签名一致（3.x 已核到 `dsh-v0.1.5-rc.2`）；
+> `dsh-v0.1.1-rc.2` 与 `dsh-v0.1.2-rc.1` 之间签名一致（本线已核到 `dsh-v0.1.5-rc.2`）；
 > 唯一需要双读的是 `tool/result` 记录的调用 id 形态（`content[].toolCallId` 优先、
 > `source.callId` 回退），已抽到 `src/tool-call-id.js` 并配单测——两版本的回放日志都可能出现这两种形态。
-> 0.1.5 起 `session.events` 数组访问器被移除，3.x 经 `snapshotEvents()`（保留旧数组回退）读取，
+> 0.1.5 起 `session.events` 数组访问器被移除，本线经 `snapshotEvents()`（保留旧数组回退）读取，
 > 只影响 `findToolOutcome` / `lastUserPrompt` 两条辅助路径。
 > `model/selection` 事件**仅 0.1.2+**，只做切模型加速且必须特性探测；设置面只用
 > `register` + `get` 交集（不碰 `installSection` / 已移除的 `installSettingsSection`）。
-> 漂移守卫脚本：`tools/check-api-drift.ps1`（3.x 默认对 `dsh-v0.1.5-rc.2` 断言必需接口存在）。
+> 漂移守卫脚本：`tools/check-api-drift.ps1`（本线默认对 `dsh-v0.1.5-rc.2` 断言必需接口存在）。
 
 > 高峰时段自动暂停运行中的会话、低峰/周末自动续跑；配合 input-traffic 的冻结按钮做到**会话级**锁定；后端**自动重试**在冻结/门控期间让路。核心基于**自研会话门**（`agent.cancel keepInbox + goals.pause + session/event 安全边界 + followup 续跑`），不再依赖 dsh-task-control。
 
@@ -86,10 +98,22 @@
 ## 安装
 
 ```bash
+# DSH 0.1.5-rc.x 宿主（本线，dist-tag dsh-0.1.5）
+dsh plugin --profile web add dsh-session-guard@dsh-0.1.5
+
+# 或直接走 git 分支
 dsh plugin --profile web add github:drscrewdriver/dsh-session-guard#compat/0.1.5
+
+# DSH 0.1.2-rc.x 宿主请改用 0.1.2 线
+dsh plugin --profile web add dsh-session-guard@dsh-0.1.2
 ```
 
-`compat/0.1.5` 是 DSH `0.1.5-rc.x` 专线（3.x）；`main` 继续服务 DSH `0.1.0-rc.7` – `0.1.2-rc.1`（2.x / 0.2.x）。
+`compat/0.1.5` 是 DSH `0.1.5-rc.x` 专线，npm 版本号 **`3.0.0`**；DSH `0.1.2-rc.x` 宿主请改用
+分支 **`legacy/0.1.2`**（npm dist-tag `dsh-0.1.2`，版本 `0.3.1`）。**`main` 已冻结在 `0.2.0-beta.1`，
+不是 0.1.2 线的发布分支。**
+
+> ⚠️ 不要依赖裸包名 `dsh-session-guard`：npm 的 `latest` 标签无法同时服务两条互斥版本线
+> （两条线的 `engines.dsh` 按 semver 预发布规则互斥），必须显式指定 dist-tag。
 
 装后重启 dsh web 并刷新页面。
 

package/cordis.patch.yml

@@ -1,10 +1,10 @@
-# dsh-session-guard bundle patch：一行装配进 profile。
-#
-# host 半（src/index.js）注册 sessionGuard 服务（冗余端口，供 input-traffic 适配）、
-# 高峰自动会话门（taskControl.pause/resume，缺失时回退锁等待队列）、
-# /session-guard/* 路由与 设置→插件→session-guard 子板块（简单开关）。
-# 浏览器半（src/client/index.js，经 package.json dsh.client 声明）提供
-# 高峰状态徽标 + 无 input-traffic 时的回退冻结按钮。
-- insert:
-    - id: session-guard
-      name: dsh-session-guard
+# dsh-session-guard bundle patch：一行装配进 profile。
+#
+# host 半（src/index.js）注册 sessionGuard 服务（冗余端口，供 input-traffic 适配）、
+# 高峰自动会话门（taskControl.pause/resume，缺失时回退锁等待队列）、
+# /session-guard/* 路由与 设置→插件→session-guard 子板块（简单开关）。
+# 浏览器半（src/client/index.js，经 package.json dsh.client 声明）提供
+# 高峰状态徽标 + 无 input-traffic 时的回退冻结按钮。
+- insert:
+    - id: session-guard
+      name: dsh-session-guard