DeepSeek Harness 架构科普:一座“插件城市”如何驱动一个 AI 智能体
本文用通俗类比拆解 deepseek-harness(简称 dsh)的整体架构与核心模块的工作原理。 所有结论均来自仓库
docs/下的架构与子系统文档(architecture.md、cordis-primer.md、subsystems/*、capability-seams.md)。 代码路径以packages/...与docs/...标注,便于深究。
一、一句话总览
dsh 是一个插件化的 AI 智能体运行底座。它有一条铁律:
产品的一切都是插件(everything is a plugin)。
模型适配器、工具注册表、会话日志、甚至驱动循环(agent loop)本身,统统是插件。 没有需要打补丁的"特权核心"——你想改任何一块行为,只要在别处再挂一个插件、或换掉某个实现即可, 因为所有注册都是可逆的副作用(reversible effects),插件卸载时自动回滚。
这就像一座城市:市政府(Cordis 框架)只提供"水电管网"(一套统一的服务注册 + 事件总线), 各个部门(插件)自己接入管网、各司其职,谁搬走都不影响大楼立着。
二、地基:Cordis 插件框架(用"城市公用事业"来比喻)
docs/cordis-primer.md 把 Cordis 浓缩成五个想法:






