DSH 0.2 系列版本总览：从 0.2.0 到 0.2.2-rc.2 的变化与升级要点

DeepSeek Harness 0.2 系列从 2026-09-28 的 0.2.0-rc.1 开始，到 2026-11-11 已发布到 0.2.2-rc.2，全部是 GitHub 预发布版，还没有正式版。截至 2026-11-11，npm 的 latest 和 next 都是 0.2.2-rc.1，本站默认命令也用这个版本；0.2.2-rc.2 只在 GitHub 发布，npm 上还没有。

这个系列最值得注意的变化：

• 桌面端： 9 月底推出 macOS 和 Windows 桌面端。
• 插件兼容： 插件的 DSH 版本范围检查开始实际拦截旧插件；0.2.1 起优先按 engines.dsh 判断。
• 凭据优先级： 0.2.1 调整了 API Key 的读取顺序。
• Node.js： 0.2.2-rc.1 把最低要求提高到 24.9。
• 默认行为： 0.2.2 的几项默认设置变化。

本页根据官方 Release 说明、固定源码和官方升级指南目录整理，没有运行任何版本。每个版本的完整说明请看官方 Release。

版本时间线

npm 不保留 latest 标签的历史，表中“为 latest”只是本站当天核对的结果，不代表官方完整的发布记录。

先确认你现在用的版本

• 还在 0.1.x： 先看 0.2.0 的插件变化。旧插件如果只声明支持 ^0.1.x，升级后会被拒绝加载。
• 在 0.2.0 或 0.2.1 的 alpha、早期 rc： 重点看 0.2.1 的凭据优先级和插件接口变化。
• 在 0.2.1-rc.5 并准备升到当前默认： 先确认 Node.js ≥24.9.0，再看 0.2.2-rc.1 的默认行为变化。
• 想试 0.2.2-rc.2： 它还不在 npm 上，只能从源码运行，或等待官方发布。变化见最后一节。

无论从哪个版本升级，都先按更新与卸载指南记录当前版本、备份 ~/.dsh，并确认回退方法。

0.2.0：桌面端与插件版本范围

• 桌面端： 官方 2026-09-29 推出 macOS 和 Windows 桌面端。0.2.0-rc.2 起可以在桌面端菜单里安装 dsh 命令，并管理插件，不需要另装 Node 或 pnpm。从图形界面启动时，会读取 macOS 和 Linux 的登录 shell 环境（PATH、代理等）。详见桌面端安装与使用。
• 插件被停用： 0.1.7 已经开始检查插件声明的 DSH 版本范围。升级到 0.2.0 后，只声明 ^0.1.x 的插件不再满足条件，会被拒绝安装，已装的会在启动时停用。处理方法见升级到 0.2.0 后已装插件被停用。
• 模型目录： 第三方模型目录更新到 pi-ai 0.87.1，部分旧模型 ID 被移除，已保存的模型选择可能需要重新选。
• 自动化任务： 0.2.0-rc.1 把它改成可选插件包；到 0.2.1 又改回 Web 内置功能，见下一节。

0.2.1：凭据优先级、插件接口与 V4.1-Flash-1017

会影响现有配置的变化（0.2.1-rc.1 起）：

• API Key 读取顺序： Web 和桌面端优先使用已保存的凭据。Headless 默认改用环境变量和 .env，不再读取已保存的密钥。用 Headless 跑脚本的用户要把密钥放进环境变量，见 Headless 指南。
• 插件兼容判断： 优先按插件 package.json 的 engines.dsh 判断，没有声明时沿用原来的规则。
• 插件开发接口： 移除运行时 invariant 插件和各包的 ./invariant 导出。自定义扩展或 Profile 用到它们时需要调整。
• 工具展示模式： 移除 both 混合模式，只保留 native 和 ptc。
• Azure： Azure 提供方从 azure-openai-responses 改名为 azure。

新功能：

• 可以从“自定义插件索引源”发现和安装插件，见插件发现与索引教程；
• 插件支持热重载；
• 实验性 Git Worktrees 插件；
• 自动化任务改为 Web 内置功能，已有任务保留。

DeepSeek-V4.1-Flash-1017： 官方 X 账号 2026-10-17 的帖子 ↗（外部链接，在新标签页打开）说 0.2.1 支持这个模型，建议升级到 0.2.1-rc.1 或更高版本。Release 说明则把“适配 V4.1-Flash-1017 上线”列在 0.2.1-rc.2 中，两个版本是同一天发布的。想用这个模型，直接用 0.2.1-rc.2 或更高版本最稳妥；当前默认的 0.2.2-rc.1 已经包含。

0.2.1-rc.5 之前的 Node 要求仍是 ^22.19.0 || >=24.0.0。升级前的凭据与搜索检查见0.2.1-rc.2 试用前检查。

0.2.2-rc.1（当前默认）：Node 24.9 与默认行为

升级前必须处理：

• Node.js ≥24.9.0。 Node 22 不再支持，先升级 Node，见 Node 版本错误排查。
• 工作树入口合并： 原来的“Git 工作树”入口并入实验性“变更请求与工作树”。如果用过旧的实验插件，需要手动从 Profile 里移除 @deepseek-ai/dsh-experimental-tool-worktree。
• 插件开发接口有破坏性调整： 例如模型改由 agent.model 选择，工具解析和提示词组装接口有变化，官方组合包列表改由 @deepseek-ai/dsh-official-bundles 导出。旧插件即使通过了版本声明检查，也不代表能正常加载。

默认行为变化：

• 文件修改前的“先读后改”防护默认关闭；
• 默认网页抓取不再拦截本机和内网地址，共享部署需要自己限制网络；
• 没有配置凭据时，模型拿不到 Web 搜索工具；
• “自定义插件市场”改名为“自定义插件索引”，可以在插件页更新第三方插件；
• 完善手机和平板适配，pi-ai 升级到 1.3.0。

逐项检查方法见0.2.2-rc.1 默认版本升级检查和运行时与插件变化说明。

0.2.2-rc.2（仅 GitHub 预发布）

2026-11-11 发布到 GitHub，截至当天还没有发布到 npm。以下内容来自官方 Release 说明和升级指南目录，本站还没有按固定源码逐项复核：

• 网页搜索默认改用 DeepSeek Search API： 搜索和抓取可以分别选择计费账号或 API Key。旧提供方和自定义配置需要按升级指南调整，Exa 和 Perplexity 的独立包已移除。现有的搜索与抓取配置教程按 0.2.2-rc.1 编写，暂不适用于 rc.2。
• 归档会话默认清理 Git 工作树： 只清理符合条件的，分支和提交会保留。需要保留本地目录的话，先关闭这项清理。
• AgentTeam 改用统一的具名子代理，中断工具默认关闭： 自定义插件和 SDK 集成需要迁移；多个进程共用同一个会话时，必须一起升级。
• Office： 改用原生工具，旧的包和技能需要迁移。
• 桌面端： 可在设置中切换正式版和开发版更新渠道。
• 插件： 可以动态注册 MCP 服务；插件索引可以提供 GitHub Star 和 npm 周下载量。
• 模型： 自定义提供方支持 Gemini 原生接口。

官方升级指南怎么查

官方仓库的 docs/upgrade-guide/ 目录按“从哪个版本升级”分文件夹，例如 v0.2.1-rc.2/node-24 讲的是从 0.2.1-rc.2 往后升级时 Node 24 的变化。这个变化实际在 0.2.2-rc.1 才生效。截至 0.2.2-rc.2，0.2 系列共有 141 篇升级指南，分布在 12 个版本文件夹中，其中 46 篇在 0.2.2-rc.1 的源码里还看不到。

查找方法：打开固定在 0.2.2-rc.2 的升级指南目录 ↗（外部链接，在新标签页打开），从你当前版本对应的文件夹开始，逐个往后读到目标版本，每篇看 guide.zh.md。

来源与核对

• 官方 Release：0.2.0-rc.1、0.2.0-rc.2、0.2.1-rc.1、0.2.1-rc.2、0.2.1-rc.5、0.2.2-rc.1、0.2.2-rc.2；0.2.2-rc.1 固定提交 66491b05 的 package.json；0.2.2-rc.2 固定提交 ddac9676 的升级指南目录；npm 包页面；@DeepSeekHarness 2026-10-17 帖子。
• 核对日期：2026-11-11。npm 与 GitHub 状态会继续变化，以官方页面为准。
• 本页没有安装或运行任何 DSH 版本，各项变化是否影响你的环境，请在测试 Profile 中确认。