deepseek-ai/deepseek-harness

DeepSeek Harness – 一个可扩展的 AI 代理框架

它是什么 – DeepSeek Harness (dsh) 是由 DeepSeek AI 创建的一个开源“代理工具架”。它提供了一个运行时环境，其中每个组件（LLM 后端、工具、UI 组件等）都被视为一个可以在运行时发现、加载和组合的 插件。其核心建立在 Cordis 库之上，该库实现了论文《A Programming Paradigm for Spatiotemporal Composability》中所描述的“一切皆插件”范式。

为什么重要 – 现代 AI 代理日益模块化：您希望在不重写整个系统的情况下更换不同的语言模型、添加新工具或更改 UI。DeepSeek Harness 为开发人员提供了一个现成的、以插件为优先的架构，让他们可以专注于代理逻辑而不是底层架构。

关键部分

• 插件架构 – 任何功能都可以打包为 dsh-plugin。插件会自动被发现，从而轻松扩展系统。
• Web UI – 内置的 Web 界面 (dsh web) 在本地 http://127.0.0.1:3080（或通过 SSH）运行，并自动在默认浏览器中打开。
• 开发工具 – 诸如 pnpm run dev:web 之类的命令提供热重载以进行快速迭代，而 make help 列表显示了所有支持的构建/运行目标。
• 安全须知 – 存储库包含一个 SAFETY.md 文件，要求用户在运行前阅读，这表明了对负责任 AI 部署的关注。
• 文档 – 完整文档托管于 https://deepseek-harness.github.io/deepseek-harness/，涵盖了用户指南、开发、架构以及如何编写代理。

如何开始

1. 快速开始 – 安装 Node.js 后，运行 npx @deepseek-ai/dsh web。这将获取软件包、构建 UI 并在本地启动。
2. 从源代码构建 – 克隆存储库，使用 pnpm install 安装依赖项，使用 pnpm run build 构建，然后通过 pnpm dsh web 启动 UI。
3. 开发插件 – 将 dsh-plugin 主题添加到您的存储库，遵循 AGENTS.md 指南，并发布您的插件以供社区发现。

社区与支持

• GitHub Discussions 用于错误报告和反馈。
• Discord 社区（README 中有邀请链接）用于实时帮助和协作。
• 贡献指南在 CONTRIBUTING.md 中提供。

许可证 – 该项目在宽松的 MIT 许可证下发布，第三方许可证列在 THIRD_PARTY_NOTICES.md 中。

引用 – 如果您在研究中使用 DeepSeek Harness，请引用提供的 BibTeX 条目。

---

DeepSeek Harness 是一个开发者预览项目，因此随着 API 的演进，预计会出现重大变更。