8月13日晚,DeepSeek Harness开发者预览版以MIT协议开源,模型、工具、会话、循环全部插件化。这篇融合安装教程与架构深度的文章,帮你一次看懂Agent进入DIY时代的关键变化。
一、Agent终于从品牌机走到DIY攒机
过去我们使用Codex、Claude Code等Agent,像用一台品牌机:输入指令,等待结果,中间过程黑盒。为什么调用这个工具、走哪条执行路径,用户无从干涉。DeepSeek Harness发布后,这个局面开始松动。它不是再造一个Codex,而是把工具、记忆、会话记录、权限、多Agent协作方式、任务执行流程都拆成可替换部件。同一个模型,能搭出完全不同的工作台。
以前我们问:哪个Agent最强?接下来更该问:我的工作,适合DIY成什么样的Agent?
写代码的人需要一个会跑测试、开分支、回放过程的Agent;做内容的人需要一个会查资料、管素材、记住口吻的Agent;运营团队更在意权限、审批和日志。大家用同一个大模型,装出来的机器可以完全不同。
二、“一切皆插件”到底是什么
DeepSeek Harness建立在Cordis插件系统之上。官方文档中,模型适配器、工具注册表、会话日志乃至Agent循环本身都是插件,开发者无需修改主体代码,即可替换或扩展能力。Cordis强调“时空可组合性”:插件卸载后,其注册过的服务、事件和副作用随之撤销;插件可以声明依赖,并在其他组件变化时重新建立协作。
这种拆分带来三类直接价值:
- 模型与运行环境分离:保留同一套会话、工具和权限,只换模型适配器;或固定模型,比较不同上下文管理效果。
- 企业基础设施可保留:沙箱、存储、审批、凭证、遥测都能作为插件接入内部权限与审计系统。
- Agent能力生态化:开发者无需维护分叉版本,只需发布插件;官方建议仓库添加dsh-plugin标签,方便检索复用。
当然,开放程度越高,治理成本越高。一个工具插件可以接触文件和外部服务,一个存储插件掌握完整会话,一个循环插件可能改变Agent决策路径。插件来源验证、权限边界、依赖冲突、供应链安全都会成为生态能否进入生产环境的前提。
三、最短教程:四步跑起来
安装门槛并不高。打开电脑任意一个Agent,按下面步骤操作即可:
- 在终端执行:npm install -g @deepseek-ai/dsh
- 运行 dsh --profile web,打开网页端
- 填入DeepSeek API Key;若环境变量已有,可跳过
- 有问题查看 github.com/deepseek-ai/deepseek-harness
预设四种模式,对应不同实验目的:
- 标准模式:完整的编程助手,能理解需求、修改代码、运行命令并检查结果。
- PTC模式:在标准模式基础上支持用TypeScript编写小程序,把多步操作组合成自动化流程。
- 极简模式:只提供持续可用的终端和基础文本替换工具,适合简单改动与基准测试。
- 创造模式:额外支持运行时检查、尝试插件,以及用预设完成创作类任务。
值得注意,内置patch层像一套“给Agent装能力的装扮系统”。除了能直接把本机的Codex和Claude Code作为子Agent调用,还可以安装插件、调整权限、开启全文搜索,甚至替换UI模块;也能用JavaScript表达式定义规则,让这些能力按条件生效。
四、可回放的事件流,让每一步都有据可查
Harness的另一项重要设计是仅追加的会话日志。一个Session由按顺序追加的事件构成,是Agent全部交互历史的唯一事实来源。模型消息历史由这份日志推导生成,不再单独保存;恢复和回放也从同一组事件重新构建。
系统提示词、思维链、工具调用及结果、子Agent调度、上下文注入都会被记录。当Agent在第几十步做错决定,开发者可以回到当时模型真正看到的上下文,确认问题来自模型判断、工具返回、提示词变化还是错误的上下文注入。可观测性正在从调试工具变成Agent基础设施的标配。
与此同时,完整事件流可能包含代码、凭证线索、内部文件内容和工具返回结果。可回放提高了审计性,也扩大了需要保护的数据面。
五、Harness与MCP,不是一回事
“一切皆插件”容易让人联想到MCP,但两者层级不同。MCP是连接AI应用与外部数据、工具和工作流的开放标准,重点是统一连接方式。Harness负责更上层的运行逻辑:什么时候把工具交给模型、调用前是否审批、结果如何写入会话、失败后是否重试、何时派出子任务、什么条件下停止。
简单说,MCP服务器可以成为Harness中的工具来源,Skills可以成为能力包,Cordis插件负责把模型、工具、状态、循环、界面和政策组合成一个可运行的Agent。谁掌握Harness,谁就更接近真实任务入口,也更容易影响模型选择、工具分发、运行成本和开发者工作流。
六、v0.1还是蓝图,但方向已经清晰
需要清醒的是,当前Harness处于开发者预览阶段,版本0.1.0-rc.5,后续会出现破坏兼容性变更。官方开发文档要求Node.js 22.19及以上的22.x版本或24及以上。Harness本身按MIT协议免费开源,但默认使用仍需配置DeepSeek API Key,运行Agent会产生模型调用成本。
短期看,它更像开发者和高级玩家的工具箱。真正的门槛会从“会不会写提示词”转到“会不会搭工作流”。这比提示词难,也更接近生产力本身。DIY从不适合每个人,有人只需要开机即用的品牌机,插件多了,兼容、权限、排错问题也会一起冒出来。
开放权重解决了“谁能运行模型”的问题,开放Harness进一步触及“谁能决定模型如何工作”。
写在最后
DeepSeek Harness把开源竞争推进到模型之外。当Agent开始执行持续数小时甚至数天的任务,模型只是系统中的一个组件,运行层会越来越多地决定能力上限与使用边界。对开发者而言,先玩起来,从自己的真实工作出发,DIY一个合适的Agent,可能比继续追问“哪个Agent最强”更重要。
夜雨聆风