ATLAS NODE #04
DeepSeek Harness 源码拆解 (Everything is a Plugin)
开源 Agent Harness 参考实现深度拆解 —— 插件化运行时、能力接缝与工程规范
预计掌握时间
90 分钟
阶段等级
Track 3 · 专家
开源参考实现
Everything is a Plugin
一切皆插件 —— 把 LLM 调用、工具执行、会话管理、授权、沙箱等能力解耦为独立插件，让开发者灵活组合扩展，而非修改核心。
底层基于 cordis 插件化应用框架（vendor/），通过插件注册与组合构建全部功能。
Agent = Model + Harness —— deepseek-harness 就是「Harness」这一半的一个开源参考实现。
一个 pnpm Monorepo，14 个核心包按职责分五层。点击任意包查看其职责明细。
core
核心代理循环
内核层
Agent 循环主逻辑：思考→规划→行动→观察
context
上下文管理
内核层
决定模型每个执行步骤看到什么信息
plan
计划模式
内核层
先规划后执行的受控模式
interaction
命令交互
内核层
用户指令的解析与派发
sandbox
本地沙箱
执行层
隔离执行，保障代码安全
shell
Shell 工具
执行层
PowerShell 等系统命令封装
web
Web 工具
执行层
网页搜索与内容获取
session
会话管理
状态层
SQLite 持久化 + 投影缓存
credentials
凭证管理
状态层
对话式授权，凭证与协议解耦
subagent
子代理后端
扩展层
Claude Code / Codex 多后端调度
experimental
实验性功能
扩展层
agent-team / tool-agent-team
host
宿主服务器
宿主层
前端静态资源 + Web 服务器
client
客户端
宿主层
UI 会话、侧边栏、工作区原语
python
Python 运行时
宿主层
打包运行时，内建 MCP 支持
内核层core · context · plan · interaction
执行层sandbox · shell · web
状态层session · credentials
扩展层subagent · experimental
宿主层host · client · python
core
核心代理循环 · 内核层
Agent 循环主逻辑：思考→规划→行动→观察
核心职责
统一的 Agent 运行时循环
多后端模型调度
终止条件与收敛控制
为什么要读这份源码
- 把抽象变成可执行：「Everything is a Plugin」不是口号，而是 cordis 插件框架上 14 个包的工程约束
- 验证 Harness 命题：deepseek-harness 是「相同模型，40 分差异取决于 Harness 质量」这一 2026 命题的开源实证
- 能力接缝是可设计出来的：ADR-0009 / ADR-0010 证明「换模型、加工具」这类演进，可以用接缝预先留出