给想弄懂 Agent 框架的人的实用指南

DeepSeek Harness
是什么?

DeepSeek Harness(命令行里叫 dsh)是 DeepSeek 开源的 Agent 运行框架:它包在模型外面,提供工具、会话、沙盒和插件系统——让模型不只是回答问题,而是能动手干活。

比如,对它说一句"每周五下午整理项目记录、生成周报",它到点自动跑完,成果以文档、表格、PDF 直接预览。官方给它的定位只有一句话:Everything is a Plugin,一切皆插件。

DeepSeek 官方 · MIT 开源 GitHub 26 万 Star 开发者预览 · 快速迭代 Web / 桌面端
terminal — dsh

体验一次任务

一个请求,在 Harness 里怎么跑

点击左侧环节,看官方架构文档描述的执行流程。正是这条流水线,把"会说话的模型"变成了"能干活的 Agent"。

session.jsonl — 事件流
PLUGIN 1 · 换脑子

模型适配器

开箱即接 DeepSeek 系模型(官方界面示例 DeepSeek-V41-Flash),适配器本身是插件,也能换成其他提供方的模型。

PLUGIN 2 · 给手脚

工具与审批

文件系统、终端、子进程、后台任务都是可插拔组件;执行要过 pre-execute → execute → post-execute 把关流水线。

PLUGIN 3 · 连循环

Agent 循环与会话

连 Agent 循环本身都是插件。会话日志是唯一事实源——session.jsonl,每次模型请求都能从日志完整重建。

大家在用 Harness 做什么

模型负责聪明,Harness 负责可靠

三个官方页面演示与社区里最常见的用法。它们是典型场景,具体效果取决于你接的模型与插件配置。

自动化定时任务

每周五 17:00,周报自己长出来

把"整理项目记录、生成周报"设成定时任务,到点后台执行,文档写好后直接在界面里预览——官方页面的同款演示。

用到 → ctx.jobs 后台任务 + 文档工具
代码终端

修问题、写功能、跑测试

让它读代码、改代码、运行测试、看报错再改——终端和文件系统工具由沙盒兜底,动作全程可审计。

用到 → ctx.shell / ctx.fs + 沙盒策略
查证文档

资料查证,标注来源

搜索、核对、给结论标注来源,输出成一篇结构化报告。整理资料、分析表格、制作汇报是官方列出的第一组用途。

用到 → 搜索工具 + 文档导出(docx / pdf)

以上为官方演示与社区典型用法,本站未复测 · 预览期能力变化较快,以官方文档为准。

为什么值得看

没有特权内核,
每个部件都能被换掉。

官方仓库的副标题就是理念:Everything is a Plugin——模型适配器、工具注册表、会话日志,乃至 Agent 循环本身,都是可插拔的组件。扩展方式只是"把插件挂到其他插件旁边",卸载时注册项自动撤销。甚至有一篇论文为这套范式背书:《A Programming Paradigm for Spatiotemporal Composability》。

01

一切皆插件

由开源插件系统 Cordis 驱动:服务、类型化事件、可逆副作用。替换提供方即替换产品形态——比如把文件系统与进程指向远程沙盒。

02

日志是唯一事实源

会话是只追加的事件日志(JSONL + zstd 压缩):"每个模型请求都必须能从日志重建"。取消是安全的,历史不会被悄悄改写。

03

生产级的配件

审批策略、沙盒、凭据、遥测都在第一层 dsh-base 里,可用 patch 整体替换;执行轨迹、工具调用详情、计时信息随时可查。

依据与事实

它到底是什么

出身
DeepSeek AI 官方出品2026 年 8 月开源,MIT 协议(杭州深度求索)
形态
TypeScript 编写 · 多形态应用Web UI、桌面端(macOS / Windows)、SDK、headless、ACP
架构
Cordis 插件系统驱动运行时是一棵插件树:profile → patch → overlay 逐层叠加
学术
有设计论文背书《A Programming Paradigm for Spatiotemporal Composability》(arXiv:2608.25512)
状态
开发者预览(Developer Preview)官方明说会有破坏性变更;迭代极快,提交数已超 2.3 万
热度
GitHub 26 万 Star · 3.1 万 Fork2026 年 10 月实测;有第三方报道称开源两日即破 9 万

你需要提供什么

STEP 1 · 10 秒

启动它

装有 Node.js 就够了,一行命令起一个带完整界面的 Agent。本机会自动打开浏览器。

❯npx @deepseek-ai/dsh web
STEP 2 · 约 2 分钟

配一次模型,直接开聊

在设置里填模型凭据(开箱即接 DeepSeek 系模型,也能配其他提供方),然后像聊天一样布置任务。

❯http://127.0.0.1:3080

不想用命令行?桌面端提供 macOS(Apple 芯片)与 Windows(64 位)安装包;想改源码就 git clone + pnpm install。官方建议运行前先读仓库里的 SAFETY.zh.md 安全说明。

安全与可靠性设计在哪里

  • 审批策略——工具执行前可被策略拦下,"自动授权审查"插件(实验性)帮你审 Agent 的每个动作。
  • 沙盒——启动进程前由沙盒包装 argv,写入被限制在沙盒根目录内;沙盒提供方可整体替换(如远程沙盒)。
  • 把关流水线——每个工具调用都经过 pre-execute → execute → post-execute,任一环节可拦截。
  • 日志不可变——会话事件只追加、已提交路径不重命名不删除;取消请求不会污染历史。
  • 可观测——开发者工具可查看执行轨迹、工具调用详情与计时信息,排查问题不用猜。
  • 凭据独立——设置与凭据是独立插件,不散落在配置文件里。

官方的诚实提醒:项目处于开发者预览阶段,"未来将出现破坏兼容性的变更"。给 Agent 的权限、接的模型、装的插件都值得审慎——生产环境建议隔离评估后再上。

接下来继续了解

常见问题

"Harness"这个词到底是什么意思?+
直译是"挽具"——套在马身上让人能驾驭马的那套装备。工程语境里指包在模型外面的运行时骨架:模型负责生成"下一步做什么",harness 负责给模型工具、记住上下文、真正执行动作、并保证安全。模型是马,Harness 是那套挽具。
它和网页版 DeepSeek / ChatGPT 有什么区别?+
网页聊天只能"说";Harness 让模型"做":读写文件、跑终端、后台批处理、定时任务,成果以 docx、xlsx、HTML、PDF 直接预览。而且整套东西运行在你自己的机器上,过程有日志、有轨迹、可审计。
免费吗?开源吗?+
工具本身 MIT 开源、完全免费,运行 Harness 不花钱。模型调用按你接入的提供方计费——用 DeepSeek API 就按其 API 价格,换成别家就按别家的价格。
只能配 DeepSeek 的模型吗?+
不是。模型适配器本身就是插件,官方支持接入其他提供方的模型——这正是"一切皆插件"的直接好处:换模型不动主体,改配置就行。
和 Claude Code 这类工具有什么区别?+
定位相似(都是让模型动手干活),但路线不同:Harness 把整个骨架——循环、工具、审批、存储——都做成可替换插件,并提供 Web / 桌面 / SDK / headless / ACP 多种形态,还面向普通用户做了界面。有第三方评测把它与 Claude Code 对比,称其为少数"从第一性原理出发"系统化设计的开源 Agent 框架。
现在上生产靠谱吗?怎么扩展?+
官方定位是开发者预览,明确警告会有破坏性变更——生产环境建议隔离评估。扩展方面:可安装现成插件(GitHub topic dsh-plugin)或自制插件,甚至能对话式创建——官方演示里 5 分 24 秒就做出了一个"番茄时钟"悬浮插件。

它适合谁

四类人,四个起点

For Everyone

普通用户

整理资料、分析表格、写汇报,开箱即用的 Web / 桌面界面,像聊天一样布置任务。

起点 → npx @deepseek-ai/dsh web
For Developers

开发者

写插件、跑源码、接自己的模型——Cordis 生态、类型化事件与能力接缝都是标准玩法。

起点 → docs/architecture.zh.md
For Teams

团队

定时自动化任务、后台批处理、可配置的审批与沙盒,把重复流程交给 Agent 并保留审计。

起点 → 自动化任务面板
For Researchers

研究者 / 极客

读设计论文、替换 Agent 循环、把执行世界迁到远程沙盒——把 Agent 当可编程对象来实验。

起点 → arXiv:2608.25512

开始使用

试着让它开始干活

一行命令,把一个能动手的 Agent 请到你的机器上。

❯ npx @deepseek-ai/dsh web
微信公众号「大话数据分析」二维码

微信扫码关注「大话数据分析」数据 · 分析 · AI 实战