DeepSeek Harness Skill:把一切能力都变成可插拔插件的 Agent 运行时框架
DeepSeek Harness Skill:把一切能力都变成可插拔插件的 Agent 运行时框架
DeepSeek Harness(dsh)是一个开源 Agent 运行框架,其核心设计哲学是”一切皆插件”:模型适配器、文件工具、Shell 执行器、Skill 系统、会话存储、沙箱权限、Agent 主循环、调度器、Web UI——全部是可拆卸替换的插件。2026年8月19日发布开发者预览版,三周内狂揽 21.5 万星,成为 GitHub Trending 榜首。它解决的本质问题是:不让框架绑架你的 Agent,让你能自由替换任何一个模块而不必重写整个系统。
功能与原则
DeepSeek Harness 的核心公式:Agent = Model + Harness。模型负责推理思考,Harness 负责对接真实环境——工具调用闭环、任务调度、权限管控、会话追踪,全部由 Harness 接管。
设计原则有三条:
– 插件即能力:130+ 插件涵盖从模型后端到 UI 的全链路,每一环都可独立替换
– 配置优于代码:不改源码,只动配置,就能换掉默认模型、编辑器或禁用某个工具
– 轨迹即真相:所有思考链、工具调用、子 Agent 调度、注入上下文全部写入 Session Log,支持暂停、分叉、回放
认可度
- GitHub Star:215,854 星(截至 2026-09-08)
- GitHub Trending:发布后迅速登顶全球 Trending 榜首
- Trending 速度:3 周内从 0 飙至 21.5 万星,是 2026 年 8-9 月开源圈最火爆的新项目之一
- 社区讨论:Reddit、Hacker News、DEV Community 均置顶讨论;Discord 社区快速增长
- 开发者预览状态:v0.1,迭代迅速,官方明确提示会有兼容性破坏更新
链接
GitHub 仓库:https://github.com/deepseek-ai/deepseek-harness
官方文档:https://deepseek-harness.github.io/deepseek-harness/
原作者
DeepSeek AI(deepseek.com)——国内顶级 AI 实验室,同时运营 DeepSeek 大模型系列和开源生态。此前已开源 DeepSeek-Coder、DeepSeek-Math 等热门项目,在开源社区拥有极高声誉。
介绍
DeepSeek Harness 基于 Cordis 插件内核构建。Cordis 只做三件事:插件生命周期管理(加载、启动、停止、卸载)、依赖注入、全局事件总线。它本身不承载任何模型、工具或 UI 逻辑,这意味着你可以完整替换任意一层而不会触动其他层。
插件生态覆盖完整 Agent 开发栈:模型适配插件让你把 DeepSeek 换成任何其他模型;沙箱终端提供安全隔离的执行环境;文件编辑器默认是字符串替换模式(diff-only),避免 AI 全盘重写;Skill 系统支持加载外部技能包;Session 存储支持会话持久化;Web UI 提供可视化操作界面。
官方内置了四种运行模式,通过配置文件切换,无需改动代码:
| 模式 | 核心能力 | 适用场景 |
|---|---|---|
| Standard | 完整工具栈(文件编辑、Shell、网页搜索、Skill、子 Agent、规划) | 日常开发、项目重构、Bug 修复 |
| PTC(Programmatic Tool Calling) | 模型输出 TypeScript 代码一次性编排多条工具调用,减少 LLM 往返次数 | 复杂多步工作流,显著节省 Token |
| Minimal | 仅保留 Bash + 字符串替换编辑器 | 模型基准测试、轻量自动化 |
| Creative | 允许运行时动态加载插件、调试框架本身 | 二次开发、插件开发者实验 |
特点
- 130+ 插件自由组合:覆盖模型、工具、技能、会话、沙箱、存储、循环、调度、UI,拒绝绑定
- 全链路 Session Log:每一次系统提示词注入、推理步骤、工具调用、子 Agent 决策全部可追溯,支持断点续跑和回放
- PTC 模式节省 Token:传统 Agent 工具调用是一轮一轮地来,PTC 让模型一次生成多步调用 TS 代码,显著减少 LLM 往返次数
- 权限沙箱 + 人工审批:高危操作(文件删除、系统命令)可开启人工确认,防止 AI 误操作
- diff-only 文件编辑:增量修改而非全量覆盖,保护已有代码不被 AI 重写
- 一键启动:
npx @deepseek-ai/dsh web即开即用,同时支持源码安装和插件开发
使用方法
快速启动(npm):
# 安装 Node.js 后,一行命令启动 Web UI
npx @deepseek-ai/dsh web
# 自动打开 http://127.0.0.1:3080
# 首次运行会提示输入 DeepSeek API Key
源码安装:
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web
切换运行模式:
在配置文件中指定模式(Standard / PTC / Minimal / Creative),重启即可切换,无需改动代码。
使用场景与人群
- AI 框架开发者:需要高度自定义 Agent 行为,不想被 LangChain 等框架绑定
- 企业级 Agent 工程师:需要沙箱隔离、权限审批、审计日志等生产级能力
- Plugin 开发者:基于 Cordis 插件协议构建私有工具集,并希望发布到 dsh 生态
- 模型评测人员:Minimal 模式提供纯净基准测试环境,排除工具干扰
- Token 成本敏感团队:PTC 模式通过减少往返次数直接降低 API 消耗
输入与输出案例
案例 1:使用 Standard 模式重构项目
输入(用户):/grill-me 描述要重构一个 React 项目的数据获取层
输出:Agent 自动调用 Skill 进行需求澄清,生成文件编辑计划,逐一执行 diff-only 修改,全过程轨迹记录在 Session Log 中可随时回放。
案例 2:使用 PTC 模式批量处理数据
输入(用户):一个包含 50 个 CSV 文件的目录,需要统一格式并生成汇总报告
输出:Agent 理解任务后,一次性生成 TypeScript 代码编排文件读取→格式转换→汇总的全链路调用,从传统的 50+ 轮对话降低为 3-4 轮,Token 消耗减少约 60%。
评论区
登录后可评论。