DeepSeek‑Harness（简称 dsh）是 DeepSeek 开源的插件化 AI Agent 运行框架，定位为智能体统一运行底盘。它不专注大模型推理能力，而是解决大模型落地 Agent 场景的工程问题：工具调用、能力编排、生命周期管理、会话持久化、沙箱执行、日志追溯等。

当前框架处于开发者预览阶段，架构高速迭代，后续版本会存在破坏性兼容变更，适合开发者提前研究架构、沉淀自定义 Agent 能力，不建议直接用于稳定生产业务。

核心底层：Cordis 微内核驱动

DeepSeek‑Harness 整体基于 Cordis 元插件框架 构建，底层设计范式源自论文 A Programming Paradigm for Spatiotemporal Composability。

Cordis 仅提供最基础的内核能力：插件加载卸载、依赖解析、服务注册、事件生命周期管理。框架本身无固化业务逻辑、无特权核心模块，所有智能体能力全部由上层插件实现、组合、替换。

核心设计理念：一切皆插件（Everything is a Plugin）

这是 dsh 最核心的架构特征，也是区别于传统 Agent 框架的关键。在多数传统智能体框架中，Agent 主循环、工具调度、会话存储、模型适配均为硬编码内核，用户只能做表层拓展，无法深度改造底层运行逻辑。

而在 DeepSeek‑Harness 中，所有智能体能力全部插件化：

• 模型适配、LLM 服务调用

• 文件系统、子进程、终端 Shell 执行

• 网页检索、网络请求能力

• 技能注册、子智能体委派、工作流调度

• 会话持久化、日志记录、上下文压缩

• 权限守卫、执行超时、人机交互审批

• 前端 UI、配置管理、凭证管理

开发者无需修改框架源码，仅通过配置即可替换、禁用、新增、重组任意一项能力，彻底解决传统 Agent 框架固化、拓展成本高、定制性差的问题。

关键架构范式：Capability 能力缝

dsh 对所有能力做了标准化分层解耦，每一项完整能力都遵循「三元结构」，形成可复用、可替换的能力缝：

• Service Definition（契约定义）：定义能力的标准接口、入参出参、调用规范，与具体实现解耦

• Service Provider（能力实现）：提供具体落地逻辑，例如 Shell 能力可切换本地 PowerShell 或云端沙箱

• Consumer（能力消费）：面向 Agent 和模型层暴露标准化工具调用入口

该设计实现了接口与实现完全分离，更换底层执行环境、升级能力逻辑，不会影响上层模型调用与业务编排。

核心工程特性

1. 全链路可追溯

框架强制遵循「模型可见即日志可见」原则。所有给到模型的系统提示、推理记录、工具调用、返回结果、子任务调度、上下文注入内容，全部以追加式日志持久化。无任何隐式上下文、黑盒状态，所有 Agent 行为均可完整回放、排查、复盘。

2. 预览版优先架构正确性，舍弃过度兼容

在开发者预览阶段，框架优先保证底层架构、包结构、协议规范的整洁统一，不堆砌兼容垫片。会话格式、数据库 Schema 均带版本管控，旧格式直接拒绝加载，避免早期迭代积累技术债务，为后续正式版稳定底座铺路。

3. 严格的边界校验与容错规范

框架内部信任同进程静态类型校验，仅在配置解析、磁盘持久化、网络协议、工具入参、进程通信等边界层做严格校验。配置错误、依赖缺失均主动报错暴露问题，不静默降级、不吞异常，极大降低 Agent 调试难度。

4. 插件生命周期自治

所有插件注册基于上下文 Effect 机制，挂载、监听、依赖均随生命周期自动回收，无残留全局状态，有效规避传统插件系统的内存泄漏、事件监听堆积问题。

框架核心价值

1. 极致可定制的 Agent 底座：从模型适配、工具执行到会话调度、循环逻辑，全链路可插拔，适配私有化部署、自定义沙箱、多模型切换、专属工作流等各类定制场景。

2. 标准化的智能体开发范式：通过能力缝、插件规范、日志规范，统一 Agent 能力开发标准，告别零散 Prompt 堆砌、自定义逻辑混乱的开发模式。

3. 可沉淀、可复盘的工程化能力：全链路日志追溯 + 快照测试体系，让 Agent 行为可复现、可回归、可迭代，满足工程化落地要求。

4. 轻量化无侵入拓展：基于配置拓展，无需fork框架源码，大幅降低自定义智能体的开发与维护成本。