DeepSeek Harness (dsh) 由 DeepSeek AI 开发的、开源且高度可扩展的 AI 代理开发平台

这份详细的部署教程将指引您安装和运行 DeepSeek Harness (dsh)——一个由 DeepSeek AI 开发的、开源且高度可扩展的 AI 代理开发平台。其核心设计理念是 “万物皆插件” ，为您构建、运行和管理 AI 代理提供了极大的灵活性。

DeepSeek Harness 目前处于开发者预览版，正在快速迭代中，可能存在破坏性变更。它主要面向开发者，提供了一个基于插件的架构，让您可以自由组合和扩展 AI 代理的功能。

整个部署流程非常简单。您可以通过 npx 一键运行，也可以从源码构建。文档提供了清晰的启动指引。

🚀 快速启动

您可以选择以下任一方式启动 DeepSeek Harness。

方式一：使用 npx 直接运行 (推荐快速体验)

这是最快捷的方式，无需克隆代码，适合快速体验。

npx @deepseek-ai/dsh web

此命令会：

1. 自动下载并运行必要的包。
2. 启动 Web UI，默认在浏览器中打开 http://127.0.0.1:3080。
3. 如果是在 SSH 会话中启动，则只会打印主机 URL，不会自动打开浏览器。

常用参数：

• --no-open：启动服务器但不自动打开浏览器。

方式二：从源码运行 (适合开发和定制)

如果您希望基于源码进行开发或深度定制，可以按以下步骤操作。

1. 前提条件：确保已安装 Node.js 和 pnpm。

2. 克隆并安装依赖：

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

3. 启动应用：

   pnpm dsh web

   注意：pnpm run build 用于构建仓库产物。pnpm dsh web 会直接使用这些构建好的产物，而不会重新构建。

📖 进一步学习

• 官方文档：请访问 DeepSeek Harness 官方文档 获取详细的使用指南、架构说明和插件开发教程。
• 贡献与反馈：
  • 欢迎通过 GitHub Discussions 提交反馈或报告 Bug。
  • 如果您开发了插件，请为其添加 dsh-plugin 主题标签，方便他人发现。
  • 贡献代码前，请阅读 CONTRIBUTING.md。
• 社区：加入 DeepSeek Harness Discord 社区 与其他开发者交流。
• 开发者指南：项目中的 开发指南 和 架构文档 为贡献者提供了详细指引。对于 AI 助手，可以参考 AGENTS.md。

💡 重要提示

• 开发者预览版：请留意，该项目仍在快速迭代中，API 和配置方式可能会发生变化。
• 安全须知：在运行项目前，请务必阅读项目文档中的 安全须知。