DeepSeek Harness

DeepSeek Harness（命令行名称 dsh）是 DeepSeek AI 开发的开源 Agent harness，用来运行和组织 AI Agent。项目采用 everything-is-a-plugin（一切皆插件） 的架构，底层基于 Cordis。Cordis 的设计思路见论文《A Programming Paradigm for Spatiotemporal Composability》。

⚠️ 开发者预览版：项目迭代很快，会有破坏兼容性的更新。运行前请先阅读仓库里的安全说明（SAFETY.md）。

主要功能

• 插件化架构：核心能力都以插件形式组织，便于扩展和组合。
• Web UI：执行 dsh web 启动，默认地址为 http://127.0.0.1:3080。本地启动时会自动打开浏览器；通过 SSH 启动时只打印地址。加 --no-open 参数则只运行服务，不打开浏览器。
• 插件生态：插件仓库添加 dsh-plugin topic 后，可以在 GitHub 上被发现。
• 桌面端支持：仓库的开发文档和 Make 目标里同时提到 Web 和 Desktop 两种应用形态。
• 多语言文档：README 和贡献指南提供英文与中文版本。

目标用户和使用场景

• 想搭建或研究 AI Agent 运行框架的开发者。
• 想基于插件机制定制 Agent 能力、开发和分享 dsh 插件的社区贡献者。
• 想试用 DeepSeek 官方 Agent 工具链的技术用户。

安装与运行

通过 npm 运行（需先安装 Node.js）：

npx @deepseek-ai/dsh web

从源码运行：

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

开发时可用 pnpm run dev:web。它会在一个终端里完成构建、启动服务，并在源码修改后重新构建客户端。

技术要求与注意事项

• 需要 Node.js 环境。从源码运行还需要 pnpm。
• 仓库以 TypeScript 为主，也包含 Python 和 native 目录。
• 使用 MIT 许可证，第三方依赖及其许可证见 THIRD_PARTY_NOTICES.md。
• 处于开发者预览阶段，API 和行为可能随时变化，不建议直接用于对稳定性要求高的生产环境。
• 文档站：https://deepseek-harness.github.io/deepseek-harness/；社区交流可使用 GitHub Discussions 和 Discord。