DeepSeek Harness (dsh) 架构与 Cordis 插件体系
绝大多数开源 Agent 工具一旦需求复杂,就必须去硬改核心循环(Main Loop)。dsh 借鉴后端微内核设计,用 Cordis 把整个 Agent 彻底拆成可热插拔的积木。
1. 设计哲学:Everything is a Plugin(万物皆插件)
在 dsh 的源码结构里,核心本身极其克制,你平时以为“理应写死在核心里”的模块,全都是可替换的独立插件:
- 模型适配器插件(Model Adapter):对接 DeepSeek-V4 / V4-Pro、Anthropic Claude、OpenAI Compatible 接口或本地推理引擎。
- 主循环插件(Agent Loop):控制 ReAct 推理步数、工具调用并发策略、停止条件与错误重试。
- 工具与沙盒插件(Tools & Sandbox):文件读写、Bash 执行、受限容器隔离、浏览器控制等权限边界。
- 会话日志与记忆插件(Session & Memory):Append-only 事件日志存储、上下文压缩、跨会话实体检索。
- 交互前端插件(UI Layer):终端 TUI、本地 Web 控制台、或者群聊机器人网关。
2. 为什么选择 Cordis?(时空可组合性)
普通插件系统最大的痛点是“能装不能干净卸”——一个插件注册了事件监听、定时器和临时文件,禁用它时如果清理不干净,主进程就会留下幽灵状态或内存泄漏。
Cordis 的“时空可组合性(Spatiotemporal Composability)”
Cordis 为每个插件建立清晰的生命周期作用域(Scope):当某个插件被动态挂载、热更新或卸载时,它所注册的工具、事件钩子、定时任务与副作用会自动随之回滚清理,保证长驻运行的 Super-Agent 不崩溃、不串味。
3. 四大内置运行模式对比
| 运行模式 | 设计定位 | 典型适用场景 |
|---|---|---|
| Standard 模式 | 完整插件生态加载,兼顾安全门禁与工具丰富度 | 日常本地开发、复杂多文件工程迭代 |
| PTC / Code 模式 | 偏向代码执行与程序化工具调用,减少高频小工具来回往返 Token | 数据分析、批量脚本生成与自动化流水线 |
| Minimal 模式 | 极简内核模式,剥离非必要交互装饰与辅助提示 | Terminal Bench / DSBench 等标准自动化评测 |
| Creator 模式 | 面向插件开发者,支持直接在内存中测试和调试自定义插件 | 团队内部快速定制专属公司规范或工具插件 |
4. Append-only(只追加)会话日志的价值
传统 Agent 经常在上下文压缩时直接把历史数组原地覆盖,导致排查“Agent 刚才为什么突然删了那个文件”时死无对证。dsh 采用只追加事件日志的设计:
- 每一次模型思考、工具入参、终端 stdout/stderr、状态变更都按时间线追加记录;
- 上下文压缩或分支回溯时,只生成新的视图投影,原始审计轨迹完整保留,极大方便复盘和 Benchmark 评测回放。