一行命令装好，5分钟跑通，然后你会明白为什么它一夜5万星
01 一个让我失眠的对话
“兄弟，DeepSeek Harness你试了吗？12小时5万星那个。”
前天晚上，一个做测试的老同事发来消息。
“看了，还没试。”
“赶紧试一下。我昨晚装上了，一行命令，5分钟跑通。然后我让它跑我们项目的测试——它自己读代码、自己执行、自己分析失败原因，然后把修复方案列出来了。”
“整个过程，我就坐在旁边看着。”
他停顿了一下，又说了一句：
“我感觉……我以后招人，标准要彻底变了。 ”
我当晚就装上了。
然后失眠了。
02 痛点：官方文档有架构，但没有“从零上手”的路径
DeepSeek Harness（简称dsh）是DeepSeek在2026年8月13日开源的Agent运行时。它以MIT协议开源了全部代码。
但有一个问题：官方文档以架构说明为主，缺少一条从零上手的路径。
打开GitHub仓库，你会看到AGENTS.md、architecture.md、development.md——全是给开发者看的架构文档。对于一个刚接触dsh的新手来说，根本不知道从哪里开始。
所以就有了这份手册。
目标只有一个：让你从0到1，跑通第一个Agent。
03 核心思路：DeepSeek Harness到底是什么？
用一句话说清楚：
DeepSeek Harness = 一个“一切皆插件”的Agent运行框架。
过去的Agent框架像一栋固定浇筑的大楼——核心Harness是固定的，用户只能在外围加插件。
DeepSeek Harness把这栋“固定的大楼”拆成了一盒乐高。不只是外围能力可以插件化，连模型适配器、工具注册表、会话日志，甚至Agent Loop本身，全都可以替换。
不存在需要打补丁的特权内核——扩展dsh的方式就是往插件树里挂载新插件。
用大白话理解：
- 模型是“大脑” ——负责思考和推理
- Harness是“手脚” ——负责让大脑真正动手干活：读文件、调工具、执行命令
而整个“手脚”系统，每一个关节都可以拆卸和替换。
这就是“一切皆插件”的真正含义。
04 具体步骤：从安装到跑通，10分钟搞定
第一步：准备Node.js
DeepSeek Harness需要Node.js环境，要求Node.js版本 ≥ 22。
打开终端（Windows用户打开命令提示符或PowerShell），输入：
node --version
如果看到版本号（如v22.19.0或更高），说明已经装好了。
如果提示找不到node命令，去Node.js官网下载LTS长期支持版本安装即可。
小技巧：如果明明装过Node.js但终端提示找不到命令，关闭当前终端重新打开。很多时候只是环境变量还没刷新。
第二步：一条命令安装DSH
Node.js准备好之后，执行这条命令：
npx @deepseek-ai/dsh web
这条命令会自动下载并启动DeepSeek Harness的Web UI。
首次运行可能需要等一两分钟下载依赖。装完之后，验证一下版本：
dsh --version
看到版本号（当前是0.1.0-rc.6）就说明安装成功了。
Windows用户特别提醒：安装Node.js或全局npm包以后，如果遇到“明明装好了却找不到命令”的问题，重新打开一次PowerShell或命令提示符。
第三步：启动Web UI
执行启动命令：
npx @deepseek-ai/dsh web
或者（如果已经全局安装过）：
dsh web
稍等片刻，浏览器会自动打开http://127.0.0.1:3080。
如果浏览器没有自动打开，手动把这个地址复制进去就行。
注意：目前DSH还是v0.1开发者预览版本，项目处于快速迭代阶段，接口和配置方式后续可能会有变化。
第四步：配置API Key
第一次进入Harness，最重要的一步：配置DeepSeek API Key。
操作路径：
- 点击界面中的 设置（Settings） → 模型（Models）
- 在DeepSeek卡片中输入你的API Key并保存
- 密钥保存在本地
$DSH_HOME/.credentials.yaml中，不会被上传
还没有API Key？ 去DeepSeek开放平台注册账号，创建API Key。
安全提醒：API Key是调用模型服务的凭证，不要随便发给别人，不要贴到公开文章、GitHub仓库或截图里。
第五步：选择工作区
配置完API Key后，点击 选择工作区（Select Workspace） 。
工作区就是Agent能“动手”操作的文件夹——Agent可以读取、编辑这个文件夹里的文件，执行命令。
选择一个你想让Agent工作的项目目录。
注意：在Web UI中选中工作区之前，会话输入框是不可用的。
第六步：跑通第一个任务
现在可以开始体验了！
新建一个会话，输入一个简单的任务，比如：
Summarize this repository and identify its main packages.
Agent会开始工作：读取仓库文件、执行命令、按需委派子任务、维护执行计划。
每个操作都可以在Web UI中看到实时进展。当某个操作需要审批时，界面会先询问你。
每次会话都会自动持久化（默认存在$DSH_HOME/sessions），可以随时恢复继续。
05 进阶：四种运行模式
除了Web UI，DeepSeek Harness还支持多种运行方式：
方式一：从npm运行（最推荐新手）
npx @deepseek-ai/dsh web
方式二：从源码运行（适合开发者）
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web
方式三：Headless模式（适合脚本/CI）
dsh --profile headless "你好，请用一句话介绍自己"
方式四：Python SDK（适合Python开发者）
from deepseek_harness import DeepSeekHarness
with DeepSeekHarness() as harness:
response = harness.chat("请帮我分析这个项目的结构")
06 真实案例：它已经能做到什么？
案例一：代码Agent实测。
发布当晚，有开发者装上Harness后让它干了两件活：照着The Verge的风格重构一个官网，再调GitHub接口画出自己的涨星曲线。两件活都交付了，全程token不到3块钱。
案例二：测试自动化闭环。
社区已经有人做了dsh-test-runner插件，让Agent一次工具调用就能完成“改代码→跑测试→修”的完整闭环——自动探测测试框架、执行测试、只返回结构化摘要。
案例三：插件生态爆发。
发布不到24小时，社区带dsh-plugin标签的插件仓库已经攒到288个。有人给它换上Windows XP的复古皮肤，有人做了表情包插件。
到8月16日，GitHub上标有dsh-plugin的开源仓库已超700个。
07 避坑指南：新手最容易踩的5个坑
坑1：Node.js版本不对
DSH要求Node.js ≥ 22。用老版本会报错。检查方法：node --version。
坑2：终端没刷新
装完Node.js或npm包之后，一定要重新打开终端。很多时候“找不到命令”只是环境变量没刷新。
坑3：API Key没配置就发消息
没配置API Key就直接发消息，会报MISSING_CREDENTIAL错误。先去设置→模型里把Key填好。
坑4：没选工作区
Web UI中没选工作区之前，输入框不可用。点一下“选择工作区”，选一个文件夹就行了。
坑5：等“稳定版”再学
DSH目前是v0.1开发者预览版，官方明确说“核心插件和基础接口未来几个月会快速演化”。等稳定了再学，你就已经落后了。
08 写在最后
DeepSeek Harness开源不到12小时，GitHub上5万星。
这不是凭空来的。
它把Agent框架从“固定大楼”变成了“一盒乐高” 。模型适配器、工具注册表、会话日志、Agent Loop——每一部分都可以从配置替换。
对于测试工程师来说，这意味着什么？
意味着“写测试脚本”这个技能，正在被AI Agent化。社区已经有人在Harness上做出了“改代码→跑测试→修”的完整闭环。
但Harness不会让测试工程师消失——它会让“只会执行”的测试工程师消失。
就像Excel没有让会计消失，但让“只会打算盘”的会计消失了。
工具在变，但“对质量负责”这件事，永远需要人。
问题是——
你是那个被工具替代的人，还是那个用工具的人？
8月20日（周四）晚20:00，我们有一场公开课，用2小时一次性讲透DeepSeek Harness的所有核心能力——Agent架构、插件体系、Web自动化、App自动化、视觉驱动自动化。
这一次，别等“稳定了再学” ——因为等你等到了，你的岗位可能已经“稳定”地被别人替代了。
