AI 分析 · 由大模型根据 README 与仓库数据生成 · 2026年11月17日
DeepSeek 开源的智能体运行框架,一切皆插件,自带网页界面。
DeepSeek Harness(简称 dsh)是 DeepSeek AI 开源的智能体运行框架(agent harness),采用「一切皆插件」的架构,底层由 Cordis 驱动。项目用 TypeScript 编写,提供 Web UI,可通过 npx 直接启动本地服务。目前处于开发者预览阶段,官方明确提示会有破坏性变更。
推荐指数
架构思路清晰、上手命令简单,但处于预览期、接口不稳定,适合愿意跟进变化的开发者尝鲜。
近 7 天
+4,766
新增 Star
总 Star 排名
#2
雷达追踪的 3,931 个 AI 仓库中
创建于
2026
2026年8月13日
核心亮点
1一切皆插件
框架能力以插件形式组织,便于按需组合和扩展。
2基于 Cordis
底层使用 Cordis 框架,其设计有配套论文说明。
3自带 Web UI
一条 npx 命令即可启动本地网页界面并自动打开浏览器。
4官方开源
由 DeepSeek AI 开源,采用 MIT 许可。
5插件生态入口
插件仓库打上 dsh-plugin 话题即可被检索到。
适用场景
快速体验智能体框架
例如:本地执行 npx @deepseek-ai/dsh web,在浏览器里直接试用。
开发自定义插件
例如:按插件架构编写扩展能力,并打上 dsh-plugin 话题发布。
研究可组合架构
例如:结合 Cordis 的设计论文,理解时空可组合的编程范式。
它是怎么工作的
第 1 步
安装运行环境
准备 Node.js 环境,通过 npm 获取 dsh 包。
第 2 步
启动 Web 服务
运行 dsh web,默认在 127.0.0.1:3080 提供网页界面。
第 3 步
插件组织能力
框架功能由插件构成,基于 Cordis 进行组合与加载。
第 4 步
按需扩展
开发者新增插件接入,形成自己的智能体能力集合。
快速上手
- 1
npm 直接运行
安装 Node.js 后执行,默认启动 Web UI 并打开浏览器。
npx @deepseek-ai/dsh web - 2
不自动开浏览器
只启动服务,适合远程或脚本场景。
npx @deepseek-ai/dsh web --no-open - 3
从源码构建
克隆仓库、安装依赖并构建产物。
git clone https://github.com/deepseek-ai/deepseek-harness.git && cd deepseek-harness && pnpm install && pnpm run build - 4
运行构建产物
使用已构建的产物启动 Web 界面,不重新构建。
pnpm dsh web
适合谁
- 想快速试用智能体框架的开发者
- 需要插件化扩展能力的团队
- 关注 Cordis 架构的研究者
- 使用 TypeScript 的前端或全栈开发者
不太适合
- 要求接口长期稳定的生产项目
- 不熟悉 Node.js 工具链的用户
成熟度
- 活跃度创建于 2026-08,最近一次推送在 2026-11,仍在活跃迭代。
- 文档有独立文档站、开发指南、架构文档和安全说明。
- 社区star 与 fork 数很高,设有 Discussions、Discord 和插件话题。
- 上手难度一条 npx 命令即可启动,但源码运行需 pnpm 构建流程。
使用前注意
- · 处于开发者预览阶段,官方明示会有破坏性兼容变更。
- · 运行前应先阅读仓库中的 SAFETY.md 安全说明。
- · 默认在本地 3080 端口启动服务,远程使用需自行处理端口转发。
- · 采用 MIT 许可,第三方依赖许可见 THIRD_PARTY_NOTICES.md。
