2026年DeepSeekHarness全景白皮书从0到1详细拆解与实战教程

郭太侠2小时前AIGC4

这份白皮书完整拆解 DeepSeek Harness 这套开源 Agent 运行系统。不同于单纯大模型,Harness 承担模型之外的全部工作,包含工具调度、会话管理、权限沙箱、插件扩展等能力,是决定 Agent 实际落地效果的关键底座,目前产品仍处于开发者预览阶段。

从架构层面,该项目核心设计理念为 “一切皆插件”,Agent Loop、会话、界面都可作为插件自由替换重组。依托 Cordis 运行底座完成插件依赖管理、生命周期与副作用回收,区分 Profile 进程级配置与 Preset 会话级配置;任务执行划分为事实线与控制线两套逻辑,会话以追加式事件日志作为底层存储,支持任务恢复、分叉与重放,同时通过多级策略实现 Token 消耗优化。

在实操层面,白皮书覆盖 Web、Headless、Python SDK 三类接入方式,梳理社区插件查找、安装、验证流程,并给出从零开发、打包发布插件的完整步骤。同时白皮书也客观指出现存风险:第三方宿主插件不受沙箱保护、社区插件质量参差不齐、API 接口存在迭代变动。针对评测与生产落地,文档给出标准化评测方法,明确当前适合架构研究、本地工作流原型,不建议直接面向公网大规模部署。

整体来看,Agent 的竞争正在从模型能力,转向 Harness 运行层能力。想要用好这套系统,需要理解整套插件运行机制,做好权限管控、版本锁定与插件安全审查,循序渐进推进落地。

报告目录:

第一篇 为什么需要 Harness

1. Agent 的上限,越来越由模型之外决定

2. 从 Harness Engineering 到一套可维护的系统

3. DeepSeek Harness 到底是什么

第二篇 从源码拆开 DeepSeek Harness

4. 238 个工作区,219 个功能包

5. 一切皆插件:这套架构最重要的决定

6. Cordis: 让 219 个功能包共同生活的运行层

7. 从一条命令到一棵插件树

8. Agent Loop: 一次任务里同时跑着两条线

9. Session: 整套系统真正的脊柱

10. 工具执行:可以并行,提交顺序不能乱

11. 上下文与 Token: 省在稳定、裁剪和延迟压缩

12. 安全边界:沙箱保护工具,插件仍是宿主代码

第三篇 安装、配置与部署

13. 十分钟跑起 DeepSeek Harness

14. 从源码运行、Headless 与真实测试

15. Python SDK: 把 Harness 嵌入自己的程序

第四篇 内置能力与插件生态

16. 从 Skills 到 Schedule: 官方底座已经装了什么

17. 社区插件从哪里找,怎样装,怎样验证

18. 运行增强插件:终端、视觉、搜索与自动化

19. 工作流增强插件:输入、恢复与创作

第五篇 开发自己的 DeepSeek Harness 插件

20. 从零写出第一个插件

21. 工具、配置、服务与界面怎样设计

22. 打包、测试、发布与进入社区聚合页

23. 完整案例:把王虹手写 PPT Skill 变成 DSH 插件

第六篇 评测、落地与未来

24. 怎样公平评测一套 Harness

25. 生产落地:当前能做什么,还缺什么

附录 A—G: 命令、配置、发布检查、源码索引、术语、资料与版本账本

DeepSeekHarness# 智能体 #Agent#Cordis# 插件系统 #大模型# 会话管理 #Token 优化 #AI 框架 #插件开发


1.png