DeepSeek Harness 学习笔记

这是一组面向实践的 DeepSeek Harness 学习笔记，主要梳理 Harness 的运行机制、能力扩展方式，以及 Tool、Workflow、Memory、Sandbox、Multi-Agent 等概念之间的关系。

Harness 管“怎么运行”，Plugin 管“有什么能力”，企业系统负责“真正执行”。

推荐阅读顺序

1. Harness 基本认知：先建立整体架构和职责边界。
2. 写一个简单的 Tool：理解 Agent 可以调用的原子能力。
3. 写一个简单的 Workflow：理解如何组合多个 Tool 完成固定流程。
4. 理解 Agent Loop：理解模型如何动态判断并调用能力。
5. 理解 Context Management：理解对话、Tool 调用和执行状态如何进入上下文。
6. 写一个简单的 Memory：为 Agent 补充长期记忆。
7. 写一个简单的 Sandbox：限制危险操作的执行边界。
8. 写一个简单的 Plugin Governance：治理能力的权限、风险与审批。
9. 理解 Trajectory 与 Observability：排查单次执行并监控整体运行质量。
10. 理解 Multi-Agent：理解多个 Agent 如何分工协作。
11. 理解自动运营与复杂编排：将调度、Agent、Tool 和 Workflow 组合成完整业务流程。

按问题快速定位

想了解的问题	快速入口
Harness 自带什么，开发者需要实现什么？	Harness 基本认知
Agent 如何连接 API、数据库或业务系统？	Tool
如何把多个步骤组成稳定、可重复的业务流程？	Workflow
模型如何决定下一步调用什么能力？	Agent Loop
Tool Result、历史消息和当前状态如何传给模型？	Context Management
如何保留跨会话的用户偏好和项目背景？	Memory
如何隔离 Shell、脚本和文件修改等危险操作？	Sandbox
如何控制 Plugin / Tool 的权限、风险和审批？	Plugin Governance
如何排错、审计并观察 Agent 的长期运行质量？	Trajectory 与 Observability
Tool、Workflow、Plugin 和 Multi-Agent 有什么关系？	Multi-Agent
如何实现定时执行、并行任务和复杂协作？	自动运营与复杂编排

概念速记

Tool             = 原子能力：能做什么
Agent Loop       = 动态判断：下一步做什么
Workflow         = 固定编排：多个步骤怎么组织
Context          = 当前信息：模型此刻知道什么
Memory           = 长期记忆：跨任务保留什么
Multi-Agent      = 角色分工：谁来做
Governance       = 执行治理：能不能做、是否需要审批
Sandbox          = 安全边界：最多允许做到哪里
Observability    = 运行观察：做过什么、运行得怎么样

补充材料

• Mock API Prompt：Mock API 实践过程的截图记录。