文档很多但不知道从哪看起?DeepSeek Harness 5个网站帮你从零上手

收藏这一篇就够了

5 Parts + Conclusion

滑动查看 →

Model + Harness = Agent

模型负责思考，Harness 负责让思考落地

DeepSeek Harness 101

deepseekharness101.com/zh

社区做的中文上手指南，核心卖点是「不用先翻几十篇零散教程」。把第一次运行拆成5个可检查的结果：装 Node.js → 执行命令 → 打开页面 → 配置模型 → 发送第一条只读任务。每一步都有明确的"做完了长什么样"的判断标准。

适合谁：还没跑起来的人。这是你的第一个入口。

官方文档 - 使用 Web UI

deepseek-harness.github.io/deepseek-harness/guide/quickstart

DeepSeek 官方出的 Web UI 快速上手指南。内容很精炼：配置模型（输入 DeepSeek API Key）→ 选择工作区 → 运行第一个任务。官方文档的优势是命令和参数一定是最新的，不会过时。

适合谁：跑起来之后，想确认自己配置是否正确。和网站①配合看，互为补充。

DeepSeek Harness 从入门到插件化实践：增强版

doc.laoyao.cn/wtknpy

这是我见过最系统的中文教程，16个章节 + 4个动手实验。从「运行时地图」讲起，覆盖安装、Profile/Bundle/patch 组合、插件生命周期、Tool 开发、Service/Provider/Consumer、事件系统、会话日志、打包测试、安全审查、排错速查。每一章都有可运行示例和预期输出。

适合谁：跑起来之后想深入理解架构、学插件开发的人。这是进阶的核心资料。

官方文档 - 第一个插件

deepseek-harness.github.io/deepseek-harness/develop/basic/

官方的插件开发入门教程。从创建本地项目开始，教你写一个最小的 Harness 插件：导出 apply 函数 → 通过 ctx 注册能力 → 注册到 cordis.yml → 加载到 Web UI。后面还有 Tool 开发、插件配置、打包安装、生命周期、服务依赖、事件系统等完整文档链。

适合谁：想自己写插件、扩展 Harness 能力的开发者。和网站③配合看效果最好。

从 DeepSeek 招聘反推：Harness 研究员到底要会什么？

reelos.ai/articles/deepseek-agent-harness-researcher/

ReelOS 写的一篇深度分析，从 DeepSeek 招聘「Agent Harness 研究员」这个岗位反推，拆解了 Harness 需要的七类能力：Agent 基本机制、Context Engineering 与 Memory、Tool Use 与执行环境、Subagent 与 Multi-Agent、Harness Eval、Self-Evolving Harness、Model-Harness Co-Evolution。文章里有一句话说得很到位：Agent 的竞争正在从"模型能力"进入"Harness 能力"。

适合谁：已经上手了，想理解 Harness 的技术方向和职业前景。不适合新手第一步看。

GitHub - deepseek-ai/deepseek-harness

github.com/deepseek-ai/deepseek-harness

源码、README、示例、架构、版本变化和社区入口的权威来源。遇到问题先搜 Issues，大概率有人踩过同样的坑。

打开网站① deepseekharness101.com，按5步走：装 Node.js → 执行 npx @deepseek-ai/dsh web → 打开本地页面 → 配置模型 → 发一条只读任务。遇到问题对照网站②官方文档确认命令。

打开网站③ doc.laoyao.cn，先看前3章：建立运行时地图 → 安装启动验证 → Profile/Bundle/patch 组合。不用全看完，先搞懂 Harness 的整体架构。

照着网站④官方教程，创建本地项目 → 写一个最小插件 → 注册到 cordis.yml → 加载到 Web UI。跑通之后再看网站③的第4-6章（生命周期、effect、热替换），动手实验一和实验二。

跟着网站③的第7-8章（开发完整 Tool、取消/策略/UI 卡片）和网站④的 Tool 开发文档，做一个能实际使用的 Tool。这是插件开发的核心能力。

读网站⑤的深度分析，理解 Harness 的技术方向：Context Engineering、Tool Use 设计、Multi-Agent 协作、评测体系。这些决定了你后续往哪个方向深入。

踩坑提示 · PITFALL

模型不回答？先分清四种原因：模型未配置、API Key 错误、网络不可用、工作区未选择。不要反复重装，先看终端报错。

踩坑提示 · PITFALL

第一次任务用临时目录，先让它「看」不要让它「改」。发一句「列出当前目录的文件，不要修改」，确认能跑通再放开权限。

踩坑提示 · PITFALL

插件安装前先看仓库、许可证和访问范围。用临时目录跑一个最小任务，确认没问题再用到正式项目。

踩坑提示 · PITFALL

目前是开发者预览阶段，命令和 API 可能变化。遇到问题先查 GitHub Issues，再对照官方文档确认当前版本的正确用法。

网站①跑起来 → 网站②确认配置 → 网站③理解架构 → 网站④写插件 → 网站⑤看方向。按这个顺序走，不用来回跳。