# DSH 0.2.1 候选版本适配

插件版本：0.3.2。核对日期：2026-10-17。

## 官方基线

- 目标发行版：`dsh-v0.2.1-rc.2`，提交 `687f282e8625c6b8d11ff58211a90524be2e4317`。
- 实际安装验证的开发依赖：`0.2.1-rc.1`，对应提交 `1600d8a1e140dcde43a1a0941940a0480712c011`。
- 核对时包仓库尚未提供 `@deepseek-ai/dsh-client-connection@0.2.1-rc.2`，所以未声称已经安装 rc.2 整套宿主。
- 对两个标签执行源码差异检查：connection、ui-settings、ui-plugin-manager、ui-sidebar、ui-layout、ui-slots、ui-renderer、workspace、Cordis 和 Schemastery 的 `src` 均无差异。因此使用 rc.1 配套包验证本插件消费的 rc.2 接口。

官方发布页：<https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.2.1-rc.2>。

## 修改内容

1. 新版通信服务的共享浏览器主体由 `operator`（操作主体）改为 `browserPeer`（浏览器连接主体）。传输适配层优先使用新版字段，旧版使用旧字段；缺失主体会在注册时明确报错。继续保留精确认证路由，不接管共享网关。
2. 新版通信客户端按 `node`（服务器运行环境）和 `browser`（浏览器运行环境）条件分别导出。真实发布包测试明确选择浏览器入口，避免把服务器模块作为浏览器工厂执行。插件自身浏览器工厂注册格式无需变更。
3. 开发依赖更新到 0.2.1-rc.1，Cordis 更新到 4.0.5，Schemastery 更新到 3.18.5，附带新的 `pnpm-lock.yaml`；继续允许 esbuild 安装构建脚本。
4. 保留宿主范围 `>=0.2.0-rc.2 <0.3.0-0`。顶层宿主声明与各 DSH 宿主依赖范围一致。新版宿主优先使用顶层声明，旧版检查仍可通过。

## 验证结果

| 环境 | 实际验证 | 结果 |
| --- | --- | --- |
| 0.2.1-rc.1 配套依赖 | `pnpm check`：类型检查、全部测试、双端构建 | 87 项测试通过 |
| 0.2.1-rc.1 配套依赖 | `node scripts/smoke-built.mjs`：宿主产物导入、配置默认值、浏览器模块注册 | 通过 |
| 0.2.0-rc.2 配套依赖与 Cordis 4.0.4 | 独立目录类型检查、传输与真实浏览器通信及原生面板测试、双端打包和产物检查 | 39 项测试通过 |
| rc.1 → rc.2 | 本插件直接消费的官方接口源码差异检查 | 无差异 |

全部测试包含临时 Git 仓库操作、提交差异、分支切换、批量并发、配置、原生面板挂载，以及拉取时保留本地修改和拒绝覆盖风险。

最低版本验证继续使用本插件声明的直接依赖 Schemastery 3.18.5。测试没有依赖开发者的实际 Git 仓库。

## 安装与验收

解压源码包，在包含 `package.json` 的目录执行：

```powershell
pnpm install --frozen-lockfile
pnpm check
node scripts/smoke-built.mjs
dsh plugin --profile web add ./
```

隔离测试可将 `web` 替换为已创建的测试配置名称。源码包不包含 `node_modules` 或构建产物，必须先安装依赖并构建。

已有插件通过管理页更新后，按 DSH 提示进行热重载或重启。仅停用再启用不会自动更新源码或重新构建。代理策略沿用既有配置，本次不执行配置迁移。

尚未完成完整 DSH 桌面端与网页端人工验收。在实际环境重点检查：无会话工作区发现、工作台打开和关闭、网络设置保存与清除、深浅色切换、暂存和提交、非冲突修改下拉取，以及插件更新后入口和路由没有重复。Windows 运行行为仍需在用户实际环境确认。