DeepSeek Harness v0.2.1-rc.3 是 DeepSeek AI 于 2026 年 10 月 23 日发布的智能体框架预发布版本，围绕插件入口、未发送草稿找回和模型列表更新做了三项调整。新增的“更多”菜单方便浏览和创建插件，“新会话”会复用符合条件的空白会话，官方 API Key 模式则在默认目录下跟随服务端模型列表。截至 10 月 26 日，npm 的 latest 仍指向 rc.2，试用 rc.3 需要指定版本。升级时应结合自身的 API 接入方式（官方直连或托管中转）核对版本并逐项验收。
这次更新落在几个每天都会碰到的操作上：找插件、切会话、选模型。官方 GitHub Release 显示，rc.3 发布于 10 月 23 日 23:26，仍标记为预发布版；项目 README 也保留了开发者预览与未来可能出现破坏兼容性变更的提示。
先区分一下版本归属。10 月 17 日的 rc.2 已适配 DeepSeek-V4.1-Flash-1017，以及可在网页搜索设置中开启的 Search、Fetch API。rc.3 的发布说明列出的是下面三项改动，不能把前一版的功能算作本次新增。
核心更新解析
1. 插件入口：三处“更多”菜单能做什么
rc.3 在左侧栏、会话视图和右侧栏新增了“更多”菜单，用来浏览和创建插件。对于经常调整工作区的用户，变化首先体现在操作入口：可以从当前区域进入插件列表，或开始为这个区域创建插件。
根据 rc.3 标签下的入口定制文档，“浏览”会进入插件主列表；“创建你的插件”则进入 Creator 预设，并把当前区域的提示词放进未发送草稿。已有文字、引用和附件会保留，区域提示追加进去。
因此，点一下“创建”只是准备好创作入口，后面仍要检查提示词、发送任务和验证结果。发布说明没有承诺自动完成插件，也没有承诺所有第三方插件都已适配本版。
2. 草稿恢复：切回“新会话”可以找回什么
rc.3 修复的是切换会话后，点击“新会话”找不回未发送草稿的问题。官方升级说明解释，rc.2 的新会话操作每次都会创建新的 Session 和 Agent，被留下的空白会话又不会出现在会话树里，草稿便难以重新打开。
新逻辑会优先复用同一工作区中未开始、未归档的空白会话，没有符合条件的会话才新建。你可以先在新会话里写一段话，暂不发送，切到另一个会话，再点击“新会话”，检查原草稿是否重新出现。
这个修复针对空白会话的复用，不能理解为历史草稿云同步。若你开发了自定义 Agent preset，也要留意官方迁移说明：仍在加载的空白会话会保留创建时的 preset 装配，修改定义后需要验证新会话实际使用的配置。
3. 模型列表：自动更新有两个前提
rc.3 让 DeepSeek API Key 适配器的模型列表更新方式与账号登录模式保持一致。根据指定版本的适配器文档，只有使用官方 Messages 端点、且模型目录未自定义时，才会跟随官方服务端的模型列表。
这意味着符合条件的 API Key 用户可以获取服务端列出的模型，无需每次都等待 Harness 发版更新内置目录。自定义目录则整份优先，其他端点也不会自动采用这套发现机制。
列表获取失败时会保留上一次成功结果，或回退到内置目录；客户端版本与能力限制仍然存在。因此，升级后没有看到预期模型，应先核对端点和目录设置。看到模型名称之后，还需要用实际请求验证当前配置能否调用。
试用 rc.3：先查标签，再固定版本
截至 2026 年 10 月 26 日核验时，npm 包 @deepseek-ai/dsh 的 latest 指向 0.2.1-rc.2，next 指向 0.2.1-rc.3。直接照旧运行不带版本的启动命令，不能确保拿到这次讨论的 rc.3。
先在终端检查本机 Node.js 和 npm 当前标签：
node --version
npm view @deepseek-ai/dsh dist-tags --json
npm view @deepseek-ai/dsh@0.2.1-rc.3 version
rc.3 标签下的根 package.json 声明 Node.js 范围为 ^22.19.0 || >=24.0.0，即 22.19.0 及以上的 22.x，或 24.0.0 及以上版本；不要只按“高于 22”判断，23.x 不在这个声明范围内。
确认环境后，停止原有 Web 进程，再固定版本启动：
npx @deepseek-ai/dsh@0.2.1-rc.3 --version
npx @deepseek-ai/dsh@0.2.1-rc.3 web
第一条检查所调用包的版本，第二条启动 Web UI。官方 README 给出的默认本机地址为 127.0.0.1:3080。运行时可能需要下载 npm 包及依赖。
桌面版用户应使用应用菜单里的“检查更新…”，并核对更新界面实际提供的版本；终端运行指定 npm 包不会替换桌面安装。若界面尚未提供 rc.3，可以先通过上述固定版本的 Web 入口验证。
试用前保留当前安装包，并备份本机配置与工作数据。固定软件版本只控制运行的代码，不会自动隔离既有数据；退回旧包也不等于恢复数据快照。
大模型 API 接入指南：官方订阅与托管中转配置
由于 rc.3 调整了模型目录的自动发现机制，不同 API 接入方式在升级后的配置表现有所区别。在 Harness 中接入大模型通常分为以下两种路径：
1. 官方订阅与 API 直连模式
适合主要依赖单一官方模型生态、且希望直接启用 rc.3“服务端模型列表自动同步”特性的用户。
- 网页端授权登录：启动 Web UI 后，在设置面板直接绑定官方账号，客户端会自动拉取账号权限下的可用模型。
- 官方 API Key 接入：在配置文件或环境变量中填入官方控制台签发的
API Key，将Base URL保持为默认的官方 Messages 端点，且不额外覆盖本地模型目录（Catalog）。在此状态下，rc.3 会在启动和刷新时自动同步官方服务端下发的最新模型列表。
2. 国内托管中转站接入（以 4SAPI 为例）
在实际研发中，如果工作区需要同时调用 DeepSeek 与海外主流模型（如 Claude、GPT 系列），或者在跨区域网络环境下追求更稳定的接口响应，开发者通常会选择接入 4SAPI 等国内托管中转站。
- 接入配置方法：在 Harness 的适配器配置中，将默认
Base URL替换为中转平台提供的兼容接口地址，填入平台分发的统一 API Key，并在配置文件中显式声明自定义模型目录（Custom Catalog）。需要注意，由于修改了默认端点与模型目录，rc.3 将遵循“自定义目录整份优先”原则，跳过官方端点的自动发现逻辑，直接加载你在配置中指定的模型列表。 - 使用托管中转的核心优势：
- 跨网链路优化：通过国内托管节点完成请求转发，减少本地直连海外模型接口时的连接超时与网络抖动，保障长链路 Agent 任务执行的连续性。
- 多模型统一路由：无需在 Harness 中分别维护多个厂商的适配器密钥，仅需一套标准接口与单一 Key 即可在工作区切换调用异构大模型，简化配置管理。
- 并发限流平滑：智能体在执行复杂任务或插件构建时容易触发短时高频请求，托管中转层的通道池分发机制有助于缓解单一官方账号的速率限制（Rate Limit）报错。
升级后，用自己的工作流验收
如果你在 rc.2 上遇到过草稿找不回，或经常浏览、创建插件，这次改动与日常操作直接相关。可以按下面顺序检查：
- 检查插件入口：在左侧栏、会话视图和右侧栏打开“更多”菜单，验证浏览与创建入口是否正常加载。
- 验证草稿复用：在空白会话写入未发送草稿，切到另一个会话，再用“新会话”返回，确认草稿与预设配置未被清空。
- 核对模型目录与端点：使用官方 API Key 默认目录时，检查模型选择器是否同步服务端列表；使用 4SAPI 等自定义中转端点与自定义目录时，确认本地声明的跨模型列表未被覆盖且正常显示。
- 执行真实调用测试：用一个轻量级任务检查常用插件和模型 API 的实际连通性，确认返回正常后再恢复日常工作。
以上是依据官方说明整理的升级与接入验收建议，本文未进行完整工作区迁移或性能测试。根据 rc.3 Release 与固定标签文档，这次更新的重点是操作体验与模型目录维护；是否迁移主工作区，应以自己的 API 配置和插件验收结果为准。本文信息截至 2026 年 10 月 26 日。