夜雨聆风
| DOMN STUDIO |
哈喽，我是庄一。
一个项目开源三天，star 冲到 12 万，这个速度放在开源圈里，属于你不看一眼都觉得自己漏掉了什么的程度。
它就是 DeepSeek Harness，社区里习惯叫它 dsh。热闹归热闹，我翻了官方资料之后发现，热闹背后缺的其实是一份新手能照着走完的整理稿。这篇就是保姆级工具入门，你只要有一台能上网的电脑，就能跟着走完。
写在前面
我猜你可能正在想，我又不是工程师，dsh 这种东西跟我有什么关系。关系就一句话，dsh 的插件体系不要求你会写代码，装它、跑它、照着改一行配置，都不需要编程基础。
这篇的每一节我都给你三件套，复制就能用的命令、跑起来预期看到什么、卡住了往哪回头。
dsh 是什么
dsh 全称 DeepSeek Harness，是 DeepSeek 官方维护的开源 agent harness。harness 这个词直译是挽具，在这里可以理解成给 AI 套上的那副马具，它负责调度模型、工具和文件，让 AI 按你的指令干活。项目是 MIT 协议，意思是代码谁都能拿去用、拿去改，仓库叫 deepseek-ai/deepseek-harness。
它 8 月 13 号开源，三天出头 star 冲到 12 万。这个数字我先不替它下结论，值不值得装，上一期那篇 dsh 真伪价值拆解已经拆过一遍了。这篇是那个判断之后的动手篇，前面讲该不该动手，这里只讲怎么动手。我的立场延续前面的口径，装来学习、装来跑通一个最小闭环，很值；但把它当成生产环境的主力工具押上去，还太早。
为什么说还早，因为 dsh 现在是 developer preview，开发者预览版。官方在 README 里原话写着 THE FUTURE WILL BE COMPATIBILITY-BREAKING CHANGES，翻译成大白话，未来的版本会带来不兼容的变更。现在能跑通的东西，下个版本可能就换写法了。这个状态贯穿全文，后面每个环节都会再提醒一次。
动手之前先检查两样东西，一台能上网的电脑，一个 Node 环境。dsh 要求 Node 22.19 以上或者 24 以上。不会看版本的，先在终端跑这一行。
预期输出是一行版本号，比如 v22.19.0。如果提示找不到 node，或者版本太低，去 Node 官网装一个新版，装完再回来。这一步卡住很正常，下面一节讲启动方式的时候还会再提一次怎么排查。
三种启动方式
方式 A，命令行加 Web UI，最省事，适合大多数第一次接触的人。
开一个终端，复制这一行。
第一次跑会自动下载包，等它装完，本地会起一个网页界面，地址是 http://127.0.0.1:3080。预期输出是，终端里出现本地服务启动的提示，浏览器打开那个地址，能看到 dsh 的对话界面。
第一次启动，界面会先让你填 API Key，别慌，这是正常流程。API Key 就是调用模型时用的密钥，相当于你的通行证，去 platform.deepseek.com 创建一个，填进去就行。
保姆级教程不假定你已经准备好了，没有 Key 就先申请，申请完回来再填。
如果卡在无法启动怎么办，三个最常见的情况。
第一个，Node 版本不够，跑 node -v 看版本，不够就去官网装新版。
第二个，3080 端口被占，多半是之前开过别的东西，把占用进程关掉再跑。
第三个，API Key 填了但一直报无效，回 platform.deepseek.com 重新复制一遍，注意别带多余空格。
最简单的就是交给其他 AI 工具来解决就好啦。
方式 B，源码启动，适合想看代码、想自己改插件的人。
命令行一次给全。
预期输出，clone 之后本地出现 deepseek-harness 文件夹，pnpm install 跑完没有红色报错，build 跑完，最后一行同样把界面起在 3080 端口。卡在这里怎么办，多数是 pnpm 没装，先跑 npm install -g pnpm；如果 build 报错，多半还是 Node 版本，回方式 A 的检查步骤。
方式 C，桌面端。
这里要特别说清楚，dsh 官方没有出桌面端，官方提供的只有 Web UI。你在各种教程里看到的 dsh 桌面版，是社区项目 anywhere-labs/deepseek-harness-desktop，官网 dshdesktop.cn，七千多 star。它是第三方做的，不是官方产品。想用桌面端的可以装它，但心里要有数，出问题优先去社区仓库问，别指望官方售后。
四种模式
dsh 有几种运行模式，保姆级的讲法不抠内部实现，只讲怎么选。
标准模式，默认状态，什么能力都给你挂好，日常用选它就行。拿不准的时候，选标准一般不会错。
PTC 模式，批量多步骤。适合一次交代一串任务、让它按顺序批量跑完的活。什么时候不用，任务之间需要你反复确认、随时改方向的，别用它，改了就得重来。
极简模式，贴近裸模型。适合简单任务、想省资源的场景。token 是模型计费的计量单位，可以理解成一段文本被切成的小块，这个模式挂的能力最少，跑起来最轻，花的 token 也少。什么时候不用，任务复杂、要读文件查网页的，别用它，它会显得笨。
创造模式，DIY 自己的 agent。agent 就是能自己动手干活的 AI 程序，你给它一个目标，它自己拆步骤、调工具。这个模式适合你已经跑熟前面几种、想自己拼一个专属工作流的时候。什么时候不用，刚上手别一上来就进创造模式，先把默认环境跑明白。
选型就一句话，任务越明确越可以往轻里走，任务越开放越需要完整能力，拿不准就标准模式。
一切皆插件
dsh 最容易被误解的一句话，Everything is a Plugin，一切皆插件。
它不是广告词，是架构。
怎么理解，想成手机换壳。出厂手机什么样不重要，重要的是你能按自己的习惯换壳、加模块、改配置，不满意随时换掉，不用动底层。dsh 就是把这套逻辑搬到了 AI agent 身上，今天想让它多读文件，就挂一个文件能力的插件，明天想让它自己上网查资料，再挂一个网页能力的插件，挂什么、卸什么，都是你说了算。
每个能力块在工程上叫 Service Definition、Provider、Consumer 三元组，这套玩法用的是 Cordis 框架。
大白话就是，一个能力先定义好它是什么，也就是 Service Definition；再有人提供实现，也就是 Provider；最后有人负责调用，也就是 Consumer。
三者解耦，想换实现就换 Provider，想换用法就换 Consumer，谁也不碰谁。对应到使用上，是两个好处，时间上插件可以随时卸载，空间上依赖可以重新连接。
DIY 第一个插件
到这里你已经把 dsh 装好、按其中一种方式跑起来了。
这一节我们做一件最容易看出「插件」是什么的事：给 dsh 接一个识图能力——丢给它一张图片，它能告诉你里面写了什么。
第一步，打开创造模式，然后在对话框里直接输入你的需求，用一句话讲清楚就好，比如：
「我想让 agent 多一个识图能力——它能读我丢过去的图片，把里面写了什么告诉我。使用识图模型的方式，需要考虑有部署模型 API 的地方。」
接下来 dsh 会在后台自己处理这件事：识别你描述里需要的能力类型（这里是图像识别）、挑对应方向的 provider（识图模型 API ）、自动写好 cordis.yml 或 profile 配置、把能力挂上去。这一段你看着它跑、屏幕上滚动几行 process 信息就行，不用动手。
第二步，等它装好后，查看一下是否多了一个配置识图模型 API 的入口。将 API 部署好，就可以进入测试。
第三步，丢一张图给它试试——一张包含几行中文的截图、一张带价格表的页截图、一张你手边任意有字的图都行。预期输出，agent 会基于你刚接的能力把图里的文字或内容解读出来贴到对话框里，这条识图能力就算挂上了。
学到这里你已经摸过一遍「自己拼插件」的最小闭环——打开模式、输入需求、等它干活、丢东西测试。下次你想要的别的能力（读 PDF、抓网页、画流程图），走一模一样的三步就行，不用再去翻源码。
最后顺便说一句，dsh 社区现在特别活跃。
你想接的很多能力——识图、读 PDF、抓网页、画流程图——可能 github 上已经有人做好了现成插件，搜 dsh-plugin 主题就能找到一批。
有时候你的需求不一定要自己拼，先搜一下，说不定已经有人做了。这种「先用现成、再 DIY 自己拼」的学习顺序对新人更友好。
毕竟还是不要重复造轮子，要学会站在巨人的肩膀上。
几个口径校正
最后把三件容易看走眼的事摆平。
第一件，桌面端不是官方的。前面说过，官方只有 Web UI，桌面端是社区项目 anywhere-labs/deepseek-harness-desktop，别把它记成官方出品。
第二件，价格。DeepSeek 从 8 月 17 号零点起调价，旗舰模型 V4-Pro 的输出价从 6 元涨到 27 元每百万 token，涨幅 350%。这篇不聊它贵不贵，聊使用边界。涨价之后它分峰谷，高峰是上午 9 点到 12 点、下午 2 点到 6 点，其余算空闲，空闲价是高峰的一半，也就是输出 13.5 元每百万 token。
落到你头上是什么效果，如果你跑 dsh 只是自己试试、不赶时间，把批量一点的活挪到空闲时段，成本差一倍。如果你要的是实时交互、边问边改，那就只能按高峰价算，这是用 dsh 之前就该算清的一笔账。价格随时可能再调，这篇写的数字只代表写稿这一刻的口径。
第三件，developer preview。整篇都在强调这件事，现在所有 cordis.yml 模板、命令行、插件 API 都可能不兼容，你今天跑通的步骤，下个版本可能就变了。所以动手前，以 platform.deepseek.com 官方为准。
最后给你一条路径建议，如果你今天就想把 dsh 跑起来，装好、跑起来、看懂四种模式就够了，DIY 那节可以放一周再回来看，不影响你开始用。
dsh 是潜力很大的毛坯房，这篇给了你毛坯房的钥匙，装修的事，等它稳定一点再说。
我是庄一，下回见。