夜雨聆风DeepSeek 开源了 DeepSeek Harness（dsh），一个"一切皆插件"的 Agent 运行时框架。发布当天，技术圈都在讨论它的架构设计。
但真正上手的人很快遇到了一个尴尬：官方文档全是架构视角——AGENTS.md、architecture.md，讲的是系统怎么设计的，没人讲"新手第一步该干嘛"。装好了，然后呢？插件怎么写？性能怎么调？报错怎么办？
两天后，一本社区白皮书把这个问题解决了。dsh-handbook，从 0 到 1 玩转 DeepSeek Harness 的新手百科全书，中英双语，14章，PDF 5.2兆，两天收获两百多星，被收录进 awesome-dsh-plugin 精选列表。
不是文档，是一条路
这本手册和官方文档最大的区别，是它有一条完整的路径。
作者没有按架构模块来组织内容，而是按"从零到会用"来设计：3天学习计划，每天有明确目标和验收标准。第一天认识框架、跑通安装；第二天写第一个插件；第三天做场景实战和性能调优。
每一章都有可复制、可运行的命令，全部在本机实测过，不是纸面教程。第4章讲插件开发，从零写第一个插件，带完整代码、测试和实机验证；第8章给了60多个能力包的速查地图；第9章讲MCP接入和并行子代理。
第12章标题叫"已知不足与边界"——直接承认 dsh 还在 rc 阶段，有不稳定性，生态早期，跨平台有短板。一个教程愿意把框架的缺点单独开一章讲，还是比较少见的。
数据都是实测出来的
手册里的数字，不是抄来的，是跑出来的。
性能调优章节专门做了缓存命中率专题，实测数据是97%——这意味着大部分重复上下文不需要重新计算，这是 dsh 在长会话场景省钱省时间的关键。复杂案例章节给了完整耗时：一个数据清洗管线跑完用了186秒，一次修5个bug的任务用了94秒，每个案例都带产出和验证方法。
选型章节更有意思：6个主流 Agent 框架放在一起对比，还做了同模型实测 benchmark。不是列参数表，是真的跑给你看。
社区长出来的书
发布两天，官方讨论区有138帖回应，FAQ里的39条问题大多来自真实提问——社区问什么，作者沉淀什么。手册和20多个社区项目互链，内容随讨论区持续更新，还建了一条"反馈沉淀流水线"，19项可追踪。
这不是一个人闷头写出来的教程，是社区一起"长"出来的。哪里看不懂，有人提；哪里讲错了，有人纠；哪里缺内容，有人补。两天时间，一本教程能迭代到这个程度，靠的是 dsh 社区本身的活跃度。
一点感想
dsh-handbook 的走红，让我想起一个道理：开源项目的天花板，往往不在代码，在文档。
代码写得好，只有能跑起来的人才知道；文档写得好，所有人都能进来。官方文档解决"是什么"，社区教程解决"怎么用"——这两者之间有空隙，就是手册们的位置。
每个爆火的开源项目背后，都需要社区来补这本书。dsh 开源两天就有人补上了，说明它的社区够活跃。