快速上手：5 分钟跑通 DeepSeek Harness —— 最快的 dsh guide
史上最短 DeepSeek Harness 使用教程：npm install -g @deepseek-ai/dsh、dsh --profile web 打开网页端、填上 API key、四个模式选一个，搞定。
最近更新: 2026-08-14
安装：两条命令
DeepSeek Harness（dsh）只需要 Node.js，没有别的依赖。最短路径：
npm install -g @deepseek-ai/dsh
dsh --profile web
第一条全局安装 CLI；第二条以 web profile 启动 Harness，并在浏览器里打开网页端。
不想全局安装？一条命令的等价方案：
npx @deepseek-ai/dsh web
过程中遇到问题，直接看 github.com/deepseek-ai/deepseek-harness —— README 和 issue 都在那里，所支持的 Node.js 版本也以 README 为准。
API key，或者不用填
在网页端填上 DeepSeek 的 API key，就能开始用了。如果本机环境变量里已经有 DeepSeek 的 key，这一步都可以直接跳过。
Harness 是身体，模型才是大脑。想用别的模型也行，任何 OpenAI 兼容端点都能在 UI 设置里接入（见什么是 DeepSeek Harness？）。
第一个任务之前
只确认一件事：从想让智能体干活的文件夹启动 dsh。 默认沙箱只允许它碰这个工作区，所以启动目录本身就是一道安全边界。
你的第一个任务
网页端打开就是一个对话。描述你想要的结果，而不是具体操作——智能体会自己规划步骤。适合第一次试的任务：
- "总结这个仓库里的 TODO，并给出完成的计划。"
- "修好这个项目里失败的测试，并运行测试确认。"
- "用一篇短文解释这个代码库的结构。"
观察发生了什么：智能体可能会先问一个澄清问题，或者先提出方案、等你批准再动手，然后开始一连串工具调用。会话日志记录模型看到的一切，所以之后可以随时恢复或分叉这个会话。
遇到风险操作——写工作区以外的文件、联网、运行陌生命令——Harness 会先问你。那是审批系统在工作，不是 bug。
选对模式
界面顶部的模式选择器，选的是当前会话的 Agent Preset。第一次跑用默认的标准模式就够了。四个模式：
| 模式 | 是什么 | 什么时候用 |
|---|---|---|
| 标准模式 | 完整的编程助手：能理解需求、修改代码、运行命令并检查结果 | 日常写代码和调研 |
| PTC 模式 | 在标准模式基础上，支持用 TypeScript 编写小程序，把多步操作组合成自动化流程 | 大量机械步骤的任务 |
| 极简模式 | 只提供持续可用的终端和基础文本替换工具 | 简单的改动、基准测试，或想看零魔法的主循环 |
| 创造模式 | 在标准模式基础上，额外支持运行时检查、尝试插件，以及使用预设完成创作类任务 | 设计你自己的预设——信任等级等同 shell，谨慎使用 |
会话一旦产生内容就锁定预设，所以先选模式、再开始输入。
第一次会话之后
- 会话可恢复。 关掉标签页再回来，事件日志支持恢复、分叉、检索、回放。
- "装插件"是改配置，不是包管理器命令。 每个插件的 README 都写了自己的安装方式；装第一个之前先读安全地安装插件。
- Profile、Patch 与 Preset 决定了 Harness 如何围绕你组装——配置指南讲清了叠加顺序。内置 Patch 层也是 dsh 和其他 Agent 拉开差距的地方：子 Agent、条件规则、权限、UI 替换，全是配置。
跑不起来怎么办
- Node.js 版本 —— 最常见的首次运行失败原因，对照官方 README 支持的版本。
- 模型没响应 —— 检查 UI 设置里的 API key，以及机器能否访问供应商的端点。
- 命令被拒绝 —— 那是沙箱或审批策略在拦；要么有意识地放宽沙箱（见安全指南），要么就在工作区内干活。
下一步
- 什么是 DeepSeek Harness？ —— 你刚跑起来的这套东西背后的概念
- Profile、Patch 与 Preset —— 把 Harness 调成你的形状
- 浏览插件 —— 最快地感受"一切皆插件"到底意味着什么