如果你是个 AI Agent / 模型开发的人最近应该没少听说DeepSeek Harness。简单说它是一个围绕 DeepSeek 模型打造的、可以自托管、能插件的智能体运行框架——所有能力都是插件你想让它干什么装个插件就行。但网上的资料大多是讲它是什么、架构怎么样真正讲我到底怎么把它跑起来的少。这篇就是纯实操从零开始把我自己走过的路完整记录下来——装依赖、起服务、装插件、管插件一条龙。先给结论整个上手过程就三步——装好 Node、起一个 web 服务、往里加插件。下面一步步来。文章目录一、先把依赖装好二、把它跑起来最省事的方式三、另一种打开方式绑定本机回环地址四、先搞懂 Profile 是什么五、装插件四步走5.1 配置允许构建的白名单5.2 交互式批准 node-pty5.3 添加插件六、管插件查看和卸载查看已装的插件卸载插件七、想玩更多插件生态探索一句话总结一、先把依赖装好Harness 是 Node 生态的东西先确认本地的 Node 和 npm 版本够不够新node-v# v22.23.2npm-v# 10.9.8Node 22 以上的版本基本都没问题。版本太老的话先升级 Node 再继续不然后面装插件容易各种报错。二、把它跑起来最省事的方式Harness 的官方启动命令非常简单一条 npx 就完事npx deepseek-ai/dsh web但这里有个实际的场景问题Harness 通常装在你的远程服务器上而你人在本地电脑。这时候你不想把 3080 端口裸暴露到公网最稳妥的办法是走 SSH 隧道端口转发ssh-L3080:127.0.0.1:3080 user192.168.1.100 npx deepseek-ai/dsh web-L 3080:127.0.0.1:3080的意思是把本地 3080 端口通过 SSH 安全通道转发到远端服务器的 3080 端口。这样你在本地浏览器打开http://localhost:3080/就能访问到远端跑着的 Harness 了——全程加密服务器端口不对外暴露干净又安全。小提示192.168.1.100 是我示例的内网地址你替换成你自己的服务器 IP。三、另一种打开方式绑定本机回环地址如果你人就在服务器上操作或者通过跳板机想让服务只监听本机、不许外部访问可以这样启动npx deepseek-ai/dsh web--host127.0.0.1然后本地访问http://127.0.0.1:3080/--host 127.0.0.1就是告诉服务只在本机回环地址上监听外面谁也连不上。安全性拉满适合调试场景。两种方式怎么选人在本地、服务在远端→ SSH 隧道 localhost:3080人就在服务器上→--host 127.0.0.1127.0.0.1:3080四、先搞懂 Profile 是什么在装插件之前必须搞清楚一个概念Profile。官方文档说得比较抽象我用人话翻译一下Profile 就是一套独立的 DSH 运行配置/环境。你可以把它理解成Docker 里的一个独立容器Python 里的一个独立虚拟环境venv每个 Profile 有自己独立的插件集合、配置、依赖。你想实验新插件开个新 Profile 随便折腾搞坏了不影响主环境不同项目用不同 Profile插件互相不串。后面所有插件操作都要带--profile web这样的参数指明操作的是哪个 Profile。记住这一点后面就不会晕。五、装插件四步走装插件之前需要先把 pnpm 准备好Harness 的插件机制依赖它corepackenablepnpmpnpm--version然后是最关键的一步——允许插件执行构建脚本。5.1 配置允许构建的白名单插件的构建脚本默认是禁止执行的安全考虑。要先在配置文件里声明信任vim~/.dsh/profiles/default/pnpm-workspace.yaml加入这一行把插件源地址加进 allowBuildsallowBuilds:dsh-better-sidebarhttps://github.com/example/dsh-better-sidebar/tar.gz/xxxx:true5.2 交互式批准 node-pty然后进入 Profile 目录运行cd~/.dsh/profiles/webpnpmapprove-builds执行后会出现一个交互式列表让你勾选允许执行 build script 的依赖。找到node-pty选中它确认。终端操作方式↑ / ↓移动光标Space选中Enter确认。这个node-pty很关键——它是给 Harness 提供真实终端能力的依赖不批准它很多功能跑不起来。5.3 添加插件批准完构建就可以正式装插件了# 装一个更好的侧边栏 UIdsh pluginaddgithub:omdsh-dev/DSH-better-sidebar--profileweb# 装一个文件引用增强插件dsh pluginaddgithub:FSMargoo/dsh-at-file--profileweb# 装一个网页 UI 增强插件dsh pluginaddgithub:zhu1090093659/dsh-web-ui--profileweb每个插件后面都带了--profile web——再次强调这就是装到web这个 Profile 里别漏掉。注上面的插件地址是示例实际以你搜到的官方仓库地址为准。六、管插件查看和卸载查看已装的插件三种方式任选dsh plugin list--profileweb npx deepseek-ai/dsh plugin list--profilewebcat~/.dsh/profiles/web/package.json前两条是命令行的正规姿势第三条是直接看 Profile 的 package.json——插件本质上就是 npm 依赖看文件最直观。卸载插件npx deepseek-ai/dsh plugin remove dsh-better-sidebar dsh-at-file dsh-web--profileweb可以一次卸载多个空格分隔就行。七、想玩更多插件生态探索装完基础三件套你还可以去社区挖更多插件。比如# 探索式装插件--profile 用 add 子命令dsh plugin--profilewebaddwxg-prc-cpg/dsh-weknora# 或dsh plugin--profilewebadddsh-contextHarness 的插件生态是它最大的想象空间——一切能力皆插件你的 Harness 想变成什么样全看你想往里装什么。一句话总结DeepSeek Harness 上手就是装 Node → 起服务 → 加插件三步。Profile 是隔离环境的容器插件是扩展能力的积木SSH 隧道是安全访问的桥。把这三样搞明白Harness 就算真正上手了。装好之后你可以开始研究它的内部流程了——Harness 基于 Cordis 框架、一切能力皆插件、请求怎么进来、Turn 和 Step 怎么流转这些我整理在另一篇《DeepSeek Harness 请求处理流程》里看完这两篇你对 Harness 的理解就完整了。如果这篇对你有帮助点个赞、收藏一下评论区聊聊你还想了解 Harness 的哪部分插件开发还是多 Agent 编排