🚀 DeepSeek Harness(dsh) 正式开源!
DeepSeek Harness 是由 DeepSeek AI 开发的开源智能体框架(agent harness),采用"一切皆插件"的架构设计,由 Cordis 驱动,其设计理念在论文 A Programming Paradigm for Spatiotemporal Composability 中详细阐述。
- GitHub 仓库: https://github.com/deepseek-ai/DeepSeek-Harness
- 开源协议: MIT
- 发布时间: 2026 年 8 月 13 日以开发者预览版开源,8 月 20 日迭代至 v0.1.0-rc.8
- 最新版本: v0.1.0-rc.8(2026-08-19/20)
开发者预览状态
DeepSeek Harness 目前处于开发者预览阶段,正在快速迭代中。请注意:将会有破坏性变更(BREAKING CHANGES)。
快速开始
通过 npm 运行
安装 Node.js 后,直接运行:
bash
npx @deepseek-ai/dsh web
该命令默认在 http://127.0.0.1:3080 启动 Web UI,并在默认浏览器中打开(本地启动时)。SSH 启动仅打印主机 URL,因为 SSH 客户端或编辑器拥有本地转发地址。传入 --no-open 参数可在不打开浏览器的情况下运行服务器。详见 Web UI 指南。
从源码运行
从仓库检出代码运行:
bash
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web
pnpm run build 准备仓库产物,pnpm dsh web 使用这些构建好的产物运行,无需重新构建。
v0.1.0-rc.8 新特性
8 月 20 日发布的 v0.1.0-rc.8 版本新增以下重要功能:
- 原生图片请求支持:智能体可以直接请求和处理图片
- 图文输入功能:支持同时输入文本和图片进行多模态交互
- 引用功能:智能体回复支持引用来源,增强可追溯性
项目结构
deepseek-harness/
├── .agents/ # 智能体配置
├── .claude/ # Claude Code 配置
├── .github/ # GitHub Actions 工作流
├── apps/ # 应用层
├── docs/ # 文档
├── examples/ # 示例
├── native/ # 原生模块(含 landlock-run 沙箱)
├── packages/ # 核心包
├── patches/ # 补丁
├── python/ # Python 支持
├── scripts/ # 构建脚本
├── vendor/ # 第三方依赖
└── website/ # 官网
技术栈
- 主要语言: TypeScript(97.2%)
- 其他: CSS(1.5%)、Python(0.7%)、JavaScript(0.5%)、Shell(0.1%)
- 包管理: pnpm workspace
- 测试框架: Vitest
核心特性
插件化架构
DSH 采用"一切皆插件"的设计,所有功能模块均以插件形式存在,开发者可以灵活扩展和定制智能体能力。通过 dsh-plugin 主题标签可以发现社区插件。
Web UI 优先
默认提供开箱即用的 Web UI 界面,降低使用门槛,用户可以通过浏览器直接与智能体交互。
多语言支持
README、贡献指南、品牌指南等文档均提供中英文双语版本。
沙箱执行
通过 native/landlock-run 模块提供安全的代码执行沙箱环境。
Agent Teams 支持
支持多智能体团队协作,通过 .agents 目录配置智能体团队,不同智能体承担不同角色协同完成任务。
社区与支持
- 反馈与 Bug 报告: 通过 GitHub Discussions 提交
- 插件发现: 在你的插件仓库添加
dsh-plugin主题标签 - Discord 社区: 加入 DeepSeek Harness Discord
- 贡献指南: 参见 CONTRIBUTING.md
- 开发指南: 从开发指南和架构文档开始
- 智能体开发: 遵循 AGENTS.md
许可证
第三方依赖及其许可证在 THIRD_PARTY_NOTICES.md 中披露。