它是什么

DeepSeek Harness，简称 dsh，是 DeepSeek 以 MIT 协议开源的 Agent Harness。可以把它理解为让模型调用工具、执行任务的一套运行框架，用途包括处理文件、数据、文档和幻灯片，阅读代码仓库、修复 bug、运行测试，以及调研、后台任务和插件扩展。

它基于 Cordis 的“一切皆插件”架构：模型适配、工具注册、Agent 循环都是插件。这意味着模型如何接入、工具如何使用、任务如何推进，都属于可扩展的部分。

目前 dsh 处于开发者预览／公开预览阶段，可能出现不兼容变更。学习时应先熟悉基本流程，再逐步接入自己的工作资料。

适合谁

dsh 适合希望用自然语言组织多步骤任务的人。例如，办公用户可以尝试整理资料、分析数据和起草文档；开发者可以让它阅读仓库、定位问题并验证修改；有扩展需求的人则可以研究插件。

第一次使用时，建议选择范围小、结果容易检查的任务。不要一开始就交给它整个项目或大量原始资料，先确认它能否正确理解要求，以及产出的结果是否可靠。

安装：按系统选择入口

macOS Apple 芯片与 Windows 64 位

从 v0.2 起，dsh 提供面向 macOS Apple 芯片和 Windows 64 位的官方桌面版，可从官网下载：

https://www.deepseek.com/en/harness/

桌面版内置 dsh 命令，无需另装 Node.js。具体下载项和安装细节以官方文档为准，注意选择与设备匹配的版本。

Linux 及选择 npm 方式的环境

先安装 Node.js，再执行：

npx @deepseek-ai/dsh web

启动后，默认会打开浏览器，Web UI 地址为：

http://127.0.0.1:3080

不希望自动打开浏览器时，可使用 --no-open 参数。通过 SSH 远程启动时，只会打印地址；远程访问的具体配置以官方文档为准，不要直接把服务暴露到公网。

本文所依据的已核实信息中，npm 的 latest 版本为 0.2.1-rc.5。另需注意，针对 CVE-2026-82533 沙箱逃逸问题，npm 部署版本至少应为 0.1.2-alpha.2。达到这一版本下限不代表运行环境已经没有风险。

首次登录与配置

官方桌面版支持使用 DeepSeek 账号登录，也支持填写 API Key。先选择一种方式，完成后用一个简单问题检查连接是否正常。各入口的具体操作以官方文档为准。

dsh 也支持第三方和自定义 OpenAI 兼容模型。如果使用 DeepSeek API，Base URL 为：

https://api.deepseek.com

模型可参考 deepseek-v4-pro、deepseek-v4-flash，具体可用情况以 https://api-docs.deepseek.com/ 为准。接入其他服务时，应使用对应服务提供的信息，不要混用不同服务的地址和密钥。

首次测试先不提供敏感文件，只验证模型能否正常响应，再尝试读取专门准备的样例资料。

上手示例：用自然语言描述任务

任务描述最好包含四项内容：处理对象、预期结果、操作范围和验收要求。以下示例都可以先在资料副本或测试环境中尝试，实际执行能力取决于模型、工具和插件配置。

整理办公资料：

阅读我提供的几份会议记录，按议题整理结论、待办事项和未解决问题。没有明确负责人或日期的内容标为待确认，不要自行补充，也不要修改原文件。

阅读代码仓库：

先阅读项目说明和相关代码，解释这个问题可能出现在哪里，列出判断依据。暂时不要修改文件，等我确认方向后再提出修复方案。

确认方案后，可以继续要求它实施小范围修改并运行相关测试。不要只看“已完成”的回答，还要检查修改内容和测试结果。

辅助调研：

根据我提供的资料比较两种方案，分别整理适用条件、成本因素和仍需核实的问题。区分资料中的事实与你的推断，不要补写没有依据的数据。

这些任务都把结果写得比较具体，便于判断是否完成，也能减少模型自行扩大操作范围的机会。

实用技巧与安全注意

初次使用可从默认的 Standard 模式开始。Creator 用于通过对话创建插件，PTC 用于程序化工具调用，Minimal 提供精简循环。先根据任务需要选择模式，无需为了尝试功能频繁切换。

长对话可以用 /compact 手动压缩上下文。操作前，建议把目标、约束和验收标准整理清楚，后续也更容易检查任务是否偏离要求。

dsh 可读取 AGENTS.md，共享目录由 DSH_AGENTS_HOME 指定。可以考虑把项目约定集中整理，但具体读取规则和配置方式以官方文档为准：

https://deepseek-harness.github.io/deepseek-harness/

安全方面，官方 SAFETY 说明指出，dsh 未经安全审计，能够执行模型生成的代码和命令。建议采用最小权限，在一次性虚拟机或容器中运行，并提前做好备份。使用插件前审查其内容，执行命令前检查实际操作，避免把账号密钥和无关敏感资料交给任务环境。

小结

上手 dsh，可以先选择桌面版或 npm 方式启动，完成模型连接，再用一个范围明确的小任务验证流程。熟悉后逐步增加工具和插件。预览阶段尤其要保留备份、控制权限，并亲自检查结果，让每一步操作都能被理解和核验。

官方链接

命令与版本核对于 2026-11-03，产品迭代较快，请以官方文档为准。