DeepSeek Harness 教程：从安装到 headless
十个经截图验证的步骤，从全新安装一路走到智能体预设、Creator 模式插件和 headless 运行——DSH 的完整导览。
最近更新: 2026-09-14
DeepSeek Harness（DSH）是 DeepSeek 开源的智能体运行框架，上线一周就拿下 169,000 GitHub stars：工作区、插件、工具、子代理、可随时更换的模型，连界面都能重建。本攻略把目前最完整的一支实拍教程拆成十个经截图验证的步骤：从一次全新 clone，到预设、插件、沙箱和 headless 运行。
这是一页看完的完整导览。每一步都能深链回源视频的精确时刻；而装插件、切模型、配预设这些深挖主题，页面底部各有一篇专属攻略。
十个步骤，走完 DSH 全程
- 1
安装 harness，启动仪表盘
DeepSeek Harness（DSH）就是给模型装上手脚的那层开源框架：文件工具、shell、记忆、权限。官方文档给了两条路——npx 一行命令，或者完整 clone 仓库（视频走的是 clone）。然后一条命令启动 Web UI 并打印本地地址（视频里是 127.0.0.1:3080），打开就是仪表盘。首次启动会弹出对话框索要 DeepSeek API key。
$git clone https://github.com/deepseek-ai/deepseek-harness$pnpm dsh web
两种装法：npx 一行命令，或 clone 仓库——视频选了后者。在 1:15 观看 
一条命令启动 Web UI，启动后打印本地地址。在 1:38 观看 - 3
先加工作区，再提任何要求
在 DSH 里，想让它干正事就必须先给它一个文件夹：点侧边栏的 Add workspace 按钮，或用输入框上的工作区下拉。每个智能体会话都被限定在那个文件夹里——这正是“专注一份工作”和“放它扫遍你整台电脑”的区别。会话还是持久的：今天关掉，明天打开，之前的工作原样都在，接着干就行。
先选文件夹——每个会话都被限定在里面。在 2:30 观看 - 4
万物皆插件——包括你以为属于核心的部分
这是 DeepSeek 官方打头的那句话：跟模型对话的部分、工具列表、记录一切的日志，乃至驱动智能体走出下一步的循环——全是插件。没有受保护的核心，所以 DSH 里没有什么是永久的，也就没有什么能困住你。打开 Settings → Plugins 一看便知：存储、会话、审批，甚至 web server 都是带 Enabled 徽标的插件。生态里已经有现成的连接器，但 DSH 还是开发者预览版，readme 明说会有破坏性变更——动手造轮子之前先查插件目录，把自己做的东西当原型对待。
DeepSeek 官方的那句话：DSH 里没有什么是永久的。在 4:15 观看 
存储、审批、web server——在这份列表里都只是插件。在 4:25 观看 - 5
按任务挑运行模式
Settings → Agent presets 列出了内置的几种重组方式。Standard 模式是全家桶：文件编辑、检索、shell、Skills、规划、子代理。Code 模式暴露同样的工具，但让模型写一段程序把它们串起来，而不是一次一个调用。Minimal 模式只留两个工具：终端和文件编辑器。视频给同一个任务（重命名 200 个文件）做了基准：Standard 模式花了 30 次往返，Code 模式只花 3 次。同一套工具，三种成本——挑能干完活的最便宜一档。
四套内置预设——复制一份改造，或让 Creator 模式帮你起草。在 5:22 观看 
同样重命名 200 个文件：Standard 30 次往返，Code 模式 3 次。在 5:32 观看 - 7
随手读 Trajectory 收据
模型看到和做过的每件事都写进一份只增不改的日志，Trajectory 页就是它的回读界面：系统提示词、上下文注入、推理、每一次工具调用和结果。它出了错，你能看到它到底被灌了什么。这一页同时也是工具清单——bash、skill 等等就是全部可动用的表面，不在清单里就发生不了（Creator 模式还能再加）。
系统提示词、上下文注入、工具调用——整份收据，只增不改。在 9:28 观看 - 9
让它先亮计划，再动手
Plan 模式让 DSH 在动手之前先说清楚要做什么——在输入框里敲 /plan，描述任务，读完计划再放行。读计划用不了一分钟；返工 40 处改错的文件能拖上几周。凡是会碰到两个以上文件的任务，都值得先来一份计划。
读完计划，再放行智能体。在 9:55 观看 - 10
教它、派活给它，然后 headless 跑起来
Skills 是写好一套流程的指令文件，放进项目或全局安装——视频作者那批 Claude Code 全局技能就被自动接了进来。目标（/goal）给会话装上一条终点线，让它朝着结果一直跑；目标要写得具体，它才知道何时停。DSH 没有内置调度，但 Creator 模式能给你起草一个定时任务插件——只是会话一关它就停。长任务会派给子代理，每个子代理都有干净独立的上下文；或者由它写一段一次性的工作流程序去追一个结果。最后是 headless：一条命令，打印答案，直接退出——没有窗口、没有端口。凡是能执行命令的东西，从此都能调度一个智能体。
$pnpm dsh --profile headless "<one-off task>"
Skills 是写一次就反复用的指令——可限定项目，也可全局安装。在 10:35 观看 
没有窗口、没有端口：一条命令进，一个答案出。在 13:30 观看
DeepSeek Harness 教程：常见问题
这篇导览最常被问到的几件事。
安装 DeepSeek Harness 最快的方式是什么？
官方文档给了两条路：一行 npx 命令直接启动 Web UI，或者像视频里那样 clone git 仓库。无论哪种，一条命令——clone 下来后是 pnpm dsh web——就会把仪表盘架在本地地址上（攻略里是 127.0.0.1:3080），首次启动会要求填 API key。
用 DSH 必须要 DeepSeek 的 API key 吗？
不需要。首次运行的弹窗虽然索要 key，但 Settings → Models → Add provider 接受列表里任何服务商的密钥。攻略用的是 OpenRouter，它暴露的每个模型都能在输入框的模型选择器里按任务试用和切换。
应该从哪种运行模式起步？
Standard 模式——全家桶，带文件编辑、检索、shell、Skills、规划和子代理。便宜重复的活换 Minimal 模式；几十次往返才能干完的活换 Code 模式：视频里重命名 200 个文件的基准，Code 模式 3 次往返搞定，Standard 模式花了 30 次。
DeepSeek Harness 怎么防止智能体弄坏我的文件？
沙箱级别由操作系统在底层强制执行，不是提示词里的客套话：read-only 只能看不能碰；workspace write 只能改项目文件夹内的东西；full access 无所不能。攻略里的只读会话拒绝复制文件，直到获得明确批准。DSH 没有“总是允许”选项——完全访问要通过警告对话框手动开启，也不该当默认。
DSH 真的能给自己造插件吗？
能，靠的就是 Creator 模式。你用大白话描述想要的能力，它检视自己的运行环境、在内存里试装部件、定义插件包。视频里一句话就让一个能玩的 Pong 游戏渲染在聊天里；后来还让 Creator 模式起草了一个定时任务插件——注意，它只在会话存活期间运行。
不开 Web UI 也能跑 DeepSeek Harness 吗？
Headless 模式用一条命令带上任务，打印答案后直接退出——没有窗口、没有端口、什么都不监听。脚本、定时任务、其他智能体工具因此都能从终端调用 DSH：凡是能执行命令的东西，都能调度一个智能体。
相关攻略
把这条路线上的每一环再挖深一点。
DeepSeek Harness 快速上手
5 分钟装好并跑起来的最短路径，一步一步写清楚。
阅读指南DeepSeek Harness 插件安装指南
找社区插件、从 npm 或 GitHub 添加、验证加载成功。
阅读指南DeepSeek Harness 智能体预设详解
Standard、Code、Minimal、Creator 四种模式深入拆解，再加自定义预设。
阅读指南DeepSeek Harness 切换模型指南
接服务商、比较模型、在输入框里按任务随时切换。
阅读指南DeepSeek Harness 必装插件
最值得先装的那些社区插件，以及各自补上了什么。
阅读指南DeepSeek Harness 子代理与多智能体实战
一次拉起五个子代理并行干活：会话头部逐个监控、完成报告逐个读、按子代理指定模型，截图逐步对齐
阅读指南来源与致谢
本页所有截图均来自下方公开的屏幕录制，每张图都可深链回截取的精确时刻。攻略内容已与官方文档交叉核对。