dsh-input-traffic 0.2.10-beta.2 → 0.2.10-beta.3

package/CHANGELOG.md

@@ -4,6 +4,17 @@
 
 ## Unreleased
 
+### 变更：本线收窄为 DSH < 0.1.2-alpha.1（旧版线 compat，0.2.10-beta.3）
+
+- **`engines.dsh` 上限收窄**：`>=0.1.0-rc.7 <0.2.0-0` → `>=0.1.0-rc.7 <0.1.2-alpha.1`。
+  原上限声称兼容到 0.2.0，但 `@deepseek-ai/dsh-client-runtime` 在 DSH `0.1.2-alpha.1`
+  已被整体删除（commit `be531688f3`），本版本仍依赖它发布的 `ClientContext` / `SessionId`，
+  在 0.1.2+ 上会解析失败。收窄后安装器能挡住误装。
+- **双线分工**：`compat` dist-tag = 本线（DSH 0.1.0/0.1.1）；`beta` dist-tag = 0.1.2+ 线
+  （0.2.11 起，`ClientContext` 改由 `@deepseek-ai/cordis` 提供）。两条线互不覆盖，
+  升级 DSH 到 0.1.2+ 时需换线。
+- **代码不变**：本版本只改 engines、版本号与文档，`src/` 与 `lib/` 与 0.2.10-beta.2 一致。
+
 ### 变更：冻结按钮文案与 session-guard 的分工说明
 
 - **按钮文案**：`steer.freeze` →「冻结追加」（Freeze & append / 凍結して追加 / 동결 후 추가），

package/INSTALL.md

@@ -1,152 +1,152 @@
-# Installation Guide (Official DSH CLI)
-
-This guide uses only the official DSH `dsh plugin` command. The command installs the dependency into a profile and synchronizes `dsh.profile.bundles`. Do not replace it with plain `npm install`, direct `pnpm add` in the profile, or manual edits to the profile manifest.
-
-- [English installation guide](./INSTALL.md)
-- [中文安装指南](./INSTALL.zh.md)
-- [日本語インストールガイド](./INSTALL.ja.md)
-- [한국어 설치 안내](./INSTALL.ko.md)
-- [English README](./README.en.md)
-- [中文 README](./README.md)
-- [日本語 README](./README.ja.md)
-- [한국어 README](./README.ko.md)
-- [Changelog](./CHANGELOG.md)
-- [日本語 changelog](./CHANGELOG.ja.md)
-- [한국어 changelog](./CHANGELOG.ko.md)
-
-The placeholders in this guide are:
-
-- `<profile>`: the DSH profile to modify, usually `web`;
-- `dsh-input-traffic`: the npm package and runtime plugin ID.
-
-## 0. Prerequisites and profile discovery
-
-```bash
-echo "DSH_HOME=${DSH_HOME:-$HOME/.dsh}"
-dsh --version
-ls "${DSH_HOME:-$HOME/.dsh}/profiles"
-```
-
-Use the profile named by your running DSH process. `web` is common, but the active `--profile` argument is authoritative.
-
-## 1. Official installation
-
-Install the latest version:
-
-```bash
-dsh plugin --profile <profile> add dsh-input-traffic -w
-```
-
-(The `-w` flag is required when the profile is a pnpm workspace root, as `web` is.)
-
-Install the current release explicitly:
-
-```bash
-dsh plugin --profile <profile> add dsh-input-traffic@0.2.9 -w
-```
-
-The official CLI updates the profile dependency, lockfile, and `dsh.profile.bundles` automatically. Do not add a manual YAML row.
-
-### Supply-chain cooling period
-
-The dsh runtime uses pnpm 11, whose `minimumReleaseAge` policy may block a freshly published version with `ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION`. Add the version to `minimumReleaseAgeExclude` in `~/.dsh/profiles/web/pnpm-workspace.yaml`:
-
-```yaml
-minimumReleaseAgeExclude:
-  - dsh-input-traffic@0.2.9
-```
-
-## 2. Upgrade
-
-Upgrade to the latest registry version:
-
-```bash
-dsh plugin --profile <profile> update dsh-input-traffic -w
-```
-
-Restart DSH for host changes and refresh the Web page for client changes.
-
-## 3. Local-path / link: registration (alternative)
-
-For development or offline installs, register the plugin from a local checkout:
-
-```bash
-#    ~/.dsh/profiles/web/package.json dependencies:
-#      "dsh-input-traffic": "link:<absolute path to dsh-input-traffic>"
-#    ~/.dsh/profiles/web/cordis.patch.yml:
-#      - insert:
-#          - id: input-traffic
-#            name: dsh-input-traffic
-cd ~/.dsh/profiles/web && pnpm install && dsh web
-```
-
-Or use the official CLI with a local path (no network needed):
-
-```bash
-dsh plugin --profile <profile> add /absolute/path/to/dsh-input-traffic -w
-```
-
-## 4. Verify installation
-
-Check the dependency and installed version:
-
-```bash
-grep -n "dsh-input-traffic" \
-  "${DSH_HOME:-$HOME/.dsh}/profiles/<profile>/package.json"
-node -p "require('${DSH_HOME:-$HOME/.dsh}/profiles/<profile>/node_modules/dsh-input-traffic/package.json').version"
-```
-
-Check the official composition:
-
-```bash
-dsh --profile <profile> --dump-default-config
-```
-
-It must contain:
-
-```yaml
-- id: input-traffic
-  name: dsh-input-traffic
-```
-
-## 5. Verify the plugin
-
-Restart DSH, then refresh the Web page. In a session, verify:
-
-1. The three-tier planning dock appears in the waiting area;
-2. The "Freeze session" button is visible on the composer's right;
-3. The official "busy-Enter behavior" settings row is hidden;
-4. While the agent is busy, sending a message places it in the waiting area with red/yellow/green planning buttons.
-
-## Japanese and Korean support status
-
-The plugin ships `ja` and `ko` dictionaries, but the current official DSH release exposes only `zh` and `en` through `LocaleRuntime`. On stock DSH, selecting Japanese or Korean fails with `locale "<id>" is not registered`.
-
-To use them before official support lands, maintain a DSH fork and update:
-
-- `packages/client/locale/src/locale-settings.ts`: add `ja` and `ko` to `LOCALE_IDS`.
-- `packages/client/locale/src/client/index.ts`: add `{ id: 'ja', label: '日本語' }` and `{ id: 'ko', label: '한국어' }` to `LOCALES`.
-- Add the corresponding core dictionaries and tests, then rebuild and run the forked DSH.
-
-A plugin-only change cannot extend DSH's global locale list.
-
-## 6. Troubleshooting
-
-| Symptom | Action |
-| --- | --- |
-| `dsh` is not found | Install or enable the official DSH CLI. |
-| `ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION` | Add the version to `minimumReleaseAgeExclude` in the profile's `pnpm-workspace.yaml`. |
-| Plugin shows as "disabled/unmounted" with no error | Check the profile composition. |
-| Client entry missing from `__DSH_BOOT__` | Confirm `exports["./client"]` exists and the host fiber was established. |
-| Freeze/resume buttons not working | Ensure session-guard is installed if using session-level locking; the plugin operates fail-open when session-guard is absent. |
-| Stale client bundle | Hard-refresh the browser (Ctrl+Shift+R) after an upgrade. |
-
-## 7. Remove
-
-Use the official command:
-
-```bash
-dsh plugin --profile <profile> remove dsh-input-traffic
-```
-
-Restart DSH afterwards to restore the official queue dock and the "busy-Enter behavior" settings row.
+# Installation Guide (Official DSH CLI)
+
+This guide uses only the official DSH `dsh plugin` command. The command installs the dependency into a profile and synchronizes `dsh.profile.bundles`. Do not replace it with plain `npm install`, direct `pnpm add` in the profile, or manual edits to the profile manifest.
+
+- [English installation guide](./INSTALL.md)
+- [中文安装指南](./INSTALL.zh.md)
+- [日本語インストールガイド](./INSTALL.ja.md)
+- [한국어 설치 안내](./INSTALL.ko.md)
+- [English README](./README.en.md)
+- [中文 README](./README.md)
+- [日本語 README](./README.ja.md)
+- [한국어 README](./README.ko.md)
+- [Changelog](./CHANGELOG.md)
+- [日本語 changelog](./CHANGELOG.ja.md)
+- [한국어 changelog](./CHANGELOG.ko.md)
+
+The placeholders in this guide are:
+
+- `<profile>`: the DSH profile to modify, usually `web`;
+- `dsh-input-traffic`: the npm package and runtime plugin ID.
+
+## 0. Prerequisites and profile discovery
+
+```bash
+echo "DSH_HOME=${DSH_HOME:-$HOME/.dsh}"
+dsh --version
+ls "${DSH_HOME:-$HOME/.dsh}/profiles"
+```
+
+Use the profile named by your running DSH process. `web` is common, but the active `--profile` argument is authoritative.
+
+## 1. Official installation
+
+Install the latest version:
+
+```bash
+dsh plugin --profile <profile> add dsh-input-traffic -w
+```
+
+(The `-w` flag is required when the profile is a pnpm workspace root, as `web` is.)
+
+Install the current release explicitly:
+
+```bash
+dsh plugin --profile <profile> add dsh-input-traffic@0.2.9 -w
+```
+
+The official CLI updates the profile dependency, lockfile, and `dsh.profile.bundles` automatically. Do not add a manual YAML row.
+
+### Supply-chain cooling period
+
+The dsh runtime uses pnpm 11, whose `minimumReleaseAge` policy may block a freshly published version with `ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION`. Add the version to `minimumReleaseAgeExclude` in `~/.dsh/profiles/web/pnpm-workspace.yaml`:
+
+```yaml
+minimumReleaseAgeExclude:
+  - dsh-input-traffic@0.2.9
+```
+
+## 2. Upgrade
+
+Upgrade to the latest registry version:
+
+```bash
+dsh plugin --profile <profile> update dsh-input-traffic -w
+```
+
+Restart DSH for host changes and refresh the Web page for client changes.
+
+## 3. Local-path / link: registration (alternative)
+
+For development or offline installs, register the plugin from a local checkout:
+
+```bash
+#    ~/.dsh/profiles/web/package.json dependencies:
+#      "dsh-input-traffic": "link:<absolute path to dsh-input-traffic>"
+#    ~/.dsh/profiles/web/cordis.patch.yml:
+#      - insert:
+#          - id: input-traffic
+#            name: dsh-input-traffic
+cd ~/.dsh/profiles/web && pnpm install && dsh web
+```
+
+Or use the official CLI with a local path (no network needed):
+
+```bash
+dsh plugin --profile <profile> add /absolute/path/to/dsh-input-traffic -w
+```
+
+## 4. Verify installation
+
+Check the dependency and installed version:
+
+```bash
+grep -n "dsh-input-traffic" \
+  "${DSH_HOME:-$HOME/.dsh}/profiles/<profile>/package.json"
+node -p "require('${DSH_HOME:-$HOME/.dsh}/profiles/<profile>/node_modules/dsh-input-traffic/package.json').version"
+```
+
+Check the official composition:
+
+```bash
+dsh --profile <profile> --dump-default-config
+```
+
+It must contain:
+
+```yaml
+- id: input-traffic
+  name: dsh-input-traffic
+```
+
+## 5. Verify the plugin
+
+Restart DSH, then refresh the Web page. In a session, verify:
+
+1. The three-tier planning dock appears in the waiting area;
+2. The "Freeze session" button is visible on the composer's right;
+3. The official "busy-Enter behavior" settings row is hidden;
+4. While the agent is busy, sending a message places it in the waiting area with red/yellow/green planning buttons.
+
+## Japanese and Korean support status
+
+The plugin ships `ja` and `ko` dictionaries, but the current official DSH release exposes only `zh` and `en` through `LocaleRuntime`. On stock DSH, selecting Japanese or Korean fails with `locale "<id>" is not registered`.
+
+To use them before official support lands, maintain a DSH fork and update:
+
+- `packages/client/locale/src/locale-settings.ts`: add `ja` and `ko` to `LOCALE_IDS`.
+- `packages/client/locale/src/client/index.ts`: add `{ id: 'ja', label: '日本語' }` and `{ id: 'ko', label: '한국어' }` to `LOCALES`.
+- Add the corresponding core dictionaries and tests, then rebuild and run the forked DSH.
+
+A plugin-only change cannot extend DSH's global locale list.
+
+## 6. Troubleshooting
+
+| Symptom | Action |
+| --- | --- |
+| `dsh` is not found | Install or enable the official DSH CLI. |
+| `ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION` | Add the version to `minimumReleaseAgeExclude` in the profile's `pnpm-workspace.yaml`. |
+| Plugin shows as "disabled/unmounted" with no error | Check the profile composition. |
+| Client entry missing from `__DSH_BOOT__` | Confirm `exports["./client"]` exists and the host fiber was established. |
+| Freeze/resume buttons not working | Ensure session-guard is installed if using session-level locking; the plugin operates fail-open when session-guard is absent. |
+| Stale client bundle | Hard-refresh the browser (Ctrl+Shift+R) after an upgrade. |
+
+## 7. Remove
+
+Use the official command:
+
+```bash
+dsh plugin --profile <profile> remove dsh-input-traffic
+```
+
+Restart DSH afterwards to restore the official queue dock and the "busy-Enter behavior" settings row.

package/INSTALL.zh.md

@@ -1,151 +1,151 @@
-# 安装指南（官方 DSH CLI）
-
-本指南只使用官方 `dsh plugin` 命令。该命令会把依赖装进 profile 并同步 `dsh.profile.bundles`。不要用普通 `npm install`、在 profile 里直接 `pnpm add` 或手工编辑 profile 清单代替。
-
-- [安装指南](./INSTALL.zh.md)
-- [English installation guide](./INSTALL.md)
-- [日本語インストールガイド](./INSTALL.ja.md)
-- [한국어 설치 안내](./INSTALL.ko.md)
-- [中文 README](./README.md)
-- [English README](./README.en.md)
-- [日本語 README](./README.ja.md)
-- [한국어 README](./README.ko.md)
-- [版本更新日志](./CHANGELOG.md)
-- [日本語 changelog](./CHANGELOG.ja.md)
-- [한국어 changelog](./CHANGELOG.ko.md)
-
-本指南中的占位符：
-
-- `<profile>`：要修改的 DSH profile，通常是 `web`；
-- `dsh-input-traffic`：npm 包名与运行时插件 ID。
-
-## 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-input-traffic -w
-```
-
-（当 profile 是 pnpm workspace root 时必须带 `-w`，`web` 就是。）
-
-显式安装当前发布版：
-
-```bash
-dsh plugin --profile <profile> add dsh-input-traffic@0.2.9 -w
-```
-
-官方 CLI 会自动更新 profile 依赖、锁文件与 `dsh.profile.bundles`。不要手工追加 YAML。
-
-### 供应链冷却期
-
-dsh 运行环境使用 pnpm 11，其 `minimumReleaseAge` 策略可能拦截刚发布的版本，报 `ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION`。把版本加入 `~/.dsh/profiles/web/pnpm-workspace.yaml` 的 `minimumReleaseAgeExclude`：
-
-```yaml
-minimumReleaseAgeExclude:
-  - dsh-input-traffic@0.2.9
-```
-
-## 2. 升级
-
-升级到 registry 最新版本：
-
-```bash
-dsh plugin --profile <profile> update dsh-input-traffic -w
-```
-
-宿主侧改动需重启 DSH；浏览器侧刷新 Web 页面。
-
-## 3. 本地路径 / link: 注册（备选）
-
-开发或离线安装时，可以从本地检出注册插件：
-
-```bash
-#    ~/.dsh/profiles/web/package.json dependencies 增加：
-#      "dsh-input-traffic": "link:<dsh-input-traffic 的绝对路径>"
-#    ~/.dsh/profiles/web/cordis.patch.yml：
-#      - insert:
-#          - id: input-traffic
-#            name: dsh-input-traffic
-cd ~/.dsh/profiles/web && pnpm install && dsh web
-```
-
-或用官方 CLI 加本地路径（无需网络）：
-
-```bash
-dsh plugin --profile <profile> add /dsh-input-traffic 的绝对路径/ -w
-```
-
-## 4. 验证安装
-
-检查依赖与安装版本：
-
-```bash
-grep -n "dsh-input-traffic" \
-  "${DSH_HOME:-$HOME/.dsh}/profiles/<profile>/package.json"
-```
-
-检查官方组合配置：
-
-```bash
-dsh --profile <profile> --dump-default-config
-```
-
-应包含：
-
-```yaml
-- id: input-traffic
-  name: dsh-input-traffic
-```
-
-## 5. 验证插件
-
-重启 DSH 后刷新 Web 页面。在会话中验证：
-
-1. 等待区出现三档规划 dock；
-2. 输入框右侧显示「冻结会话」按钮；
-3. 公式设置面板的「繁忙时 Enter 键行为」设置行已隐藏；
-4. 智能体忙碌时发送消息，消息进入等待区并显示红/黄/绿规划按钮。
-
-## 日语与韩语支持状态
-
-插件自带 `ja` 与 `ko` 字典，但当前官方 DSH 只通过 `LocaleRuntime` 暴露 `zh` 和 `en`。在原版 DSH 上选择日语或韩语会报 `locale "<id>" is not registered`。
-
-官方支持落地前要使用它们，请维护 DSH fork 并更新：
-
-- `packages/client/locale/src/locale-settings.ts`：把 `ja` 与 `ko` 加入 `LOCALE_IDS`。
-- `packages/client/locale/src/client/index.ts`：在 `LOCALES` 中加入 `{ id: 'ja', label: '日本語' }` 与 `{ id: 'ko', label: '한국어' }`。
-- 补齐对应的核心字典与测试，然后重新构建并运行 fork 版本。
-
-仅修改插件无法扩展 DSH 的全局 locale 列表。
-
-## 6. 排查
-
-| 症状 | 处理 |
-| --- | --- |
-| 找不到 `dsh` 命令 | 安装或启用官方 DSH CLI。 |
-| `ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION` | 把版本加入 profile 的 `pnpm-workspace.yaml` 的 `minimumReleaseAgeExclude`。 |
-| 插件显示「已停用/未挂载」且无错误 | 检查 profile 组合。 |
-| client 入口不在 `__DSH_BOOT__` | 确认 `exports["./client"]` 存在且 host fiber 已建立。 |
-| 冻结/恢复按钮不工作 | 如使用会话级锁定，确保 session-guard 已安装；未安装时插件以 fail-open 方式运行。 |
-| 浏览器显示旧 bundle | 升级后硬刷新（Ctrl+Shift+R）。 |
-
-## 7. 卸载
-
-使用官方命令：
-
-```bash
-dsh plugin --profile <profile> remove dsh-input-traffic
-```
-
-重启后，公式队列 dock 与「繁忙时 Enter 键行为」设置行将恢复。
+# 安装指南（官方 DSH CLI）
+
+本指南只使用官方 `dsh plugin` 命令。该命令会把依赖装进 profile 并同步 `dsh.profile.bundles`。不要用普通 `npm install`、在 profile 里直接 `pnpm add` 或手工编辑 profile 清单代替。
+
+- [安装指南](./INSTALL.zh.md)
+- [English installation guide](./INSTALL.md)
+- [日本語インストールガイド](./INSTALL.ja.md)
+- [한국어 설치 안내](./INSTALL.ko.md)
+- [中文 README](./README.md)
+- [English README](./README.en.md)
+- [日本語 README](./README.ja.md)
+- [한국어 README](./README.ko.md)
+- [版本更新日志](./CHANGELOG.md)
+- [日本語 changelog](./CHANGELOG.ja.md)
+- [한국어 changelog](./CHANGELOG.ko.md)
+
+本指南中的占位符：
+
+- `<profile>`：要修改的 DSH profile，通常是 `web`；
+- `dsh-input-traffic`：npm 包名与运行时插件 ID。
+
+## 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-input-traffic -w
+```
+
+（当 profile 是 pnpm workspace root 时必须带 `-w`，`web` 就是。）
+
+显式安装当前发布版：
+
+```bash
+dsh plugin --profile <profile> add dsh-input-traffic@0.2.9 -w
+```
+
+官方 CLI 会自动更新 profile 依赖、锁文件与 `dsh.profile.bundles`。不要手工追加 YAML。
+
+### 供应链冷却期
+
+dsh 运行环境使用 pnpm 11，其 `minimumReleaseAge` 策略可能拦截刚发布的版本，报 `ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION`。把版本加入 `~/.dsh/profiles/web/pnpm-workspace.yaml` 的 `minimumReleaseAgeExclude`：
+
+```yaml
+minimumReleaseAgeExclude:
+  - dsh-input-traffic@0.2.9
+```
+
+## 2. 升级
+
+升级到 registry 最新版本：
+
+```bash
+dsh plugin --profile <profile> update dsh-input-traffic -w
+```
+
+宿主侧改动需重启 DSH；浏览器侧刷新 Web 页面。
+
+## 3. 本地路径 / link: 注册（备选）
+
+开发或离线安装时，可以从本地检出注册插件：
+
+```bash
+#    ~/.dsh/profiles/web/package.json dependencies 增加：
+#      "dsh-input-traffic": "link:<dsh-input-traffic 的绝对路径>"
+#    ~/.dsh/profiles/web/cordis.patch.yml：
+#      - insert:
+#          - id: input-traffic
+#            name: dsh-input-traffic
+cd ~/.dsh/profiles/web && pnpm install && dsh web
+```
+
+或用官方 CLI 加本地路径（无需网络）：
+
+```bash
+dsh plugin --profile <profile> add /dsh-input-traffic 的绝对路径/ -w
+```
+
+## 4. 验证安装
+
+检查依赖与安装版本：
+
+```bash
+grep -n "dsh-input-traffic" \
+  "${DSH_HOME:-$HOME/.dsh}/profiles/<profile>/package.json"
+```
+
+检查官方组合配置：
+
+```bash
+dsh --profile <profile> --dump-default-config
+```
+
+应包含：
+
+```yaml
+- id: input-traffic
+  name: dsh-input-traffic
+```
+
+## 5. 验证插件
+
+重启 DSH 后刷新 Web 页面。在会话中验证：
+
+1. 等待区出现三档规划 dock；
+2. 输入框右侧显示「冻结会话」按钮；
+3. 公式设置面板的「繁忙时 Enter 键行为」设置行已隐藏；
+4. 智能体忙碌时发送消息，消息进入等待区并显示红/黄/绿规划按钮。
+
+## 日语与韩语支持状态
+
+插件自带 `ja` 与 `ko` 字典，但当前官方 DSH 只通过 `LocaleRuntime` 暴露 `zh` 和 `en`。在原版 DSH 上选择日语或韩语会报 `locale "<id>" is not registered`。
+
+官方支持落地前要使用它们，请维护 DSH fork 并更新：
+
+- `packages/client/locale/src/locale-settings.ts`：把 `ja` 与 `ko` 加入 `LOCALE_IDS`。
+- `packages/client/locale/src/client/index.ts`：在 `LOCALES` 中加入 `{ id: 'ja', label: '日本語' }` 与 `{ id: 'ko', label: '한국어' }`。
+- 补齐对应的核心字典与测试，然后重新构建并运行 fork 版本。
+
+仅修改插件无法扩展 DSH 的全局 locale 列表。
+
+## 6. 排查
+
+| 症状 | 处理 |
+| --- | --- |
+| 找不到 `dsh` 命令 | 安装或启用官方 DSH CLI。 |
+| `ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION` | 把版本加入 profile 的 `pnpm-workspace.yaml` 的 `minimumReleaseAgeExclude`。 |
+| 插件显示「已停用/未挂载」且无错误 | 检查 profile 组合。 |
+| client 入口不在 `__DSH_BOOT__` | 确认 `exports["./client"]` 存在且 host fiber 已建立。 |
+| 冻结/恢复按钮不工作 | 如使用会话级锁定，确保 session-guard 已安装；未安装时插件以 fail-open 方式运行。 |
+| 浏览器显示旧 bundle | 升级后硬刷新（Ctrl+Shift+R）。 |
+
+## 7. 卸载
+
+使用官方命令：
+
+```bash
+dsh plugin --profile <profile> remove dsh-input-traffic
+```
+
+重启后，公式队列 dock 与「繁忙时 Enter 键行为」设置行将恢复。

package/README.md

@@ -25,14 +25,17 @@
 - [日本語 changelog](./CHANGELOG.ja.md)
 - [한국어 changelog](./CHANGELOG.ko.md)
 
-> **▼ DSH 版本适配**
-> | DSH 版本 | 队列条 / 冻结按钮 | 繁忙时 Enter 钉住 | 关键差异 |
-> | --- | --- | --- | --- |
-> | 0.1.1-rc.2 | ✅ | ✅ | `conversation.input.right` 仍带 `InputZone` owner（插件已不依赖） |
-> | 0.1.2-rc.1 | ✅ | ✅ | 该槽改为无 owner（`InputBar.tsx:466` 传 `{}`）；冻结按钮改读会话标准件 `useSession` |
+> **▼ DSH 版本适配（旧版线 compat）**
 >
-> - **单一产物，运行时自适应**：同一份 `lib/client.js` 在两个版本都可用。客户端 bundle 只 `require` `react` / `react/jsx-runtime` / `@deepseek-ai/dsh-client-ui-primitives`，三者在两版的共享模块表内，不涉及 `dsh-client-runtime` → `dsh-client-store` 的改名。
-> - **只消费两版共享面**：队列条在 `conversation.input.dock`（两版都带 `InputZone` owner，`input.draft` 两版都有）；冻结按钮在 `conversation.input.right`，该槽 0.1.2 起不再传 owner，因此组件只读 `useSession` / `sessionId`——两者在两版 `SessionStandardProps` 中都有。
+> 本版本（`0.2.10-beta.x`）**仅支持 DSH < 0.1.2-alpha.1**（0.1.0 / 0.1.1 系列）。
+>
+> | DSH 版本 | 状态 | 安装命令 |
+> | --- | --- | --- |
+> | < 0.1.2-alpha.1 | ✅ 支持（本安装线） | `npm i dsh-input-traffic@compat` |
+> | ≥ 0.1.2-alpha.1 | ❌ **不支持** | 请改用 `npm i dsh-input-traffic@beta`（0.2.11+） |
+>
+> - **分界点**：`@deepseek-ai/dsh-client-runtime` 在 DSH `0.1.2-alpha.1` 被整体删除（commit `be531688f3`）。本版本仍使用它发布的 `ClientContext` / `SessionId`，所以在 0.1.2+ 上会解析失败——`engines.dsh` 已收窄为 `>=0.1.0-rc.7 <0.1.2-alpha.1` 以挡住误装。
+> - **序列关系**：`compat` = 0.1.0/0.1.1 线（本版本）；`beta` = 0.1.2+ 线（0.2.11 起，改为从 `@deepseek-ai/cordis` 取 `Context`）。两条线互不覆盖。
 > - **队列条位置**：注册 `order: 1000`，排在 `conversation.input.dock` 带内所有已知条目（todo 0 / goal 10 / 官方 queue 20 / dsh-perm-gate 提示 30）之后，紧贴输入卡片。DSH 没有 "last" 语义，这是约定而非结构性保证——第三方插件若注册更大的 `order` 仍可能插到它下面。
 
 > **兼容性说明：** v0.2.9 已包含日语（`ja`）和韩语（`ko`）字典，但当前官方 DSH 只通过 `LocaleRuntime` 提供 `zh` 和 `en`。在原版 DSH 中选择 `ja` 或 `ko` 会失败，并提示 `locale "<id>" is not registered`。需要等待官方 DSH 增加对应 locale ID 后才能正常使用。高级用户可以维护 DSH fork，在 `packages/client/locale/src/locale-settings.ts` 更新 `LOCALE_IDS`，在 `packages/client/locale/src/client/index.ts` 更新 `LOCALES` 标签，并补齐核心字典和测试，然后重新构建并运行 fork 版本。仅修改本插件无法扩展 DSH 的全局 locale 列表。