目录引言黑鲸出水DeepSeek 的 Agent 底座正式开源Agent Model Harness理解 Harness 的本质Cordis 微内核一切皆插件的架构基石四种运行模式一套内核四种装法多 Agent 编排Spawn、Fork、Workflow 与 Ralph全链路可观测Append-only 会话日志与 Trajectory工具执行流水线从 Hook 到沙箱的全链路管控快速上手从安装到自定义插件竞品对比Harness vs Claude Code vs Codex挑战与局限v0.1 阶段的冷静思考总结与展望01引言黑鲸出水DeepSeek 的 Agent 底座正式开源2026 年 8 月 13 日晚间DeepSeek 做了一次闪电二连击在发布 DeepSeek-V4-Pro-0813 正式版模型的同时悄然开源了 DeepSeek Harness 开发者预览版 v0.1[1][2]。这是 DeepSeek 官方推出的首款开源 Agent 运行框架以 MIT 协议在 GitHub 上开放了完整源码仓库地址为deepseek-ai/deepseek-harness[3]。上线不到 48 小时GitHub Star 数就突破了 9.3 万首日更是以约 3.75 万 Star 的速度刷新了 AI 开源项目的记录[4]。这一数据甚至超过了当年 DeepSeek-R1 开源时的盛况引爆了全球 AI 开发者社区。从俄罗斯的技术媒体到中国的开发者论坛从 HN 到 RedditDeepSeek Harness 成为本周最热门的技术话题。DeepSeek Harness简称dsh不是一个模型也不是一个 API 客户端而是一个智能体运行框架。它的核心口号只有五个字——一切皆插件Everything is a Plugin[5]。这句话的真意是框架里没有特权组件模型、工具、技能、会话、沙箱、存储、Agent 循环、调度乃至 UI全部由可替换的插件组成。项目负责人崔添翼Tianyi Cui在发布时说了一句被社区广泛传播的话闭源为用户提供现在开源让用户自己掌握未来。[6]这句话也道出了 DeepSeek Harness 的产品哲学——它不是要做一个精致封闭的成品而是要交出一套可组合、可替换、可扩展的底座。本文将从架构设计、运行模式、多 Agent 编排、可观测性、工具执行流水线等多个维度深入拆解 DeepSeek Harness 到底厉害在哪里并通过可运行的代码示例帮助开发者快速理解其设计理念。02Agent Model Harness理解 Harness 的本质2.1 什么是 Agent Harness在理解 DeepSeek Harness 之前需要先理解Harness这个概念在 AI Agent 语境下的含义。DeepSeek 官方给出了一个简洁的公式[5]Agent Model Harness模型Model是 Agent 的灵魂负责推理、决策和生成下一步内容。但模型本身只会想不会做。一个能在真实环境中持续工作的 Agent还需要处理大量模型之外的事情执行能力读写文件、执行命令、调用外部服务上下文管理长任务中积累的大量中间信息需要压缩、筛选和注入权限控制哪些目录能碰、哪些命令需要批准状态保存与错误恢复任务中断后能恢复、重试循环与停止条件什么情况下继续、什么情况下收尾可观测性记录每一步的输入输出方便排查问题Harness 就是负责这一切的运行时底座——你可以把它理解成 AI 的操作系统外壳。它决定了模型能看到什么、可以调用哪些工具、如何组织上下文、遇到错误怎么重试以及什么时候判断任务已经完成[2]。2.2 为什么 Harness 正在成为关键变量过去几个月围绕 AI Coding 的讨论正在从模型能力转向Harness 设计。核心原因很简单同一个模型被放进不同的 Agent 系统最终表现可能相差很大。当模型评测从单次问答走向真实工程任务之后Harness 本身已经成为影响评测结果的重要变量。一个设计良好的 Harness 能让中等水平的模型在复杂任务中表现优异而一个糟糕的 Harness 可能让顶级模型频繁出错。这正是 DeepSeek 选择在 V4 Pro 正式版发布的同时开源 Harness 的原因——模型能力和运行框架必须协同进化。V4 Pro 提供了更强的 Agent 能力而 Harness 提供了让这种能力充分发挥的运行环境[7]。2.3 AI 工程范式的三次跃迁从宏观视角看AI 工程范式正在经历第三次跃迁阶段形态核心特点第一次跃迁对话式 AI模型即产品一次提问一次回答能力边界在模型本身第二次跃迁Agent 工具调用Function Calling、MCP 等把外部工具接入模型模型开始动手第三次跃迁Agent 运行时Harness在模型与工具之上增加循环、权限、状态、可观测、可组合的底座Agent 可连续完成长任务DeepSeek Harness 正是第三次跃迁的代表作之一。它不再只拼模型能力而是把模型如何利用工具、如何持续运行变成一套可编程、可组合的底层运行时[8]。03Cordis 微内核一切皆插件的架构基石3.1 Cordis 是什么DeepSeek Harness 底层的插件框架叫做Cordis——一个只负责插件加载、卸载和依赖管理的微内核[9]。Cordis 本身几乎什么都不干它只提供三样东西插件的加载mount把插件挂载到共享上下文中插件的卸载unmount卸载时自动撤销该插件注册的所有副作用依赖关系管理插件可以声明依赖框架保证依赖先于消费方启动你可以把整个 Harness 想象成一棵由插件组成的树Cordis Root ContextLoader PluginLLM AdapterTool RegistryAgent LoopDeepSeek APIOpenAI APIClaude APIShell ToolFile EditorSandboxApproval没有特权核心 —— 所有能力都是插件模型、工具、会话、沙箱、存储、循环、调度、UI 全部可替换图 1DeepSeek Harness 插件树架构总览Cordis 的理念来自北京大学与 DeepSeek 联合署名的论文《A Programming Paradigm for Spatiotemporal Composability》强调时空可组合性[8]时间可组合性插件卸载后它注册过的服务、事件和副作用能随之撤销空间可组合性插件可以声明依赖并在其他组件变化时重新建立协作关系3.2 插件的三种形态Cordis 接受三种插件形态函数插件、对象插件和类插件Service 子类[9]。下面通过一个最简单的示例来理解插件的写法。代码示例 1你的第一个 Cordis 插件import type { Context } from deepseek-ai/cordis export const name hello export function apply(ctx: Context) { console.log(hello from my first plugin) }每个插件通过一个apply(ctx)函数描述自己贡献的内容而cordis.yml负责把这些插件组合成一个应用- name: ./hello.tscordis.yml是一组 Cordis 配置项的列表。name是模块指定符可以是相对路径或 NPM 包名。各项会并发启动所以列表顺序不保证加载先后——加载顺序由服务依赖inject决定而非文件中的位置[9]。整个过程中你的文件里没有框架启动代码插件只描述自己的贡献cordis.yml负责组合应用。这正是一切皆插件理念的直接体现。3.3 服务插件间的协作桥梁服务是一个插件提供、其他插件通过ctx消费的具名能力。在 Harness 中ctx.tools、ctx.llm和ctx.agents都是服务[9]。消费方只指定tools之类的能力而不导入其提供方因此配置可以选择提供方无需修改消费方。代码示例 2服务定义与消费// greeter.ts —— 定义服务 import { Service, type Context } from deepseek-ai/cordis declare module deepseek-ai/cordis { interface Context { greeter: GreeterService } } export class GreeterService extends Service { constructor(ctx: Context) { super(ctx, greeter) } greet(who: string) { return Hello, ${who}! } } export const name greeter export function apply(ctx: Context) { ctx.plugin(GreeterService) } // consumer.ts —— 消费服务 import type { Context } from deepseek-ai/cordis export const name consumer export const inject [greeter] // 声明依赖 export function apply(ctx: Context) { console.log(ctx.greeter.greet(world)) }这里有两部分协同工作运行时super(ctx, greeter)以名称greeter注册该实例。此后任何插件都可以通过ctx.greeter访问它编译时declare module块使用 TypeScript 声明合并把greeter加入Context接口使ctx.greeter在各处都能通过类型检查inject列出该插件需要的服务。Cordis 会让插件保持PENDING状态直到列出的每项服务都存在[9]。这意味着cordis.yml中的加载顺序无关紧要——决定插件何时启动的是依赖关系而不是文件顺序。核心设计依赖跟踪是动态的inject并非一次性的启动检查。如果应用运行期间所需服务消失——例如提供方被卸载或热替换——每个依赖插件也会随之卸载并在服务恢复后再次加载。结合 effect 机制这能防止运行中的消费方保留对不可用服务的引用。这也是配置中可以替换服务的原因卸载dsh-bash-local挂载另一个shell提供方所有注入shell的插件都会重新启动并使用新实现。3.4 生命周期与 Effect自动清理的资源管理Cordis 插件可能因修改配置、热重载、显式资源释放或所需服务消失而卸载。通过 Cordis API 建立的注册属于effect会在所属插件卸载时自动撤销[9]。代码示例 3生命周期与 Effectimport type { Context } from deepseek-ai/cordis export const name lifecycle-demo function heartbeat(ctx: Context) { console.log(heartbeat plugin loading) ctx.effect(() { const timer setInterval(() console.log(tick), 200) return () { clearInterval(timer) console.log(heartbeat cleaned up) } }) } export function apply(ctx: Context) { // 挂载子插件并保留其 fiber 以便后续释放 const fiber ctx.plugin(heartbeat) ctx.effect(() { const timer setTimeout(async () { await fiber.dispose() console.log(disposed) process.exit(0) }, 700) return () clearTimeout(timer) }) }每个已加载插件实例都拥有一个fiber并在以下状态之间转换PENDING → LOADING → ACTIVE → UNLOADING → DISPOSED ↘ FAILEDfiber.dispose()会等该插件的所有清理工作包括异步 disposer完成后才结束并递归卸载它挂载的所有子插件[9]。这种设计确保了插件系统的时间可组合性——卸载是干净的、可逆的、递归的。3.5 事件系统五种分发模式服务支持直接调用事件让插件无需知道有哪些插件正在监听就能发出通知[9]。Cordis 提供了五种事件分发模式模式调用方式行为emitctx.emit(name, ...args)同步广播不等待或收集返回值parallelawait ctx.parallel(name, ...args)所有监听器并发运行并一同等待serialawait ctx.serial(name, ...args)按顺序运行第一个非空返回值胜出并停止后续bailctx.bail(name, ...args)serial 的同步版本waterfallctx.waterfall(name, ...args, next)环绕中间件可转换或短路代码示例 4Waterfall 事件 —— 转换与短路import type { Context } from deepseek-ai/cordis declare module deepseek-ai/cordis { interface Events { demo/transform(input: string, next: () Promisestring): Promisestring } } export const name waterfall-demo export function apply(ctx: Context) { // 监听器 1包装下游结果 ctx.on(demo/transform, async (input, next) { const downstream await next() return downstream.toUpperCase() }) // 监听器 2满足条件时短路否决 ctx.on(demo/transform, async (input, next) { if (input.includes(blocked)) return ** blocked ** return next() }) void (async () { console.log(await ctx.waterfall(demo/transform, hello, async () hello)) console.log(await ctx.waterfall(demo/transform, blocked words, async () blocked words)) })() }运行结果HELLO ** BLOCKED **这个 waterfall 模式在 Harness 中有实际用途agent/request事件允许插件替换模型调用配置approval/request事件允许策略代替用户作答[9]。一个重要纪律是只负责观察或标注的 waterfall 监听器必须调用next()否则会悄无声息地吞掉所有下游的默认行为。3.6 配置与 Schema类型安全的插件配置代码示例 5带 Schema 验证的可配置插件import type { Context } from deepseek-ai/cordis import Schema from deepseek-ai/schemastery export const name config-demo export interface Config { greeting: string targets: string[] } export const Config: SchemaConfig Schema.object({ greeting: Schema.string().default(Hello), targets: Schema.array(String).default([world]), }) export function apply(ctx: Context, config: Config) { for (const target of config.targets) { console.log(${config.greeting}, ${target}!) } }导出的Config既是 TypeScript 接口也是同名的运行时 schema消费方获得类型Cordis 获得验证器。错误配置会导致加载失败并给出准确错误——插件绝不会在配置不完整时启动[9]。04四种运行模式一套内核四种装法基于同一套 Cordis 底座DeepSeek Harness 当前提供四种运行模式。它们没有分别维护四套系统主要差异来自默认加载的插件集合[2]。模式默认插件集合适用场景标准模式Standard完整工具组合文件操作、Shell、搜索、子任务委派、计划维护等日常写代码、修 Bug、分析项目默认推荐代码模式Code / PTC标准模式全部能力 Code Mode SDK模型生成 TypeScript 程序来编排多轮工具调用极简模式Minimal只保留 Shell 工具和 str_replace_editor最小环境下做模型基准测试创造模式Creator标准模式全部能力 运行时检查 插件试验实验新插件组合并创作新的运行模式4.1 标准模式最省心的全能选手标准模式提供完整工具组合包括文件操作、Shell 执行、文件和 Web 搜索、技能Skills、计划Planning、目标Goals、子 AgentSubagents和工作流Workflows[5]。这是日常开发中最常用的模式能力最全开箱即用。4.2 PTC 模式让模型写代码来编排工具调用PTCProgrammatic Tool Calling程序化工具调用模式是四种模式中最具技术深度的创新之一。传统工具调用是一轮一次的模型决定调用某个工具等待结果再决定下一步。而 PTC 模式允许模型先生成一段 TypeScript 程序再由这段程序编排多轮工具调用[2]。这适合需要根据中间结果分支、循环、批量处理的复杂任务。例如模型可以写一段代码先查询文件列表对每个文件检查内容根据匹配结果决定是否修改——整个过程在一次模型请求中完成减少了多轮对话的延迟和上下文消耗。安全设计PTC 模式中的代码及其子调用同样要经过完整的工具执行流水线——不能绕过审批与沙箱。普通工具调用和程序化工具调用入口不同但共享同一套安全与观测机制[2]。4.3 极简模式模型基准测试的无尘室极简模式只保留一个 Shell 工具和一个文件编辑工具str_replace_editor主要用于减少其他组件干扰在最小环境中测试模型能力[5]。当你要评测不同模型在相同条件下的表现时极简模式提供了最干净的测试环境。4.4 创造模式让 Agent 改造自己的运行时创造模式是四种模式中最值得关注的设计。传统 Harness 的运行方式通常由产品开发者预先写定用户只能在既有配置中选择。创造模式试图让Agent 直接理解自己所处的运行时再按任务需要试装插件和组合能力[2]。换句话说Harness 的配置本身也开始成为 Agent 可以操作的对象。这距离Agent 自己改造自己的 Harness还有多远需要等代码、示例和真实任务验证。但目前能够确认的是DeepSeek 已经把运行时的可组合性同时交给了模型、配置文件和框架开发者。4.5 Profile 与 Bundle模式背后的组合机制四种模式本质上是四种Profile。一个 Profile 是存储在 Harness 主目录中的命名组合它列出了要堆叠的 Bundle、持有的任何外部插件并保留用户自己的cordis.patch.yml[10]。一个Bundle是 Cordis 配置行及其所挂载代码的分发格式——无论它插入什么都可以被上层 patch 覆盖。每个 Bundle 在自己的package.json中通过dsh字段声明dsh.profile列出 Profile 的 Bundledsh.bundle指向 Bundle 的 patch 文件。# 查看你的机器实际启动的配置树 dsh --profile web --dump-config这条命令打印出的任何行都可以被你自己的 patch 替换。这就是一切皆插件在配置层面的落地方式——不 fork 源码只改配置。05多 Agent 编排Spawn、Fork、Workflow 与 RalphDeepSeek Harness 已经内置了一套完整的多 Agent 系统[2]。父 Agent 可以通过多种方式启动子 Agent面对更复杂的任务还能通过 workflow 工具现场编写 JavaScript 来组织并行或流水线任务。Parent AgentSpawn (fresh)ForkWorkflowRalphChild (new ctx)Child (inherited)parallel() / pipeline()Relay Agents全新上下文独立探索任务互不干扰继承父会话共享上下文前缀缓存友好模型写 JS 代码并行 / 流水线复杂编排多 Agent按轮次接力持续工作层级式 Supervisor-Worker 架构父 Agent 负责拆解、分配和汇总子 Agent 负责执行图 2DeepSeek Harness 多 Agent 编排模式5.1 Spawn 与 ForkSpawn启动拥有全新上下文的子 Agent适合独立的探索任务。Fork让子 Agent 继承已有会话——在 fork 模式下子请求保持父 Agent 的系统提示词和消息历史字节级一致追加一个结构化状态快照然后添加子 Agent 角色指令和任务[11]。这种设计让 DeepSeek 前缀缓存复用率保持在较高水平同时给子 Agent 提供了续写、审查、摘要或压缩工作所需的上下文。5.2 Workflowparallel() 与 pipeline()面对更复杂的任务模型还能通过 workflow 工具现场编写 JavaScript用parallel()和pipeline()组织并行或流水线任务[2]。这意味着模型不再局限于一步一工具的串行调用而是可以像写程序一样设计 Agent 间的协作流程。5.3 Ralph 循环模式Ralph 模式让多个全新 Agent 按轮次接力——每个 Agent 在自己的轮次中工作完成后将控制权交给下一个 Agent。这种模式适合需要持续迭代的长时间任务比如不断审查和改进代码直到通过所有测试。5.4 编排范式的冷静评估如果放进常见的五种编排模式中DeepSeek Harness 最接近层级式 Supervisor-Worker父 Agent 负责拆解、分配和汇总任务子 Agent 负责执行[2]。更准确地说它是一个以层级式编排为主兼容并行、流水线和 Ralph 循环的混合系统。它目前离真正的 Swarm 还有较大距离。系统中的任务分配和控制权主要掌握在父 Agent 手中缺少 Agent 之间的自主发现、协商、竞争和动态接管任务机制。创新在哪里Spawn、Fork、Pipeline 和 Ralph Loop 都已有成熟先例真正特别的地方在于——它把这些编排方式做成了可以随配置替换的插件甚至可以把 Claude Code、Codex 或支持 ACP 的外部 Agent 接到同一个子 Agent 接口后面[2]。架构设计有新意编排范式没有突破。放在开源 Harness 中这套设计已经相当先进。06全链路可观测Append-only 会话日志与 TrajectoryDeepSeek Harness 的另一个核心设计是仅追加的会话日志append-only session log[2]。这是整个框架最具特色的功能之一。6.1 统一事件流模型看到的所有内容都会进入同一份 append-only 日志包括系统提示词system prompts推理内容reasoning / thinking工具调用及其结果tool calls and results子 Agent 调度subagent scheduling每一次上下文注入context injection开发者可以在Trajectory轨迹视图中按照来源检查这些信息[5]。会话恢复、分叉、检索与回放也都建立在同一份事件流之上。6.2 Turn Flow一次对话的完整生命周期一个step是一次模型请求加上它调用的工具。一个turn是零或多个 step[10]。完整的 Turn Flow 如下turn/startassemble prompt tool schemasagent/pre-step (waterfall)step/startagent/request → llm/streamtools/pre-execute → executeassistant/chunk* → messagetools/post-execute → resultstep/end → turn/enddurable eventextension point图 3Turn Flow —— 一次对话的完整生命周期turn/*、step/*、user/message、assistant/*和tool/*是持久化会话事件其余的是跨三个域的实时扩展点[10]。agent/pre-step、agent/request、llm/stream和三个tools/*事件是 waterfall其监听器必须调用next()来委托agent/turn-stopping是 serial 且没有next()。6.3 为什么统一事件流如此重要这项设计首先解决的是可观测性。Agent 任务失败时问题可能出在模型判断、工具返回、上下文注入、调度策略或系统提示词。若这些内容散落在不同组件中开发者很难还原模型当时究竟看到了什么。统一事件流给调试、评估和回放提供了一份共同底稿[2]。它也为会话分叉提供了更自然的数据结构新分支可以沿用分叉点以前的事件再追加新的上下文和行动无需覆写原有历史。对于一个强调插件可替换的系统这尤其重要——因为开发者需要比较不同 Loop、工具或调度插件在相同任务轨迹上的表现。架构文档中有一条关键的运行时不变量模型可见即已记录Model-visible means logged[10]。任何到达模型请求的内容都必须可以从日志中重建运行时会断言这一点。这就是为什么一个新的模型可见输入需要一个新的会话事件。07工具执行流水线从 Hook 到沙箱的全链路管控工具调用在 DeepSeek Harness 中被拆成了一条可扩展流水线[2]。这条流水线是整个框架安全设计的核心。Hook前置拦截Approval人工审批Permission权限检查Sandbox沙箱隔离Execute实际执行Rewrite结果改写Record记录UI工具执行流水线Tool Execution Pipeline请求执行前执行执行后图 4工具执行流水线 —— 从请求到结果的全链路管控请求执行前会经过Hook、审批、权限检查、沙箱和超时控制执行后还可进行结果改写、记录和 UI 渲染。开发者无需修改工具或 Agent Loop就能在各个环节插入插件[2]。7.1 Capability Seams可替换的能力接缝Harness 架构中有一个核心概念叫Seam接缝——一个可替换的能力包含三个角色[10]Service Definition服务定义声明接口Service Provider服务提供方实现接口Consumer消费方使用接口通常是面向模型的工具Seams 是为什么一次提供方替换就能改变整个产品的原因。文件系统和子进程提供方共享一个执行世界因此将它们指向远程沙箱时Bash、PTY 和 LSP 会随之移动无需 provider 分叉[10]。子 Agent 提供方也在一个接口后面变化极大——从一个全新的子 Agent 到另一个产品中的委托轮次。7.2 扩展点地图架构文档中有一张详细的新行为归属映射表列出了所有可扩展的入口[10]目标机制添加模型提供方在ctx.llm上注册适配器添加面向模型的能力在ctx.tools上注册其 schema 加入提示词组装添加 Shell 执行注册ctx.shell后端本地版本通过ctx.subprocess生成添加文件系统访问或策略注册ctx.fs提供方或监听fs/*事件限制生成的进程使用ctx.sandbox后端消费者在生成前包装 argv拦截请求、工具或轮次使用对应的agent/*或tools/*事件添加面向模型的上下文调用agent.inject()它会进入下一次接受的请求分叉活动会话ctx.sessions.fork(source, boundary?, childSessionId?)这张表的含义非常明确几乎所有你能想到的扩展需求都有对应的插件入口不需要修改 Harness 源码。08快速上手从安装到自定义插件8.1 一行命令启动对一个刚开源的 v0.1 来说DeepSeek Harness 安装简单得有点不像官方产品。前置条件只有一个装好 Node.jsv22.19 及以上或 v24 及以上[8]。代码示例 6快速启动# 方式一npx 一行命令尝鲜首选 npx deepseek-ai/dsh web # 启动成功后浏览器打开 http://127.0.0.1:3080 # 在设置 → 模型中填入 DeepSeek API Key 并保存 # 选择工作区目录发送第一个任务 # 方式二从源码构建想改插件、读源码选这个 git clone https://github.com/deepseek-ai/deepseek-harness.git cd deepseek-harness pnpm install pnpm run build pnpm dsh web国内网络较慢时可以先配置 npm 镜像npm config set registry https://registry.npmmirror.com8.2 配置模型DeepSeek Harness 是模型无关Model-agnostic的。官方内置 DeepSeek 模型接入同时支持 Anthropic、OpenAI 等提供方以及任意 OpenAI 兼容的自定义端点[8]。模型配置变更下次请求即生效无需重启服务。对于自定义提供方公司网关、自建服务器等只需选择添加自定义提供方填写 Provider ID、基础 URL、API 协议、凭据和至少一个模型即可。Provider ID 是永久的——请求、已保存会话、模型默认值和凭据引用都会使用它[8]。8.3 Python SDK程序化调用适合把 Harness 的能力嵌入自己的脚本或自动化流程而不是通过 Web 界面交互[8]。代码示例 7Python SDK 调用# 安装 SDK pip install deepseek-harness-sdk # 设置环境变量 export DEEPSEEK_API_KEY你的密钥 export DSH_MODELdeepseek-v4-flash # 运行仓库内置示例 python examples/jsonrpc-agent/minimal.py \ --workspace /绝对路径/workspace \ --session-root /绝对路径/sessions \ --session-id example-001 \ Inspect the repository and fix the failing tests.Windows 注意官方 Python SDK 文档目前列出的前置环境为Linux x64 / Linux arm64 / macOS 14 (arm64)示例组合不支持 Windows。Windows 用户建议用 Web UI 方式体验或借助 WSL。8.4 编写你的第一个自定义插件结合前面学到的 Cordis 知识让我们写一个更有实际意义的插件——一个简单的统计服务记录工具调用次数代码示例 8完整的统计服务插件import { Service, type Context } from deepseek-ai/cordis declare module deepseek-ai/cordis { interface Context { stats: StatsService } interface Events { stats/report(name: string, count: number): void } } export class StatsService extends Service { private counts new Mapstring, number() constructor(ctx: Context) { super(ctx, stats) } bump(name: string) { const next (this.counts.get(name) ?? 0) 1 this.counts.set(name, next) this.ctx.emit(stats/report, name, next) } } export const name stats export function apply(ctx: Context) { ctx.plugin(StatsService) // 监听工具执行事件自动统计 ctx.on(tools/execute, () { ctx.stats.bump(tool_call) }) }然后在cordis.yml中挂载它- name: ./stats.ts - name: ./reporter.ts # 消费 stats 服务的插件这个示例展示了 Cordis 的几个关键设计在实践中的组合服务定义、事件声明、effect 自动清理、以及通过事件钩子集成到 Harness 的工具执行流程中。09竞品对比Harness vs Claude Code vs CodexDeepSeek Harness 的定位更接近一套可组装的 Agent 运行时底座与功能固定的 Coding Agent 有明显区别[2]。让我们把它和主流竞品做一个对比对比维度DeepSeek HarnessClaude CodeOpenAI CodexLangGraph开源协议MIT 全开源闭源闭源MIT 开源架构理念一切皆插件无特权核心核心封闭开放扩展点封闭黑盒图结构状态机模型支持可换近 40 种主流模型仅 Claude仅 OpenAI模型无关Agent Loop 可替换是否否部分UI 可替换是否否不适用多 Agent 编排Spawn/Fork/Workflow/Ralph有限有限图结构编排可观测性Append-only 事件流 Trajectory有限有限LangSmith 集成二次开发自由度最高受限受限中等成熟度v0.1 预览版成熟产品成熟产品成熟框架形象开发者工坊精装成品精装成品编排引擎说白了Claude Code 是精装房拎包入住DeepSeek Harness 是毛坯工坊工具给齐了但家具得你自己拼[6]。两者面向的用户群体不同Claude Code 面向想开箱即用写代码的开发者Harness 面向想搭建自己的 Agent 工作流的 Harness 开发者。与 MCP 的关系也值得一提两者不在同一层。MCP 是连接 AI 应用与外部数据、工具、工作流的开放标准Harness 是更上层的运行逻辑。MCP Server 可以成为 Harness 里的一个插件[8]。10挑战与局限v0.1 阶段的冷静思考10.1 官方自己的警告DeepSeek 在 GitHub 仓库的 README 中明确标注[3]DeepSeek Harness is currently in developer preview and is iterating rapidly. THERE WILL BE COMPATIBILITY-BREAKING CHANGES.这意味着现在进入生态的开发者需要承受较高的迁移成本。核心插件与基础接口仍会快速变化尝鲜、学习、做二次开发完全没问题追求稳定、要上生产建议等版本收敛[6]。10.2 插件边界的代价什么都能换这条路线也带来了明显挑战[2]接口稳定性插件边界越深接口稳定性就越难控制依赖管理插件之间的依赖关系可能变得复杂版本兼容不同版本的插件之间可能不兼容性能开销插件化的间接调用带来额外开销调试复杂度问题可能出在任何一个插件的交互中10.3 可替换不等于更好更重要的是什么都能换并不会自动带来更好的任务成功率[2]。真正决定这套架构价值的仍然是官方能否给出高质量的默认插件能否形成稳定的组合范式能否提供可信的评测结果第三方开发者是否愿意围绕它持续构建插件插件系统提供的是差异化空间最终效果还要由具体实现兑现。10.4 未来真正的差距在哪里一位业内专家向 InfoQ 表示从 Harness 的完整链路看工具调用、记忆管理和任务规划等大方向已经基本确定未来仍有大量创新会发生在各个局部环节[2]记忆管理当记忆不断累积时需要压缩当不同记忆之间出现冲突时需要及时整理和清理任务规划Agent 没有必要每次都从头规划面对相似问题时可以复用已有路径Plan 校验计划生成后可以增加一层近似编译的检查——先把 Plan 表示成结构化数据再检查异常处理分支是否完整、是否包含无法执行的操作DeepSeek 一切皆插件的价值也正在于为这些局部能力预留替换、组合和持续试验的空间。11总结与展望DeepSeek Harness v0.1 的发布标志着 DeepSeek 从模型公司向模型 框架公司的延伸。它选择 MIT 协议并在开发者预览阶段就开放完整源码说明其目标已经超过一个封闭的 DeepSeek 模型客户端[2]。从架构层面看DeepSeek Harness 当前最鲜明的差异落在三个点上一切皆插件从模型到 UI所有能力都可替换没有特权核心全链路可观测Append-only 事件流让每次运行都有迹可循四种运行模式一套内核覆盖从基准测试到 Agent 自我改造的全场景它试图把模型、工具、Loop、调度和 UI 都放进同一套可组合框架中再邀请外部开发者共同扩展这套系统。这是一个雄心勃勃的方向但也是一个充满挑战的方向。接下来真正值得观察的是一切皆插件能否形成一套足够稳定的开发标准它最终会长成 DeepSeek 自己的 Coding 产品还是成为更多 Agent 产品共同采用的底层 Harness社区生态能否在 v0.1 的不稳定期存活并壮大DeepSeek Harness v0.1 只是起点。对于爱折腾的开发者来说现在正是上手体验、参与生态建设的最佳时机。想要什么能力自己拼——这正是一切皆插件的承诺。相关资源GitHub 仓库github.com/deepseek-ai/deepseek-harness官方网站deepseek.com/harness官方文档deepseek-harness.github.io社区插件GitHub Topics: dsh-pluginCordis 论文A Programming Paradigm for Spatiotemporal Composabilitynpm 包deepseek-ai/dshnpx deepseek-ai/dsh web一键启动参考来源CGTN, DeepSeek launches V4 Pro model with enhanced AI agent capabilities. 2026-08-14.DeepSeek launches V4 Pro model with enhanced AI agent capabilitiesTina, InfoQ. DeepSeek 把 Harness 开源了模型、工具、Agent Loop 全是插件. 2026-08-14.DeepSeek 把 Harness 开源了模型、工具、Agent Loop 全是插件 - InfoQGitHub, deepseek-ai/deepseek-harness. DeepSeek Harness: Everything is a Plugin.GitHub - deepseek-ai/deepseek-harness: DeepSeek Harness: Everything is a Plugin. · GitHubHabr, DeepSeek Harness набрал 37 тысяч звёзд за первый день. 2026-08-14.DeepSeek Harness набрал 37 тысяч звёзд за первый день: что умеет новый кодинг‑агент / ХабрDeepSeek Official, DeepSeek Harness Developer Preview. Everything is a plugin.DeepSeek Harness developer preview: Everything is a plugin晚安code, 阿里云开发者社区. DeepSeek Harness 一切皆插件开源Agent框架强在哪怎么装. 2026-08-15.DeepSeek Harness 一切皆插件开源Agent框架强在哪怎么装-阿里云开发者社区China Daily, Chinas DeepSeek upgrades its V4 Pro model. 2026-08-13.Chinas DeepSeek upgrades its V4 Pro model - Chinadaily.com.cn掉落的果实, 博客园. DeepSeek Harness 教程一切皆插件的开源 Agent 框架. 2026-08-15.DeepSeek Harness 教程一切皆插件的开源 Agent 框架 - 掉落的果实 - 博客园CSDN, DeepSeek Harness Cordis 教程从零到接入真实 harness. 2026-08-14.DeepSeek Harness Cordis 教程从零到接入真实 harness-CSDN博客GitHub, deepseek-ai/deepseek-harness/docs/architecture.md. DeepSeek Harness Architecture.deepseek-harness/docs/architecture.md at master · deepseek-ai/deepseek-harness · GitHubGitHub, sockerch/DeepSeek-TUI/docs/SUBAGENTS.md. Sub-Agents documentation.DeepSeek-TUI/docs/SUBAGENTS.md at main · sockerch/DeepSeek-TUI · GitHub