> **来源：[研报客](https://pc.yanbaoke.cn)** # 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 能力向模型之外扩展，成为智能系统的重要基础设施。