DeepSeek Harness 深度解析：一切皆插件的下一代 Agent 框架

一句话概括：DeepSeek 官方开源的智能体（Agent）开发框架，把「模型、工具、人设、沙箱、界面」全部插件化，让你像搭积木一样组装属于自己的 AI 助手。

文章目录

一、为什么需要关注 DeepSeek Harness

这两年大模型能力突飞猛进，但真正让模型「干实事」的是外面的壳——Agent 框架。你给它工具、给它指令、给它执行环境，它才能读代码、跑命令、改文件、调接口。

然而市面上的 Agent 框架普遍存在几个痛点：

  • 能力焊死：内置工具列表写死，想加一个工具得改源码、重新编译；
  • 场景割裂：写代码用一个工具，做研究用另一个工具，跑自动化任务又要换一套，配置各不兼容；
  • 扩展成本高：普通用户很难定制「人格设定」「工具权限」「运行沙箱」，开发者则要面对大量重复造轮子。

DeepSeek Harness 给出的答案是六个字：一切皆插件（Everything is a Plugin）。

二、DeepSeek Harness 是什么

DeepSeek Harness 是 DeepSeek 官方开源的 Agent 框架与运行时（Harness 一词本意就是「驾驭、装备」，官方用它强调：框架负责驾驭模型，而不是替你做决定）。

项目 信息
官方仓库 github.com/deepseek-ai/deepseek-harness
官方站点 deepseek.com/harness
核心口号 Everything is a Plugin（一切皆插件）
许可证 MIT
当前阶段 0.1.0-rc 系列（开发预览版，迭代很快）
核心包 @deepseek-ai/dsh（提供 dsh 命令行）
桌面端 dsh-desktop（Electron 桌面壳）
底层架构 基于 Cordis 插件框架

它的定位可以理解为：一个「可编程的 Agent 运行时」。模型、工具、人格（Persona）、技能（Skill）、沙箱、工作流、甚至交互界面，统统以插件形式存在，可以自由装卸、组合、替换。

三、核心设计理念：一切皆插件

3.1 插件化到什么程度？

在 DeepSeek Harness 里，几乎你能想到的每一层都是插件：

  • 模型层：接入 DeepSeek 官方 API，也支持其他兼容模型，模型本身就是可替换的插件；
  • 工具层：Bash、PowerShell、文件读写与编辑、代码执行、Web 搜索、提问用户……每个工具都是独立插件；
  • 能力层：子代理（Subagent）、工作流（Workflow）、目标驱动（Goal）、技能（Skill）、任务看板，都是插件；
  • 环境层：文件沙箱、命令沙箱、MCP 客户端（接入外部工具生态），都是插件；
  • 交互层：Web GUI、TUI 终端界面、Headless 无头模式，是不同 profile（配置文件档案）的组合。

3.2 Profile：插件的「组合配方」

Harness 引入了一个非常工程化的概念——Profile。一个 Profile 就是一份 YAML 配置，声明「我要启动哪些插件、以什么顺序叠加、覆盖哪些参数」。官方内置了三种：

Profile 说明
web 启动本地 Web 图形界面（dsh web）
tui 启动终端交互界面
headless 无头模式：dsh --profile headless "一句话任务"，执行完打印结果退出

你还可以通过 --patch xxx.yml 在官方配置之上再叠加自己的覆盖层，实现「官方底座 + 个人定制」的分层配置，互不污染。

3.3 为什么基于 Cordis

Cordis 是 Koishi 社区出品的插件化框架，以「依赖注入 + 插件生命周期 + 配置分层」见长。Harness 选择它做底座，等于把成熟的插件工程经验直接继承过来：插件可以声明依赖、可以按需加载、可以在运行时热替换，开发者不需要从零设计插件协议。

四、能力全景盘点

把 Harness 的能力摊开来看，可以分成下面几大块：

能力分类 具体内容
🛠️ 工具链 Bash 持久终端、PowerShell（Windows）、文件读写/搜索/编辑（str_replace_editor 风格）、代码执行
🔒 沙箱 文件沙箱分级：只读 / 工作区可写 / 完全访问；命令在受限环境中执行，降低误操作风险
👥 多 Agent 子代理（Subagent）后台并行干活；Workflow 编排大规模多 Agent 流水线；Ralph 循环等新鲜玩法
🎯 目标驱动 Goal 工具支持「一次下达、多轮自主推进」的长期任务；后台任务（Jobs）可挂起/恢复/终止
🧩 技能 Skill 系统：把提示词 + 工具用法打包成可复用技能，按需加载
🔌 生态接入 内置 MCP 客户端，直接接入 MCP 工具生态（数据库、浏览器、设计工具等）
📝 会话工程 上下文压缩（Compaction）、Token 计量（Token Meter）、会话轨迹（Trajectory）回放、会话标题自动生成
🖥️ 多形态 Web GUI / TUI / Headless / 桌面端（Windows、macOS、Linux）
🎭 人格预设 Agent Preset 预设系统，一套人设 + 工具白名单打包成可切换的模式

其中几个值得单独展开：

4.1 多 Agent 协作

Harness 把「一个 Agent 单打独斗」升级成了「Agent 团队」：主 Agent 可以派生子代理并行研究、独立写代码；Workflow 工具则支持写脚本批量编排几十上百个子代理做审计、迁移、多角度验证等重活，全部异步调度。

4.2 长期任务与后台 Jobs

普通对话是一次性的，Harness 的 Goal 机制支持把「一个长期目标」交给 Agent 自动多轮推进，中途可以暂停、续跑、调整；配合 Jobs 机制，任务在后台运行，浏览器关了也不影响执行（如任务看板类插件的典型用法）。

4.3 会话工程

长会话最怕上下文爆炸。Harness 内置 Compaction（压缩历史）、Token Meter（精确计量消耗）、轨迹回放（复盘 Agent 每一步干了什么），把「用着用着就乱」的体验问题当成一等公民来解决。

五、快速上手

5.1 安装

方式一：npm 全局安装（会提供 dsh 命令）：

# 需要较新的 Node.js 环境（建议 LTS 或更高）
npm install -g @deepseek-ai/dsh

方式二：直接下载桌面端安装包（dsh-desktop，支持 Windows / macOS / Linux），图形化安装、双击启动，适合不想碰命令行的用户。安装包从官方 GitHub Releases 页面获取。

具体安装步骤以官方 README 为准，各平台略有差异。

5.2 配置模型

需要准备一个可用的 API Key（DeepSeek 开放平台申请，或其他兼容模型服务）。可以通过环境变量注入：

export DEEPSEEK_API_KEY=sk-xxxxxxxx

也可以直接在 Web 界面 / TUI 的设置页填写，保存后即生效。

5.3 启动

# 启动本地 Web 图形界面（默认在浏览器打开，地址形如 http://127.0.0.1:xxxxx）
dsh web

# 终端交互界面
dsh --profile tui

# 无头模式：一句话任务，跑完即退出
dsh --profile headless "帮我把这个目录下的代码跑一遍测试，并输出结果摘要"

5.4 安装插件

插件管理走 pnpm，dsh plugin 命令会转发给对应 Profile 目录下的 pnpm：

# 给 tui profile 安装一个插件
dsh plugin --profile tui add <插件包名>

# 卸载 / 查看依赖
dsh plugin --profile tui remove <插件包名>
dsh plugin --profile tui why <插件包名>

更多插件可以通过 Web 界面的插件市场浏览、一键安装。

六、CLI 一览（官方帮助原文整理）

dsh 的设计很有意思：它只负责「启动哪个 Profile、叠加哪些 patch」，其余参数原样透传给被启动的应用。官方帮助里的几个典型用法：

dsh --profile web                          # 启动 Web profile（等价于 dsh web）
dsh --profile headless "run the tests"     # 无头模式：回答一个任务，打印结果后退出
dsh --profile tui --patch ./extra.yml      # 用自定义叠加层启动 TUI
dsh --profile tui --resume <session>       # 恢复指定会话
dsh --profile web --help                   # 查看 Web 应用自己的参数
dsh plugin --profile tui add <package>     # 为 TUI profile 安装插件

另外还有两个调试利器：

dsh --profile web --dump-config            # 打印最终组合出来的配置树（含用户层与 patch）
dsh --profile web --dump-default-config    # 打印官方内置配置树（不含用户覆盖）

对想深度定制的人来说，--dump-config 基本等于「把整个框架的装配清单打印给你看」。

七、生态：插件市场与社区

Harness 开源后社区响应很快，目前已经能看到三类生态：

  1. 官方内置插件族：@deepseek-ai/dsh-* 系列，覆盖 bash、pwsh、fs、sandbox、subagent、workflow、goal、skill、MCP client、compaction 等，全部以独立 npm 包发布，按需组装；
  2. 社区精选清单：awesome-deepseek-harness 整理了快速入门、资源推荐、精选插件与工具，是了解生态的入口；
  3. 典型社区插件（举例）：
    • dsh-ssh：SSH 远程运维插件，主机管理、远程执行、文件上传下载、端口隧道、集群并发执行；
    • dsh-task-board：任务看板插件，多列看板管理任务，支持 cron 定时任务，浏览器关了 Host 仍继续执行；
    • dsh-desktop-launcher：桌面启动器，一键生成桌面快捷方式、优雅退出；
    • 各种 Agent 预设（Preset）插件：把「人设 + 工具白名单 + 工作区绑定」打包成一键切换的模式，例如社区流行的「锚定模式」类预设。

八、适用场景

  • 开发者日常：在仓库里跑一个 Agent，让它读代码、改文件、跑测试、做代码审查；
  • 自动化运维：配合 SSH 类插件，做多服务器批量巡检、部署、日志排查；
  • 长期任务自动化：Goal + Jobs + 任务看板，实现「睡前下任务、醒来收结果」；
  • 研究调研：子代理并行搜索、多角度交叉验证，最后汇总成报告；
  • 工具链整合：通过 MCP 把数据库、浏览器、设计软件接进同一个 Agent；
  • Agent 产品研发：把 Harness 当底座，用插件方式快速拼出自己的 Agent 产品。

九、局限与注意事项

客观说几点（避免被捧杀）：

  • 仍在早期：目前处于 0.1.0-rc 阶段，API 和插件协议可能频繁变动，生产环境落地需评估；
  • 上手有门槛：虽然提供了图形界面，但要玩转「插件 + Profile + patch」这套体系，最好有点命令行基础；
  • 资源消耗：跑在本地，长会话、多子代理会消耗较多内存与 API 额度（token 计量功能可以帮你盯住成本）；
  • 权限安全：沙箱能降低风险但非万能，danger-full-access 等宽权限模式要谨慎授予。

十、总结

DeepSeek Harness 的价值不在于「又多了一个 Agent 框架」，而在于它把 Agent 的开发范式从「改源码」变成了「拼插件」：

  • 模型、工具、人设、沙箱、界面全部可插拔；
  • Profile + patch 让「官方底座」与「个人定制」优雅分层；
  • 内置多 Agent、目标驱动、MCP、会话工程等完整能力矩阵；
  • 背靠 DeepSeek 官方，MIT 开源，社区生态正在快速生长。

如果你正在寻找一个「开放、可扩展、能真正长在自己手里的 Agent 框架」，DeepSeek Harness 值得你花一个下午把它跑起来。

参考链接

# 人工智能
Logo
DeepSeek技术社区

欢迎加入DeepSeek 技术社区。在这里，你可以找到志同道合的朋友，共同探索AI技术的奥秘。

更多推荐

初识智能体

在过去两年中，几乎所有人都体验过大语言模型（如 ChatGPT、Claude、DeepSeek）的强大能力：写周报、润色邮件、解答编程疑难。被动响应：你问一句，它答一句。如果你的 Prompt 没有写清楚约束条件，它无法主动追问或修正目标。知行脱节：大模型能用流畅的文字告诉你“如何部署一个高可用 K8s 集群”，但它无法替你登录服务器敲下命令、查看报错日志并自动回滚。信息孤岛：大模型的知识止步于预

avatar DeepSeek技术社区

DeepSeek总结的时间旅行者的主键

来源：https://www.pgedge.com/blog/the-time-traveler-s-primary-key。

avatar DeepSeek技术社区
cover

Windows 下部署 New API 中转站全过程实录（含 6 个真实踩坑）

avatar DeepSeek技术社区