--- title: "DSH 0.2 系列版本总览：从 0.2.0 到 0.2.2-rc.2 的变化与升级要点" seo_title: "DeepSeek Harness 0.2 版本总览：0.2.0、0.2.1、0.2.2 变化与升级要点" description: "一页看懂 DeepSeek Harness 0.2 系列：桌面端、凭据优先级、插件兼容规则、Node 24.9、默认行为和 0.2.2-rc.2 预发布变化，按你当前的版本找到升级前要检查的事项。" canonical: https://52dsh.com/tutorials/deepseek-harness-0-2-series-overview/ authors: ["52DSH 编辑部"] audience: [] outcomes: [] prerequisites: ["记下当前运行的 DSH 版本","升级前备份 ~/.dsh"] difficulty: intermediate estimated_action_time: null next_steps: null published_at: 2026-11-11 updated_at: 2026-11-11 verified_on: 2026-11-11 maintenance_status: community verification_level: source_reviewed risk_level: medium dsh_version: 0.2.2-rc.1 plugin_id: null tutorial_kind: null related_plugin_url: null --- # DSH 0.2 系列版本总览：从 0.2.0 到 0.2.2-rc.2 的变化与升级要点 一页看懂 DeepSeek Harness 0.2 系列：桌面端、凭据优先级、插件兼容规则、Node 24.9、默认行为和 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。 ## 版本时间线 | 版本 | GitHub 发布 | npm | 说明 | |---|---|---|---| | `0.2.0-rc.1` | 2026-09-28 | 已发布 | 0.2 系列第一个版本，没有 0.2.0 alpha | | `0.2.0-rc.2` | 2026-09-29 | 已发布，本站 09-30 核对时为 latest | 本站 09-30 起以它为默认 | | `0.2.1-alpha.1` ～ `alpha.5` | 10-03 ～ 10-16 | 已发布（alpha 通道） | 开发预览 | | `0.2.1-rc.1` / `rc.2` | 10-17（同一天） | 已发布 | rc.2 适配 DeepSeek-V4.1-Flash-1017 | | `0.2.1-rc.3` / `rc.4` | 10-23 / 10-28 | 已发布 | 小幅改进 | | `0.2.1-rc.5` | 10-30 | 已发布，本站 11-01 核对时为 latest | 本站 11-01 起以它为默认 | | `0.2.2-alpha.2` / `alpha.3` | 10-28 / 11-03 | 已发布（alpha 通道） | 开发预览 | | `0.2.2-rc.1` | 11-04 | 已发布，11-11 为 latest 与 next | **本站当前默认**，11-06 起 | | `0.2.2-rc.2` | 11-11 | **未发布** | 只在 GitHub 预发布 | npm 不保留 `latest` 标签的历史，表中“为 latest”只是本站当天核对的结果，不代表官方完整的发布记录。 ## 先确认你现在用的版本 - **还在 0.1.x：** 先看 [0.2.0](#020桌面端与插件版本范围) 的插件变化。旧插件如果只声明支持 `^0.1.x`，升级后会被拒绝加载。 - **在 0.2.0 或 0.2.1 的 alpha、早期 rc：** 重点看 [0.2.1](#021凭据优先级插件接口与-v41-flash-1017) 的凭据优先级和插件接口变化。 - **在 0.2.1-rc.5 并准备升到当前默认：** 先确认 Node.js ≥24.9.0，再看 [0.2.2-rc.1](#022-rc1当前默认node-249-与默认行为) 的默认行为变化。 - **想试 0.2.2-rc.2：** 它还不在 npm 上，只能从源码运行，或等待官方发布。变化见[最后一节](#022-rc2仅-github-预发布)。 无论从哪个版本升级，都先按[更新与卸载指南](/tutorials/dsh-update-uninstall/)记录当前版本、备份 `~/.dsh`，并确认回退方法。 ## 0.2.0：桌面端与插件版本范围 - **桌面端：** 官方 2026-09-29 推出 macOS 和 Windows 桌面端。`0.2.0-rc.2` 起可以在桌面端菜单里安装 `dsh` 命令，并管理插件，不需要另装 Node 或 pnpm。从图形界面启动时，会读取 macOS 和 Linux 的登录 shell 环境（PATH、代理等）。详见[桌面端安装与使用](/tutorials/dsh-desktop-app-guide/)。 - **插件被停用：** 0.1.7 已经开始检查插件声明的 DSH 版本范围。升级到 0.2.0 后，只声明 `^0.1.x` 的插件不再满足条件，会被拒绝安装，已装的会在启动时停用。处理方法见[升级到 0.2.0 后已装插件被停用](/tutorials/dsh-update-uninstall/#升级到-020-后已装插件被停用)。 - **模型目录：** 第三方模型目录更新到 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 指南](/tutorials/dsh-headless-guide/)。 - **插件兼容判断：** 优先按插件 `package.json` 的 `engines.dsh` 判断，没有声明时沿用原来的规则。 - **插件开发接口：** 移除运行时 invariant 插件和各包的 `./invariant` 导出。自定义扩展或 Profile 用到它们时需要调整。 - **工具展示模式：** 移除 `both` 混合模式，只保留 `native` 和 `ptc`。 - **Azure：** Azure 提供方从 `azure-openai-responses` 改名为 `azure`。 **新功能：** - 可以从“自定义插件索引源”发现和安装插件，见[插件发现与索引教程](/tutorials/dsh-plugin-discover-index-sources/)； - 插件支持热重载； - 实验性 Git Worktrees 插件； - 自动化任务改为 Web 内置功能，已有任务保留。 **DeepSeek-V4.1-Flash-1017：** 官方 X 账号 2026-10-17 的[帖子](https://x.com/DeepSeekHarness/status/2111376365497077958)说 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 试用前检查](/tutorials/dsh-update-uninstall/#021-rc2试用前检查凭据与搜索)。 ## 0.2.2-rc.1（当前默认）：Node 24.9 与默认行为 **升级前必须处理：** - **Node.js ≥24.9.0。** Node 22 不再支持，先升级 Node，见 [Node 版本错误排查](/errors/dsh-node-version-error/)。 - **工作树入口合并：** 原来的“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 默认版本升级检查](/tutorials/dsh-update-uninstall/#022-rc1默认版本升级检查)和[运行时与插件变化说明](/tutorials/dsh-update-uninstall/#022-rc1预发布评估前先看运行时与插件)。 ## 0.2.2-rc.2（仅 GitHub 预发布） 2026-11-11 发布到 GitHub，截至当天**还没有发布到 npm**。以下内容来自官方 Release 说明和升级指南目录，本站还没有按固定源码逐项复核： - **网页搜索默认改用 DeepSeek Search API：** 搜索和抓取可以分别选择计费账号或 API Key。旧提供方和自定义配置需要按升级指南调整，Exa 和 Perplexity 的独立包已移除。现有的[搜索与抓取配置教程](/tutorials/dsh-web-search-fetch-guide/)按 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 的升级指南目录](https://github.com/deepseek-ai/deepseek-harness/tree/ddac96760b6edf8fa0fe17cbdcf0b512f4c12b2c/docs/upgrade-guide)，从你当前版本对应的文件夹开始，逐个往后读到目标版本，每篇看 `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 中确认。 ## 原始来源 - https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.2.0-rc.1 - https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.2.0-rc.2 - https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.2.1-rc.1 - https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.2.1-rc.2 - https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.2.1-rc.5 - https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.2.2-rc.1 - https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.2.2-rc.2 - https://github.com/deepseek-ai/deepseek-harness/blob/66491b05e3f05ad35bcdd4f6cd7ed26041d9e3db/package.json - https://github.com/deepseek-ai/deepseek-harness/tree/ddac96760b6edf8fa0fe17cbdcf0b512f4c12b2c/docs/upgrade-guide - https://www.npmjs.com/package/@deepseek-ai/dsh - https://x.com/DeepSeekHarness/status/2111376365497077958