DeepSeek Harness：深度求索的编程智能体
📍 国产 AI 工具 · DeepSeek
先说发生了什么
Section titled “先说发生了什么”2026 年 8 月，DeepSeek（公司中文名叫深度求索）干了一件很多人等了很久的事：
开源了自家的 Agent（智能体）框架——DeepSeek Harness，缩写 dsh。
一句话定位：DeepSeek 版的 Claude Code。你在本站学的那套「让 AI 真的替你干活」——读文件、跑命令、改代码、拆任务——dsh 全都要做，而且开源、免费、国内直连。
- 仓库：github.com/deepseek-ai/deepseek-harness（MIT 协议，就是「随便用」级别的开源协议）；官方中文文档：deepseek-harness.github.io/deepseek-harness
- 当前版本：截至 2026-10-26，npm（Node.js 的软件包仓库）上的默认版本仍是 0.2.1-rc.2（2026-10-17 发布；GitHub 上已有更新的 0.2.1-rc.3），GitHub 上的每个发布都标着「预发布」，仍是开发者预览（这五个字很重要，文末细说）。DeepSeek 在 10 月 17 日更新模型时，请大家升级到 0.2.1-rc.1 及以上，升级办法见文末「想试的话」。迭代非常快，一周可能发好几版；8 月下旬的版本补上了多模态——可以直接把图片发给模型（DeepSeek 现在由 API 模型
deepseek-flash负责看图，见《DeepSeek 能看图了》），子代理还能按需装 Claude Code / Codex - 上手：装好 Node.js 22.19 以上的电脑上，一行命令
npx @deepseek-ai/dsh web，浏览器就能用；不想装 Node.js，也可以到官网下载桌面版（macOS 要苹果芯片的 Mac，Windows 要 64 位），同样是预览版
为什么值得单独写一篇？因为本站国内路线的主角一直是 DeepSeek——Claude Code 接 DeepSeek靠它的 API，省钱实战靠它的价格。现在这家公司自己下场做了「身体」，这事对国内用户不是新闻，是选项。
名字里的 Harness 是什么意思
Section titled “名字里的 Harness 是什么意思”先把这个词讲明白，后面就都通了。
业内有个说法：Agent = Model + Harness。
- Model（模型） 是灵魂——负责「想」
- Harness（挽具，就是套在马身上拉车的那套装备） 是身体——负责「干」：给模型装上眼睛（读文件）、手（改文件、跑命令）、记忆（会话日志）、安全带（审批和沙箱）
Claude Code 就是 Anthropic 给 Claude 模型做的 Harness。DeepSeek Harness，顾名思义，是 DeepSeek 给自家模型做的身体。
它最大的卖点：一切皆插件
Section titled “它最大的卖点：一切皆插件”大多数软件像整装电脑——出厂什么样就什么样，顶多让你换个壁纸。
dsh 的设计像组装台式机：机箱只提供插槽，CPU、显卡、硬盘全是插上去的，哪个不满意拔了换。
而 dsh 拆得比你想象的狠——模型接入、工具箱、聊天界面、审批策略、会话日志，甚至驱动智能体运转的主循环本身，全部是插件：
- 想换搜索引擎？改个配置，不动框架代码
- 想接公司自建的模型服务？它支持任何 OpenAI 兼容接口，设置页填完立刻生效
- 想加个画板功能？装个插件就有了
- 卸载插件时，它注册过的一切自动撤销，不留残余
内测玩家们已经把这个自由度玩出花了：有人给它换上 Excel 皮肤（上班摸鱼神器）、复古 Windows XP 皮肤、甚至表情包插件——让 AI 回复时自动配上大肥鱼表情。框架不拦着你，是这个东西最大的性格。
（技术上这套插件系统叫 Cordis，感兴趣的去仓库看，小白记住「乐高式组装」这个感觉就够。）
四种开箱模式
Section titled “四种开箱模式”
新建任务时可以选模式，每个模式=一套完整的智能体配置：
| 模式 | 一句话 | 适合谁 |
|---|---|---|
| 标准 | 全功能编程智能体，文件、命令、搜索、计划、子代理全都有 | 大多数人的默认选择 |
| PTC | 模型写一段程序来批量调用工具，程序先筛选、汇总结果，再交给模型 | 规则明确的批量处理；能不能更快、更省钱，要看具体任务 |
| 极简 | 只有一个终端工具，加一段固定的系统提示词 | 做对照实验的人（它是实验基线，不是给新手的简化版） |
| 创造 | 用 AI 创造新模式——「给我做一个只能读不能写的审查模式」，它自己写配置装上 | 玩家和团队定制 |
PTC（Programmatic Tool Calling，用程序调用工具）值得多说一句，打个比方：标准模式像你派实习生跑腿，跑一趟汇报一次再派下一趟；PTC 像你把五件事写成一张清单，实习生揣着清单一趟办完，回来只交汇总。规则明确的批量活儿适合这么干，但快不快、省不省要看具体任务；官方也说，标准模式同样能写脚本批量处理，批量任务不一定非用 PTC。
创造模式则要多提醒一句：它能执行 AI 写的代码、修改自己的运行时——权限等同于把终端交给 AI，只在自己信任的环境里玩。
几个真材实料的设计
Section titled “几个真材实料的设计”看一个新工具是不是认真做的，别看宣传页，看细节。dsh 有几处让我们眼前一亮：
- 「先读后写」门禁：强制 AI 必须先读过一个文件才能改它——防止 AI 凭想象乱改。妙在这不是写死的规则，而是一个可选装的门禁插件，团队能按需加严或放宽
- 会话日志只增不改：AI 看到的一切（系统提示词、思维链、每次工具调用）全部按顺序落盘，只追加、不修改——出了问题能完整回放「它当时到底看到了什么」。恢复会话、分叉重试、跨会话检索都建立在这份日志上
- 沙箱不虚报：命令可以跑在系统级沙箱里（三档：只读 / 只写工作区 / 完全放开），而且如果当前系统条件只能做到部分隔离，它如实报告「partial」而不是假装安全——这个诚实度在同类工具里少见
- 密钥不进日志：API Key 走独立通道，会话日志里只有引用没有明文——跟本站反复强调的「什么能发给 AI」是同一种自觉
- 生态不排外：支持 MCP（外部服务连接器），你为 Claude Code 写的 Hooks 脚本可以通过桥接直接用，不用重写——摆明了不想让你在生态间二选一
dsh vs Claude Code vs Trae
Section titled “dsh vs Claude Code vs Trae”三个工具放一起看（截至 2026-09-26）：
| dsh | Claude Code | TraeCode（原 Trae IDE） | |
|---|---|---|---|
| 出品方 | DeepSeek | Anthropic | 字节跳动（现属豆包体系） |
| 形态 | 框架 + Web 界面 / 命令行；后来另有桌面版（预览版，见下文） | 命令行 + 桌面 / 网页 / IDE 插件 | 图形 IDE（编辑器） |
| 国内可达 | ✅ 开源直连 | ⚠️ Anthropic 不向中国大陆提供服务，可改接 DeepSeek API | ✅ 国内版直连 |
| 价格 | 免费开源 + 自付模型 API | 订阅或 API 按量 | 免费档可用，按积分计费（有赠送积分），另有付费会员 |
| 可定制度 | 极高（一切皆插件） | 中（Skills / Hooks / MCP） | 较低（产品化封装，也有 Skill、Hook 和插件市场） |
| 成熟度 | ⚠️ 开发者预览版（版本号还是 0.x） | ✅ 成熟稳定 | ✅ 成熟稳定 |
| 适合 | 爱折腾的玩家、要深度定制的团队 | 想要成熟工具链、文档齐全的人 | 想要开箱即用图形界面的人 |
一句话总结三者的性格：TraeCode 是精装房，Claude Code 是带家具的公寓，dsh 是毛坯房加一仓库的建材——毛坯房自由度最大，但你得自己动手。
我们家实测下来
Section titled “我们家实测下来”写这篇之前我们自己上手跑了一遍，两个真实体感：
上手真的快。一台装好 Node.js 的电脑，一行 npx @deepseek-ai/dsh web，一两分钟后浏览器里就是完整的聊天界面——这个「从零到能用」的距离，比当年配 Claude Code + DeepSeek 那套环境变量短多了。
但坑也真实存在，有的坑不该去填。我们一开始想把它部署到家里的服务器上，让全屋设备都能用，结果发现这条路官方就不支持：dsh web 只在本机地址 127.0.0.1 上监听，并且有意拒绝 --host 0.0.0.0（向局域网开放）。道理很简单：这个网页界面能以你的身份执行命令，开放到局域网，就等于把命令执行入口交给同一网络里的每台设备。我们当时硬绕过去，又撞上浏览器在非 HTTPS 的局域网地址下缺少部分安全接口、前端报错——这些都在提醒同一件事：别这么用，不要绕过这个限制。 真要在别的设备上用，就走 SSH 端口转发（用加密连接把服务器上的端口接到你面前这台电脑上）；官方安全说明还建议优先放在一次性虚拟机、容器这类专用环境里运行，并写明沙箱和审批能降低风险，但不保证隔离。这就是 v0.1 预览版的真实含义：能用，但要清楚它的边界。
（2026-10-19 补：按 0.2.1 候选版的发布说明，官方加了在别的设备上访问的正式办法：可以绑定本机的某一个具体网络地址，可以自己配 HTTPS 证书，也可以放在反向代理（替它接收外部访问、再转进来的服务器程序）后面，见官方的公开部署说明；对所有网络开放的 0.0.0.0 仍然会被拒绝。要注意：只绑定一个局域网地址、不配 HTTPS 的话，同一网络里的设备照样能连到这个端口，网址里那串令牌也是明文传的，官方会在启动时给出警告。这几种办法都要自己管好证书和谁能访问，新手还是只在本机用，或者走上面说的 SSH 端口转发。）
谁现在该玩，谁先观望
Section titled “谁现在该玩，谁先观望”本站的一贯风格：不吹不黑，按人群说。
现在就值得上手 ✅：
- 爱折腾的玩家——插件生态正在野蛮生长期，现在进场是「早期玩家」
- 已经在用 DeepSeek API 的开发者——同一家的模型和身体，配合最顺
- 想给团队做定制智能体的人——「一切皆插件」就是为你设计的
建议再等等 ⏳：
- 完全零基础的小白——预览版的坑需要动手能力，先用 Trae 或 Claude Code 把基本功练熟
- 拿它干正经工作的人——现在的版本都是 rc（候选发布版）或更早的预览版，命令里不写版本号的话，每次启动都可能拉到新版本，行为随时会变（想固定版本见文末），生产环境等正式版
- 期待「装完就完美」的人——它现在的完成度是「毛坯房」，惊喜和惊吓都会有
npx @deepseek-ai/dsh web不想装 Node.js 的，可以直接到 DeepSeek Harness 官网下载桌面版（macOS 要苹果芯片的 Mac，Windows 要 64 位），装好打开后按界面引导设置。按官方的桌面端说明，桌面版就是在网页版外面套了一层应用外壳，界面和下面说的网页版基本一样。
下面是命令行这条路，分三步，建议先拿一个练习用的空文件夹来试：
- 装好 Node.js 22.19 或更高版本（24 以上也行）：到 Node.js 官网下载 LTS（长期支持）版，装完在终端运行
node -v，看到版本号就行。然后在终端里进入练习文件夹，运行上面的命令。 - 填 Key：浏览器会自动打开 dsh 的网页界面（地址是本机的 127.0.0.1:3080）；没自动打开的话，第一次要复制终端里打印出的完整地址，后面带着一串一次性令牌。在设置里找到「模型」，填上 DeepSeek 的 API Key（开放平台申请，按量付费），保存后立即生效。
- 选工作区：点「选择工作区」，添加并选中刚才那个文件夹。不选工作区，输入框是灰的；选好之后，再发第一条消息。
想让行为稳定、不被新版本打扰，就在命令里写上版本号，例如 npx @deepseek-ai/dsh@0.2.1-rc.2 web。
用命令行的，升级也是这个办法：把命令里的版本号换成新的就行。DeepSeek 在 2026-10-17 更新模型时请大家升级到 0.2.1-rc.1 及以上；截至 2026-10-26，npm 上的默认版本仍是 0.2.1-rc.2。（DeepSeek 官方公告、GitHub 上的发布列表）
用桌面版的，它会在后台自己检查更新，有新版时界面上会出现提示（官方说明里写在左下角），点一下开始下载；也可以在应用菜单里点「检查更新…」（Windows 在顶栏的「应用」菜单里）马上查一次。下载好之后会弹出重启确认，按提示重启就行（官方桌面端说明，偏技术）。
还要留意一笔新费用：DeepSeek 在同一份公告里说，在 dsh 里用 DeepSeek API 时，已经会用到它的联网搜索和抓取网页接口，这部分原来不收费，北京时间 2026-11-01 00:00 起按次收费，每 1,000 次成功请求 5 元（价目表）。一次大概多少钱、在 Claude Code 里怎么关，见Claude Code 接入 DeepSeek 里「联网搜索」那一节；dsh 里怎么设置，以你那一版的设置页为准。
更多玩法看官方中文文档和 GitHub 仓库——预览版迭代很快，一切以官方文档为准，本文只负责帮你判断「要不要投入时间」。
- 还没用过任何 Agent 工具 → 先看什么是 Claude Code 建立概念
- 想要开箱即用的国产选择 → Trae 完整教程（4 篇）
- 想懂「Agent 的身体」是怎么构成的 → 给 Agent 配齐 6 类 API 工具 + MCP 协议详解