DSH 兼容约定

September 11, 2026 · View on GitHub

核验日期：2026-09-11。

来源	版本	精确提交	本轮验证
npm next 发布包	`0.1.5-rc.2`	发布包安装与锁文件	类型检查、80 项单元/集成测试、生产构建、pack dry-run
DSH 0.1.2-rc.1 源码	`0.1.2-rc.1`	`a66e4702047846cdaa10c66c9d3df3951f5ea70d`	类型检查、80 项测试、7 个 Web 场景、3 个 M6 场景
DSH alpha.1 源码	`0.1.3-alpha.1`	`d347e703908d0406b7a7ef80e3a0e594d86b2215`	类型检查、80 项测试、7 个 Web 场景、3 个 M6 场景
DSH alpha.2 源码	`0.1.3-alpha.2`	`82a5fd61a7cf5c293cec4bdff68f455398d685e9`	类型检查、80 项测试、7 个 Web 场景、3 个 M6 场景
DSH 0.1.5-alpha.1 源码	`0.1.5-alpha.1`	`5dda764ed3aa172535a7967b06ff95d9cbfe536a`	类型检查、80 项测试、7 个 Web 场景、3 个 M6 场景
DSH 0.1.5-alpha.2 源码	`0.1.5-alpha.2`	`b2e3b2a0125854567a4a5fcba75782e42fe84901`	类型检查、80 项测试、7 个 Web 场景、3 个 M6 场景
npm latest 对应源码	`0.1.5-rc.1`	`183f08e9c6dde7e36cd2318eaee70b0da08fb35e`	类型检查、80 项测试、7 个 Web 场景、3 个 M6 场景
最新 DSH 源码发布	`0.1.5-rc.2`	`fb2c4b9e698e30edb738bca4cf0618587db7d203`	类型检查、80 项测试、7 个 Web 场景、3 个 M6 场景

官方 0.1.5-rc.2 发布页的发布时间为 2026-09-10 15:09:34 UTC；0.1.5-rc.1 发布于同日 03:09:00 UTC。npm next 指向 0.1.5-rc.2，latest 为 0.1.5-rc.1，alpha 为 0.1.5-alpha.2。开发依赖和锁文件精确固定 rc.2，peerDependencies 显式接受七个已验证的预发布版本。

rc.2 优化原生点赞/点踩反馈弹窗和交付文件卡片。Explain 使用自己的反馈按钮、conversation 内部视图与快捷入口；实际组装验收验证设置、来源跳转、学习反馈、导出清空和编辑草稿。Session 仍为 format 3，消费的 Session、conversation 输入和设置插槽类型与 alpha.2 一致，无需修改产品运行时或快照期望。

发布包依赖修复

dsh-client-store 在 0.1.5-alpha.2、0.1.5-rc.1 和 0.1.5-rc.2 的产物中仍导入 Zustand/Immer，但 manifest 仅将两者列为 devDependencies。独立 npm 安装对照：0.1.5-alpha.1 导入成功，两个新 rc 版本均报 ERR_MODULE_NOT_FOUND: zustand；原 alpha.2 复现记录保留在 M16。

pnpm-workspace.yaml 的 packageExtensions 只匹配上述三个已复现版本，补齐原依赖范围 immer: ^10.1.1 与 zustand: ~4.4.7，锁文件记录修复。rc.2 发布包经 frozen install、类型检查、80 项测试、构建与 pack dry-run 通过；上游进展与更广的静态客户端打包问题见 Discussion #6082。静态库产物保留 bare imports，而上游依赖门禁要求浏览器输入仅列为开发依赖，完整修复需要维护者统一产物与依赖规则。本项目只修复实际消费的 store；该配置作用于本仓库 pnpm 安装，不代表其他消费方或上游发布包已修复。

安装

npx @deepseek-ai/dsh@0.1.5-rc.2 plugin --profile web add github:yuezengwu/dsh-explain
npx @deepseek-ai/dsh@0.1.5-rc.2 --profile web

如使用 npm 默认渠道，将两条命令中的版本均替换为 0.1.5-rc.1；旧 0.1.2-rc.1 也继续受支持。Explain 当前 GitHub 安装使用 main；最新标签仍为 v0.2.0，尚未发布 v0.3.0。宿主的 Session 格式迁移与插件 SQLite 分开管理：升级前保留 DSH 数据备份；七个版本的独立验收不表示新版 Session 文件能降级给旧宿主读取。

兼容实现

V3 来源回归在真实 Session 中追加系统提示词，证明其不进入学习 capsule，来源结束坐标和主会话消息不变。合成旧 Web 日志保持先 step/start、再 user/message 的时间顺序，由官方 V0→V3 迁移器转换。
Explain 继续只消费 Session.seq、eventAt()、snapshotEvents() 和 settled assistant/message，不依赖已移除的 durable chunk 事件。
0.1.3-alpha.1/alpha.2 使用 Session format 2，0.1.5-alpha.1/alpha.2/rc.1/rc.2 使用 format 3。测试中的合成 settled assistant 事件补充 stream: []；旧版宿主兼容此额外字段。
真实 Web 夹具通过对应宿主自己的 llm-replay 解析和迁移旧日志。format 2/3 写入使用 SessionHandle.append/flush/close，0.1.2-rc.1 使用原持久化接口。这层分支仅在测试夹具中。
源码链接覆盖所有直接开发依赖和 peer 包，并共用宿主 React/Cordis 实例，避免源码包和 npm 包混装导致对象身份不一致。链接脚本拒绝未经验证的源码版本。
Explain SQLite 保持 schema 4、backup v3，不改写旧记录。薄弱概念通过当前有效状态投影恢复 learning，同时保留原有复习排期。

本地复现

先按 DSH 官方开发说明安装并构建上表任一精确源码版本，再在 Explain checkout 运行：

pnpm install --frozen-lockfile
export DSH_SOURCE_DIR=/absolute/path/to/built/deepseek-harness
pnpm dsh:link
pnpm dsh:link:check
pnpm typecheck
pnpm test
pnpm build
pnpm exec vitest run --config vitest.web.config.ts
pnpm exec vitest run --config vitest.m6.config.ts
pnpm pack --dry-run

本地验证新版插件时，在该 DSH 源码目录调用其 CLI，并使用独立的测试 home：

export DSH_HOME=/absolute/path/to/isolated-test-home
node --import tsx/esm apps/cli/src/bin.ts plugin --profile web add /absolute/path/to/dsh-explain
node --import tsx/esm apps/cli/src/bin.ts --profile web --no-open

CI 检查锁定的 0.1.5-rc.2 发布包及上述依赖修复，并对七个固定源码提交运行完整组装矩阵。上表是本地运行证据；对应提交的 CI 结果见 Actions。Web/M6 使用临时 Session、数据库和无密钥夹具；本轮不构成真实模型教学效果评估。现有 Demo 媒体仍明确标注 0.1.2-rc.1。

修复后的学习行为

同一 context/activity generation 的空闲压缩失败后停止布置零延时定时器；新活动或新可压缩内容再触发。
活跃讲解独立读取，不会因历史超过 30 条而隐藏；历史游标保持原语义。
全局模型请求只含有界 Topic 提示。重讲带目标最新正文和至多三个旧标题，所有历史 revision 仍保存在本地。
partial/forgotten 立即反映为 learning，统一用于 UI、统计、模型提示和自主选题。重新讲解取消旧题，避免在学习中重复测验。
来源摘要、模型出入文本和公开导出过滤常见凭证与路径格式；历史数据不被破坏性改写。该过滤不保证识别任意私人文本，界面明确说明辅助 provider 会收到有界来源文本。
题型按每个概念自己的复习历史推进，成功进入下一题型，失败重复当前题型。