DeepSeek Harness是什么
DeepSeek Harness 是杭州深度求索人工智能基础技术研究有限公司（DeepSeek）于 2026 年推出的开发者预览版开源 Agent 开发框架，官方定位为”一切皆插件”的智能体运行时环境。该框架基于 Cordis 插件系统构建，将模型、工具、技能、会话、沙箱、存储、循环、调度、UI 等所有 Agent 能力全部插件化，开发者无需改动源码即可在配置层自由替换、组合或扩展任一能力。DeepSeek Harness 的核心设计理念是”Agent = Model + Harness”，即模型提供智能灵魂，Harness 赋予 Agent 理解环境、使用工具并在真实场景中持续工作的能力。框架提供标准、PTC、极简、创造四种运行模式，覆盖从完整编码 Agent 到最小化基准测试的多种场景，并以 MIT 许可证完全开源，支持通过 npx 一键启动 Web UI 或从 GitHub 克隆源码安装，面向全球 Harness 开发者开放测试。
DeepSeek Harness的主要功能
- Cordis 插件系统基于 Cordis 内核构建，内核仅负责插件的加载、卸载和依赖关系管理，不承载具体 Agent 能力，所有能力通过 Cordis 服务与事件机制彼此协作。
- 全能力插件化模型、工具、技能、会话、沙箱、存储、循环、调度、UI 等全部 Agent 能力均由独立插件提供，开发者可在配置层选择、替换或扩展任一能力，无需修改框架源码。
- Trajectory 会话日志模型看到的一切内容均写入仅追加设计的会话日志，包括系统提示词、思维链、工具调用与结果、子 Agent 调度及每一次上下文注入，支持按来源查看。
- 事件流恢复与回放会话恢复、分叉、检索与回放共享同一份事件流数据，开发者可以完整追溯每一次 Agent 运行的决策过程。
- 标准模式功能完整的编码 Agent，支持文件编辑、Shell、文件与网页检索、Skills、计划、目标、子代理和工作流，提供全套工具组合。
- PTC 模式具备标准模式全部能力，并通过 Code Mode SDK 呈现工具，让模型用一个 TypeScript 程序组合多步操作，实现多轮工具调用的代码化编排。
- 极简模式仅提供持久 bash 与 str_replace_editor 两个工具，用于最小化环境下的模型基准测试，排除多余干扰因素。
- 创造模式用于创建自定义 Agent preset，具备标准模式全部能力，并提供运行时检查、插件实验和 preset 创作指导，支持在内存中试验 Cordis 插件。
- Web UI 快速启动安装 Node.js 后通过 npx @deepseek-ai/dsh web 命令即可启动图形化界面，无需复杂配置。
- 源码安装支持通过 git clone https://github.com/deepseek-ai/deepseek-harness 获取完整项目源码，按仓库说明完成安装部署。
- dsh-demo 演示环境内置创造模式演示入口，用户可描述想要构建的内容，系统引导完成自定义 Agent preset 的创作流程。
如何使用DeepSeek Harness
- 准备运行环境确保本机已安装 Node.js 运行时环境，这是通过 npx 启动 Web UI 或运行源码安装的前提条件。
- 快速体验启动在终端执行 npx @deepseek-ai/dsh web 命令，框架将自动拉取依赖并启动 Web UI 界面，进入开发者预览版测试环境。
- 或选择源码安装执行 git clone https://github.com/deepseek-ai/deepseek-harness 克隆完整仓库，按照仓库 README 中的说明完成依赖安装与环境配置。
- 选择运行模式根据任务需求在标准模式、PTC 模式、极简模式或创造模式中进行选择，标准模式适合完整编码任务，极简模式用于基准测试。
- 配置插件组合在配置层选择需要启用的模型、工具、技能、存储等插件，替换或扩展默认组合，无需修改任何源码。
- 启动 Agent 会话在选定模式下启动 Agent，通过 Web UI 或命令行接口与 Agent 交互，观察其工具调用与任务执行过程。
- 查看 Trajectory 日志在 Trajectory 视图中按来源查看系统提示词、思维链、工具调用结果等完整运行轨迹，进行调试或回放分析。
- 创作自定义模式在创造模式中检查当前运行时、在内存中试验 Cordis 插件，组合并创作新的 Agent preset，导出后供后续使用。
DeepSeek Harness的核心优势
- 一切皆插件架构模型、工具、UI 等所有能力均可独立替换与重组，彻底打破传统 Agent 框架的模块耦合，开发者可自由拼装最适合自身场景的能力组合。
- 零源码配置扩展在配置层即可完成能力选择与替换，无需深入框架源码，大幅降低二次开发门槛，让非核心开发者也能定制专属 Agent。
- 完整运行可追溯仅追加设计的会话日志记录模型看到的一切内容，Trajectory 视图按来源展示，恢复、分叉、检索与回放共享同一事件流，调试效率极高。
- 多模式覆盖全场景从功能完整的标准模式到仅双工具的极简模式，再到支持代码化编排的 PTC 模式，一套框架满足开发、测试、基准评测多种需求。
- 开源开放生态基于 MIT 许可证完全开源，提供 GitHub 仓库、开发者文档、社区插件与 Cordis 论文，全球开发者可共同参与生态建设。
- 创造模式赋能创新支持在内存中试验 Cordis 插件并组合新 preset，配合运行时检查与创作指导，加速自定义 Agent 的迭代验证周期。
DeepSeek Harness的适用人群
- Agent 应用开发者需要构建定制化智能体的技术团队，可利用插件化架构快速组合模型、工具与 UI，避免从零搭建基础设施。
- 大模型研究人员需要进行模型基准测试的科研人员，极简模式提供仅含 bash 与 str_replace_editor 的最小化环境，确保测试结果纯净可复现。
- AI 工具链工程师负责企业内部 AI 工具集成与运维的工程师，可通过配置层替换模型或工具插件，适配不同业务场景的合规与性能要求。
- 开源社区贡献者希望参与 Agent 框架生态建设的开发者，可基于 Cordis 插件规范开发新能力插件，通过社区插件渠道分享给全球用户。
- 技术架构决策者评估 Agent 开发框架选型的技术负责人，可通过创造模式快速验证框架扩展性，结合 Trajectory 日志评估运行透明度。
- AI 产品原型设计师需要快速搭建 Agent 产品 Demo 的产品经理或设计师，利用 npx 一键启动和预设模式，在数分钟内产出可交互原型。
效果点评
DeepSeek Harness 在 Agent 开发框架领域展现出鲜明的设计哲学，将”一切皆插件”从口号落实为可操作的配置层能力，这使其在灵活性和可扩展性上具备显著优势。四种运行模式的划分精准对应开发、编排、测试、创作四类典型场景，尤其是极简模式为模型基准测试提供了标准化的纯净环境，这在同类框架中并不多见。Trajectory 日志的仅追加设计与事件流共享机制，让 Agent 运行的每个决策步骤都清晰可查，对调试复杂多轮任务极具价值。作为开发者预览版，其核心插件和基础 API 仍处于持续迭代阶段，生产环境稳定性有待社区验证。整体而言，DeepSeek Harness 适合追求高度定制化 Agent 方案的技术团队，其开源策略和插件生态有望吸引大量开发者参与共建。
常见问答
DeepSeek Harness 是免费使用的吗？
DeepSeek Harness 以 MIT 许可证完全开源，开发者可以免费获取源码、自由使用和修改。项目通过 GitHub 公开仓库分发，并提供 npx 快速启动方式，无需付费即可体验全部功能。
DeepSeek Harness 和传统 Agent 框架有什么区别？
传统框架通常将模型、工具、UI 等模块固化在核心代码中，而 DeepSeek Harness 基于 Cordis 插件系统将所有能力插件化，开发者无需改动源码即可在配置层替换或组合任意能力，实现真正的模块化自由拼装。
DeepSeek Harness 适合新手开发者吗？
新手可以通过 npx @deepseek-ai/dsh web 一键启动 Web UI 快速上手，标准模式提供完整工具组合可直接使用。若需深度定制，则需了解 Cordis 插件机制，建议先阅读开发者文档和社区插件示例。
DeepSeek Harness 支持哪些运行模式？
框架提供四种模式：标准模式（完整编码 Agent）、PTC 模式（TypeScript 代码编排工具调用）、极简模式（仅双工具基准测试）和创造模式（自定义 preset 创作），覆盖从开发到测试的多种需求。
DeepSeek Harness 的数据安全如何保障？
框架采用仅追加设计的会话日志记录所有运行数据，开发者可完全掌控日志存储位置。由于是开源项目，数据流向透明可控，企业可根据自身安全策略配置沙箱和存储插件。
