收藏!小白/程序员快速入门大模型Agent Harness深度解析

DeepSeek Harness 中 AGENTS.md 与 Skills 的注入机制与协同实践 在大语言模型应用开发中,系统提示与上下文窗口管理是核心工程问题。AGENTS.md 作为常驻系统级指令,注入系统提示区域,确保项目级行为约束始终生效;Skills 则采用渐进式披露机制,按需加载能力包,避免上下文膨胀。两者协同实现了行为一致性与技能复用的平衡,广泛应用于代码生成、项目配置、团队经验沉淀等场景。理解其加载优先级与触发机制,是构建高效 AI 辅助开发流程的关键。 阅读详情

本文深入解析了DeepSeek Harness的架构设计,强调其“一切皆插件”的理念,将Agent的运行时结构分解为可组合组件,包括提示词、模型、工具、Session、沙箱等。文章详细介绍了Cordis框架如何驱动插件树,以及Profile、Bundle和Patch在运行时配置中的作用。此外,还探讨了持久事实与实时控制的分离,以及能力接缝的设计。对于希望理解大模型Agent运行时结构并希望深入学习的大模型初学者和程序员来说,本文提供了宝贵的见解。

图片

2026 年 8 月 13 日,DeepSeek 正式公开了 DeepSeek Harness。官方把它描述为一个开源 Agent Harness,并用一句很醒目的话概括它的设计:Everything is a plugin,一切皆插件。

这句话很容易被理解成“又一个支持插件的 AI 编程工具”,但读完代码和架构文档后,我认为它真正值得关注的地方不是多了几个插件接口,而是把通常写死在 Agent 产品内部的部分都变成了可组合组件:

提示词

模型、工具、Skill、Session、沙箱、文件系统
Agent Loop、子 Agent、工作流、后台任务,甚至 Web UI

换句话说,DeepSeek Harness 想开放的不是某个工具栏,而是 Agent 的运行时结构本身。

项目说明
内容类型开源项目架构解读
适合读者已经知道 LLM、工具调用和 Agent 基本概念,希望理解 Harness 内部结构的读者
阅读时间约 15-20 分钟
官方状态Developer Preview,官方明确提示会有破坏兼容性的变更
npm 版本@deepseek-ai/dsh@0.1.0-rc.6
源码锚点47f9438
资料核对日期2026-08-14
本文边界静态源码与架构分析;不比较模型能力,不把预览版当作生产承诺

名称提醒

GitHub 上存在其他同名或近似项目。本文讨论的是 deepseek-ai/deepseek-harness,也就是 DeepSeek 官方账号在 2026 年 8 月 13 日宣布开放 Developer Preview 的仓库。

一分钟概览

  1. DeepSeek Harness 不是新模型,而是负责组织模型、工具、上下文、状态、权限和执行环境的 Agent 运行时。

  2. 它同时提供可运行的 dsh 应用和可用于构建新 Agent 产品的底层组件,不能简单等同于“DeepSeek 版 Codex”。

  3. “一切皆插件”的基础是 Cordis:插件向共享 Context 注册服务和事件,并用可撤销副作用管理生命周期。

  4. 一个运行中的 dsh 不是固定程序,而是由 Profile、Bundle、用户 Patch 和临时 Overlay 叠出的插件树。

  5. 它把持久事实与实时控制分开:Session Event 负责回放,agent/* 事件负责正在发生的协调。

  6. Agent Loop 只是一项可替换服务。一次 Turn 可以包含多个 Step,每个 Step 是一次模型请求及其工具调用。

  7. 文件系统、Shell、沙箱、持久化和子 Agent 都按照“定义、提供方、消费方”的能力接缝组织。

  8. 这套架构的优势是可替换、可观察和可实验;代价是概念多、组合复杂,而且当前版本没有兼容性承诺。

  9. 对多数只想使用 AI 编程工具的人,Codex 或 Claude Code 仍然更直接;DeepSeek Harness 更值得 Agent 基础设施开发者研究。

图片

图 1:DeepSeek Harness 把模型、工具、Session、沙箱、循环和界面组装成可替换的 Agent 运行时

图 1:DeepSeek Harness 的核心信号不是“又多了一个聊天界面”,而是 Agent 运行时的各个组成部分都进入同一套插件生命周期。

  1. 先分清模型、Agent 和 Harness

理解这个项目,第一步是把三个经常混在一起的概念分开。

1.1 模型负责生成下一步

大语言模型接收消息和工具描述,然后生成文本或工具调用。它可以提出:

提示词

读取 package.json
运行测试
修改某个文件
继续分析失败日志

但模型本身并不拥有你的文件系统,也不会天然保存 Session、限制命令权限或保证失败后能够恢复。

1.2 Agent 把模型接入行动循环

Agent 通常会重复下面的过程:

提示词

组装上下文
  -> 请求模型
  -> 解析工具调用
  -> 执行工具
  -> 把结果送回模型
  -> 判断是否继续

有了这个循环,模型才从“回答问题”变成“连续完成任务”。

1.3 Harness 管理循环周围的现实

真正进入工程环境后,只有循环还不够。系统还要回答:

  • 模型可以看见哪些文件和说明?
  • 哪些命令可以直接运行,哪些动作必须审批?
  • 工具调用怎样限时、取消和记录?
  • 上下文过长时怎样压缩?
  • Session 中断后从哪里恢复?
  • 多个子 Agent 怎样创建、隔离和停止?
  • Web UI、CLI 和 SDK 如何观察同一段执行?

负责这些问题的,就是 Harness。

图片

图 2:模型、Agent Loop 与 Harness 三层关系

图 2:模型决定候选动作,Agent Loop 驱动动作与反馈,Harness 则管理状态、权限、生命周期和外部执行环境。

这也是为什么我不太认同把 DeepSeek Harness 简化成“DeepSeek 版 Claude Code”或“DeepSeek 版 Codex”。仓库确实带有 Web UI、Headless Profile、工具和编程 Agent 能力,但它同时暴露了比普通终端产品更低的一层:开发者可以替换 Loop、文件系统、持久化和子 Agent Provider,再组装自己的应用。

  1. “一切皆插件”到底是什么意思

很多软件都说自己支持插件,通常指的是:主程序固定,第三方可以增加命令、主题或工具。

DeepSeek Harness 的范围更彻底。它的架构文档明确写道,模型适配器、工具注册表、Session 日志和 Agent Loop 本身都是插件。代码库中还能看到:

  • packages/llm
    :模型适配器与 Token 计量;
  • packages/core
    :Session、系统提示词、工具和 Agent Loop;
  • packages/fs
    、shell、subprocess:文件与进程能力;
  • packages/sandbox
    、interaction:执行隔离、权限和审批;
  • packages/skill
    、mcp、hooks:能力扩展与外部兼容;
  • packages/subagent
    、workflow、jobs:委派、工作流和后台任务;
  • packages/web
    、host、client:界面和远程调用。

这里的关键不是包多,而是这些包遵守同一种组合方式。一个工具插件不需要导入“默认 Agent Loop”的具体实现;它只依赖工具注册服务。一个 Shell 工具也不必知道命令最终在本机、沙箱还是远程环境执行。

这会产生一种很重要的工程效果:

替换能力提供方时,尽量不修改它的消费方。

例如,文件系统和子进程如果共同切换到远程沙箱,Bash、持久终端和 LSP 可以继续消费原来的接口,而不必各自维护一套 E2B 专用分支。

不过,“一切皆插件”不等于“系统没有核心”。Cordis 运行时、共享 Context、服务名称、事件语义、Session Event 词汇和包约定仍然构成稳定地基。更准确的理解是:

DeepSeek Harness 把产品行为从一个难以替换的中心类,迁移到一组受统一生命周期约束的插件之中。

  1. Cordis:插件树下面的元框架

DeepSeek Harness 由 Cordis 驱动。官方把 Cordis 称为“时空可组合”的元框架,并提供了对应的设计论文仓库。如果不理解 Cordis,dsh 的大量目录会显得像过度拆包;理解之后,会发现这些包在重复表达五个概念。

3.1 Plugin:一段可挂载行为

插件可以提供服务、注册事件监听器、增加工具或挂载其他插件。它不是静态模块清单,而是一个有加载、等待、重载和卸载过程的运行单元。

3.2 Context:服务容器和作用域

服务通过稳定键进入共享 Context,例如:

提示词

ctx.llm
ctx.tools
ctx.sessions
ctx.agents
ctx.shell
ctx.subagents

插件依赖服务键,而不是依赖某个具体类。这让同一个消费方可以面对不同 Provider。

3.3 Inject:用依赖声明启动顺序

插件通过 inject 声明自己需要哪些服务。所需服务没有准备好时,插件保持等待;服务就绪后再启动。

因此,配置文件中的排列顺序并不等于运行时启动顺序。真正的顺序来自依赖关系。这比手工在一个大入口文件里安排“先初始化 A,再初始化 B”更适合频繁替换的插件树。

3.4 Typed Event:在不知道对方实现时协作

Cordis 提供四种事件分发模式:

模式作用
emit同步广播事实,不等待返回值
parallel并行等待多个观察者
serial按顺序执行并收集单一决策
waterfall像中间件一样包装下游,可改写或短路

其中 waterfall 对 Agent 特别重要。agent/pre-step、agent/request、tools/pre-execute 和 tools/post-execute 都可以被策略插件包裹:有的只记录,有的改写输入,有的拒绝继续。

3.5 Effect:注册必须能够撤销

工具、服务、监听器和提示词片段都被视为副作用。插件卸载时,这些注册需要一并撤销。服务被替换后,依赖它的插件可以停止,再基于新服务重启。

图片

图 3:Cordis 用 Context、Inject、Event 和可逆 Effect 组成插件生命周期

图 3:插件并非一次性执行脚本,而是带作用域和清理语义的运行单元。可撤销副作用是热替换不留下残余注册的前提。

所谓“时空可组合”,可以先用一个不那么抽象的方式理解:

  • 空间上
    ,Context 决定一个插件能看到哪些服务,以及能力属于全局还是某个 Agent;
  • 时间上
    ,Fiber 和 Effect 决定插件什么时候生效、依赖变化时如何重启、卸载时怎样清理。

这也是 Cordis 比普通依赖注入容器多出来的部分:它管理的不是一张静态对象图,而是一棵会变化的运行时插件树。

  1. dsh 是一棵组装出来的插件树

DeepSeek Harness 没有把 Web、CLI 和 Headless 的所有能力硬编码在一个启动流程里。一个实际运行的 dsh 由三类配置叠加而成。

4.1 Profile:一个具名应用

Profile 表示用户实际启动的组装,例如 Web 或 Headless。它保存所使用的 Bundle、Profile 自己的插件和 Patch。

4.2 Bundle:一组可分发能力

dsh-base 提供模型适配器、工具、持久化、沙箱、审批、设置、凭据和遥测等基础能力;dsh-web-app 在它上面加入浏览器应用;dsh-headless 则加入一次性任务运行器,不启动 Web 服务。

4.3 Patch 与 Overlay:最后决定实际树

各层按顺序叠加:

提示词

Profile 指定的 Bundle
  -> Profile 的 cordis.patch.yml
  -> Harness Home 的 cordis.patch.yml
  -> 命令行 --patch Overlay

Patch 通过稳定 id 找到配置项,替换它的完整配置,或者插入新插件。这意味着“换一个 Provider”并不是进入主程序打补丁,而是改变插件树的一条装配记录。

图片

图 4:Profile、Bundle 和 Patch 叠加成运行时插件树

图 4:Profile 是应用配方,Bundle 是能力组合包,Patch 是部署和用户对配方的覆盖;最终产物才是运行中的插件树。

这种结构带来很强的可定制性,也带来第一个明显代价:配置不再只是几个开关,而是在描述一棵具有依赖、作用域和生命周期的程序。对于插件作者,这是能力;对于普通用户,则可能是额外认知成本。

  1. 它最值得学习的地方:持久事实与实时控制分离

很多 Agent 框架把“发生过什么”和“现在该做什么”都塞进同一个内存状态对象。程序运行时看起来简单,一旦需要恢复、Fork、回放或多界面同步,状态含义就会变得含混。

DeepSeek Harness 明确区分三类事件。

5.1 Session Event:可以回放的持久事实

turn/start、step/start、user/message、assistant/chunk、assistant/message、tool/call、tool/result 和 turn/end 会进入仅追加的 Session 日志。

这些事件回答:

提示词

过去到底发生了什么?
重新加载后应该恢复出什么历史?
UI 怎样重建当时的流式输出?
Fork 应该从哪个边界开始?

5.2 Agent Event:只负责活跃运行时协调

agent/pre-step、agent/request、agent/status、agent/turn-stopping 等事件携带正在运行的 Agent、Inbox、取消信号和控制决策。

这些事件回答:

提示词

下一步是否允许开始?
模型请求是否需要改写?
当前 Agent 是 idle 还是 running?
自然停止前还有没有插件要求继续?

它们不是历史事实的替代品。需要重建 transcript 的客户端应该消费 Session Event,而不是假设实时 Agent Event 能够重放。

5.3 Capability Event:对某项能力附加策略

tools/pre-execute、tools/post-execute、fs/* 等事件让策略靠近对应能力,不必让所有扩展都导入 Agent Loop。

这一分层背后有一句很硬的仓库不变量:

模型可见,当且仅当已经记录。

任何真正进入模型请求的内容,都必须可以从 Session 日志重建。新增一项模型可见上下文,不能只在请求发送前临时拼接,还需要定义相应的持久事件。

这条规则看起来繁琐,却直接服务于上下文审计、Session 恢复和结果复现。对于 Agent 系统,它比“我们记录了大部分日志”严格得多。

  1. Turn、Step 与 Agent Loop

在 DeepSeek Harness 中:

  • Step
    :一次模型请求,加上这次请求产生的工具调用;
  • Turn
    :从领取用户输入开始,到系统不再欠下后续工作为止,可以包含多个 Step。

简化后的生命周期如下:

提示词

领取 Inbox 输入
  -> turn/start
  -> agent/pre-step
  -> step/start
  -> 组装提示词与工具 Schema
  -> agent/request -> llm/stream
  -> assistant/message
  -> tools/pre-execute
  -> tools/execute
  -> tools/post-execute
  -> tool/result
  -> step/end
  -> 仍有工具结果或 steering?继续下一 Step
  -> agent/turn-stopping
  -> turn/end

图片

图 5:DeepSeek Harness 的 Turn、Step、模型请求、工具调用与持久事件关系

图 5:控制钩子可以阻止或改写下一步;真正抵达模型和工具的事实则写入 Session Event,供 UI、恢复和回放使用。

这里有几个不太显眼、但很成熟的设计判断。

6.1 Inbox 不只有普通追问

输入可以进入 next-turn 或 next-step:

  • followup
    等待一个新的 Turn;
  • steer
    在当前运行的下一个安全 Step 介入;
  • inject
    只加入上下文,不主动唤醒 Agent。

这比“运行中再发一句话”更精确,因为系统需要明确消息什么时候能够被模型看到,以及取消后它是否还应保留。

6.2 停止输出不等于任务完成

模型不再调用工具,只能说明本轮自然停止。agent/turn-stopping 仍可以让目标驱动器、验证器或 Hook 决定是否继续。

6.3 Loop 不是不可替换内核

ctx.agentLoop 是一项服务,默认 Loop 实现公开的 Agent 接口。外部插件依赖 agent 服务,而不是直接依赖默认 agent-loop 包。理论上可以更换驱动策略,同时保留 Session、工具和 UI 等其他组件。

  1. Capability Seam:比“接口抽象”多一步

DeepSeek Harness 用 Capability Seam 描述可替换能力。一个完整 Seam 包含三个角色:

提示词

Service Definition:声明稳定接口
Service Provider:实现本地、远程或其他版本
Consumer:把能力暴露给 Agent 或其他组件

只声明一个 TypeScript 接口,还不能算完整接缝;系统必须同时知道谁提供它、谁消费它,以及替换 Provider 后哪些组件会重新绑定。
以 Shell 为例:

提示词

ctx.shell
  定义:shell 能力
  Provider:bash-local / bash-sandbox / pwsh-local
  Consumer:Bash 工具 / PowerShell 工具 / Hook Bridge

再看 Subagent:

提示词

ctx.subagents
  Provider:进程内新 Agent、Session Fork、ACP、Codex、Claude Code、dsh SDK
  Consumer:subagent 工具、控制工具、工作流工具

这说明 DeepSeek Harness 的目标并不只是“让 DeepSeek 模型调用几个子 Agent”。它甚至可以把 Codex 或 Claude Code 放到统一 Subagent 接口之后,由上层编排选择 Provider。

图片

图 6:能力接缝把稳定定义、可替换提供方和消费方分离

图 6:插件化的重点不是每个包都很小,而是替换 Provider 时,Consumer 继续面对同一个能力定义。

这也是项目最有研究价值的部分:它没有把“本地文件系统”“DeepSeek 模型”“进程内子 Agent”当作永远成立的产品事实,而是把它们当作某个部署下的 Provider 选择。

  1. 它不是只服务 DeepSeek 模型

虽然项目名是 DeepSeek Harness,官方模型配置文档已经包含 DeepSeek、Anthropic、OpenAI 和自定义 OpenAI 兼容端点。

这与插件架构是吻合的:DeepSeek 提供默认模型体验,但 ctx.llm 是适配器注册表,模型 Provider 不是整个 Harness 的身份边界。

同样,仓库提供 Web UI、Headless Bundle、TypeScript SDK、ACP 以及 Python SDK。它既想成为一个可以直接运行的 Agent,也想成为其他 Agent 产品的组件库。

这两种目标可以互相促进:可运行产品会逼迫底层抽象面对真实问题。但它们也可能产生张力:普通用户希望默认值稳定简单,框架开发者则希望每一层都可以替换。未来版本能否同时守住两类体验,是我认为最值得观察的地方之一。

  1. 自修改能力很吸引人,也最需要克制

仓库里有一组 tool-cordis 工具,允许 Agent 检查运行时服务和事件,并动态定义、运行或停止新的 Cordis Package。它展示了一个很有想象力的方向:

提示词

Agent 发现缺少能力
  -> 检查当前运行时
  -> 编写一个插件
  -> 挂载插件
  -> 获得新的模型可见工具

但官方工具目录也明确说明,这组工具不会默认进入发行版的插件树,必须主动启用,因为动态 Package 可以访问真实运行时。

这是正确的边界。插件化会降低扩展成本,却不会自动降低扩展风险。第三方插件可能接触:

  • 模型请求和会话内容;
  • 文件系统与子进程;
  • API 密钥和凭据引用;
  • 工具调用与审批流程;
  • UI 和持久化数据。

因此,“一切皆插件”的安全含义不是“可以放心安装更多插件”,而是:

插件本身已经成为 Agent 的软件供应链,需要来源审查、最小权限、明确配置和可追踪的生命周期。

  1. 和 Codex、Claude Code 应该怎样比较

比较三者时,最容易犯的错误是列一个功能表,然后数谁的勾更多。DeepSeek Harness 仍处于预览期,Codex 与 Claude Code 也在快速变化,这种比较很快失效。

更稳定的比较方式是看它们优先开放哪一层。

当前主要形态

DeepSeek Harness:可运行 Agent + 可重组元框架

Codex:App、CLI、IDE、Cloud、SDK 与 App Server

Claude Code:CLI、Desktop、IDE、Web 与 Agent SDK

主要内部抽象

DeepSeek Harness:Cordis 插件树、Service、Event、Effect

Codex:Thread、Turn、Item、工具与审批事件

Claude Code:Session、工具、Hook、Skill、Subagent 与工作流

扩展重点

DeepSeek Harness:连 Agent Loop、Session、文件系统和 UI 都可替换

Codex:Skills、Plugins、MCP、Hooks、SDK/App Server 集成

Claude Code:CLAUDE.md、Rules、Skills、Hooks、Subagents、SDK

最值得研究的点

DeepSeek Harness:运行时本身的可组合性

Codex:完整工程 Agent 产品和客户端协议

Claude Code:长任务 Harness、动态工作流和成熟的指导体系

Codex 的 App Server 让开发者把线程、轮次、审批和流式事件嵌入自己的客户端;Anthropic 则持续公开长任务 Harness和动态工作流的实践。

DeepSeek Harness 的差异不在于“首次发明 Harness”,而在于它选择把 Agent 产品的大部分内部构件纳入同一套插件元框架,并以 MIT 许可证公开完整代码。

这也意味着三者并不一定是互斥关系。DeepSeek Harness 已经包含 Codex 与 Claude Code 的 Subagent Provider 和 Hook Bridge;Codex、Claude Code 也都能通过 CLI、SDK 或协议与外部编排器协作。未来 Agent 工具链更可能出现“一个 Harness 调用另一个 Harness”,而不是每个人只生活在单一产品里。

  1. 这套架构解决了什么

11.1 让实验不必不断 Fork 主循环

新的压缩策略、工具策略、模型 Provider 或子 Agent 实现可以挂到明确接缝,而不是持续修改一个越来越大的 Loop。

11.2 让运行时状态更容易解释

持久 Session Event 和实时控制事件分离后,UI、SDK、回放与 Agent 协调各自消费适合自己的数据。

11.3 让能力替换成为装配问题

本地与远程文件系统、不同持久化后端、不同模型和不同 Subagent 传输都可以通过 Provider 选择完成。

11.4 让卸载和重载具有正式语义

注册是 Effect,依赖由 Inject 声明,插件卸载时撤销自己的贡献。这比“动态 import 一个模块,然后希望它没有留下全局状态”更可控。

  1. 它没有自动解决什么

12.1 插件多不代表默认组合就正确

框架提供替换能力,但一个实际 Agent 是否可靠,仍取决于默认 Prompt、工具描述、权限、验证、模型和任务环境。

12.2 事件完整不代表任务已经验收

日志可以证明系统执行过什么,却不能单独证明结果满足业务目标。独立验证器、确定性测试和人工判断仍然需要存在。

12.3 可组合不代表低复杂度

服务作用域、事件顺序、Waterfall 短路、配置 Patch、Effect 清理和 Provider 生命周期都需要严格约定。项目自己的开发文档和测试门禁非常密集,也从侧面说明维护这类架构并不轻松。

12.4 开源不等于已经适合生产

官方 README 明确写着 Developer Preview,并警告未来会出现破坏兼容性的变更。npm 在公开当天已经连续发布多个 RC,也说明接口仍在快速收敛。npm 当前版本应当在实际采用前重新核对。

12.5 SDK 示例的安全边界不能忽略

官方 Python SDK 最小组合目前使用 danger-full-access,文档要求放在可丢弃 Checkout 或容器里,并说明持久 PTY 组合不支持 Windows Agent。这是示例的明确边界,不应被改写成“安装后即可安全接管本机工程”。

  1. 谁应该现在关注它

值得深入阅读

  • 正在设计 Agent Runtime、工具执行层或多 Agent 编排器;
  • 需要在同一产品中切换本地、沙箱与远程执行环境;
  • 正在研究 Session 回放、Fork、Steering 和上下文可审计性;
  • 希望把 Codex、Claude Code 或其他 Agent 放到统一委派接口之后;
  • 想理解插件生命周期怎样超越普通依赖注入。

暂时不必迁移

  • 只是需要一个成熟的 AI 编程助手;
  • 项目没有替换 Agent Loop、文件系统或持久化层的真实需求;
  • 团队需要稳定 API 和长期兼容承诺;
  • 没有能力审计第三方插件及其文件、网络和凭据权限。

对第一类读者,DeepSeek Harness 是一份很少见的完整架构样本。对第二类读者,现在更适合观察,而不是因为“官方开源”就立刻迁移工作流。

  1. 源码阅读地图:六个切口就够了

DeepSeek Harness 的 Monorepo 很大,不适合从 packages/ 目录逐个点开。若想验证本文的核心判断,可以按问题阅读,而不是按包名阅读。

“一切皆插件”依靠什么运行

建议先读:docs/cordis-primer.zh.md

阅读时抓住什么:Context、inject、四种事件分发和可撤销 Effect

默认产品是怎样组装出来的

建议先读:packages/bundle/base/cordis.patch.yml

阅读时抓住什么:每个 id 对应一条插件装配记录;行顺序不承担启动顺序

Session 为什么能够恢复和回放

建议先读:packages/core/session/README.zh.md

阅读时抓住什么:仅追加事件、序号、Fork 边界,以及模型可见内容的持久化要求

默认 Agent Loop 怎样驱动 Turn

建议先读:packages/core/agent-loop/README.zh.md

阅读时抓住什么:Agent 创建、恢复、停止、并行工具调用和有序清理

Provider 与 Consumer 怎样解耦

建议先读:docs/capability-seams.zh.md

阅读时抓住什么:沿 ctx.shell、ctx.fs、ctx.subagents 追踪定义、提供方和消费方

Agent 自修改的权限到底有多大

建议先读:packages/extensions/tool-cordis/README.zh.md

阅读时抓住什么:动态 Package 可触达的运行时表面,以及为什么它不进入默认插件树

这六处读完后,再沿服务名反向搜索 Provider,通常比顺序阅读整个仓库更有效。尤其要留意 README.zh.md、cordis.patch.yml 和测试文件:这个项目把许多不变量写在包级说明与组合测试里,公开 API 文件反而只是其中一部分。

  1. 我的判断

DeepSeek Harness 当前最重要的价值,不是给 Agent 用户增加一个新的选择按钮,而是把一个长期隐藏在产品内部的问题摆到代码层面:

当模型能力越来越接近时,Agent 产品的差异会越来越多地来自运行时怎样组织上下文、状态、工具、权限、恢复和扩展。

OpenAI 把这个方向称为 Harness Engineering;Anthropic 通过长任务、Hooks 和动态工作流不断展示 Harness 的影响;DeepSeek 这次给出的回答,则是一个以 Cordis 为底座的、接近“Agent 操作系统装配层”的开源实现。

我最认可它的三个决定:

  1. 模型可见内容必须可由日志重建。

这让上下文不再是请求发送前的一段魔法拼接。

  1. Loop 之外的能力也必须可替换。

文件系统、进程、持久化和 Subagent Provider 与模型同样重要。

  1. 注册必须能够撤销。

插件生命周期如果没有清理语义,热重载最终只会变成状态泄漏。

我目前最大的保留也有三个:

  1. “一切皆插件”会把很多简单修改提升为框架级装配问题;

  2. 同时服务最终用户和框架开发者,可能让默认体验与开放性互相拉扯;

  3. Developer Preview 阶段的快速变化,使现在写出的插件和配置都需要承担迁移成本。

所以现阶段最合理的态度不是急着给它贴上“Codex 替代品”的标签,而是把它当成一份公开的 Agent Runtime 设计提案:读它怎样定义状态,怎样组织扩展,怎样把实时控制与持久事实分开,再决定这些思想中哪些值得带回自己的系统。

最后

2026 年一晃已经过半,AI 大模型的热潮不仅没有降温,反而持续升温!

金融行业用大模型做风控、医疗依靠 AI 解析影像,电商、制造、教育各行各业,都在把 AI 融入日常业务。曾经热闹的 “百模大战”,早就告别单纯比拼模型参数,正式进入落地应用时代。

现在企业疯狂紧缺一类人才:懂业务、懂 AI、能做出可上线项目的大模型开发工程师,岗位缺口大,薪资待遇十分可观。

在这里插入图片描述

风口再好,不如手握高薪 offer 实在。行情火热,普通人、程序员该怎样从零入门大模型,抓住这波机会?

今天整理好【2026 最新版】AI 大模型全套免费学习资源,覆盖零基础入门、项目实战、理论知识、大厂面试,从基础一路进阶。所有资料分类归档,没有多余杂料,无套路免费分享给想要入局 AI 赛道的程序员与零基础小白!

👇👇扫码免费领取全部内容👇👇

在这里插入图片描述

1、大模型系统化完整学习路线

在这里插入图片描述

2、大模型经典书籍&文档

在这里插入图片描述

3、AI 大模型最新行业研究报告

在这里插入图片描述

4、企业级实战项目 + 完整配套源码

img

5、大厂大模型面试真题汇总

img

6、这些资料真的有用吗?

这份资料由我和鲁为民博士(北京清华大学学士和美国加州理工学院博士)共同整理,现任上海殷泊信息科技CEO,其创立的MoPaaS云平台获Forrester全球’强劲表现者’认证,服务航天科工、国家电网等1000+企业,以第一作者在IEEE Transactions发表论文50+篇,获NASA JPL火星探测系统强化学习专利等35项中美专利。本套AI大模型课程由清华大学-加州理工双料博士、吴文俊人工智能奖得主鲁为民教授领衔研发。

资料内容涵盖了从入门到进阶的各类视频教程和实战项目,无论你是小白还是有些技术基础的技术人员,这份资料都绝对能帮助你提升薪资待遇,转行大模型岗位。
在这里插入图片描述
在这里插入图片描述

这份完整版的大模型 AI 学习资料已经上传优快云,朋友们如果需要可以微信扫描下方优快云官方认证二维码免费领取【保证100%免费】

在这里插入图片描述

Harness架构深度解析:从零构建企业级AI Agent与DeepAgent实战 在AI大模型应用开发中,模型能力只是系统的一环,真正的复杂度来自上下文管理、工具调用与错误恢复等工程问题。Harness正是承担这一职责的“运行环境”,它将模型、工具与流程串联成可靠管道。随着Agent向DeepAgent演进,多层级决策循环与复杂任务编排对Harness提出了更高要求。理解Harness架构,是从原型走向企业级项目落地的关键一步。本文从零开始解析Harness的核心模块与设计原理,并结合工具协议、可观测性等实践,帮助开发者掌握构建可控AI Agent的工程方法论。 阅读详情

相关推荐

Agent 托管运行时:Session/Harness/Sandbox 三层架构解析

Agent 运行时(Agent Runtime)是支撑长流程、多工具、高可靠 AI 应用的底层基础设施,其核心在于解耦状态、执行与环境——Session 实现事件溯源的持久化会话管理,Harness 提供无状态、可验证的工具调度中枢,Sandbox 则通过按需隔离执行保障安全与成本效率。这一分层设计直击上下文溢出、凭证泄露、会话中断等生产级痛点,显著提升可观测性、可测试性与故障隔离能力。当前主流云厂商正加速构建模型中立或专属的托管 Runtime 层,推动 AI 工程从‘手造轮子’迈向标准化交付。本文深入剖

weixin_34174422的博客 334

重置密码解决MySQL for Linux错误 ERROR 1045 (28000): Access denied for user 'root'@'localhost' (using passwo

一般这个错误是由密码错误引起,解决的办法自然就是重置密码。假设我们使用的是root账户。1,停止mysql服务service mysqld stop2,找到my.cnf文件3,修改配置文件无密码登录vi /etc/my.cnf在最尾部加上skip-grant-tables保存(:wq)4,启动mysqlsystemctl start mysqld.service mysqld start5,登录m...

tanzhiyuantanzhiyuan的博客 7052

DeepSeek Harness 深度解析:为 Agent 开发补齐可控性短板

大模型应用正从单次问答走向复杂的自动化执行,AI Agent 与工具调用逐渐成为工程实践的核心场景。然而,许多开发者在构建 Agent 时发现,模型能够轻松完成演示,却难以稳定执行多步任务——循环失控、重复调用、上下文膨胀等问题频发。这背后的关键并非模型能力不足,而是缺少一层位于模型之上的流程控制机制。Harness 作为一种运行约束层,通过轮次限制、错误恢复、预算管理和可观测性设计,让 Agent 从自由生成变为边界内执行。从 API 调用到工具编排,从配置管理到异常隔离,Harness 为智能体系统提供

weixin_30357231的博客 403

deepseek-harness-desktop 仓库工程规则全解:双桌面工作区、锁定上游子模块与双包管理器边界

本篇技术指南围绕开源仓库 [AGENTS.md](https://link.gitcode.com/i/71cc90e9a2581189df8dcca0095a2749)(DSH Desktop repository rules)展开,它是本仓库对 Agent 与开发者暴露的唯一权威工程规则文件,完整规定了环境准备、构建验证命令、仓库拓扑、双桌面变体同步、包管理器隔离、兼容模式与提交纪律。读完本文

gitblog_00185的博客 940

DeepSeek Harness:开源Agent工程化装配架与插件机制解析

Agent开发正从原型验证走向工程交付,但多步推理、工具调用、上下文管理等复杂环节常让开发者陷入困境。DeepSeek Harness作为围绕大模型构建的工程装配架,以插件机制和确定性基础设施为核心,解决模型与外部系统连接的可维护性与可控性问题。本文从基础概念出发,解析其底层运行原理与插件设计逻辑,并演示如何通过配置文件快速搭建可部署的Agent智能体。理解这一框架,有助于开发者掌握Agent工程化的关键路径,在真实业务环境中实现稳定、可观测、可扩展的智能体应用。

weixin_34211761的博客 377

C#通过Aforge调用电脑摄像头(附代码)

C#标准库本身不带有能调用电脑摄像头的库,如果利用windows自身的API来实现的话,着实有些麻烦。Aforge这个第三方库能很好的实现调用、处理的功能。 PS:文末给大家分享了完整的项目源码,各位最好先下载下来,对照着来看 1、先看一下效果 2、Aforge介绍 AForge.NET是一个专门为开发者和研究者基于C#框架设计的,这个框架提供了不同的类库和关于类库的资源,还有很多应用程序例子,包括计算机视觉与人工智能,图像处理,神经网络,遗传算法,机器学习,机器人等领域。 3、我使用的开发环境 操作系统

weixin_44996090的博客 1万+

基于 Deepseek Harness 开发 agent 笔记

适用环境:AutoDL Linux 实例(本项目路径前置:你已在的 chat 页能用 DeepSeek 聊天目标:让大模型,而是作为调用 Skill、执行 bash、改文件。

weixin_42019995的博客 267

使用MeshLab高效对齐3D模型:从OBJ导入到坐标修正全流程

本文详细介绍了使用MeshLab高效对齐3D模型的全流程,涵盖从OBJ导入、坐标修正到最终导出的核心步骤。通过将模型中心归位至坐标原点,并利用主轴对齐功能快速摆正模型,为后续的3D打印、体素化等处理奠定精确的几何基础。

weixin_29313423的博客 93

【AI大模型】-DeepSeek Harness 深度解析

DeepSeek Harness 的插件体系是结构性的——连 Agent Loop 和会话日志都是插件,其他框架的插件是功能性的——在固定核心上扩展功能。这个差异决定了:如果你需要一个可以深度定制的 Agent 平台底座,dsh 是唯一选择;如果你只是需要一个能写代码的工具,Claude Code 和 Codex 目前更成熟。使用 Creator 模式,在运行时检查当前环境、实验 Cordis 插件、组合自定义运行模式。

【javatoai17819112191】→Java && python && AI Agent工程师 4597

全面讲解电子齿轮比与脉冲数计算

什么是编码器分辨率。

viixin的博客 1万+

FreeRTOS实战:STM32CubeMX配置USART+DMA实现高效串口通信(附完整代码)

本文详细介绍了如何使用FreeRTOS和STM32CubeMX配置USART与DMA实现高效串口通信。通过对比轮询、中断和DMA三种模式的性能差异,提供完整的STM32CubeMX配置步骤和代码实现,帮助开发者优化嵌入式系统的串口通信性能,显著提升数据吞吐量和系统响应速度。

weixin_29190169的博客 455

DeepSeek Harness保姆级实战:一文搞懂Agent Harness

DeepSeek Harness 是官方开源的 Agent 运行时框架,其核心价值在于将大模型能力转化为可执行任务的工作流(如代码分析/修改/测试)。与直接调用 API 不同,它通过插件化架构(Cordis)整合模型、工具、沙箱、会话等组件,支持 Standard/Code/Minimal/Creator 四种运行模式。本文详解其架构原理、Web UI/Headless/Python SDK 三种使用方式,并梳理权限控制、会话复用等实践要点。当前处于开发者预览阶段,适合需要定制 Agent 基础设施的团队。

CodeBlog-star 2442

VMD分子可视化实战:5个隐藏技巧让你的科研图像秒变顶刊级别

本文深入探讨了VMD分子可视化软件在科研图像美化中的5个高阶技巧,旨在帮助研究者将分子结构图提升至顶刊级别。内容涵盖原子色彩与材质的艺术化定制、沉浸式分子环境构建、专业构图与视角控制、数据驱动的动态可视化以及自动化工作流建立,通过精细的色彩映射、光照调整、周期性边界展示和脚本自动化,显著增强图像的科学叙事性与视觉冲击力。

weixin_29240343的博客 421

收藏必备!小白程序员轻松入门大模型:编码智能体与Agent harness详解

用一份可复制的 agent_config.json 加 mini_agent.py,30 分钟跑通编码智能体闭环。文章拆解 Agent harness 六大组件,并给出 TaoToken 三件套配置与 401、路径越界排障方法,帮程序员快速上手大模型编码。详见 https://taotoken.net/?utm_source=taotoken_aicg_blog_end

weixin_42600407的博客 218

PINN——加入物理约束的神经网络

【摘要】 基于物理信息的神经网络(Physics-informed Neural Network, 简称PINN),是一类用于解决有监督学习任务的神经网络,它不仅能够像传统神经网络一样学习到训练数据样本的分布规律,而且能够学习到数学方程描述的物理定律。与纯数据驱动的神经网络学习相比,PINN在训练过程中施加了物理信息约束,因而能用更少的数据样本学习到更具泛化能力的模型。本文主要解析这种神经网络以...

qq_39444290的博客 4584

论文阅读--射频电源在半导体领域的应用

射频电源(RF Power Supply)是能够输出300kHz~300GHz正弦波电压的高频交流电源,在半导体制造领域,射频电源的典型工作频率范围为400kHz∼60 MHz,主要由射频发生器(功率源)、匹配器及配套控制电路组件构成,其关键组件包括变压器与电抗器、晶闸管、绝缘栅双极型晶体管(IGBT)、钣金件、铜材及各种电子元器件。射频电源是刻蚀和薄膜沉积工艺的核心,主要用于产生等离子体,以增强气体反应活性,其性能直接影响反应腔体内等离子体的浓度、均匀性和稳定性。

伊丽莎白的学习之路 2337

收藏!小白/程序员快速入门大模型:三款AI Coding工具深度解析与实战指南

基于 VS Code 为界面的 IDE 型产品:Qoder、Kiro、Cursor、Trae、Windsurf非 VS Code 的原生 IDE 型产品:Zed、JetBrains(Qoder 插件),和上边同属 IDE 型产品独立 APP:Claude Desktop、Codex以终端为界面的 CLI / TUI 形态产品:Claude Code、Qoder CLI、Open Code、Qwen Code壳子不同,内核也不同。偏人机协同,你依然在写代码,AI 在旁辅助补全、生成和解释;

大模型研究中心 1511

【数据分享】2012-2022年全国及各城市POI(兴趣点)数据(超20G)

POI(一般作为Point of Interest的缩写,也有Point of Information的说法),通常称作兴趣点,泛指互联网电子地图中的点类数据,基本包含名称、地址、坐标、类别四个属性;随着互联网电子地图服务与LBS应用的普及,POI无论从概念范畴,还是从信息纵深都有了长足发展,互联网各个风口或火山口都和POI有一定关系,如O2O、电商、社交、互联网金融、共享经济等。

J_Giser的博客 2738

收藏!小白程序员必备:一张图看懂 AI Agent、OpenClaw 和 Harness,轻松入门大模型世界

本文从零开始介绍 AI Agent、OpenClaw 和 Harness 的概念及实际应用。Agent 是能自主完成任务的 AI 系统,OpenClaw 是智能体的操作系统,负责调度、管理和通信,而 Harness 是专业编程框架,用于构建复杂智能体应用。文章通过生活化类比和实际案例,帮助读者理解这三个概念的区别和适用场景,并提供技术选型决策树和实际应用场景对照表,帮助读者根据自身需求选择合适的工具。

2401_85375186的博客 710

精雕软件(JDpaint) 5.5 绿色版

精雕软件(JDpaint) 5.5 绿色版精雕软件(JDpaint) 5.5 绿色版精雕软件(JDpaint) 5.5 绿色版

怀旧版电脑GBC模拟器

再现原版GBC掌机的界面,电脑运行连游戏界面都一样大小,很怀旧,很真实,(英文版)强烈推荐,很小的文件,很难才找到的。

Hermes Agent深度解析:小白程序员轻松入门大模型自进化秘籍(收藏版)

本文深入探讨了开源AI项目Hermes Agent的创新设计,重点解析其"自进化"机制如何通过动态Skill生成和RL训练闭环实现长效能力提升。项目通过Prompt Engineering、Context Engineering和Harness Engineering三个维度的协同设计,在继承OpenClaw等现有方案优点的同时,创新性地实现了Agent的自主进化能力。文章详细对比了Hermes与其他Agent框架的差异,指出其在模型异构性、生态兼容性和记忆系统等方面的优势,特别分析了动态Skill生成机制

ajhddjangc的博客 241

大中型超市收银系统(可直接运行)

光步前台收银系统系统功能:商品销售、商品退货、挂单、收银员权限、会员销售、单品取消、整单取消、商品查询、脱机销售、脱机数据上传,基本资料下载,开钱箱、小票打印、收款结算,支持多币种付款方式(现金、储值卡、礼券、微信等),支持多种促销。运行环境:.net 4.0登陆信息用户名:1001 密码:123456内置商品信息,商品编码可输入00001000 - 00010000,测试效果相关功能键F5 结算 F9挂单 F11商品查询 F8退货 Insert单品取消 Del整单取消 F12开钱箱F2 会员 Ctrl+Z退出系统 Home 锁屏 相关源码待公开

深挖Harness Engineering——全方位深度解析

Harness Engineering(驾驭工程)是围绕 AI 智能体(Agent)设计和构建约束机制、反馈回路、工作流控制与持续改进循环的系统工程实践。它不优化模型本身,而是优化模型运行的环境。2025 年底,GPT-5.x、Claude Opus 4.x、Gemini 3.x 相继发布。换个更强的模型,对实际产出的提升,远不如把模型外面那一圈东西搞好来得猛。模型在静态 Benchmark 上的差距正在缩小,但真正的差距在任务越复杂、越长期时才会显现——核心指标是耐久性(Durability)

技术博客 350

汉书HE8,好用的汇编代码编写工具

汉书HE8,好用的汇编代码编写工具早期编写汇编代码所用功能强大

DeepSeek Harness 入门教程

2026年8月13日,DeepSeek推出开源Agent开发框架 DeepSeek Harness v0.1,核心定位为“Model + Harness = Agent”,通过插件化架构(基于Cordis元框架)实现模型与工具的无缝集成。其特点包括: 模块化设计:所有功能(模型适配、工具调用等)均以插件形式扩展,支持动态替换; 四种运行模式:覆盖开发、测试、自动化等场景,极简模式已用于模型基准测试; 轨迹记录:完整保存Agent运行日志,便于调试与溯源; 开发者友好:提供Node.js/Python支持,

智造编程 1712

DeepSeek Harness深度解析:从安装配置到Agent工作流实践

大模型应用开发正从简单的问答走向复杂的任务执行,但模型API、工具调用与评测脚本彼此割裂,本地模型和云端服务的切换也带来额外成本。DeepSeek Harness作为一个面向大模型应用与评测的工程框架,将模型接入、工具执行和任务评测封装为可插拔的工作流,通过统一的控制层让Agent开发不再重复造轮子。其“本地模型随便接”的能力,本质上依赖Ollama、vLLM等工具对OpenAI兼容接口的支持,只需修改api_base即可切换云端与本地推理服务。本文从环境准备、安装配置、核心流程拆解到Docker隔离运行,

weixin_33796205的博客 453

Agent Harness 深度解析:给大模型套上缰绳,让 AI 真正落地

大模型在对话场景中表现出色,但接入真实业务系统时却常因不可预测的行为而“翻车”,这正是 AI Agent 落地难的关键。工程化的核心在于为模型套上缰绳:通过工具注册、编排循环、记忆分层、护栏沙箱与可观测性设计,将大语言模型从概率系统改造成行为可控、结果可复现的执行引擎。Agent Harness 作为连接模型与业务系统的运行框架,正成为 AI 应用从 Demo 走向生产的基础设施。本文从概念到原理,结合手写实现与生产案例,剖析 Agent Harness 的核心部件、选型考量与调试技巧,为开发者提供一套可落

weixin_33402252的博客 210

Harness架构深度拆解:从零搭建企业级AI Agent运行时骨架

在AI大模型应用开发中,Agent正在从聊天机器人进化为能够自主决策、调用工具和执行多步任务的智能体。然而,仅靠提示词或API调用难以构建稳定的企业级系统,核心瓶颈在于缺乏统一的运行时控制层。Harness架构正是解决这一问题的关键,它作为Agent的编排骨架,负责模型调度、上下文管理、工具注册与循环控制,让大模型从单纯的文本接口升级为可监控、可容错的任务执行器。通过合理设计Harness,开发者可以快速搭建知识库问答、自动化运营、工单处理等场景的企业应用,并实现批量任务、性能观测与安全合规。本文以零基础视

weixin_34380948的博客 646
上一篇: 传统后端转AI开发?别一上来就啃大模型原理!收藏这份实用学习路线助你轻松入门
下一篇: 收藏!大数据工程师必备:轻松转型高薪大模型岗位的四大路径
冻感糕人~
博客等级 码龄3年 8926粉丝 2384原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值