把 DeepSeek Harness 跑起来，一行命令的事

上一篇把概念讲完了，dsh 是 DeepSeek 开源的那个 agent 装配台，负责把模型和工具拼成能干活的 agent。这篇动手，你电脑上装好 Node.js，一行命令就能把它跑起来。

先确认两样东西

动手前确认两样。Node.js 版本要 22.19 以上（24 也行，官方 CI 覆盖 22.19、24、26），再就是包管理器 pnpm。没有就先去装，教程里写得比我清楚，我不重复。有 DeepSeek API key 最好，没有也能把界面起起来，只是真让它干活会报错。

最省事的跑法，一条命令就能起。

npx @deepseek-ai/dsh web

这条命令装好运行时要的东西，起一个本地 Web 服务，默认地址 http://127.0.0.1:3080。浏览器打开，你已经有一个会调工具、会记日志、能自己拆步骤干活的 agent 界面了。

想从源码跑也行，把官方仓库 clone 下来，再装。

pnpm install
pnpm run build
pnpm dsh web

效果一样。第一次跑完 pnpm run typecheck 验证环境就绪，教程里这么说的。

不想开浏览器，还有 headless 模式，适合脚本和自动化。

dsh --profile headless "把当前目录梳理一遍"

它起一个全新的持久会话，干完活把最终答案打到终端就退出，不启动任何服务器。

web 和 headless 是官方随产品带的两个模板。你想定义自己的组合，用 dsh --profile <名字> 指定，dsh plugin 帮你管插件。

跑起来之后有个命令值得玩。

dsh --profile web --dump-config

它不真正启动，直接把当前 profile 拼出来的插件树打印给你看。base 层是什么、web 层加了什么、每一行配置长什么样，一目了然。

上一篇说的「一切皆插件」，这里看得最直观，打印出来的任意一行，你都能用一份补丁覆盖掉。这就是那个装配台的零件清单，拆给你看了。

API key 别写进仓库，放环境变量 DEEPSEEK_API_KEY，或者放 gitignore 掉的 .env。没配 key 时，要真调模型的演示会自动跳过，不会崩，这个设计挺贴心。

另外它还在开发者预览，接口说变就变，玩可以，生产先别上。

首发于公众号「键盘漫笔」