DeepSeek Harness开源了:45小时8万星,Model+Harness=Agent让AI真正动手干活
2026年8月13日,DeepSeek扔出一颗深水炸弹——DeepSeek Harness开源了。GitHub仓库45小时破8万星,老玩家们的反应出奇一致:这玩意儿不是又一个"聊天机器人",它是真正能让AI替你"动手干活"的基建框架。公式很简单:Model + Harness = Agent。光有大模型,它只会动嘴;加上Harness,它才能读你的代码、改你的文件、跑你的终端。
先搞清楚一件事:你装的不是模型,是跑腿的管家
很多人第一步就卡在"DeepSeek Harness是不是DeepSeek V4"这个问题上。答案很干脆:不是。Harness本身不跑模型,它只是一个"运行环境"。你还得自己准备API Key,让Harness去调用DeepSeek V4或其他模型。有人会问:"我都用DeepSeek API了,还要Harness干嘛?"——当你只是发一句"帮我写个函数",确实不需要。但当需求变成"帮我读整个Git仓库、改3个文件、跑pytest、出错了继续修",你面对的问题已经从"怎么调用LLM"变成"怎么把大模型组织成真正能持续干活的Agent"。这就是Harness存在的意义。
三条路,选最适合自己的
第一条:npx一键体验,适合"先跑起来看看"的人。确认Node.js装好后,终端敲一行:
npx @deepseek-ai/dsh web
浏览器会自动弹出http://127.0.0.1:3080。第一次用会下载依赖,等就完事。
npx @deepseek-ai/dsh web
浏览器会自动弹出http://127.0.0.1:3080。第一次用会下载依赖,等就完事。
第二条:全局安装,适合日常用、想固定版本的人。全局装一次,以后随时敲dsh web就能起来,不用每次都下载:
npm install -g @deepseek-ai/dsh
dsh web
npm install -g @deepseek-ai/dsh
dsh web
第三条:源码构建,适合想读源码、写插件、追最新提交的开发者。先装pnpm(仓库锁定11.7.0),再clone再build:
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web
有一条硬性门槛:Node.js版本必须≥22.19.0,或24.x系列。低于这个版本,装完可能报错。node --version查一下,版本低了先去升。
跑起来之后,三件事必须做
第一件事:配API Key。浏览器打开http://127.0.0.1:3080后,会弹出提示让你填Key。进入Settings → Models,找到DeepSeek那张卡片,把sk-...填进去保存。Key存在本地配置目录,不会写进会话日志——这点做得不错。没有Key的去DeepSeek开放平台申请,充值后就能用。切记:API Key不要截图发群里,不要贴到公开文章里。
第二件事:选工作区。这件事被大量新手忽略,踩过的坑友不少。配完Key直接打字,发现发不出去——不是坏了,是没选工作区。Harness的规矩是:你不告诉它在哪干活,它就拒绝干活。点"选择工作区",新建一个空目录(比如dsh-test),把它指给Harness。聊天框立刻活过来。为什么必须是空目录?因为工作区就是Agent的文件操作边界——它只能读写这个目录里的东西,超出一步都不行。这是Harness的核心安全设计。
第三件事:选模式。点击顶部"标准模式"下拉,会看到四种预设。第一次用,无脑选标准模式就对了。文件编辑、Shell、搜索、网页检索、Skills、计划、目标、子Agent、工作流,完整能力全开。极简模式只给两个工具(一个Shell一个文件编辑器),适合做模型基准测试;PTC模式允许模型生成TypeScript程序一次性组合多步操作,适合长程任务省Token;创造模式面向插件开发者,普通人别碰。
这些坑,踩过的都懂
常见问题避坑指南
- 坑1:端口3080被占用。启动时提示端口被占用?多半是之前开过没关干净。换端口解决:dsh web --port 3081,或者直接关掉多余终端窗口。
- 坑2:重启后"找不到"了。因为Web界面由dsh进程提供,终端关掉进程就停了。下次重新敲命令就行,别慌,不是程序坏了。
- 坑3:装插件把程序弄崩了。插件一次装一个,验证能用再装下一个。出错了记下报错名字,去Settings里把那个插件卸载掉,重启就好了。
- 坑4:明明装了Node却提示找不到。安装全局包后,关闭当前终端重开一次。Windows环境下,环境变量需要刷新才生效。
现在能不能上生产?直接说结论
可以体验,可以研究,可以做实验,别急着上生产。官方自己说了:当前是v0.1开发者预览版,项目处于快速迭代阶段,接口、配置方式、行为都可能在后续版本中变化。磁盘上的会话/存储格式没有向后兼容承诺,升级后旧格式可能被拒绝。
另外,生产环境的安全模块目前还是短板。框架本身有文件沙箱和工作区隔离,但权限管控、并发处理、日志审计这些企业级能力还没补齐。如果你准备认真研究,最好单独准备一个测试环境,尤其是涉及企业代码仓库、生产服务器、重要业务数据的场景。
至于值不值得学——GitHub 8万星不是白来的。DeepSeek把Harness的设计哲学、代码实现、生态接入标准全部摊在桌面上,开源路线意味着安全不是靠"封闭堡垒"保证的,是靠每一个接入的开发者、每一个PR、每一个审计者盯着每一行代码。如果你想学Agent开发、想搞懂"Model + Harness = Agent"这套逻辑,现在入场是最好时机。等生态成熟了再进,就只能当用户了。
当前文章无评论,是时候发表评论了