deepseek-harness

把 AI 能力拆成乐高积木，拼出你的专属智能体。

deepseek-harness 是一个基于 TypeScript 的智能体编排框架，核心理念是“万物皆插件”。它通过 Cordis 插件系统，将 DeepSeek 模型能力与外部工具、数据源、业务逻辑解耦，让开发者能以插件形式灵活扩展智能体的功能。项目解决了传统智能体开发中功能耦合、扩展困难、复用性差的问题，提供了一套统一的插件接口和生命周期管理，支持动态加载、热更新和组合编排。其核心能力包括：插件化的工具调用、多智能体协作、上下文管理与记忆持久化、以及事件驱动的消息流处理。开发者可以快速构建定制化的 AI 助手、自动化工作流或企业级知识问答系统，而无需关注底层模型细节。项目文档清晰，示例丰富，适合中高级开发者深度定制。

开源 unknown 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 236752

维护状态活跃

是否开源是

定价模式 unknown

项目数据

分类智能体

开发团队deepseek-ai

所属国家

官网地址https://deepseek.com/harness

GitHubhttps://github.com/deepseek-ai/deepseek-harness

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型ai-agents,cordis,dsh,dsh-plugin

GitHub 星标★ 236752

30天Star增速

HF 下载量

上线时间2026-08-13 00:00:00

最近更新2026-09-26 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-15

浏览次数34

使用教程

难度：入门约 10 分钟部署方式：命令行工具 6 步

环境要求

已安装 Node.js（npm 与 npx 可用）
从源码运行时需要 pnpm
从源码运行时需要 git
本地环境可访问 http://127.0.0.1:3080

安装与启动步骤

1安装 Node.js

README 要求先安装 Node.js，之后才能使用 npx 或 pnpm 命令。安装完成后可在终端中确认 npm、npx 可用。
2npx 直接启动

这是最简方式，无需克隆仓库，npx 会拉取 @deepseek-ai/dsh 并启动 Web UI，默认监听 3080 端口。
```
npx @deepseek-ai/dsh web
```
3克隆源码仓库

改用源码方式运行时，先把 deepseek-harness 仓库克隆到本地。
```
git clone https://github.com/deepseek-ai/deepseek-harness.git
```
4安装依赖

进入仓库目录后用 pnpm 安装全部依赖，需保证本机已装好 pnpm。
```
cd deepseek-harness
pnpm install
```
5构建产物

pnpm run build 用于准备仓库的构建产物，是源码启动前的必要一步。
```
pnpm run build
```
6从源码启动 Web UI

该命令直接使用已构建产物启动服务，不会重新构建，默认同样监听 3080 端口。
```
pnpm dsh web
```

关键配置

配置项	必填	说明	示例
`--no-open`	否	启动服务但不自动打开浏览器	`npx @deepseek-ai/dsh web --no-open`

如何确认成功

启动后浏览器自动打开 http://127.0.0.1:3080 并显示 Web UI；SSH 环境则只打印 host URL。

常见问题

Q：启动后会打开浏览器吗？

A：本地启动默认会打开默认浏览器并访问 http://127.0.0.1:3080；在 SSH 会话中只打印 host URL，因为本地转发地址由 SSH 客户端或编辑器掌控。

Q：不想自动打开浏览器怎么办？

A：在启动命令后加上 --no-open 参数，服务照常运行但不弹出浏览器。

Q：构建后启动还需重新构建吗？

A：不需要。pnpm dsh web 直接使用 pnpm run build 生成的产物，不会再次构建。

Q：npm 和源码两种方式都要装依赖吗？

A：不必。npx @deepseek-ai/dsh dsh web 方式只需 Node.js；源码方式才需要 git、pnpm 并执行 pnpm install 与 pnpm run build。

注意事项

项目处于 developer preview 阶段且迭代很快，会出现破坏兼容性的变更。
运行前请先阅读仓库中的 SAFETY.md 安全须知。
默认 Web UI 地址为 http://127.0.0.1:3080，SSH 环境需自行确认端口转发。
文档站点：https://deepseek-harness.github.io/deepseek-harness/

核心亮点

插件机制彻底解耦，新增功能只需写个插件，不改核心代码
基于 Cordis 生态，可复用大量现成插件，上手快
支持动态加载和热更新，线上调整无需重启服务

不足之处

文档偏技术化，新手理解插件开发流程有门槛
社区生态尚在早期，第三方插件数量有限

适用场景

企业构建内部知识库问答机器人，按部门插件化定制
开发者快速原型验证 AI 功能，通过插件组合试错
多智能体协作场景，如自动写报告+发邮件+数据分析

替代项目

LangChain、AutoGPT、Dify

项目介绍

deepseek-harness 是智能体领域的开源项目，由 deepseek-ai 开发，是 2026 年新上线的项目。

在全站 13,199 个收录项目中，它的 GitHub 星标数（236,752）位列前 1%，在智能体分类的 2,528 个项目里位列前 1%。

近 43 天，它的 GitHub 星标从 94,093 增加到 236,752，净增 142,659。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-26。

它主要面向的使用场景是：企业构建内部知识库问答机器人，按部门插件化定制。同类可对比的替代方案包括 LangChain、AutoGPT、Dify。

上一篇：caura

下一篇：agent-safe-pipeline