DeepSeek Harness

DeepSeek Harness 是 DeepSeek AI 推出的开源 agent harness，采用插件优先架构并提供本地 Web UI，适合开发者探索 agent 工作流、扩展与运行时组合。

概述

DeepSeek Harness（dsh）是由 DeepSeek AI 开发的开源 agent harness。README 将其描述为一种“everything is a plugin（万物皆插件）”的架构，并说明其由 Cordis 提供支持，Cordis 被视为底层的可组合性框架。

该项目目前处于开发者预览阶段，README 明确警告仍可能出现破坏兼容性的变更。用户可以通过 npm 使用 `npx @deepseek-ai/dsh web` 在本地运行它，默认会启动位于 `http://127.0.0.1:3080` 的 Web UI；也可以从仓库检出后使用 pnpm 构建并运行。

仓库还包含详细文档和可运行示例，覆盖架构、开发、API、工作流和界面模式。这使该项目适合希望试验 agent harness 概念、理解插件模型，或将 harness 适配到自定义工具和运行时设置的开发者。

核心功能

面向插件的架构

项目围绕插件优先设计组织，README 声明“everything is a plugin（万物皆插件）”。这表明该 harness 旨在通过模块化组件扩展，而不是封闭的固定功能集。

本地 Web 界面

README 记录了 Web UI 的启动路径，并注明默认通过 `http://127.0.0.1:3080` 在本地提供服务。这让用户在安装后可以通过浏览器与 harness 交互。

详尽的技术文档

仓库包含一个 docs 目录树，涵盖架构、开发、工具目录、API 网关和工作流相关文档。这表明它拥有相当完整的文档集，便于理解内部机制并基于项目继续构建。

可运行示例

examples 目录包含可运行演示，例如 headless-agent、jsonrpc-agent、web-cordis、web-schedule 和 mcp-memory。这些示例帮助用户在不从零搭建一切的情况下探索不同的界面模式和扩展点。

社区支持渠道

项目提到可通过 GitHub Discussions 和 Discord 社区获取反馈。这为采用者提供了提问、报告问题和关注持续开发进展的渠道。

典型使用场景

试验 agent 插件
开发者可以使用该 harness 尝试插件优先的运行时模型，并在构建自己的扩展之前了解系统各部分如何协同工作。
本地 agent 工作流测试
团队可以在本地启动 Web UI，并将该 harness 用作交互式环境，以测试 agent 行为、工作流和界面变更。
了解架构与扩展模型
构建者可以查看 docs 目录树和 examples 目录，学习架构、开发流程以及用于创建自定义集成或运行时的扩展点。
研究可运行的 agent 示例
喜欢动手示例的用户可以从 headless-agent 或 jsonrpc-agent 等示例项目入手，查看非交互式和机器可读的 agent 流程是如何组织的。
跟踪开发并参与贡献
社区贡献者可以通过 GitHub Discussions 和项目的社区渠道报告问题、讨论行为变更，并跟进快速迭代过程。

Pros and Cons

Pros

开源并采用 MIT 许可证。
插件优先设计使系统天然适合扩展与组合。
可通过 npm 或源码检出在本地运行。
提供 Web UI 入口点和多个可运行示例。
仓库文档详尽，涵盖架构与开发。

Cons

项目处于开发者预览阶段，因此维护者提示可能会发生破坏兼容性的变更。
源材料没有显示 DeepSeek Harness 自身的产品定价或托管商业方案。

FAQ

什么是 DeepSeek Harness？

仓库 README 将 DeepSeek Harness 描述为由 DeepSeek AI 开发的开源 agent harness。项目处于开发者预览阶段，因此作者提醒仍可能发生破坏兼容性的变更。

如何在本地运行它？

README 给出了一个使用 Node.js 的快速开始路径：`npx @deepseek-ai/dsh web`，默认会在 `http://127.0.0.1:3080` 启动 Web UI。它还说明了如何克隆仓库并使用 pnpm 从源码运行。

它支持哪些类型的工作流？

源材料展示了一个 Web UI、插件导向架构，以及 headless-agent、jsonrpc-agent、web-cordis、web-schedule 和 mcp-memory 等示例运行时。这使它更适合用于探索 agent 工作流和扩展点，而不只是单一固定界面。

是否有社区或贡献支持？

支持。README 指向 GitHub Discussions 以获取反馈和问题报告，仓库也引用了贡献与开发文档。

它可以免费使用吗？

该仓库在 GitHub 上公开，README 中列出的许可证是 MIT。页面内容没有显示 DeepSeek Harness 自身的产品级商业定价。

Quick Facts

产品类型: 开源 agent harness
开发者: DeepSeek AI
许可证: MIT
主要界面: Web UI
默认本地 URL: http://127.0.0.1:3080
源域名: github.com