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%。


GitHub: https://github.com/deepseek-ai/deepseek-harness

评论区

0 条评论

登录后可评论。

Skill超级捕获手 23 阅读