dsh-input-traffic 0.2.10-beta.3 → 0.2.11-beta.1

package/CHANGELOG.md

@@ -4,16 +4,14 @@
 
 ## 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 一致。
+### 破坏性：仅支持 DSH 0.1.2+，完成 `dsh-client-runtime` 移除替换（0.2.11-beta.1）
+
+- **`engines.dsh` 收窄为 `>=0.1.2-alpha.1 <0.2.0-0`**：`@deepseek-ai/dsh-client-runtime` 在 0.1.2-alpha.1 被整体删除（commit `be531688f3`），该版本即为本插件的硬分段点。旧版线（≤0.2.10-beta.2）继续服务 DSH 0.1.0/0.1.1。
+- **`ClientContext` / `SessionId` 改由真实归属包提供**：`src/client/index.ts` 改为 `import type { Context as ClientContext } from '@deepseek-ai/cordis'` 与 `import type { SessionId } from '@deepseek-ai/dsh-session/types'`，与官方客户端插件一致。
+- **契约拆除 `dsh-client-runtime` 镜像**：`src/types/contracts.d.ts` 删除 `declare module '@deepseek-ai/dsh-client-runtime/client'`；`QueuedMessage` / `SessionSnapshot` / `ISessions` 迁回 `@deepseek-ai/dsh-api-session-controller/client`，`SnapshotSelectorHook` 迁回 `@deepseek-ai/dsh-client-store`。
+- **新增 `src/types/cordis-augment.d.ts`**：把 `slots` / `sessions` / `locale` / `settingsScope` / `conversation` 声明到 cordis `Context`（官方客户端插件的做法），替代已删除的 `ClientContext`；`ctx.get<IConversation>('conversation')` 相应改为 `ctx.get('conversation')`，因为真实 cordis `get` 由 `Context[K]` 决定返回类型。
+- **`SettingsScopeSnapshot` 补齐 `base` / `user` / `revision`**，`SettingsScopeFace.bind` 增加可选 `decode`。
+- **新增 `@deepseek-ai/dsh-session` peerDependency**；其余 `@deepseek-ai/dsh-client-*` peer 区间同步收窄到 `>=0.1.2-alpha.1 <0.2.0-0`。
 
 ### 变更：冻结按钮文案与 session-guard 的分工说明
 

package/INSTALL.md

@@ -19,6 +19,17 @@ The placeholders in this guide are:
 - `<profile>`: the DSH profile to modify, usually `web`;
 - `dsh-input-traffic`: the npm package and runtime plugin ID.
 
+> **Version requirement — DSH v0.1.2 or newer.**
+>
+> Check the running version first (`dsh --version`).
+>
+> | DSH version | Action |
+> | --- | --- |
+> | ≥ 0.1.2 | Install this release. |
+> | < 0.1.2 | Stay on the previous plugin line (0.2.10-beta.2 or earlier). Do not run an older plugin build against DSH v0.1.2+ — upgrade the plugin instead. |
+>
+> The boundary is `0.1.2-alpha.1`, where DSH removed `@deepseek-ai/dsh-client-runtime`. This release imports `Context` from `@deepseek-ai/cordis` and `SessionId` from `@deepseek-ai/dsh-session/types` instead, matching the official client plugins.
+
 ## 0. Prerequisites and profile discovery
 
 ```bash

package/INSTALL.zh.md

@@ -19,6 +19,17 @@
 - `<profile>`：要修改的 DSH profile，通常是 `web`；
 - `dsh-input-traffic`：npm 包名与运行时插件 ID。
 
+> **版本要求 —— 仅支持 DSH v0.1.2 及以上。**
+>
+> 安装前先确认版本（`dsh --version`）。
+>
+> | DSH 版本 | 操作 |
+> | --- | --- |
+> | ≥ 0.1.2 | 安装本版本。 |
+> | < 0.1.2 | 留在旧版插件（0.2.10-beta.2 及更早）。**不要在 v0.1.2+ 的 DSH 上运行旧版插件，请升级插件。** |
+>
+> 分界点是 `0.1.2-alpha.1`：该版本删除了 `@deepseek-ai/dsh-client-runtime`。本版本改为从 `@deepseek-ai/cordis` 引入 `Context`、从 `@deepseek-ai/dsh-session/types` 引入 `SessionId`，与官方客户端插件一致。
+
 ## 0. 前置检查与 profile 确认
 
 ```bash

package/README.md

@@ -25,17 +25,17 @@
 - [日本語 changelog](./CHANGELOG.ja.md)
 - [한국어 changelog](./CHANGELOG.ko.md)
 
-> **▼ DSH 版本适配（旧版线 compat）**
+> **▼ DSH 版本适配**
 >
-> 本版本（`0.2.10-beta.x`）**仅支持 DSH < 0.1.2-alpha.1**（0.1.0 / 0.1.1 系列）。
+> 本插件 **仅支持 DSH v0.1.2+**。
 >
-> | DSH 版本 | 状态 | 安装命令 |
+> | 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+） |
+> | ≥ 0.1.2-alpha.1 | ✅ 支持 | 覆盖 0.1.2 / 0.1.3 / 0.1.4 / 0.1.5 系列 |
+> | < 0.1.2-alpha.1 | ⚠️ 不建议 | 请留在旧版插件（0.2.10-beta.2 及更早）；**不要在 v0.1.2+ 的 DSH 上运行旧版插件，请升级** |
 >
-> - **分界点**：`@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`）。两条线互不覆盖。
+> - **分界点在 0.1.2-alpha.1**：`@deepseek-ai/dsh-client-runtime` 在该版本被整体删除（commit `be531688f3`），它发布的 `ClientContext` / `SessionId` 不再存在。本版本起改为从 `@deepseek-ai/cordis` 引入 `Context`、从 `@deepseek-ai/dsh-session/types` 引入 `SessionId`，与官方客户端插件一致。
+> - **旧版为什么不能配新版 DSH**：旧版产物中的 `.d.ts` 仍引用已删除的 `@deepseek-ai/dsh-client-runtime/client`，在 v0.1.2+ 上做类型检查会解析失败。运行时 bundle 虽自包含，仍请一律升级到本版本。
 > - **队列条位置**：注册 `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 列表。