DeepSeek Harness(命令名 dsh)是 DeepSeek AI 开源的 Agent Harness。它负责组合模型、工具与运行环境,提供可定制的 Agent 执行系统;编码 Agent 是它提供的一种具体形态。
项目采用 MIT 许可证。截至 2026 年 9 月 6 日,官方仍将其标记为开发者预览版,并提示可能发生不兼容变化。来源:官方仓库
核心设计
DeepSeek Harness 基于 Cordis 插件系统构建。内核负责插件的加载、卸载和依赖关系;模型接入、工具、Skills、会话、沙箱、存储、Agent 循环、调度和界面由插件提供。开发者通过配置选择与组合能力,也可以开发插件扩展系统。
这种设计把 Harness 本身变成可调整的运行环境。例如,编码任务可以组合文件编辑与 Shell 工具;研究不同运行策略时,可以替换工具组合或循环相关能力。来源:官方架构介绍
运行模式
| 模式 | 主要用途 |
|---|---|
| 标准模式 | 提供文件编辑、Shell、检索、Skills、计划、目标、子 Agent 与工作流 |
| PTC/Code 模式 | 通过 Code Mode SDK,让模型使用 TypeScript 程序组合多步工具操作 |
| 极简模式 | 使用持久 Bash 与 str_replace_editor,用于最小环境下的编码和模型评测 |
| 创造模式 | 检查运行时、试验 Cordis 插件并创作自定义 preset |
上述模式来自官方预览版说明,后续可能调整。来源:官方模式介绍
会话与运行记录
官方设计使用仅追加的会话日志记录模型上下文、工具调用及结果等运行信息,并提供 Trajectory 视图用于检查过程。恢复、分叉、检索与回放共享事件流,有助于分析 Agent 为什么采取某个动作。日志能够帮助追踪执行,但任务是否完成仍需依据测试或实际环境状态判断。来源:官方运行记录介绍
快速开始
安装 Node.js 后运行:
npx @deepseek-ai/dsh web
默认 Web UI 地址为 http://127.0.0.1:3080。之后按文档配置模型和工作环境。需要从源码运行时,可获取官方仓库:
git clone https://github.com/deepseek-ai/deepseek-harness.git
软件开源许可与所连接模型服务的认证、计费是不同事项。来源:官方 README
与 Pi Coding Agent 的区别
Pi Coding Agent 强调终端编码的小核心,通过扩展定制工作方式;DeepSeek Harness 强调运行能力的插件组合,并提供多种预设模式。两者都可用于编码,但比较时应分别考察工具接口、上下文管理、权限配置和实际任务表现,不能只依据所连接的模型名称判断。