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