DeepSeek Harness 蓝皮书 — 一本讲 dsh 的实战指南|30 章正文、4 篇附录

DeepSeek Harness 蓝皮书 是一份以真实任务为主线的实战指南,30 章正文加 4 篇附录,七万五千字,开源 放在网上,打开就能读。它讲的是怎么把一个命令行智能体框架用顺:从第一个能验收的智能体开始,一路到能反复调用的工作系统,首页写着三天入门的目标。归到 AI教程 这一类,它属于能边看边敲的实战书;做 AI编程 的人顺着目录走,基本就是一条上手路线。

dsh,全名 DeepSeek Harness,是 DeepSeek 在 2026 年 8 月 13 日放出来的智能体运行框架。官方给的等式是:模型加框架,才等于一个能干活的智能体——大语言模型 负责想,框架负责读文件、敲命令、调接口、管上下文、做计划。它跟常见的编码助手不是一类东西:后者是成品,工具、会话、沙箱全封在一个壳里。dsh 只管底下那一层,写代码是它预置的一套组合,也能拼出跟编程无关的活。

功能特点

  • 真实任务驱动:每章内容来自真实实操——命令、截图、报错全部真实,可照做复现
  • 6 种语言:中文(默认)、English、日本語、한국어、Español、Português
  • 插件优先:围绕 dsh”一切皆插件”架构展开——从会装、会写到会发
  • E-INK 风格:米白纸底、墨字、荧光黄标注,零干扰动效
  • 图片查看器:点击放大、Ctrl+滚轮缩放、左右键切换、拖拽平移、ESC 退出

六段路径,按目标进

DeepSeek Harness 蓝皮书 首页把 30 章切成六段,每段标着覆盖的章节号,可以挑着读:

  • PART 01 从 0 到 1(第 2 至 7 章):认识、安装、第一次对话、命令行、配置模型、排障,新手从这里进。
  • PART 02 理解骨架(第 8 至 10 章):插件树怎么搭起来的、核心子系统与消息流转、会话日志。
  • PART 03 组装智能体(第 11 至 16 章):工具与沙箱、子代理、定时任务、本地部署。
  • PART 04 会装会写会发插件(第 17 至 23 章):从装第一个插件、写 hello-plugin,到造工具、写钩子、做界面、发布。
  • PART 05 场景实操(第 24 至 26 章):个人网站、演示文稿、视频。
  • PART 06 生产与生态(第 27 至 29 章):部署选型、安全合规、可观测与上下文管理。

另外还有 PART 00 开篇(为什么学、怎么读)和 4 篇附录:术语表、命令速查、学习路径、面试题。就算不打算马上动手,把它当 AI资料 翻一遍,这套框架的骨架也能摸清。

每章一个固定套路

每章开头标出全文字数、预估耗时、前置条件和难度,正文按「本章目标 → 动手 → 按图片内容分小节 → 这一章学到了什么」走。章末那节是一份勾选清单,能自己检查到底学会没有。

图是真的,看也方便

全书 120 张配图都是真实截图,命令、报错都不做假。页面是米白纸底配墨字、荧光黄标注的纸感风格,点图能放大,滚轮缩放、左右键切换、拖着看、按退出键关闭。

写书也有硬规矩

作者在仓库里写明了写作规范:内容必须能核验,命令和截图不许编造;用第一人称实操口吻写,保留真实踩过的坑,句子要短;核心概念一律配自己画的架构图;演示统一用一个带视觉的模型;每个动手章还要补一节「让 dsh 自己搭」,给出一条能直接用的提示词。

六种语言与协作流程

站点支持中文、英文、日文、韩文、西班牙文、葡萄牙文六种语言,中文是源语言。改内容只改中文,改动记进根目录的一个日志文件,收到翻译指令后才按中文到英文、再到其余四种语言的顺序翻,翻完删掉日志。

整本也能自己搭一份

它是静态站点,装好依赖后能在本地跑起来边改边看,构建产物输出到一个固定目录,可以丢到常见的静态托管平台。习惯自己折腾 开发者工具 的人,照这套结构改也很省事。

使用教程

  1. 打开在线站点,中文是默认语言,想换语言在页面顶部切。
  2. 先读开篇那两篇,搞清这本书讲什么、自己该走哪条路。
  3. 新手直接进第一段,从认识、安装、第一次对话一路读到排障。
  4. 每章按「本章目标 → 动手 → 小结」读,动手部分跟着敲,章末清单逐条自查。
  5. 想挑着看:查插件写法去第四段,想看能交付的成品去第五段,要上生产看第六段。
  6. 想改内容或加章节:把 GitHub 上的仓库拉到本地,装好依赖启动本地预览,在对应目录加文件,再改侧边栏配置;改动记进根目录的日志。
  7. 想自己部署:构建之后把产物目录推到静态托管平台即可。

使用感受

这份指南是个 开源项目,最实在的一点是把「能复现」当成硬要求:命令、截图、报错都是真的,跟着敲就能对上,不像有些教程只给结果不给过程。把它当 效率工具 看也说得通——它想做的不是让人多读一本书,而是把跑通过的那一次变成下次能直接用的东西。

要说门槛,书本身没有:中文、免费、打开就能读。门槛在被讲的那件东西上。dsh 还在开发者预览阶段,官方默认只加载最小的一圈工具,识图、读文档、操作浏览器这些都要自己装插件,官方也明说会有破坏性变更。想省心的人可以先把第一段读完,再决定要不要往下走。当作 宝藏资料 收一份也不亏,市面上把踩坑过程一并写进去的中文实战书不多。

官方网站

下载地址

https://pan.quark.cn/s/e7e6d55b2d7d

https://www.guangyapan.com/s/1952214234506694735_aeWhI5wocgzRgCO6(光鸭新用户注册福利:永久免费空间:所有新用户注册即可解锁 2TB 永久免费存储空间,无需额外任务或付费)

相关推荐

Avatar photo

JameCling

我是 格律诗的软件世界 的作者,一名专注于软件工具、AI 技术和数字效率领域的独立研究者。
多年来,我持续关注互联网工具的发展趋势,体验不同平台的软件产品,并研究它们如何帮助用户提升效率。
我的工作不仅是整理软件信息,而是通过实际测试、功能分析和使用场景研究,帮助用户判断一个工具是否真正值得使用。
格律诗的软件世界 的每一篇文章都希望提供真实、有价值的信息,包括工具特点、使用方法、优缺点分析以及适合的人群。
我相信,好的工具能够改变工作方式,而准确的信息能够帮助用户做出更好的选择。