DeepSeek Harness
什么是 DeepSeek Harness
一个开源、可自由组合的 Agent Harness，为构建与探索智能体而生
今天，DeepSeek Harness 的开发者预览版（v0.1 版本）面向全球 Harness 开发者开放测试，并同步以 MIT 协议开放源代码。作为早期预览版本，当前仍有许多细节有待改进和打磨，核心插件与基础接口也将在后续快速迭代演进。
DeepSeek Harness（dsh）采取「一切皆插件」的设计思路：我们采用插件式开放架构来构建 Agent Harness——模型、工具、技能、会话、沙箱、存储、循环、调度、UI 等所有 Agent 能力均由插件组合而成，可自由替换、灵活重组。
开发者无需改动 DeepSeek Harness 的源码本身，就能以插件的方式独立选择、替换或扩展其中的任一能力。
设计思路
一切皆插件
基于具有时空可组合性的 Cordis 插件系统
元框架只做两件事
Cordis 元框架只负责插件的加载与卸载以及依赖关系，Agent Harness 的所有具体组件都是不同的 Cordis 插件。
插件彼此协作
插件通过 Cordis 服务与事件彼此协作，并可以在配置层自由组合——替换一个提供方，就能改变整个产品的行为。
每一个能力都可被替换
模型适配器、工具注册表、会话日志、Agent 循环本身都是插件，因此每一部分都可以从配置层被替换。
不存在需要打补丁的内核
扩展 dsh 的方式是把插件挂载到其他插件旁边，各项注册都是副作用，会在其插件卸载时撤销。
运行模式
多种运行模式
针对不同的使用场景，每种模式默认加载不同的插件集合
完整的工具组合
提供完整的工具组合，开箱即用，适合绝大多数日常任务。
程序化工具调用
Programmatic Tool Calling：由模型生成的一段代码来组合多轮工具调用，把多次调用编排成一次程序化流程。
最小环境基准测试
仅保留一个 shell 工具与一个文件编辑工具，用于最小环境下的模型基准测试。
试验与创作新模式
可以检查当前运行时、在内存中试验 Cordis 插件，并据此组合和创作新的模式。
可观测性
每一次运行都有迹可循
模型看到的一切，都会写入仅追加（append-only）设计的会话日志
完整记录
系统提示词、思维链、工具调用与结果、子 Agent 调度，以及每一次上下文注入，全部写入会话日志。
按来源查看
在 Trajectory 视图中，你可以按来源查看这些信息，清晰还原每一次运行轨迹。
同一份事件流
恢复、分叉、检索与回放也都共享同一份事件流——模型可见即已记录。
可重建
抵达模型请求的一切都必须能从日志重建，并由运行时不变式断言这一点。
开始使用
快速开始
一条命令即可启动 Web UI
快速体验
在已安装 Node.js 开发工具链的系统中，使用 npx 命令快速启动 DeepSeek Harness 的 Web UI：
npx @deepseek-ai/dsh web源码安装
获取完整项目源码，并按照仓库说明完成安装：
git clone https://github.com/deepseek-ai/deepseek-harnessFAQ
常见问题解答
关于架构、模式、开源协议与社区的常见疑问。
DeepSeek Harness 是什么？
DeepSeek Harness（dsh）是 DeepSeek AI 开发的开源 agent harness（智能体框架）。它采用「一切皆插件」的架构，由 Cordis 驱动，把模型、工具、技能、会话、沙箱、存储、循环、调度、UI 等所有 Agent 能力都做成可自由组合的插件。
「一切皆插件」是什么意思？
意思是：Agent Harness 的所有具体组件都是不同的 Cordis 插件。Cordis 元框架只负责插件的加载与卸载以及依赖关系，插件通过 Cordis 服务与事件彼此协作，并可以在配置层自由组合。开发者无需改动源码就能独立选择、替换或扩展任一能力。
有哪几种运行模式？
四种：标准模式（完整工具组合）、PTC 模式（程序化工具调用）、极简模式（仅 shell + 文件编辑工具，用于最小环境基准测试）、创造模式（检查运行时、在内存中试验插件并创作新模式）。每种模式默认加载不同的插件集合。
如何快速体验？
在已安装 Node.js 的系统中运行 npx @deepseek-ai/dsh web，即可启动 Web UI（默认地址 http://127.0.0.1:3080）。也可以 git clone https://github.com/deepseek-ai/deepseek-harness 从源码安装。详见安装下载页。
运行过程可以被追踪吗？
可以。模型看到的一切都会写入仅追加（append-only）的会话日志，包括系统提示词、思维链、工具调用与结果、子 Agent 调度与每次上下文注入。在 Trajectory 视图中可按来源查看，恢复、分叉、检索与回放共享同一份事件流。
开源吗？可以商用吗？
完全开源，MIT License。可自由使用、修改、商用。仓库在 github.com/deepseek-ai/deepseek-harness。
如何参与插件生态共建？
欢迎通过 GitHub Discussions 提交反馈或 bug 报告；为你的插件仓库添加 dsh-plugin 话题便于被发现。详见联系我们。
现在是稳定版本吗？
目前是开发者预览版（v0.1），正在快速迭代，未来将出现破坏兼容性的变更。核心插件与基础接口也将在后续快速演进，欢迎反馈与建议。
什么是 Agent Harness？
Agent Harness 是运行与编排智能体的框架，负责模型、工具、会话、沙箱、循环与调度。详见什么是 Agent Harness。
DeepSeek Harness 和 Claude Code / Codex / OpenCode 有什么区别？
dsh 是 MIT 开源、一切皆插件的 Agent Harness 框架，可自由替换模型、工具、沙箱；Claude Code、Codex 为闭源编码智能体，OpenCode 为开源编码智能体。详见对比页。
加入共建
一起探索智能上限，
共建 DSH 插件生态。
DeepSeek Harness 目前的 v0.1 版本只是一个起点，我们期待与全球开发者一起，
在开源、开放、可复用、可组合的基础设施之上，共同探索智能上限。
诚邀全球 Harness 开发者共建 DSH 插件生态。