DeepSeek Harness（dsh） ：保姆级安装使用教程

开源刚满一周DeepSeek 又放了个大招——DeepSeek Harness简称 dsh一个 Agent 运行时框架目前在GitHub上狂揽170KStar。官方给了一个公式一句话就能听懂Agent Model Harness模型负责思考推理Harness 负责让模型真正干活——调用工具、读写文件、跑 shell、出错重试、持久化对话、权限管控。你给它一个 DeepSeek API Key它就能把模型从只会输出文字变成能自己改代码、跑命令、完成一整套任务。这篇从零开始保姆级带你跑通装、配、用。一、保姆级安装三条路任你挑环境前提先看这行少踩一半坑Node.js要求^22.19.0或24.0.0。不确定就装 Node 24 LTS官方安装器不会拦老版本太老的 Node 跑起来报错你都不知道为啥。验证 Node 装没装node --version # 看到 v 开头的版本号就行方式一一行命令临时体验推荐这个只想玩玩、不折腾源码官方给了免安装的一条命令npx deepseek-ai/dsh web # 默认启动在 http://127.0.0.1:3080⚠️第一次跑的耐心提醒npx第一次会先下载一整包依赖实测完整安装占用300MB 以上而且没有进度条、没有百分比屏幕只会一直滚字。有 Windows 用户反馈第一次跑了 8 分钟以为卡死了。别慌等它滚完打印出网址就行。方式二全局安装后续要定制选这个npm install -g deepseek-ai/dsh dsh --version # 看到版本号即成功方式三源码安装开发者 / 想写插件必走这条git clone https://github.com/deepseek-ai/deepseek-harness.git cd deepseek-harness # 没有 pnpm 先装一个npm install -g pnpm pnpm install # 装依赖 pnpm run build # 编译 workspace 包生成 lib/这步不能省否则 Web 界面异常 pnpm dsh web # 启动 Web UI国内加速 clone直接克隆 GitHub 经常卡住或只有几 KB/s在原始 git 链接前面拼一个代理地址就行# 原始https://github.com/deepseek-ai/deepseek-harness.git git clone https://gh-proxy.com/https://github.com/deepseek-ai/deepseek-harness.git二、首次启动与配置 API Key启动成功后终端会打印类似这样的输出dsh web: http://127.0.0.1:3080浏览器打开这个地址端口不一定每次都是 3080以你屏幕上打印的为准如果没自动跳手动粘地址。第一次打开会发生什么弹一个内测声明Harness 还在快速迭代接口和功能随时可能有破坏性变更。点继续进主界面。填你的DeepSeek API Key。API Key 在DeepSeek 开放平台platform.deepseek.com注册、充值后在 API Keys 页面创建。密钥只在创建那一刻显示一次务必先复制保存好关掉就再也看不到了。页面布局左侧是工作区中间是选择工作区和配置的模型以及四种模式选择。1、标准模式 standard 完整工具栈读写文件、Shell、网页检索、Skill、子 Agent 委派、任务规划 | 日常代码开发、项目重构、Bug 修复最常用2、PTC 程序化工具调用模型输出 TS 代码编排多条工具调用一次性执行批量动作减少多轮 LLM 往返 | 批量处理、复杂分支工作流显著省 Token3、极简模式 minimal仅保留文件编辑 Shell | 基准测试、轻量化自动化降低上下文开销4、创造模式 creative运行时动态加载插件、调试框架本身 | 二次开发、自定义 Agent 实验PS下面是我选择了一个工作区有具体的执行过程以及token使用详细。❝⚠️浏览器踩坑如果打开设置页提示 HTTP 403多半是浏览器装了 Page Assist 这类插件拦截了请求禁用该插件即可。三、模型也是插件接第三方模型一切皆插件最直观的验证——模型本身也能换。DeepSeek 只是默认预置的一个模型插件你完全可以接 Anthropic、OpenAI或者自定义兼容端点接公司内部网关。操作路径Web 界面 → 左下角设置 → 模型标签页 → 添加提供方以接一个 OpenAI 兼容端点的模型为例填好三样就能用Base URL接口地址模型名对应的 Key填完保存回到会话界面就能在新会话里选这个模型了。四、Headless 模式一行跑完一个任务不想要 Web 界面、只想把 dsh 当命令行工具用有 headless profiledsh --profile headless 总结一下当前这个仓库运行命令时所在的目录会成为默认工作区Agent 可以读取、编辑其中的文件并运行命令。任务跑完输出最终答案后自动退出适合脚本化、定时任务、CI 流水线里调。五、踩坑清单建议收藏⚠️坑 1npx 第一次没进度条npx deepseek-ai/dsh web第一次跑会下载 300MB 依赖没百分比、没进度条屏幕一直滚字。等它滚完打印出网址就行别中途 CtrlC。⚠️坑 2Node 版本太老官方要求^22.19或24。用老版本 Node 装上不报错但跑起来各种玄学问题。不确定就装 Node 24 LTS。⚠️坑 3缺 pnpm源码安装报command not found: pnpm先npm install -g pnpm。⚠️坑 4跳过 buildpnpm install后直接pnpm dsh webWeb 界面会异常。pnpm run build这步不能省生成lib/产物。⚠️坑 5设置页 HTTP 403浏览器装了 Page Assist 等插件会拦截请求禁用该插件即可。⚠️坑 6CtrlC 杀不干净 node 子进程端口 3080 被占下次 boot 报EADDRINUSE。用Get-NetTCPConnection -LocalPort 3080拿 PID 再Stop-Process清理。注意端口冲突时插件apply依然会先执行挂插件和启服务器是两个阶段。⚠️坑 7API Key 只显示一次在 platform.deepseek.com 创建后只在那一刻显示关掉就再也看不到务必先复制保存。总结一句话记住 DeepSeek Harness 的定位它是 Agent 的操作系统不是应用。内核只提供调度和通信基础设施所有能力由插件组装。想体验npx deepseek-ai/dsh web等它滚完依赖填个 Key 就能用。想定制npm install -g deepseek-ai/dsh或源码安装走 patch/bundle/profile 三层配置。想扩展写一个apply(ctx)ctx.tools.register挂个工具--patch注入真实 dsh。想省 Token复杂批量任务切 PTC 模式模型一次输出 TS 代码编排多条调用。❝官方入口仓库https://github.com/deepseek-ai/deepseek-harness文档站https://deepseek-harness.github.io/deepseek-harness/官网页https://www.deepseek.com/harness/反馈渠道GitHub Discussions / Discord把一切皆插件想通了你就拿到了 DeepSeek 给 Agent 圈的这张新底座的钥匙。剩下的事就是挂你的插件。若有帮助点赞、分享、推荐感谢各位关注我—— 持续分享更多好用的开发工具效率快到飞起