# DSH 0.2.1 系列兼容说明

## 2026-10-30：0.2.1-rc.5 验证

插件版本：**0.5.2**（基于 0.5.1 的兼容验证，发布仅调整元数据、文档及测试）。最低宿主：**0.2.1-rc.2**。本次验证宿主：**0.2.1-rc.5**；Node.js：**22.23.2**。

`engines.dsh` 限定为 `>=0.2.1-rc.2 <0.2.2-0`。不将 0.2.2-alpha 或未来 0.2.2 正式版视为已兼容；该分支的工具、会话投影及 PTC 接口需要另行适配。

使用独立源码快照与真实 rc.5 依赖执行现有构建／回归检查，**190 项测试通过**。另有 1 项旧版 Sylva 场景测试按原设置跳过。不使用生产凭据或真实渠道。桌面端来源测试不等同于原生桌面应用的完整验收。


开发依赖保留 rc.2 作为最低支持基线；验证 rc.5 时在独立依赖目录中解析 rc.5 的宿主包。运行所用接口无需改写，已有 rc.2 部署不需要为了本次兼容说明强制升级或迁移数据。

上游差异：[rc.2 → rc.5](https://github.com/deepseek-ai/deepseek-harness/compare/dsh-v0.2.1-rc.2...dsh-v0.2.1-rc.5)。新增导航“更多”入口及思考展示字段不要求本插件替换宿主组件。

---

以下为历史适配记录，其版本号仅指当次验证。

# DSH 0.2.1-rc.2 兼容适配

本版本：0.5.0-rift.19。宿主目标：DSH 0.2.1-rc.2；旧版 DSH 请继续使用原插件版本。

基于现有罗小黑 Rift 主题适配新版依赖；不重做视觉效果，不回退已确认的衣角、嘿咻与侧栏交互。

所有 DSH 构建依赖固定为 0.2.1-rc.2，运行时 peerDependencies 与 engines.dsh 明确包含该预发布版本。不能仅根据声明判定兼容；升级前需在无生产凭据、无真实渠道的隔离容器验证。

本次不修改 DSH 核心源码，不迁移或清理生产会话与插件数据。

## 刷新与交互反馈补充修复

- 背景 WebGL/图集尚未就绪或不可用时，仍保留轻量界面反馈；减少动态、用户暂停、后台/失焦策略继续有效。
- 会话/目录行、原生 `data-files-entry` 文件按钮及实际输入卡片恢复轮廓向外扩散，不缩放控件本身。装饰层挂在 body，在 900ms 内跟随真实控件的位置与尺寸，不继承 shell.overlay 的坐标偏移；连续触发替换旧轮廓，失焦、暂停、减少动态和卸载均清理。
- 适配原生 `hidden="until-found"` 折叠：只清除外层的背景、边框、内边距与伪元素，避免回答结束后留下 24px 空白气泡；不改 `display`，保留页面搜索、原生展开和最终答复。
- 动效分块下载失败最多重试三次，成功只挂载一次，卸载取消重试并忽略迟到结果；失败保留静态背景。
- 页面从浏览器历史缓存恢复时重新同步焦点与动画状态。

验证：主题测试 161 项通过、1 项已有跳过；浏览器契约验证浅深色轮廓坐标、变换祖先、输入框尺寸变化、连续触发及销毁，以及浅深色 × 手机/桌面折叠容器不留空白、展开内容正常、回写与元数据仍为纯文字。

新版网页端默认工作步骤展示为“详细”（进行中展开、历史收起）。希望执行时就归入过程折叠项，可在 DSH 通用设置选择“标准”；主题不篡改宿主的展示偏好。

轮廓细节恢复：沿用旧版左上、右下两个 4×32px 斜切粗块，分别向左上/右下移动并在 850ms 内淡出；与轮廓共用定位和销毁流程，不额外移动原生控件。