ToolBox
昨天把 DeepSeek 刚开源的 Harness 源码教程从头翻了一遍，十五个章节，中文写的，讲得比我预想的好懂。这篇先把最基础的概念说清楚：它到底是什么，凭什么值得开发者多看一眼。
先分清大脑和手
智能体这个词这两年被说烂了，但拆开其实就两样东西。大脑负责想和说，本体是背后那种大语言模型，你给它一段话它回你一段话，ChatGPT、DeepSeek 都是这种东西；手负责做，读文件、写文件、跑命令、上网搜索，全是工具的活。
大脑自己碰不到电脑上的任何东西，没有工具，它只会空想、干说；配上工具，它才算长了手。这是理解智能体最关键的一句话。
光有大脑和手还不够
那有大脑有手，一个 agent 就齐了吗？没有。谁来把大脑和手接起来，谁来记下每一步干了什么免得它忘了自己干到哪，谁来管权限决定哪些文件能碰哪些不能，出错了怎么兜底、卡住了怎么办？
这些杂活就是 harness 干的。中文翻译成框架不准确，更贴切的说法是装配台：它把大脑和一堆手组装成一个能正常干活的 agent，再负责后面的记录、权限、容错。DeepSeek 开源的这套东西，官方就叫 DeepSeek Harness，简写 dsh，就是这个角色。
装配台具体管三件事
接。 模型要读文件、要跑命令，怎么把「我想读这个文件」变成一次真实的文件读取？中间隔着一层标准接口，dsh 里叫接缝（seam）：工具按这个接口插进来，模型通过它调工具，两边的代码都不用动。
记。 模型看到的所有信息，都写进一份只能追加的会话日志，想回放、想恢复、想查当时到底发生了什么，翻日志就行。dsh 立了条规矩：模型所见，必入日志。
管。 权限和沙箱是另一摊事：文件只读还是可写，命令放不放开，越权了是拦还是放行，都在这层解决，审批没人应答时默认拒绝，安全上宁可错杀。
一切皆插件，USB 的道理
dsh 最特别的设计一句话：所有零件都是插件，像乐高一样能插能拔能换。大脑是插件，想换成别家模型，换一块积木；工具是插件，想加一只新手，插一块新积木；记忆、权限、记录日志，全是插件。
好处是你要扩展它，不用改它的源码，插一块自己的积木就行，跟换电脑的 USB 设备不用拆机箱是一个道理，只要接口对得上。这个设计决定了后面所有章节的走向，也决定了它跟市面上那些装好就锁死的编码助手完全不同。
上手前认清一件事
dsh 现在是开发者预览阶段，官方明说了接口会以破坏兼容的方式快速演进，想体验随便，生产环境先别碰，这是实话。
概念理顺了，下一篇写怎么把它跑起来：一行命令的事。
首发于公众号「键盘漫笔」