DeepSeek Harness 终于开源了。相比之前只能通过云端 API 调用的方式,Harness 让开发者可以自己造 Agent 来干活,自由度高了不少。

DeepSeek Harness 是什么?
DeepSeek Harness 的核心设计理念是一切皆插件——模型、工具、技能、会话、沙箱、存储、Agent Loop、调度、UI 全部由插件组成,底层运行在 Cordis 插件系统上。开发者不用修改源码,就能替换掉模型调用方式、上下文组织、错误重试机制等关键环节。
简单来说,之前的 DeepSeek 处于云端,无法直接读取本地文件或连接代码库和终端。现在通过 Harness,它可以在本地生态中运行自己的模型,摆脱单纯的对话模式。
怎么部署?
最快捷的方式是让 AI 工具帮忙安装。如果你有 Claude Code、Codex 或者腾讯的 Workbuddy,直接把指令发给它们即可:
帮我安装 DeepSeek 的 Harness:npx @deepseek-ai/dsh web
安装流程去他的仓库自己看:github.com/deepseek-ai/deepseek-harness
在我的用户盘中单独创建一个文件夹作为他的项目空间
AI 工具会自动解决 Node.js 安装、端口冲突等问题,大约 3 分钟就能完成。启动后访问返回的地址(默认是 127.0.0.1:3080)即可。

⚠️ 关键注意:一定要让 AI 工具「在用户盘中单独创建一个文件夹作为项目空间」。否则 Harness 会和 AI 工具共用同一个工作目录,后续使用会很麻烦。

打开浏览器后,界面如下:

接下来需要填入 DeepSeek 官方 API Key。可以到 https://platform.deepseek.com/ 获取。


Harness 支持接入其他模型,但最快上手还是先用官方 API。后续可以更换为任何兼容接口的模型。

如果遇到 401 或 402 等错误,通常是 API Key 问题,需要自行排查。
使用前需要配置一个正式工作空间,否则对话框会被锁定。

使用注意事项
1. Agent 预设
Harness 内置四种 Agent 预设模式:
- 标准:最完整的功能,能整合完整的工具
- PTC:AI 先写操作流程,然后自动执行
- 极简:让模型能力放大,不被外部工具干扰,适合简单处理
- 创造:在标准基础上增加运行检查,适合开发 Agent 或插件时使用

2. 启动和关闭
由于 AI 工具通常在半小时后会自动关闭进程,需要了解如何手动启动和关闭 Harness:
npx @deepseek-ai/dsh web
启动后按 Ctrl+C 即可关闭进程。

3. 调用 Claude Code 和 Codex 作为子 Agent
Harness 支持将本地部署的 Claude Code 作为子 Agent 使用。只需告诉它:连接 Claude Code 作为子 Agent 即可。

连上 Claude Code 和 Codex 后,原有的使用习惯和资源不需要大迁移,可以直接调用这些 AI 工具辅助创造。

4. 文件阅读
目前 Harness 还不支持拖拽文件读取。如需读取文件,可以给它文件名,让它自己去电脑上查询并阅读。


总结
Harness 目前功能还不多,属于内测阶段,需要开发者一起探索。但作为开源框架,它的操作空间很大,就像之前的 Codex 换皮肤一样,开发者可以基于它开发出新玩法。
GitHub 项目地址:https://github.com/deepseek-ai/deepseek-harness