DeepSeek Harness 是什么
DeepSeek Harness（简称 dsh）是 DeepSeek 开源的 Agent Harness 框架，采用"一切皆插件"的架构设计。模型、工具、技能、会话、沙箱、存储、循环、调度、UI 等所有 Agent 能力均以插件形式实现，开发者无需修改框架源码即可替换或扩展任意一层。框架基于 Cordis 插件元框架构建，提供标准、PTC、极简、创造四种运行模式，并将模型看到的全部信息写入仅追加的会话日志，支持恢复、分叉、检索与回放。以 MIT 协议开源，适合需要深度定制 Agent 运行时的开发者。
DeepSeek Harness 的主要功能
- 一切皆插件架构： 模型、工具、Skills、沙箱、存储、调度、UI 等 Agent 能力均以插件形式存在，可根据项目需求自由组合和替换。
- Cordis 插件系统： 基于 Cordis 构建插件底层架构，由 Cordis 负责插件加载、卸载和依赖管理，不同插件通过服务与事件机制协同工作。
- 多种 Agent 运行模式： 内置标准模式、PTC 模式、极简模式和创造模式，适配完整 Agent 应用、程序化工具调用、模型基准测试及插件实验等不同场景。
- 程序化工具调用： PTC（Programmatic Tool Calling）模式允许模型生成代码，通过代码组合多轮工具调用，处理更复杂的 Agent 执行流程。
- Agent 运行轨迹追踪： 采用仅追加的会话日志保存 Agent 运行事件，可记录系统提示词、模型推理、工具调用、子 Agent 调度和上下文注入等信息。
- 会话恢复与分叉： Agent 的恢复、分叉、检索及回放共享统一事件流，方便开发者分析、调试和复现 Agent 的执行过程。
DeepSeek Harness 的适用场景或人群
- AI Agent 开发者： 用于搭建支持模型、工具、Skills 与沙箱协作的智能体系统，并根据项目需求自由组合运行组件。
- AI 应用工程师： 可作为 Agent Runtime 或 Harness 基础设施，构建代码 Agent、研究 Agent、自动化 Agent 等应用。
- 模型研究人员： 极简模式仅保留 Shell 和文件编辑工具，可用于测试不同模型在统一 Agent 环境中的实际表现。
- 插件开发者： 可以围绕 Cordis 开发模型、工具、存储、沙箱或其他插件，扩展 DeepSeek Harness 的能力边界。
- 企业 AI 团队： 适合需要自定义模型、工具权限、执行环境和数据存储方式的 Agent 系统研发与内部平台建设。
DeepSeek Harness的产品定价
DeepSeek Harness 本身完全免费，以 MIT 协议开源，可自由使用、修改与分发。框架不含模型推理能力，实际运行时需要自行配置模型供应商，使用 DeepSeek 官方 API 时按其 API 定价计费，接入其他供应商或自定义 OpenAI 兼容端点时按对应服务商定价计费，具体以各家官网为准。
如何使用 DeepSeek Harness
- 准备运行环境： 在电脑或服务器中安装 Node.js 开发工具链，为 DeepSeek Harness 提供基础运行环境。
- 快速启动 Web UI： 执行
npx @deepseek-ai/dsh web，即可快速启动 DeepSeek Harness 的 Web UI，体验基础 Agent Harness 功能。默认访问地址为http://127.0.0.1:3080 - 选择运行模式： 根据实际需求选择标准模式、PTC 模式、极简模式或创造模式，不同模式会自动加载对应的默认插件组合。
- 配置模型与插件： 根据项目需求添加或替换模型、工具、Skills、沙箱、存储和调度等 Cordis 插件，组合自己的 Agent 环境。
- 查看运行轨迹： 通过 Trajectory 视图查看 Agent 的上下文、工具调用、子 Agent 调度等运行记录，用于分析和调试任务执行过程。
- 源码部署与开发： 需要进行深度定制时，可克隆 DeepSeek Harness GitHub 源码，并根据项目说明完成本地安装及插件开发。完整说明见 https://github.com/deepseek-ai/deepseek-harness
常见问题
Q：DeepSeek Harness 是免费的吗？
A：框架本身免费且以 MIT 协议开源，但运行 Agent 需要接入模型服务，模型调用费用由所选供应商收取。
Q：只能搭配 DeepSeek 的模型使用吗？
A：不是。官方文档除 DeepSeek API 外，还覆盖其他供应商以及自定义 OpenAI 兼容端点的配置方式，模型适配器本身也是可替换的插件。
Q：DeepSeek Harness 和 Claude Code、Codex CLI 这类编码 Agent 有什么区别？
A：后者是面向终端用户的成品 Agent 应用，DeepSeek Harness 更偏向底座框架，强调每一层都能被开发者替换和重组，默认自带的 Web UI 与工具集只是其中一种组合方式。
Q：现在可以用于生产环境吗？
A：官方明确说明当前为开发者预览版，正在快速迭代，会出现破坏兼容性的变更，建议先用于试验与评估。
Q：如何参与插件生态共建？
A：可将自研插件开源，并为仓库添加 dsh-plugin 主题以便被检索；反馈与问题可通过项目的 GitHub Discussions 提交。