DeepSeek Harness

deepseek_harness2026-10-29 11:03:47

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 强调运行能力的插件组合,并提供多种预设模式。两者都可用于编码,但比较时应分别考察工具接口、上下文管理、权限配置和实际任务表现,不能只依据所连接的模型名称判断。

参考资料

本页目录