deepseek-ai/deepseek-harness

它是做什么的

DeepSeek 官方开源的 agent 运行框架（harness）。你可以把它理解成「AI 助手的外壳」：模型本身负责思考，harness 负责给它工具、记忆、界面和权限。它的设计理念是「一切皆插件」，连界面都能换掉。

特点

• 一条命令就能跑起来：装好 Node.js 后执行 `npx @deepseek-ai/dsh web`，默认在 http://127.0.0.1:3080 打开网页界面，加 `--no-open` 可以不自动弹浏览器
• 基于 Cordis 插件框架，界面、工具、模型接入都能拆成插件替换，社区已有数千个插件
• 官方提供文档站和中文 README，生态里的插件大多围绕它开发
• 官方明确标注为 developer preview（开发者预览版），并写了大写警告：会有破坏兼容性的改动

什么任务适合用它

• 想搭一个属于自己的 AI 工作台，而不是用别人做好的成品
• 需要把 AI 接进本地文件、终端、Git 这些开发环境
• 想通过装插件的方式逐步扩展能力，而不是一次买定

使用建议

• 第一次用直接跑 `npx @deepseek-ai/dsh web`，不要一上来就折腾配置文件和插件
• 跑之前先读仓库根目录的 SAFETY.md（安全说明），它讲了 agent 能操作你电脑哪些部分
• 把版本号记下来。预览期升级容易遇到插件不兼容，出问题先回退版本而不是逐个排查插件
• 插件一个一个装，每装一个确认界面正常，出问题能立刻定位是谁引起的

注意事项

• 这是开发者预览版，官方自己说会有破坏兼容性的更新，别用在不能中断的生产环境
• 装插件等于把权限交给插件，装之前看它的权限声明（本页「它声明需要的权限」一节）
• 默认只监听本机 127.0.0.1，如果要让别的设备访问，需要自己处理网络暴露和鉴权

下载与源码

源码包是仓库默认分支的当前快照；要安装包请看发布页。

git clone https://github.com/deepseek-ai/deepseek-harness.git

git clone "https://ghproxy.link/https://github.com/deepseek-ai/deepseek-harness.git"

以上链接均逐个实测可访问。「直连可用」= 不开代理也能下载；「需代理」= 你的网络需要已开启代理。

使用说明

查看完整使用说明（中文）→ · GitHub 仓库 ↗

中文版由官方 README 翻译整理，保留原结构与命令，专有名词附英文原文。

查证来源

本文依据该仓库 README 与插件目录声明整理。

打开 GitHub 仓库 ↗