DeepSeek Harness 蓝皮书 — 一本dsh实战指南

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 退出

六段路径，按目标进

首页把 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 自己搭」，给出一条能直接用的提示词。

六种语言与协作流程

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

整本也能自己搭一份

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