DeepSeek Harness（dsh）两天 10 万星，但「开发者预览版 + 插件化架构」意味着上手姿势不对会浪费很多时间。这篇 SOP 给出一条从零到跑通的最短路径：环境准备 -> 一行启动 -> 模式选择 -> 轨迹回放 -> 第一个插件 -> 成本控制，外加 5 个实测踩坑。新闻背景见本站 Harness 热点，同类工具选型见 Agent Harness 横评。
边界说明：步骤基于官方 README 与发布文档整理（截至 2026-08-15），v0.1 迭代极快，命令与界面以官方仓库为准；本文整理自官方文档与公开教程，非逐字实录。
第一步：环境准备（10 分钟）
dsh 是 Node.js 项目，前置条件只有两样：
# 1. Node.js（建议 LTS 版本，node -v 确认）
node -v
# 2. DeepSeek 平台 API Key（用于模型插件；也可是其他 provider 的 key）
# 建议导出为环境变量，dsh 首次启动时按界面指引填入两个前置判断：国内网络环境需要保证 npm registry 可达（必要时切镜像）与模型 API 端点连通；想跑源码的开发者额外需要 pnpm。
第二步：一行命令启动（2 分钟）
npx @deepseek-ai/dsh web默认在 http://127.0.0.1:3080 打开 Web UI。首次启动按界面指引配置模型插件（填 API Key、选模型），然后就能开第一个会话。源码方式：
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web注意 Web UI 是本地服务（127.0.0.1），浏览器打开是它的正常形态，不是没做完--社区对这个「朴素」有吐槽，功能都在。
第三步：按任务选模式（5 分钟理解，终身受益）
| 模式 | 工具面 | 什么时候用 |
|---|---|---|
| Standard | 完整组合：文件编辑、Shell、文件/网页搜索、技能、规划、子 agent | 日常开发任务默认 |
| Code（PTC） | Standard 全量 + Code Mode SDK | 要模型在单个 TypeScript 程序里连续编排多工具的复杂任务 |
| Minimal | 仅持久化 bash + str_replace_editor | 评估模型净能力；官方跑 Code Agent 基准的环境 |
| Creator | 运行时检查 + 插件试验组合 | 开发/调试自己的插件与预设 |
选择口诀：干活用 Standard，编排用 Code，测模型用 Minimal，写插件用 Creator。
第四步：用轨迹（Trajectory）排查 agent 跑偏
dsh 把系统提示词、思维链、工具调用与结果、子 agent 调度、每次上下文注入全部写入仅追加（append-only）会话日志。在轨迹视图里按来源筛选，可以对任何一次运行做恢复、分叉、检索、回放。实战用法三条：
- agent 结果不对 -> 先回放轨迹，定位是哪一次工具调用引入偏差，而不是重跑碰运气
- 想试不同走法 -> 从某个节点分叉，对比两条路径的成本与结果
- 复盘提示词 -> 检查系统提示与上下文注入是否按预期生效
第五步：第一个自己的插件
插件是 dsh 的核心扩展方式，官方推荐路径：给插件仓库打上 dsh-plugin topic 即可被发现（生态现有约 300 个插件）。开发流程：在 Creator 模式里检查实时运行时、试验 Cordis 插件组合，满意后固化为自己的预设模式。建议第一个插件从最小可用做起：包装一个你天天用的内部工具（查询、部署、通知），别上来就改循环编排。
五个踩坑（先读再动手）
- 别把生产系统焊在 v0.1 上：官方明确「会有破坏兼容性的变更」，核心插件与 API 都在调整。生产等稳定版，现在定位是实验与学习。
- 第三方插件先审再装：约 300 个社区插件没有审核机制，装前看源码，沙箱里跑，模型凭证别交给来路不明的插件。
- 成本先算再跑：dsh 配套模型 V4-Pro-0813 强但按 token 计费，且 DeepSeek API 高峰时段涨价（V4-Flash 输出价 2->9 元/M）。多工具长任务的 token 消耗是线性放大的，先用小任务估单价再放量。
- 国内网络两处卡点：npm 拉包与模型 API 端点连通，任一不通都会卡启动，先各测一遍再排错。
- 界面朴素不是 bug：本地 Web UI（浏览器访问 127.0.0.1:3080）就是设计形态，别等一个「原生 App」；要终端形态的成熟体验，看本站 Agent Harness 横评 再选。
常见问题
Q1：DeepSeek Harness 最低需要什么环境？
A1：Node.js（建议 LTS）+ 一个模型 API Key（DeepSeek 或其他 provider）。最快路径是 npx @deepseek-ai/dsh web，无需克隆源码；源码方式额外需要 pnpm，用于 pnpm install && pnpm run build && pnpm dsh web。
Q2：四种运行模式怎么选？ A2：口诀是「干活 Standard、编排 Code、测模型 Minimal、写插件 Creator」。Standard 是完整工具组合的日常默认；Code（PTC）用 Code Mode SDK 让模型在单个 TypeScript 程序里连续组合多工具；Minimal 只留 bash + 文件编辑，是官方基准测试环境；Creator 用于运行时试验插件并组合新预设。
Q3：Web UI 打开是浏览器页面，是不是没装好？
A3：装好了。dsh 的界面形态就是本地 Web UI，npx @deepseek-ai/dsh web 启动后默认服务在 http://127.0.0.1:3080，用浏览器访问是设计内行为。社区对界面朴素有吐槽，但功能（会话、轨迹、插件管理）都在这个界面里。
Q4：轨迹（Trajectory）功能实际怎么用？ A4：每次运行的全部事件（系统提示、思维链、工具调用与结果、子 agent 调度、上下文注入）写入仅追加日志，轨迹视图可按来源筛选，并支持恢复、分叉、检索、回放。典型用法：结果不对时回放定位偏差工具调用；从中间节点分叉对比不同走法；复盘提示词是否按预期注入。
Q5：现在值得把日常开发迁到 dsh 吗？ A5：不值得。v0.1 是开发者预览版，官方警告破坏性兼容变更，插件生态无审核，体验面向构建者而非日常用户。当下合理姿势：用 Claude Code/OpenCode 干活（配 DeepSeek 模型省钱的方案见本站 DeepSeek 接 Claude Code SOP），把 dsh 当学习与实验平台，等接口稳定再评估迁移。
参考来源
- GitHub：deepseek-ai/deepseek-harness README（安装命令、端口、开发者预览警告、dsh-plugin topic、Discord 社区）
- DeepSeek 官方发布文档：四种运行模式、append-only 轨迹、Cordis 插件架构
- 网易科技（2026-08-13）：安装方式与四种模式中文说明
- 知乎实测帖（2026-08-14）：
npx @deepseek-ai/dsh web启动体验与界面形态 - 东方财富/新浪财经（2026-08-14）：V4-Flash 高峰时段涨价（输出 2->9 元/M）
本文基于官方文档与公开教程整理（2026-08-15），非逐步实录；命令与界面以官方仓库为准。相关阅读：DeepSeek Harness 热点 ｜ Agent Harness 横评 ｜ DeepSeek 接 Claude Code SOP