DeepSeek Harness 架构设计指南

把大模型接上工具，让它替人查资料、改代码、跑命令，这件事早已不新鲜。真正让工程团队头疼的，是产品从演示走到生产之后的变化：模型供应商要换、沙箱要换、运营要加审批流。在多数 Agent 框架里，这些变化都得改框架本身。

DeepSeek Harness（dsh）对这个问题给出了一个相当彻底的回答：Everything is a plugin。模型适配器是插件，工具注册表是插件，会话日志是插件，连执行循环本身也是插件。没有特权核心，想替换哪块能力就换掉哪个插件。

本系列共十章，从 Cordis 插件系统讲起，经过 Waterfall 事件链、会话日志、Turn 与 Step 执行周期、Capability Seam 能力接缝、工具执行管道、作用域与同名遮蔽、子代理与任务委托，最后一章把全部内容拼回一张全景图，并讨论这套设计模式如何迁移到你自己的系统里。

面向对架构设计有兴趣的泛技术读者，不要求写过 TypeScript，但假定你了解软件工程的基本概念。