DeepSeek_Harness_全景白皮书_从_0_到_1_详细拆解与实战教程_112页_16mb

DeepSeek Harness 全景白皮书总结

核心内容概览

DeepSeek Harness 是一套开源的 Agent 运行系统，旨在通过插件化架构、运行机制和安全边界，提升 Agent 的灵活性、可维护性和扩展性。它将 Agent 能力拆分为多个可组合模块，如模型、工具、技能、会话、沙箱、存储、调度等，并通过 Cordis 管理插件的依赖、服务、事件和副作用，确保系统稳定运行。Harness 不仅是一个运行框架，还是一套可以运行的参考架构，适用于开发、测试和生产环境。

主要观点

1. Harness 是 Agent 的运行系统
   Harness 不仅提供界面，还涵盖模型、工具、技能、会话、沙箱、存储、调度等模块，是 Agent 的核心运行机制。

2. 插件是系统的核心
   所有功能模块均以插件形式存在，包括 Agent Loop、工具、模型适配、会话、压缩、权限等。系统通过插件树实现能力的组合与替换。

3. Profile 与 Preset 分别解决配置与运行时问题

   • Profile：定义进程的完整装配方案，包括依赖和补丁。
   • Preset：定义某次会话中的 Agent 行为，如工具调用和任务策略。

4. Cordis 是插件运行的核心
   Cordis 管理插件的加载、卸载、依赖注入、事件传播和副作用回收，为插件提供可组合、可替换的运行机制。

5. Agent Loop 分为事实线与控制线

   • 事实线：记录模型请求和工具调用，用于恢复、分叉和重放。
   • 控制线：在运行时根据事件调整策略，如权限、压缩、审批等。

6. 会话日志是系统的核心
   会话是一条追加式事件日志，模型消息由日志投影生成。日志保留原始事实，支持多种视图，如对话、轨迹、审计等。

7. Token 节省来自整条链路优化
   通过稳定前缀、工具结果裁剪、大内容落盘、上下文压缩等策略，减少无效往返和冗余信息。

8. 工具沙箱与插件宿主关系明确
   工具调用经过沙箱和审批，但第三方插件仍运行在宿主进程中，需谨慎审查。

9. 社区插件入口是发现页
   社区插件通过 GitHub 的 dsh-plugin Topic 分类，安装前需验证仓库、版本、权限和维护状态。

10. 插件的完成标准是陌生环境可复现
    插件需要在不同环境中运行并产生一致结果，确保可维护性和可测试性。

关键信息

• 源码结构：包含 238 个工作区和 219 个功能包，分为五层：产品入口、客户端、Agent、基础设施、运行底座。
• 运行机制：Cordis 管理插件生命周期、依赖注入、事件传播与副作用回收。
• 配置与部署：通过 Profile 和 Preset 管理配置，支持本地安装、命令行启动、Python SDK 集成。
• 插件开发：支持三种插件形态（工具、配置、服务），需提供清晰的契约、依赖声明和可逆副作用。
• 安全边界：工具调用需经过沙箱与审批，插件运行在宿主环境中，需注意权限与供应链安全。
• 评测与落地：建议通过多轮测试、固定变量、不同 Preset 对比等方法评估系统性能；适合用于编码、文档处理等场景，但需注意权限、沙箱和数据治理。

结构清晰说明

第一篇：为什么需要 Harness

• Agent 的上限由模型之外决定：模型能力有限，Harness 提供了扩展、控制、安全等机制。
• Harness 的六个基础问题：涉及上下文、工具、权限、任务继续、持久化、扩展性。
• 省 Token 关键在于减少无效往返：通过稳定前缀、工具裁剪、上下文压缩等策略优化 Token 使用。

第二篇：从源码拆开 DeepSeek Harness

• 源码结构：分为五层，包括产品入口、客户端、Agent、基础设施、运行底座。
• Cordis 的作用：管理插件依赖、服务注册、事件传播和副作用回收。
• 插件树构建过程：通过 CLI 命令解析 Profile 和补丁，最终由 Cordis 组合插件。

第三篇：安装、配置与部署

• 安装与启动：支持命令行启动、Python SDK 集成、环境配置。
• DSH_HOME 作用：保存用户侧状态，包括凭证、配置、会话数据。
• Profile 与 Preset：Profile 是进程配置，Preset 是会话行为，二者隔离确保安全与可维护性。

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

• 内置能力：包括 Skills、MCP、Subagent、Goal、Plan Mode、Jobs、Schedule 等。
• 社区插件管理：通过 GitHub 查找、安装、验证插件，支持四种安装来源。
• 插件推荐：包括终端、视觉、搜索与自动化插件，支持任务恢复、批注、通知等功能。

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

• 开发流程：从最小插件开始，逐步增加依赖、配置、服务、事件处理。
• 插件发布：需提供 README、配置、安全策略、测试和版本策略，确保可发现与可验证。
• 案例说明：以“王虹手写风格 PPT”为例，展示如何将 Skill 封装为插件并进入社区。

第六篇：评测、落地与未来

• 评测方法：通过多轮任务、固定变量、权限控制、事件追踪和 Token 统计进行系统评估。
• 落地与风险：当前适合用于编码、文档处理等场景，但需注意权限、沙箱、数据治理和插件生态。
• 未来方向：强调系统扩展性、可替换性和生态兼容性，推动 Agent 能力向模型之外迁移。

总结

DeepSeek Harness 通过插件化架构和运行机制，提供了一套灵活、可维护、可扩展的 Agent 运行系统。其核心在于将模型与运行环境解耦，通过 Profile 和 Preset 管理配置与行为，借助 Cordis 实现插件的依赖管理与事件驱动。系统设计注重 Token 优化、安全边界和可复现性，为开发者提供从零开始构建、测试、部署和扩展插件的完整流程。未来，Harness 将继续推动 Agent 能力向模型之外扩展，成为智能系统的重要基础设施。