DeepSeek Harnrss 实战手册

​

​

一切皆插件的 Agent 框架，从安装到上手，再到自己写插件​

​

副标题：DeepSeek 官方开源 Agent 框架（dsh）保姆级中文教程​

版本：2026 年 8 月 · 对应 dsh 开发者预览版（0.1.x）​

​

写在前面：这波热度，为什么轮到你​

2026 年 8 月 13 日晚，DeepSeek 官方在 GitHub 上开源了 DeepSeek Harness（dsh）——一个"一切皆插件"的智能体（Agent）框架。​

接下来的 48 小时里发生了什么？​

•

公布不到 2 小时，Star 破万；​

•

12 小时，Star 突破 5 万；​

•

两天，Star 超过 10 万，Fork 近万；​

•

24 小时内，社区带 dsh-plugin 标签的插件仓库攒到 288 个（据 36 氪报道）；​

•

同一晚，DeepSeek 还发布了 DeepSeek V4 Pro 正式版模型。​

媒体把它称作"Agent 界的 Android"。社区在狂欢，评测在刷屏，新的插件像雨后春笋一样冒出来。但热闹归热闹，真正能让你接住这波流量的，是你比大多数人更早、更系统地学会它。​

市面上现有的中文资料要么是新闻稿，要么是零散的安装笔记，还没有一本"从安装到写插件、从 Web UI 到 Python SDK"的完整教程。这本书就是来补这个缺口的。​

这本书能给你什么​

读完这本书，你会：​

明白 DeepSeek Harness 到底是什么、解决什么问题、和 Claude Code、Codex 这类工具有什么区别；​

用一行命令在本地跑起来 Web UI，完成第一个真实任务；​

会用无头（headless）模式和 Python SDK，把 Harness 嵌进自己的脚本和流水线；​

从零写一个自己的插件、一个自己的工具，并打包成可分发、可安装的插件包；​

了解它的架构哲学——为什么"一切皆插件"这句话不是营销，而是设计；​

避开开发者预览版的常见坑，拿到一张清晰的继续学习路线图。​

怎么读这本书​

•

只想先用起来：读第 1、3 章，跟着做一遍，20 分钟足够。​

•

想自动化：加读第 4、5 章，学会 headless 和 Python SDK。​

•

想写插件：第 6、7 章是重点，第 8 章帮你理解框架的扩展点。​

•

想深入源码：第 8、9 章给你架构地图，附录给出官方文档索引。​

书中所有命令都标注了运行环境。代码块可以直接复制。凡是标注"示例/示意"的内容，请在理解后改写为你自己的实现——毕竟，这个框架最擅长的就是让你把"你自己的实现"接进去。​

最后提醒一句：dsh 目前是开发者预览版，官方明确说"未来会出现破坏兼容性的变更"。这意味着两件事：一是现在学，你就是第一批吃螃蟹的人；二是版本升级时，多留意官方 Release 和迁移说明。​

好，我们开始。​