# DSH 0.2.1-rc.1 适配记录（插件 v0.28.0 正式版）

> 状态：实施中。RC 挂载与发布尚待验证；不声明已经发布或完整验收通过。本记录只采用本次 RC 的新鲜证据，不沿用已发布 alpha 的测试数字。

## 1. 已批准范围与支持线

- 宿主基线：DSH `0.2.1-rc.1`；插件正式版本：`0.28.0`。
- 13 条 DSH peer 下限统一为 `^0.2.1-rc.1`；开发依赖、CI 与安装脚本精确钉 RC。
- 本次不改功能实现、不新增运行时兼容层；沿用 alpha.5 适配的 Connection admission、当前执行目录、终端 labels、Context 联动及 Git 图谱等行为。
- 伴随依赖：Cordis peer `^4.0.5` / dev `4.0.5`、group `1.0.5`、schemastery `~3.18.5`、include `1.0.10`。

| 宿主版本 | 使用插件 |
| --- | --- |
| DSH 0.2.1-rc.1+ | v0.28.0 |
| DSH 0.2.1-alpha.5 | 固定 v0.28.0-alpha.0 |
| DSH 0.2.0-rc.2 | 固定 v0.26.1 |
| DSH 0.2.0-rc.1 | 固定 v0.24.1 |
| DSH 0.1.7-rc.1 至 0.1.7 正式版 | 固定 v0.22.1 |
| DSH 0.1.7-alpha.x | 先升级宿主到 rc.1 |
| DSH 0.1.6 及更早（含 0.1.5） | 固定 v0.19.1 |

## 2. 上游差异与功能边界

已批准计划的源码取证结论：alpha.5 → rc.1 上游完整树差异共 **355 个文件，全部为 `package.json`，源码零变化**。因此本批适配只更新版本、依赖与文档，不借版本前移增加功能或重写既有实现。

主线程另行完成已发布产物核查：24 个消费包 × 两个版本，共 48 个 tarball 的 integrity 均匹配；非 manifest 内容除 client-modules 的一行遥测 commit 戳外相同，消费声明与裸 import 差集无变化。会话格式仍为 4，子代理描述符仍为 3，profile roster 仍为 58 项。源码树与已发布产物分别记录，不把产物遥测戳误写成源码行为变化。

## 3. 正式版进入 latest 的明确风险

v0.28.0 **即将接管插件 npm `latest`**，而 DSH 自身的 npm `latest` 此时仍指向 **0.2.0-rc.2**。用户已明确接受这一标签分离：不能把“宿主和插件都装 latest”当作兼容安装方法。

- 新用户须先显式升级宿主到 `0.2.1-rc.1`，再安装插件 v0.28.0。
- 旧 rc.2 宿主必须固定 `dsh-better-sidebar@0.26.1`；旧 alpha.5 固定 `dsh-better-sidebar@0.28.0-alpha.0`。
- 不为保留旧宿主而放宽本版 peer 下限。
- 发布沿用现有 workflow：无预发布后缀的插件版本进入 `latest`，不修改 workflow，也不把本次插件正式版标成 alpha。

正式版安装命令（发布完成后）：

```sh
dsh plugin --profile web add dsh-better-sidebar@0.28.0
```

## 4. 本次 RC 验证矩阵

以下已执行结果由主线程提供并回填；文档子任务本身未运行测试、安装、构建或打包。未完成项保持待验证。

| 检查 | 当前状态 |
| --- | --- |
| 上游完整源码树差异 | 已核对：355 项全部 package.json，源码零变化 |
| 消费包产物 integrity / 类型面 / import 差集 | 主线程已复核报告：48 tarball integrity 匹配，类型及 import 无变化 |
| 会话格式 / 子代理描述符 / profile roster | 主线程已复核：4 / 3 / 58，未变 |
| 安装 RC 依赖与 peers 检查 | 已执行；仅可选 better-locale 的 4 条历史 peer 警告 |
| typecheck / lint | 主线程报告通过 |
| 构建后完整单元测试 | 主线程报告：221 文件，2682 passed / 17 skipped（共 2699），28.83 s |
| build / browser consumer types / pack | 主线程报告通过 |
| 精确 DSH 0.2.1-rc.1 真实挂载 | 13 passed / 3 skipped，2.6 min；Context 专用用例由独立三态 lane 覆盖 |
| RC 聚合双挂载与 Context 联动 | 通过；聚合 settings.get 返回 ok:true、未知方法 404；Context dual / tab-only / no-context 三态各 1 项通过，另 2 项按变体跳过 |
| 远端 Linux / Windows / plugin-mount CI | 待验证 |
| GitHub Release 与 npm latest / provenance | 待发布与验证 |

## 5. 文档同步与历史保留

当前基线、安装警告、支持线和伴随依赖同步至 AGENTS、双语 README、接入指南及宿主契约；双语 CHANGELOG 只新增 v0.28.0 条目，已发布 v0.28.0-alpha.0 及更早正文不改写。历史 alpha 验证记录仅作历史，不作为 RC 挂载或发布成功的证据。