DeepSeek Harness 2026：一切皆插件 — 开发者预览版完全指南
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。
目录
- 什么是 DeepSeek Harness？
- 「一切皆插件」的设计哲学
- DeepSeek Harness 的四种运行模式
- 追记式会话日志与 Trajectory 视图
- 架构：Profile、Bundle 与核心包
- 如何开始使用 DeepSeek Harness
- 为 DeepSeek Harness 开发插件
- DeepSeek Harness 与其他 Agent Harness 对比
- 常见问题解答
- 总结
什么是 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/（cli 与 web 两个应用）和 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.yml。web 与 headless 两个 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 提供服务。之后的工作流非常简单：
- 配置模型：打开 Settings → Models，输入 DeepSeek API 密钥并保存。无需重启服务器，模型路由立即可用。模型配置指南还支持其他提供商与自定义 OpenAI 兼容端点。
- 选择工作区：点击 Choose workspace，添加启动
dsh的项目目录并选中。未选择工作区之前，会话编辑器不可用。 - 运行任务：启动会话并发送提示词。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.json 的 dsh 字段中声明：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 架构的思考，「一切皆插件」的设计都值得研究——而现在，它向所有人开放。
浙公网安备 33010602011771号