deepseek-harness-orange-book README

The project's README from github.com/alchaincyf/deepseek-harness-orange-book. As one markdown file: README.md.

中文 | English summary

DeepSeek Harness 橙皮书封面

DeepSeek Harness:从开机到拆开

橙皮书系列 · 花叔 著 · v260814(2026年8月14日)

一个不写代码的人,把一个刚出厂24小时的agent框架装在自己机器上跑穿了。这本书记录它此刻的样子。

2026年8月13日,DeepSeek开源了agent框架Harness(MIT协议,发布当天开源)。官方发布稿的主语从头到尾是「它」——它怎么造的、它是什么架构。而这本书把主语换回「我」:我装上之后第一件事干什么、会不会花我的钱、会不会动我硬盘上别的文件。

🎬 15秒发布动画

DeepSeek Harness橙皮书 · 15秒发布动画

使用DeepSeek官方VI · 由Huashu-Design设计制作
⬇ 下载1080p60 MP4(含音效)

🎥 60秒能力演示

四段真实能力,全部对应书里的一手实测:开机装载129个插件 → 写入前的权限审批 → PTC让模型直接写程序编排工具(5次开口15次操作)→ 创造模式现场给自己造出第33个工具count_chinese,最后把整个终端拆成积木。

60秒能力演示预览:开机 · PTC · 创造模式 · 拆开

▶ 观看60秒完整版(1080p60 MP4,含音效)

📑 杂志编辑风幻灯片(20页)

不想读整本书?这套20页的杂志编辑风deck是全书的浓缩版:五个章节、进门四问、成本账单、44条事件、PTC、创造模式、拆开看架构,一页一个结论,适合快速过一遍或拿去做分享。

杂志编辑风幻灯片预览:封面 · 事件流 · 创造模式 · 结论

⬇ 下载PPTX(20页 · 11MB)

下载

格式 文件 大小
PDF DeepSeek-Harness-Orange-Book-zh-v260814.pdf 13MB
EPUB(微信读书优化版) DeepSeek-Harness-Orange-Book-zh-v260814.epub 5.4MB
HTML(单文件,图片已内联) DeepSeek-Harness-Orange-Book-zh-v260814.html 4.9MB

💡 PDF建议下载后阅读,GitHub在线预览可能无法完整渲染。

这本书有什么官方文档里没有的

全部一手实测,跑在作者自己的电脑上:

本书结构

部分 内容
序章 探索未至之境:你装的到底是什么,以及替你做掉那道四选一
Part 1 进门 十分钟干成第一件活 · 它被允许碰什么 · 四种模式人话版 · 从Claude Code搬家,哪些能直接用
Part 2 主线 每一次运行都有迹可循 · 一次任务多少钱 · 它给自己长出一只手 · 让模型写程序及那笔反直觉的账 · 让它自己干完一件长活
Part 3 地基 skill、MCP、插件到底谁管谁 · 两个插件都想管文件编辑谁赢 · 它出过什么事
Part 4 收 一个几乎全由AI写出来的代码库长什么样 · 它在赌什么,代价是什么
附录 数字基准表(每个数字带命令和快照时间)· 术语对照 · 命令速查 · 迁移总表

每节末尾有个固定小栏目:《他们本来想这么做,后来没做》——取自仓库里被否决的设计方案,回答「为什么这里没有X」。

适合谁读

书里凡是卡住作者的地方都原样写下来了——顺的过程没什么可信度,卡住的地方才有。

关于时效

这本书写于Harness发布后的24小时内,书里凡是从网上取的数字(star数、包数量)都只是按下回车那一刻的样子,正文里标了取数时间。实测部分(系统提示词、日志、启动清单)随版本演进可能变化,复现时以你本机输出为准。

橙皮书系列

面向AI Native Builder的实战指南系列:

完整合集见huasheng.ai。

友情链接

同一个生态里的项目:

项目 简介 链接
DeepSeek Harness Desktop 为DSH生态做的桌面端,把Harness装进图形界面里跑。 GitHub · 官网
Awesome DeepSeek Harness DSH终极指南:快速入门、资源推荐、精选插件与工具,中英日三语。 GitHub

关于作者

花叔(HuaShu) · AI Native Coder · 独立开发者

小猫补光灯(App Store付费榜第一)的开发者,橙皮书系列作者,全平台50万+读者。所有产品全部用AI完成,从未手写过一行代码。CCTV《焦点访谈》报道的「手搓经济」代表人物。

English summary

DeepSeek Harness: From First Boot to Teardown (Chinese edition) — written within 24 hours of DeepSeek open-sourcing its agent harness (Aug 13, 2026, MIT license). The author — who has never hand-written a line of code — ran it end to end on his own machine and documented what the official docs don't show: the full system prompt, the 129-line default boot manifest, three unedited session logs, and a live recording of the AI building a new tool for itself (19 steps, tool list going from 32 to 33 lines). Chinese only for now.

📚 在线阅读(WorkBuddy)

本书已同步到 WorkBuddy 资料库:每章一个网页,也可以直接把链接丢给你的 Agent 当上下文。

https://www.workbuddy.cn/space/d/XABVjoKqAElOoh6PgTgjeM

全部橙皮书入口:https://www.workbuddy.cn/space/d/YcllWXknAUoMk6lFSWdfbI

协议

CC BY-NC-SA 4.0

本作品基于CC BY-NC-SA 4.0协议发布。在保留署名的前提下,可自由分享和改编(非商用)。

deepseek-harness-orange-book (alchaincyf/deepseek-harness-orange-book)

Searching Database…

这是什么?一本免费的中文电子书(“橙皮书”),完整记录 DeepSeek Harness 智能体框架从首次启动到关闭销毁的全过程,在 2026 年 8 月 13 日 Harness 开源后 24 小时内写成。
它是下载来阅读的东西,还是要运行的应用?是下载来阅读的:一个 PDF(13MB)、一个专为微信读书优化的 EPUB,或一个图片内嵌的单文件 HTML——另外还有一份可选的 20 页 PPTX 幻灯片,把整本书浓缩在一起。
框架以后更新了,这本书还能和 Harness 对得上吗?把它当作一份快照:来自网络的数据都标注了时间戳,动手实践的部分(系统提示词、日志、启动清单)可能随新版本而变化,所以请以你自己机器上的实际输出为准。
我不是程序员,这本书还适合我吗?适合——它面向用过 Claude Code、Codex 或 OpenClaw 这类工具的非程序员:每个概念都配有一句话的技术定义、一个日常生活的类比,以及这个类比在哪些地方不成立。
按照这本书的说法,运行 Harness 到底要花多少钱?书中包含一次真实的 PTC 计费测试:5 轮用户对话编排了 15 次工具操作,反直觉的结果是固定开销反而上涨了 9%。
AI 真的给自己造了一个工具吗?是的——一次 19 步的创意模式会话记录了 Harness 为自己编写第 33 个工具(countchinese)的过程,工具清单从 32 行变成 33 行,日志原封不动地收录在书中。
这本书拆解的 DeepSeek Harness 到底是什么?是 DeepSeek 于 2026 年 8 月 13 日以 MIT 许可证开源的智能体框架;这本书检验了它在启动时加载什么、被允许触碰什么,以及它的四种模式有何区别。
我已经在用 Claude Code 了——书里讲怎么迁移到 Harness 吗?第 1 部分有一章专门讲迁移,说明哪些内容可以直接照搬,附录还提供了一张迁移对照表,并指出了官方文档没提的东西,比如 ~/.agents/skills 无需任何配置就能被读取。
Creator
alchaincyf
Size
41.1 MB
Stars
1.3K
Updated
CommitAug 23
Age
2mo
Commits · 90 Days