摘要8 月 13 日 DeepSeek 开源 Agent 框架 Harness目标直指 Claude Code。它把模型、工具、沙箱、UI 全部做成可替换插件。这篇文章带你把它跑起来、写第一个插件并聊聊这套架构离生产还有多远。七月我写过一篇 Harness Engineering讲给 AI 套上缰绳别老换模型先把模型跑的环境收拾好。当时这个词还是个概念落地全靠 AGENTS.md、verify 脚本、权限 hooks 自己拼。一个月后DeepSeek 直接把缰绳开源了。8 月 13 日深夜DeepSeek 上线 V4 Pro 正式版十几个小时后第二记重拳——DeepSeek Harness简称 dshMIT 协议完全开源的 Agent 框架v0.1 开发者预览版。代码推上 GitHub 当天Hacker News 讨论帖冲上 TOP 1星标数快速攀升不同口径下发布后两天内已达数万到近十万量级来源GitHub API / CSDN 报道2026 年 8 月。一个模型公司同一天发旗舰模型和开源框架。前者回答模型有多强后者回答强了之后怎么用起来。它不是什么DeepSeek 版 Claude Code先把定位说清楚。dsh 不是又一个聊天界面也不是模型本身。它是让模型能调用工具、执行任务、跟开发者协作的那层基础设施——OpenAI 报告里说的Agent Model HarnessHarness 就是 dsh 这层。但和 Claude Code、Codex 有一个根本区别后两者是产品你用它的规则dsh 是元框架你用它组装自己的 Agent 产品。官方设计原则就六个字一切皆插件Everything is a Plugin。打开它的架构文档你会看到模型适配器是插件工具注册是插件Session Log 是插件Agent Loop 本身是插件沙箱是插件审批策略是插件连 UI 都是插件。所有组件通过 Cordis 服务与事件互相协作在配置层自由组合来源DeepSeek Harness 官方架构文档2026 年 8 月。想换模型装个插件。想换工具注册方式装个插件。想把 Agent 从思考→行动→观察改成别的循环还是装个插件。没有特权核心每一块都能被替换。这套 Cordis 元框架不是从零造的——它已经在 Koishi 聊天机器人生态里跑了四年这次 DeepSeek 还和北大合发了一篇论文给它做了数学基础来源DeepSeek Harness 发布说明2026 年 8 月。十分钟跑起来上手比想象中简单。前提就一个Node.js 版本要^22.19.0或24。我一开始用旧版 Node 跑静默失败连报错都没有——这是它目前最坑的地方来源DeepSeek Harness 官方 README2026 年 8 月。装好 Node一行命令启动 Web UInpx deepseek-ai/dsh web默认地址http://127.0.0.1:3080。打开后三步走配模型Settings → Models填 DeepSeek API Key。它也支持 OpenAI 兼容端点和其他厂商改完不用重启选工作区Choose workspace指向你的项目目录。没选工作区之前输入框是禁用的——我第一次卡在这还以为是启动失败了发任务新开一个会话让它总结这个仓库并识别主要包试试水国内网络建议先换 npm 镜像npm config set registry https://registry.npmmirror.com不然下载可能很慢。它运行的时候所有文件读写和命令执行都被限制在工作区内路径穿越../../会被拦——这是默认的沙箱隔离不需要额外配置来源dsh 使用指南2026 年 8 月。写你的第一个插件光会跑没意思dsh 的灵魂在插件。用一个最小例子讲清楚它的机制。从源码仓库开始开发插件建议 clone 源码而不是 npxgitclone https://github.com/deepseek-ai/deepseek-harness.gitcddeepseek-harness corepackenablepnpminstallpnpmrun build然后在仓库里建一个插件目录写一个greet工具importtype{Context}fromdeepseek-ai/cordisimport{defineTool}fromdeepseek-ai/dsh-toolsexportconstnamegreet-toolexportconstinject[tools]exportfunctionapply(ctx:Context){ctx.tools.register(defineTool({name:greet,description:Greet someone by name.,parameters:{name:{type:string,required:true,description:The name to greet}},asyncexecute(args){return你好,${args.name}!}}))}示例参考Datawhale DeepSeek Harness 插件教程2026 年 8 月这个插件只干四件事声明插件名、声明需要的服务tools、在apply入口注册工具、定义工具的入参和执行逻辑。模型通过描述知道这个工具存在通过入参 schema知道怎么调用它。挂载到 Web 服务pnpmdsh web--patch./scratch-plugin/cordis.yml启动后到设置 → 插件列表确认插件是已启用状态然后让 Agent 调用请调用 greet 工具问候 Datawhale。你会看到工具调用的输入输出完整展开——插件闭环就跑通了。生产级的插件不用自己造轮子。比如 DeepSeek 的文本模型目前不能直接看图社区有 DSH Vision Toolkit 插件把图片交给单独的视觉模型再把结果送回 Harness实现截图分析、OCR、元素定位来源Datawhale 插件教程2026 年 8 月。安装就是一行dsh plugin--profilewebadddsh-external/dsh-vision-toolkit装插件前一定看源码和权限。Harness 插件运行在宿主进程里属于可信代码安装脚本会下载什么、需要哪些目录和凭据权限都得先弄清楚——这跟装任何 npm 包一个道理。四种模式各干各的活dsh 内置了四种运行模式对应不同场景来源DeepSeek 官方发布说明2026 年 8 月模式干什么用标准模式日常开发完整文件读写 命令执行极简模式纯文本对话无工具适合闲聊和快速问答PTC 模式程序化工具调用适合基准测试和脚本化场景创造模式插件开发调试内存里直接试 Cordis 插件实际用下来日常开发用标准模式就够了想验证插件逻辑创造模式省去反复重启。还有 headless 模式跑脚本和 CI 用dsh --profile headless 列出这个仓库所有 TODO一次性任务输出到 stdout 就退出不用开浏览器。回看我七月那篇 harness 文章既然 dsh 把概念落地成了产品正好回头检验一下我上个月写的《给 AI 套上缰绳Harness Engineering 是什么》哪些判断站得住哪些需要修正。站得住的三个判断一是Agent Model Harness模型是 CPUHarness 是操作系统。dsh 的定位跟这个公式严丝合缝——它把模型当可替换组件把工程能力工具、沙箱、审批、UI全部做进 Harness 层。DeepSeek 官方自己的定义就是Model Harness Agent。二是每次 Agent 犯一个错就把它工程化成一个约束。dsh 的插件化让这个循环变得更顺——AI 又漏改文件了把文件修改必须走工具注册写成一个插件约束比维护 AGENTS.md 里的一行文字更硬。约束从文档约定升级成了代码强制。三是评审与验证必须分离。dsh 的四种模式和 headless 流程天然支持把干活和验证拆开跑——这是它架构上就内建的优势。需要修正的两个地方一是旧文把 harness 落地完全押在AGENTS.md verify 脚本 权限 hooks三件套上这是 Claude Code 的生态。dsh 的出现说明 harness 不止一种形态——插件化元框架是更激进的一条路AGENTS.md 只是其中一种系统提示插件的实现。三件套是路径之一不是唯一解。二是旧文里模型一行没动环境一换效果天差地别这个说法用在给 AI 套缰绳上成立但 dsh 的实践反过来提醒Harness 和模型是协同演进的。DeepSeek 是模型和 Harness 一起发Muse Spark 也是和 Muse Code 一同训练——Harness 的边界设计会影响模型的发挥模型的进步也会反过来改变 Harness 该管什么。缰绳和马的品种是互相适配的不是单向约束。和 Claude Code 比差在哪这是绕不开的问题。说结论架构理念上 dsh 更激进工程成熟度上 Claude Code 领先。插件化程度dsh 把换工具换循环都变成配置Claude Code 的扩展点是 skills hooks自由度不在一个量级Session 可靠性dsh 把会话日志设计成 append-only 事件日志官方宣称崩溃后可重放恢复——但这是架构设计的宣称还没经过大规模生产验证Claude Code 的会话机制成熟但长会话断开后的恢复一直是它的短板。两者在可靠的定义上不一样都得等时间检验生态Claude Code 有一年多的打磨、社区和文档积累dsh 发布才几天THERE WILL BE COMPATIBILITY-BREAKING CHANGES的警告就挂在 README 首页模型绑定dsh 不绑定 DeepSeek 模型OpenAI 兼容端点都能接但当前优化得最好的肯定是自家 V4-Pro-0813成本DeepSeek 从 8 月 17 日起 API 改峰谷定价高峰北京时间 9-12 点、14-18 点价格是空闲时段的两倍晚间和深夜半价来源DeepSeek 官方定价公告2026 年 8 月。国内直连 相对低价这是它对国内团队最实在的吸引力但它现在还是 0.1 预览版官方明说存在破坏性更新。我的建议是拿它做技术预研、做内部工具的底座别在生产环境梭哈。想用 dsh 顶替 Claude Code 的团队等它稳定几个版本再说。Java 团队怎么用最后给 Java 后端同行的落地建议三句话先 headless 跑通一个真实小任务比如给这个模块补全单元测试验证工具链和工作区隔离是否顺手把团队知识做成插件——项目脚手架生成、代码规范检查、SQL 风险扫描这些都能注册成 dsh 工具让模型按团队规则干活而不是每次重新教留意它把 Session Log 做成 append-only 的设计——这对需要审计的开发场景是加分项出了问题能回放模型会一直换套缰绳的手艺才值钱。现在缰绳有人开源了还给你留了所有改装孔位——剩下的就是把团队自己的规则拧上去。作者唐悦玮 | 公众号同名从后端出发用 AI 拓展到全栈的工程师。参考资料DeepSeek Harness 官方 GitHub 仓库与 README2026 年 8 月。安装要求、MIT 协议、破坏性更新警告。DeepSeek Harness 官方架构文档与发布说明2026 年 8 月。一切皆插件设计、Cordis 框架、四种运行模式、与北大合作论文。CSDN“DeepSeek Harness 开源一切皆插件、省 Token、Agent 还能改装自己”2026 年 8 月 15 日。发布背景、GitHub 星标数据。Datawhale“DeepSeek Harness 插件开发保姆教程”2026 年 8 月。最小插件代码示例、Vision Toolkit 安装与配置。DeepSeek 官方定价公告2026 年 8 月。API 峰谷定价规则8 月 17 日生效。
DeepSeek Harness 开源，怎么上手
摘要8 月 13 日 DeepSeek 开源 Agent 框架 Harness目标直指 Claude Code。它把模型、工具、沙箱、UI 全部做成可替换插件。这篇文章带你把它跑起来、写第一个插件并聊聊这套架构离生产还有多远。七月我写过一篇 Harness Engineering讲给 AI 套上缰绳别老换模型先把模型跑的环境收拾好。当时这个词还是个概念落地全靠 AGENTS.md、verify 脚本、权限 hooks 自己拼。一个月后DeepSeek 直接把缰绳开源了。8 月 13 日深夜DeepSeek 上线 V4 Pro 正式版十几个小时后第二记重拳——DeepSeek Harness简称 dshMIT 协议完全开源的 Agent 框架v0.1 开发者预览版。代码推上 GitHub 当天Hacker News 讨论帖冲上 TOP 1星标数快速攀升不同口径下发布后两天内已达数万到近十万量级来源GitHub API / CSDN 报道2026 年 8 月。一个模型公司同一天发旗舰模型和开源框架。前者回答模型有多强后者回答强了之后怎么用起来。它不是什么DeepSeek 版 Claude Code先把定位说清楚。dsh 不是又一个聊天界面也不是模型本身。它是让模型能调用工具、执行任务、跟开发者协作的那层基础设施——OpenAI 报告里说的Agent Model HarnessHarness 就是 dsh 这层。但和 Claude Code、Codex 有一个根本区别后两者是产品你用它的规则dsh 是元框架你用它组装自己的 Agent 产品。官方设计原则就六个字一切皆插件Everything is a Plugin。打开它的架构文档你会看到模型适配器是插件工具注册是插件Session Log 是插件Agent Loop 本身是插件沙箱是插件审批策略是插件连 UI 都是插件。所有组件通过 Cordis 服务与事件互相协作在配置层自由组合来源DeepSeek Harness 官方架构文档2026 年 8 月。想换模型装个插件。想换工具注册方式装个插件。想把 Agent 从思考→行动→观察改成别的循环还是装个插件。没有特权核心每一块都能被替换。这套 Cordis 元框架不是从零造的——它已经在 Koishi 聊天机器人生态里跑了四年这次 DeepSeek 还和北大合发了一篇论文给它做了数学基础来源DeepSeek Harness 发布说明2026 年 8 月。十分钟跑起来上手比想象中简单。前提就一个Node.js 版本要^22.19.0或24。我一开始用旧版 Node 跑静默失败连报错都没有——这是它目前最坑的地方来源DeepSeek Harness 官方 README2026 年 8 月。装好 Node一行命令启动 Web UInpx deepseek-ai/dsh web默认地址http://127.0.0.1:3080。打开后三步走配模型Settings → Models填 DeepSeek API Key。它也支持 OpenAI 兼容端点和其他厂商改完不用重启选工作区Choose workspace指向你的项目目录。没选工作区之前输入框是禁用的——我第一次卡在这还以为是启动失败了发任务新开一个会话让它总结这个仓库并识别主要包试试水国内网络建议先换 npm 镜像npm config set registry https://registry.npmmirror.com不然下载可能很慢。它运行的时候所有文件读写和命令执行都被限制在工作区内路径穿越../../会被拦——这是默认的沙箱隔离不需要额外配置来源dsh 使用指南2026 年 8 月。写你的第一个插件光会跑没意思dsh 的灵魂在插件。用一个最小例子讲清楚它的机制。从源码仓库开始开发插件建议 clone 源码而不是 npxgitclone https://github.com/deepseek-ai/deepseek-harness.gitcddeepseek-harness corepackenablepnpminstallpnpmrun build然后在仓库里建一个插件目录写一个greet工具importtype{Context}fromdeepseek-ai/cordisimport{defineTool}fromdeepseek-ai/dsh-toolsexportconstnamegreet-toolexportconstinject[tools]exportfunctionapply(ctx:Context){ctx.tools.register(defineTool({name:greet,description:Greet someone by name.,parameters:{name:{type:string,required:true,description:The name to greet}},asyncexecute(args){return你好,${args.name}!}}))}示例参考Datawhale DeepSeek Harness 插件教程2026 年 8 月这个插件只干四件事声明插件名、声明需要的服务tools、在apply入口注册工具、定义工具的入参和执行逻辑。模型通过描述知道这个工具存在通过入参 schema知道怎么调用它。挂载到 Web 服务pnpmdsh web--patch./scratch-plugin/cordis.yml启动后到设置 → 插件列表确认插件是已启用状态然后让 Agent 调用请调用 greet 工具问候 Datawhale。你会看到工具调用的输入输出完整展开——插件闭环就跑通了。生产级的插件不用自己造轮子。比如 DeepSeek 的文本模型目前不能直接看图社区有 DSH Vision Toolkit 插件把图片交给单独的视觉模型再把结果送回 Harness实现截图分析、OCR、元素定位来源Datawhale 插件教程2026 年 8 月。安装就是一行dsh plugin--profilewebadddsh-external/dsh-vision-toolkit装插件前一定看源码和权限。Harness 插件运行在宿主进程里属于可信代码安装脚本会下载什么、需要哪些目录和凭据权限都得先弄清楚——这跟装任何 npm 包一个道理。四种模式各干各的活dsh 内置了四种运行模式对应不同场景来源DeepSeek 官方发布说明2026 年 8 月模式干什么用标准模式日常开发完整文件读写 命令执行极简模式纯文本对话无工具适合闲聊和快速问答PTC 模式程序化工具调用适合基准测试和脚本化场景创造模式插件开发调试内存里直接试 Cordis 插件实际用下来日常开发用标准模式就够了想验证插件逻辑创造模式省去反复重启。还有 headless 模式跑脚本和 CI 用dsh --profile headless 列出这个仓库所有 TODO一次性任务输出到 stdout 就退出不用开浏览器。回看我七月那篇 harness 文章既然 dsh 把概念落地成了产品正好回头检验一下我上个月写的《给 AI 套上缰绳Harness Engineering 是什么》哪些判断站得住哪些需要修正。站得住的三个判断一是Agent Model Harness模型是 CPUHarness 是操作系统。dsh 的定位跟这个公式严丝合缝——它把模型当可替换组件把工程能力工具、沙箱、审批、UI全部做进 Harness 层。DeepSeek 官方自己的定义就是Model Harness Agent。二是每次 Agent 犯一个错就把它工程化成一个约束。dsh 的插件化让这个循环变得更顺——AI 又漏改文件了把文件修改必须走工具注册写成一个插件约束比维护 AGENTS.md 里的一行文字更硬。约束从文档约定升级成了代码强制。三是评审与验证必须分离。dsh 的四种模式和 headless 流程天然支持把干活和验证拆开跑——这是它架构上就内建的优势。需要修正的两个地方一是旧文把 harness 落地完全押在AGENTS.md verify 脚本 权限 hooks三件套上这是 Claude Code 的生态。dsh 的出现说明 harness 不止一种形态——插件化元框架是更激进的一条路AGENTS.md 只是其中一种系统提示插件的实现。三件套是路径之一不是唯一解。二是旧文里模型一行没动环境一换效果天差地别这个说法用在给 AI 套缰绳上成立但 dsh 的实践反过来提醒Harness 和模型是协同演进的。DeepSeek 是模型和 Harness 一起发Muse Spark 也是和 Muse Code 一同训练——Harness 的边界设计会影响模型的发挥模型的进步也会反过来改变 Harness 该管什么。缰绳和马的品种是互相适配的不是单向约束。和 Claude Code 比差在哪这是绕不开的问题。说结论架构理念上 dsh 更激进工程成熟度上 Claude Code 领先。插件化程度dsh 把换工具换循环都变成配置Claude Code 的扩展点是 skills hooks自由度不在一个量级Session 可靠性dsh 把会话日志设计成 append-only 事件日志官方宣称崩溃后可重放恢复——但这是架构设计的宣称还没经过大规模生产验证Claude Code 的会话机制成熟但长会话断开后的恢复一直是它的短板。两者在可靠的定义上不一样都得等时间检验生态Claude Code 有一年多的打磨、社区和文档积累dsh 发布才几天THERE WILL BE COMPATIBILITY-BREAKING CHANGES的警告就挂在 README 首页模型绑定dsh 不绑定 DeepSeek 模型OpenAI 兼容端点都能接但当前优化得最好的肯定是自家 V4-Pro-0813成本DeepSeek 从 8 月 17 日起 API 改峰谷定价高峰北京时间 9-12 点、14-18 点价格是空闲时段的两倍晚间和深夜半价来源DeepSeek 官方定价公告2026 年 8 月。国内直连 相对低价这是它对国内团队最实在的吸引力但它现在还是 0.1 预览版官方明说存在破坏性更新。我的建议是拿它做技术预研、做内部工具的底座别在生产环境梭哈。想用 dsh 顶替 Claude Code 的团队等它稳定几个版本再说。Java 团队怎么用最后给 Java 后端同行的落地建议三句话先 headless 跑通一个真实小任务比如给这个模块补全单元测试验证工具链和工作区隔离是否顺手把团队知识做成插件——项目脚手架生成、代码规范检查、SQL 风险扫描这些都能注册成 dsh 工具让模型按团队规则干活而不是每次重新教留意它把 Session Log 做成 append-only 的设计——这对需要审计的开发场景是加分项出了问题能回放模型会一直换套缰绳的手艺才值钱。现在缰绳有人开源了还给你留了所有改装孔位——剩下的就是把团队自己的规则拧上去。作者唐悦玮 | 公众号同名从后端出发用 AI 拓展到全栈的工程师。参考资料DeepSeek Harness 官方 GitHub 仓库与 README2026 年 8 月。安装要求、MIT 协议、破坏性更新警告。DeepSeek Harness 官方架构文档与发布说明2026 年 8 月。一切皆插件设计、Cordis 框架、四种运行模式、与北大合作论文。CSDN“DeepSeek Harness 开源一切皆插件、省 Token、Agent 还能改装自己”2026 年 8 月 15 日。发布背景、GitHub 星标数据。Datawhale“DeepSeek Harness 插件开发保姆教程”2026 年 8 月。最小插件代码示例、Vision Toolkit 安装与配置。DeepSeek 官方定价公告2026 年 8 月。API 峰谷定价规则8 月 17 日生效。