惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

Google DeepMind News
Google DeepMind News
Microsoft Security Blog
Microsoft Security Blog
B
Blog
Martin Fowler
Martin Fowler
WordPress大学
WordPress大学
爱范儿
爱范儿
博客园_首页
博客园 - 聂微东
量子位
V
Visual Studio Blog
aimingoo的专栏
aimingoo的专栏
T
The Blog of Author Tim Ferriss
J
Java Code Geeks
小众软件
小众软件
大猫的无限游戏
大猫的无限游戏
OSCHINA 社区最新新闻
OSCHINA 社区最新新闻
N
Netflix TechBlog - Medium
F
Fortinet All Blogs
The Cloudflare Blog
T
Tailwind CSS Blog
G
Google Developers Blog
奇客Solidot–传递最新科技情报
奇客Solidot–传递最新科技情报
月光博客
月光博客
腾讯CDC

博客园 - 见路非道

Lumera 深度解读(2026):从一张图片到 Blender 可编辑 3D 场景——image to 3d 与 image to blender 全解析 Qwen3.8-Flash-Next(2026):Qwen Qwen4 预览版架构模型完整指南 Qwen3.8-27B(2026):Qwen 新 27B 视觉语言模型完整指南 DeepSeek Harness Agent Loop 2026:驱动每一轮对话的可替换插件内部解析 awesome design md(2026):Google DESIGN.md 精选集完整指南 DeepSeek V4 Pro 0813 完全指南(2026):价格、基准测试与 Fable 5 对比 2026 完整指南:生命路径计算器(Life Path Calculator)的每个数字到底意味着什么 Qwen 3.8 Max vs GLM 5.2 vs Kimi K3 vs DeepSeek V4 Flash(2026年):国产大模型四强全面对比 Love Meter 2026 完全指南:Lovemeter.xyz 的免费与付费功能,以及 Love Oracle 的神奇之处 Unlimited OCR(百度无限制 OCR)2026 完整指南:单次前向传播解析数十页文档的开源模型 Kimi K3 vs GLM 5.2 (2026年):中国两大开源旗舰大模型终极对比 PDF 转 Markdown 工具如何把复杂 PDF 变成干净的 Markdown:2026 年完整指南 如何使用 Garden Letters:2026 年 AI、音乐与私密分享的花信创作完整指南 Flag Tone:如何匹配旗子条纹颜色(2026完整指南) Mog Omegle 2026 完全指南:如何运行一场 AI PSL 颜值对比 Toon Tone:用更简洁、更易分享的色彩匹配游戏练习色彩记忆 CurateClick 2026年4月每周精选:发现、访问与创意AI Hy-MT1.5-1.8B-2bit:腾讯开源 574MB 能打败 72B 巨人的移动端翻译模型 Qwen3.6-35B-A3B 全面评测:阿里开源模型如何超越前沿级水平 SBTI 和 SBTI Skill 完全指南:Claude 驱动的超大型人格测试 Happy Horse:重新定义2026年AI视频生成的最强模型 OpenClaw Dreaming 完全指南 2026:AI 代理的后台记忆整合 Qwen3.6-Plus:阿里低调憋大招,百万Token上下文企业级AI旗舰发布 CurateClick 应用推荐(2026年3月22日版) 2026年完全指南:OpenClaw LCM 插件 — 再也不会丢失任何对话 ACE-Step 1.5:2026年开源AI音乐生成完全指南 用 OpenClaw 构建 CBT 疗法 Agent — 2026 年完整指南 Claude Code Telegram 官方插件:完整配置指南 2026 小米 MiMo-V2 系列完全指南 2026:Pro/Omni/TTS 三大模型全面解读 MiroThinker-1.7:改变深度研究的新一代SOTA开源AI研究代理
DeepSeek Harness 2026:一切皆插件 — 开发者预览版完全指南
见路非道 · 2026-08-13 · via 博客园 - 见路非道

DeepSeek Harness 2026:一切皆插件 — 开发者预览版完全指南

核心要点 (TL;DR)

  • DeepSeek Harness(CLI 名 dsh)于 2026 年 8 月 13 日向全球 Harness 开发者开放 v0.1 开发者预览版测试,并以 MIT 协议在 GitHub 上开源全部源码。
  • DeepSeek Harness 最重要的设计原则是「一切皆插件」:模型、工具、技能、会话、沙箱、存储、循环、调度、UI 等所有 Agent 能力均由 Cordis 插件组合而成,无需改动源码即可自由替换、灵活重组。
  • DeepSeek Harness 提供四种运行模式——标准模式、PTC 模式(程序化工具调用)、极简模式、创造模式,每种模式默认加载不同的插件集合。
  • 每一次运行都有迹可循:模型看到的一切都会写入追记式(append-only)会话日志,可在 Trajectory 视图中按来源查看;恢复、分叉、检索与回放共享同一份事件流。
  • 一分钟内即可体验 DeepSeek Harness:执行 npx @deepseek-ai/dsh web 即可在 http://127.0.0.1:3080 启动 Web UI。

目录

  1. 什么是 DeepSeek Harness?
  2. 「一切皆插件」的设计哲学
  3. DeepSeek Harness 的四种运行模式
  4. 追记式会话日志与 Trajectory 视图
  5. 架构:Profile、Bundle 与核心包
  6. 如何开始使用 DeepSeek Harness
  7. 为 DeepSeek Harness 开发插件
  8. DeepSeek Harness 与其他 Agent Harness 对比
  9. 常见问题解答
  10. 总结

什么是 DeepSeek Harness?

DeepSeek Harness 是 DeepSeek AI 开发的开源 Agent Harness。它位于大语言模型与 Agent 完成任务所需的工具、文件、环境之间,是承载智能体运行的基础设施层。与许多把组件写死的 Harness 不同,DeepSeek Harness 采取了一种截然不同的思路:每一项能力都是插件,Harness 本身只是插件的组合。

2026 年 8 月 13 日,DeepSeek Harness 团队宣布 v0.1 开发者预览版面向全球 Harness 开发者开放测试,并同步以 MIT 协议开放源代码。团队在官方微信渠道发布的公告中明确表示,v0.1 只是早期预览版本:当前仍有许多细节有待改进和打磨,核心插件与基础接口也将在后续快速迭代演进。团队正邀请全球 Harness 开发者共同建设 DSH 插件生态。

项目位于 github.com/deepseek-ai/deepseek-harness,基于 Cordis 插件框架构建,当前仓库版本为 0.1.0-rc.5。Monorepo 结构包含 apps/cliweb 两个应用)和 packages/(core、llm、mcp、sandbox、context、plan、goal 等数十个包),从中可以直观感受到 DeepSeek Harness 开箱即用的能力广度。

专业提示: DeepSeek Harness 处于开发者预览阶段,预计会有破坏性兼容变更。请固定你构建所依赖的版本,并在升级前关注 GitHub 仓库的发布说明。

「一切皆插件」的设计哲学

DeepSeek Harness 最重要的理念,在其官方文档中表述为:一切皆插件。整个架构建立在 Cordis 插件系统之上,而 Cordis 正是为时空可组合性(spatiotemporal composability)而设计的——这一编程范式在 Cordis 论文《A Programming Paradigm for Spatiotemporal Composability》中有详细阐述。

Cordis 扮演元框架的角色:它只负责插件的加载与卸载以及依赖关系管理。DeepSeek Harness 的所有具体组件——模型适配器、工具注册表、会话日志、乃至 Agent 循环本身——都是不同的 Cordis 插件。插件通过 Cordis 服务与类型化事件彼此协作,并可以在配置层自由组合。

这意味着开发者无需修改 DeepSeek Harness 的源码,就能独立选择、替换或扩展其中任一能力。想换模型提供商?替换模型插件即可。想换沙箱?替换沙箱插件。想要完全不同的 Agent 循环?挂载你自己的插件。DeepSeek Harness 没有需要打补丁的特权核心——你只需在其它插件旁边挂载一个新插件,注册效果会在插件卸载时干净地回滚。

最佳实践:DeepSeek Harness 的每一项能力都视为可替换的。在写自定义代码之前,先检查是否已有现成插件——这个生态系统的设计原则是「组合优于修改」。

DeepSeek Harness 的四种运行模式

针对不同的使用场景,DeepSeek Harness 提供四种模式,每种模式默认加载不同的插件集合:

模式 加载内容 适用场景
标准模式 完整的工具组合 日常 Agent 工作
PTC 模式 程序化工具调用(Programmatic Tool Calling)——模型生成一段代码来组合多轮工具调用 复杂的多步骤工具工作流
极简模式 仅保留一个 shell 工具与一个文件编辑工具 最小环境下的模型基准测试
创造模式 检查当前运行时、在内存中试验 Cordis 插件,并据此组合和创作新的模式 构建与测试新的插件组合

PTC 模式尤其值得关注。程序化工具调用是 DeepSeek Harness 的特色设计:模型不再逐次发起多个工具调用,而是生成一段代码,由这段代码编排多个工具调用的顺序。这减少了往返次数、提升了可靠性,也让模型能以更富表现力的方式组合工具。

创造模式对插件开发者同样极具价值。它允许你检查运行中的运行时、在内存中试验 Cordis 插件,并基于所学组合出新的模式——无需重启即可设计 DeepSeek Harness 的下一种配置。

追记式会话日志与 Trajectory 视图

DeepSeek Harness 最受开发者欢迎的特性之一是其可观测性。每一次运行都有迹可循:模型看到的一切——系统提示词、思维链、工具调用与结果、子 Agent 调度、每一次上下文注入——都会写入追记式(append-only)会话日志。

在 Trajectory 视图中,你可以按来源查看这些信息。由于日志是追记式的,任何内容都不会被静默改写,发生的事实被原样保留。恢复、分叉、检索与回放共享同一份事件流:你可以从断点恢复会话、向新方向分叉、检索历史记录,或通过回放理解发生了什么。

这一设计带来了实际的调试收益。当 Agent 运行出错时,DeepSeek Harness 的会话日志会精确展示模型在每一步看到了什么——确切的系统提示词、确切的工具输出、确切的上下文注入。对于构建生产级 Agent 的团队而言,这种级别的可追溯性意味着「知道」而非「猜测」。

架构:Profile、Bundle 与核心包

在内部,运行中的 DeepSeek Harness 是一棵在启动时按有序层级组合而成的插件树。两个概念组织这棵树:Profile 与 Bundle。

Profile 是存储在 Harness 主目录中的命名组合。它列出叠加的 Bundle、安装的外部插件,并保存用户自己的 cordis.patch.ymlwebheadless 两个 Profile 作为模板随附。Bundle 是 Cordis 配置行及其挂载代码的分发格式,Bundle 插入的任何内容都可被上层补丁覆盖。

所有 Profile 的基础层是 dsh-base,提供模型适配器、工具、持久化、沙箱与审批策略、设置、凭证、遥测。dsh-web-app 添加浏览器应用,dsh-headless 添加无服务器的单次运行器。你可以用以下命令查看机器实际启动的插件树:

dsh --profile web --dump-config

该命令输出的任何一行都可以用你自己的补丁替换。DeepSeek Harness 的核心包与职责清晰对应:

职责 ctx
core/session 追记式 SessionEvent 日志与内存存储 ctx.sessions
core/system-prompt 提示词分区与工具 schema 组装 ctx.systemPrompt
core/tools 作用域工具注册表与受控执行管道 ctx.tools
core/agent Agent 接口、实时注册表、agent/* 事件 ctx.agents
core/agent-loop 实现该接口的默认驱动 ctx.agentLoop
core/scope 每 Agent 作用域注册原语 库(无键)

如何开始使用 DeepSeek Harness

开始使用 DeepSeek Harness 只需几分钟。最快的路径是 Web UI:

npx @deepseek-ai/dsh web

该命令启动 Web UI,默认在 http://127.0.0.1:3080 提供服务。之后的工作流非常简单:

  1. 配置模型:打开 Settings → Models,输入 DeepSeek API 密钥并保存。无需重启服务器,模型路由立即可用。模型配置指南还支持其他提供商与自定义 OpenAI 兼容端点。
  2. 选择工作区:点击 Choose workspace,添加启动 dsh 的项目目录并选中。未选择工作区之前,会话编辑器不可用。
  3. 运行任务:启动会话并发送提示词。Agent 可以读写工作区文件、执行命令、委派工作并维护计划。Web UI 会在当前权限策略下需要审批的操作前征询确认。

如果希望从源码运行:

git clone https://github.com/deepseek-ai/deepseek-harness
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

dsh 进程以调用目录作为默认文件系统位置,全新的 Web UI 在添加工作区之前没有已选工作区。对于无头自动化,DeepSeek Harness 还提供无服务器的单次运行器 Profile,以及用于程序化调用的 Python SDK。

⚠️ 注意: dsh 的 Web UI 会在当前权限策略下需要审批的操作前征询确认。在运行不受信任的任务之前,请审慎配置权限策略。

为 DeepSeek Harness 开发插件

由于 DeepSeek Harness 中一切都是插件,插件开发就是主要的扩展路径。架构文档建议在编写插件之前先阅读 Cordis 入门与教程,因为服务、类型化事件与可逆效果这一框架模型是整个系统的基础。

DeepSeek Harness 的插件向共享上下文贡献服务、类型化事件与可逆效果。插件卸载时注册随之回滚,不会留下孤立状态。插件以 Bundle 形式分发,在 package.jsondsh 字段中声明:dsh.profile 列出 Profile 的 Bundle,dsh.bundle 指向 Bundle 的补丁文件。

插件作者的实际工作流是:先在创造模式中实验,检查运行时并在内存中测试 Cordis 插件;然后将插件打包为 Bundle;最后通过编辑 cordis.patch.yml 或传入 --patch 覆盖层将其挂载到 Profile。--dump-config 命令会显示机器启动时的确切配置行,让你始终清楚该补丁什么。

DeepSeek Harness 团队明确欢迎插件生态:公告邀请全球 Harness 开发者共同在开放、可复用、可组合的基础设施之上建设 DSH 插件生态。如果你开发了插件,可以为仓库添加 dsh-plugin 主题标签以提高可发现性。

DeepSeek Harness 与其他 Agent Harness 对比

DeepSeek Harness 与开发者们熟悉的 Agent Harness 有何不同?差异主要在架构层面:

维度 DeepSeek Harness 典型 Harness
架构 一切皆插件(Cordis) 单体核心 + 扩展
扩展路径 挂载插件,无需改源码 Fork 或补丁核心
可观测性 追记式会话日志 + Trajectory 视图 各不相同,往往不完整
运行模式 标准 / PTC / 极简 / 创造 通常只有一种
许可证 MIT,开源 各不相同
工具调用 经典 + PTC(代码组合调用) 通常只有经典方式

最关键的差异在于插件接缝。DeepSeek Harness 没有需要打补丁的特权核心——包括 Agent 循环本身在内的所有组件都可以从配置层替换。对于已经触到某个 Harness 扩展点上限的团队来说,这是实质性的区别。追记式会话日志也领先于多数替代方案——后者通常只记录工具调用,而不记录每一次上下文注入。

常见问题解答

Q: DeepSeek Harness 是免费开源的么?

A: 是的。DeepSeek Harness 以 MIT 协议开源,完整源码位于 github.com/deepseek-ai/deepseek-harness。v0.1 开发者预览版已于 2026 年 8 月 13 日向全球社区开放。

Q: 如何快速启动 DeepSeek Harness?

A: 在装有 Node.js 的终端中执行 npx @deepseek-ai/dsh web,Web UI 将在 http://127.0.0.1:3080 启动。随后在 Settings → Models 中添加模型 API 密钥并选择工作区即可。

Q: 「一切皆插件」在实践中意味着什么?

A: 意味着 DeepSeek Harness 的所有能力——模型、工具、技能、会话、沙箱、存储、循环、调度、UI——都是 Cordis 插件。你可以在不修改 DeepSeek Harness 自身源码的情况下选择、替换或扩展其中任意一项。

Q: DeepSeek Harness 的四种模式是什么?

A: 标准模式(完整工具集)、PTC 模式(模型编写代码组合工具调用的程序化工具调用)、极简模式(仅 shell 与文件编辑两个工具,用于基准测试)、创造模式(检查运行时并在内存中组合新模式)。

Q: 可以使用 DeepSeek 之外的模型吗?

A: 可以。模型配置指南支持其他提供商与自定义 OpenAI 兼容端点。模型适配器本身就是插件,设计上即可替换。

Q: DeepSeek Harness 可以用于生产环境吗?

A: 目前还不建议。v0.1 是早期开发者预览版,预计会有破坏性兼容变更。它非常适合实验、基准测试与插件开发,但生产依赖的团队应固定版本并持续关注仓库动态。

总结

DeepSeek Harness 带着一个大胆的判断进入 Agent 基础设施领域:Agent Harness 的正确架构,就是一切皆插件。通过基于 Cordis 构建、以 MIT 协议开源、提供四种运行模式与追记式会话日志,DeepSeek Harness 团队为开发者交付了一个开放、可观测、可组合到核心的 Harness。

v0.1 开发者预览版明确只是一个起点,而非终点。团队邀请全球 Harness 开发者在开放、可复用、可组合的基础设施之上共同建设 DSH 插件生态,而插件优先的设计让这份邀请落到实处:任何人都可以在其它插件旁挂载自己的插件,无需 Fork。

如果你在构建 Agent,下一步非常具体:克隆仓库,执行 npx @deepseek-ai/dsh web,然后在创造模式中花一小时实验插件。无论 DeepSeek Harness 最终成为你的生产 Harness,还是仅仅启发你对 Harness 架构的思考,「一切皆插件」的设计都值得研究——而现在,它向所有人开放。