DeepSeek Harness（命令名 dsh）是 DeepSeek 开发的开源智能体框架。按 README 的介绍，它采用基于 Cordis 框架的"一切皆插件"架构，工具、技能乃至界面的一部分都是插件，可以自由增删，也可以自己写。DeepSeek 官网称它能处理整理资料、分析表格这类日常工作，也能在代码仓库里写代码、查资料并标注来源，以及在后台跑耗时任务。代码以 MIT 许可证在 GitHub 开源。

它目前仍处于开发者预览阶段。README 用大写字母提醒，未来会出现破坏兼容性的变更；DeepSeek 的安全说明也写明，这款软件没有经过安全审计。由于智能体可以执行模型生成的命令、加载第三方插件，并访问交给它的文件和凭据，DeepSeek 建议只给它必需的最小权限，最好放在虚拟机、容器或其他专用环境里运行，做好备份，并在放行之前先审查插件和它提出的命令。

DeepSeek 对这个工具有多重视，眼下就看得出来。10 月 17 日发布 DeepSeek-V4.1-Flash-1017 时，更新日志专门写到新模型针对 DeepSeek Harness 做了优化，并请用户把 Harness 升级到 0.2.1-rc.1 及以上版本。

桌面版、网页版还是命令行

DeepSeek 提供了三种用法。最省事的是桌面版：DeepSeek 的 Harness 页面提供 Apple 芯片 Mac 和 64 位 Windows 两个下载，没有 Linux 桌面版。按桌面版 README 的说法，桌面应用把完整的网页版装进一个原生窗口，自带 Node.js、pnpm 和 Python 运行环境，系统里不用另装 Node.js。

第二种是 README 首推的 npm 方式，启动网页版；第三种是从源码运行，主要面向开发 Harness 本身的人。Linux 用户只能选 npm 或源码这两种方式。README 没有写明 npm 方式支持哪些系统，不过另一份 Python SDK 指南列出了 Linux x64 和 arm64、macOS 14 及以上（Apple 芯片）以及 Windows x64。

DeepSeek Harness 安装步骤

按 DeepSeek 的 README 和网页版指南，用 npm 跑起第一个会话的流程如下：

  • 安装 Node.js。README 没有指定版本。
  • 在想让智能体处理的项目目录里打开终端，运行 npx @deepseek-ai/dsh web。网页版会在本机 3080 端口启动，并用默认浏览器打开；通过 SSH 启动时只打印地址，加上 --no-open 则只启动服务、不打开浏览器。
  • 在网页版里选择工作区，把启动 dsh 的那个目录添加进来并选中。选好工作区之前，输入框不可用。
  • 按下一节配置模型，然后开始会话。

如果想从源码运行，README 的做法是克隆仓库，依次运行 pnpm install 和 pnpm run build，再用 pnpm dsh web 启动。

Windows 桌面版的安装程序只为当前用户安装。桌面版 README 提到，关闭窗口只会把应用收到系统托盘，正在跑的任务不会中断；应用菜单里的 Manage dsh Command 可以把 dsh 命令加入 Windows 当前用户的 PATH，macOS 上则装到 /usr/local/bin，这样不用另外通过 npm 安装也能在命令行里使用。

有一个细节和后面的升级建议有关。截至北京时间 10 月 17 日 18:30，npm 上 @deepseek-ai/dsh 的默认标签"latest"仍指向 0.2.0-rc.2，0.2.1-rc.2 发布在"next"标签下。README 里的命令没有带版本号，DeepSeek 的文档也没说怎么指定某个版本，所以装好之后最好确认一下实际运行的是哪个版本。想用较新的版本，可以按 npm 指定标签的通用写法运行 npx @deepseek-ai/dsh@next web。这是 npm 的标准用法，不是 DeepSeek 文档里的内容，而且标签在本文发布后可能会变。

npx 安装卡住怎么办

DeepSeek 的 README 和文档都没有提到安装卡住的情况，各版本的发布说明里也没有相关修复。在官方 GitHub 仓库的 Discussions 讨论区，从 8 月起就有用户反映运行 npx @deepseek-ai/dsh web 后 CPU 占满、迟迟不结束，Windows、macOS 和 Linux 上都有人复现。DeepSeek 的维护者 8 月 22 日回复说会调查跟进，此后官方没有给出解决办法。帖子里的各种规避办法都来自其他用户，不是 DeepSeek 的说法。在官方给出的几种方式里，只有桌面版不走 npm 安装，按其 README 的说法，它不依赖系统里的 Node.js 和 pnpm。

把 DeepSeek Harness 接入 deepseek-flash

DeepSeek 的模型配置指南这样介绍用 API key 接入：

  • 在 DeepSeek 开放平台获取 API key。
  • 在 Harness 里打开"设置"→"模型"。DeepSeek 卡片只有一个 API key 输入框，填入后保存即可。key 会存进 Harness 主目录下的凭据文件，之后页面只显示脱敏后的信息，也不需要重启。
  • 在模型选择器里选 deepseek-flash。Harness 内置的 DeepSeek 模型目录包括支持文本和图像的 deepseek-flash，以及纯文本的 deepseek-v4-pro，上下文都是 1M tokens。选中的模型会成为新会话的默认模型。
  • 如有需要，在 Effort 菜单里选择推理强度。DeepSeek 自带的路由提供 off、low、high、max 四档。

DeepSeek API 现在用 deepseek-flash 这个名字提供 V4.1-Flash-1017，所以想用新模型不需要再改别的设置。已经发过请求的会话，会继续使用其日志里记录的模型。

除了 API key，也可以直接登录 DeepSeek 账号。从 v0.2.1-rc.1 起，通过本机 HTTP 打开的网页版支持账号登录，桌面版也有自己的登录界面。按 DeepSeek 文档的说法，用账号登录时模型列表来自账号本身，需要更新版客户端的模型会被 Harness 隐藏，强行调用会报错并提示需要安装的版本。DeepSeek 没有说明 1017 是否设了这样的最低版本。

无头模式（dsh headless 后面跟任务）的情况不一样。从 0.2.1 的 alpha 版本开始，它默认不再读取网页版里保存的 key，而是从环境变量 DEEPSEEK_API_KEY 或 .env 文件里读取。

为什么要升级到 v0.2.1-rc.1 及以上

DeepSeek 给的理由很简单。10 月 17 日的更新日志说，1017 针对 DeepSeek Harness 等智能体工具做了优化，并建议升级到 Harness 0.2.1-rc.1 及以上版本，"以获得新模型的最佳体验"。北京时间 16:35 在 X 上的公告也是同样的建议。

这个版本具体带来了什么，可以看发布说明。v0.2.1-rc.1 于北京时间 10 月 17 日 13:22 在 GitHub 发布，是 0.2.1 系列的首个候选版本，汇总了自 v0.2.0-rc.2 以来的变更，包括网页版账号登录、DeepSeek 账号的模型列表随账号可用模型更新、在界面里按模型设置推理等级、自动遮挡消息里粘贴的密钥和令牌、从自定义索引源安装插件，以及用 /compact 手动压缩上下文等。也有一些行为变化，比如上面提到的无头模式读取 key 的方式，以及 Azure 提供方改名。这份说明并没有点名 1017 或 Search/Fetch。这两项写在同一天 16:16 发布的 v0.2.1-rc.2 里：新增对 DeepSeek-V4.1-Flash-1017 的适配，以及对 DeepSeek Search 与 Fetch API 的适配，可以在网页搜索设置中开启。GitHub 把这两个版本都标为预发布版。

桌面版可以通过应用自带的更新检查和 Check for Updates 菜单升级。目前桌面版下载包对应哪个 Harness 版本，DeepSeek 没有写明。

插件、智能体和其他模式

插件是整套设计的核心。可以在"插件"页安装现成的插件，也可以在创造模式里描述想要的插件，让智能体写好并装上。DeepSeek 官网就演示了用这种方式做一个番茄时钟。按 rc.1 发布说明，官方插件列表可以按需安装与当前版本对应的 Claude Code 和 Codex 组合包；另有一个实验性的 Claude Code Mods 兼容层，DeepSeek 说明它目前并不是为了提供实际可用的完整兼容。实验性的"自定义插件市场"功能可以浏览第三方插件索引，但 Harness 不自带任何索引源，DeepSeek 也提醒市场内容属于第三方。开发者还可以用 dsh plugin 命令从命令行安装插件，DeepSeek 也请插件作者给自己的 GitHub 仓库加上 dsh-plugin 话题标签。

智能体方面，文档介绍它可以读写工作区文件、运行命令、把工作委派给子智能体并维护计划，遇到需要审批的操作会先询问。"插件"页的实验性插件里还有智能体团队和自动化任务。除了网页版，dsh 命令还有处理完一个任务就退出的无头模式、通过 Agent Client Protocol 为客户端提供服务的 ACP 模式，以及供 Python SDK 使用的 SDK 模式；Python SDK 可以用 pip 安装，包名是 deepseek-harness-sdk。官方还提供一个可选的 GitHub webhook 配置，在拉取请求转为待审时自动开一个只读的审查会话。

DeepSeek 的文档没有提到 VS Code 扩展或其他编辑器集成。README 只写到，通过 SSH 启动时，转发地址由 SSH 客户端或编辑器持有。

费用

DeepSeek Harness 本身是免费的开源软件，DeepSeek 没有为它标价。真正要付费的是 DeepSeek API 的模型调用。按 DeepSeek 价格页，deepseek-flash 高峰时段每百万 tokens 输入（缓存未命中）2 元、输入（缓存命中）0.04 元、输出 8 元，空闲时段减半。高峰时段为北京时间工作日 9:00 至 12:00、14:00 至 18:00（不含法定节假日）。如果是登录账号而不是用 API key，用量怎么计费，DeepSeek 文档没有说明。

在 Harness 里联网搜索另有计价。DeepSeek 价格页写明，在 DeepSeek Harness、Claude Code 或 Codex 中使用 DeepSeek API 时，服务端工具调用已经会用到 Search 和 Fetch 接口，这部分目前不收费，将从北京时间 2026 年 11 月 1 日 00:00 起按次计费，两个接口都是每 1,000 次成功请求 5 元。这两个接口和 1017 模型本身，我们另有文章详细介绍，链接见文末。