一句话：从 0 到 1 搭一套可复用 Agent 工作系统的开源实战指南 —— E-INK 视觉、6 种语言、一切皆插件，命令可复制、报错可复现，照着做就能跑通。
先交代下背景：我从 dsh 刚出来就在折腾 DeepSeek Harness ↗（简称 dsh），一路踩了不少坑。想找份”从入门到生产”的完整教程，结果翻了一圈官方仓库——只有 API 文档，没有一篇能照着跑的实战指南。行吧，没人写，那我写。于是就有了这份 DeepSeek Harness 蓝皮书 ↗（GitHub 仓库 ↗）。
这是什么
简单来说，这是一份以真实任务为主线的 dsh 学习指南：从跑通第一个能验收的 Agent 开始，到搭出一套可复用的工作系统。它不是 API 文档的翻译——官方文档讲”是什么”，我讲”怎么跑通”。每一步的命令、截图、甚至报错，都是真实操作记录下来的，照着做就能复现。
视觉上我搞了一套 E-INK 纸感 × DeepSeek 墨蓝 主题：米白纸底、墨色文字、荧光黄标注，动效几乎为零，读起来更像一本纸书而不是网页。支持中/英/日/韩/西/葡 6 种语言，还内置了自研图片灯箱（点击放大、Ctrl+滚轮缩放、拖拽平移）。
这份指南适合谁
- 刚接触 dsh，想从”装上能跑”走到”搭一套工作系统”的开发者
- 用过一阵 dsh，但对插件树、消息流、调度、MCP 还没串起来的进阶用户
- 想给团队沉淀一套 Agent 工作流模板、而不是每次从零写脚本的负责人
讲些什么
全书按 PART 组织，从入门一路到生产环境：
- PART 00-01 · 入门：为什么是 Agent 的乐高时代；认识 dsh、安装、Web UI、headless 模式、模型配置与排错
- PART 02-03 · 核心机制：插件树、核心子系统与消息流、会话日志；工具与沙箱、MCP、子代理、Skill、调度、本地部署
- PART 04 · 插件开发：dsh 的精髓”一切皆插件” —— 从安装插件到编写插件再到发布插件，defineTool、Hooks、UI 一条龙
- PART 05-06 · 实战与生产：个人网站、PPT、视频三个实战场景；部署、安全、可观测性与上下文管理
- 附录：术语表、命令速查、学习路径、面试题
每章遵循同一个模板：本章目标 → 动手 → 分节实操 → 这一章你学到了什么。实操章节还附赠”让 dsh 自己来：一句提示词”的玩法 —— 毕竟学 Agent 工具最好的方式，就是用 Agent 来干活。
怎么读（按需挑）
- 想跑起来：直接看 PART 00-01，跟着命令敲一遍，30 分钟内能跑通第一个 Agent
- 想搞懂原理：从 PART 02 开始读，重点看插件树、消息流、调度三块
- 想自己写插件：直奔 PART 04，把 defineTool / Hooks / UI 三件套跑通一遍就能上手
- 要上生产：PART 05-06 看部署、安全、可观测性，附录有命令速查和面试题
写在最后
如果你也在用 dsh，或者对 Agent 工作流感兴趣，直接在仓库按 PART 目录读就行。觉得有用的话，点个 Star 就是最大的鼓励 ⭐