DeepSeek Harness（dsh）

DeepSeek Harness 是什么

DeepSeek Harness（简称 dsh）是 DeepSeek AI 开源的智能体运行框架（agent harness），核心设计理念是 Everything is a Plugin——框架本身只提供最小内核，所有能力都以插件形式接入。

它构建在 Cordis 之上，其设计思想在论文《A Programming Paradigm for Spatiotemporal Composability》中有详细描述。

项目目前处于 开发者预览（developer preview） 阶段，迭代很快，会出现破坏性兼容变更。运行前请先阅读仓库中的安全须知（SAFETY.md）。

核心特点

• 一切皆插件：模型接入、工具调用、界面、存储等都可以做成插件，按需组合。
• Web UI 开箱可用：默认在 http://127.0.0.1:3080 启动本地界面。
• TypeScript 实现：前后端统一技术栈，便于二次开发与调试。
• MIT 协议：可自由用于商业项目。

快速开始

通过 npm 运行

安装 Node.js 后，直接执行：

npx @deepseek-ai/dsh web

该命令默认在 http://127.0.0.1:3080 启动 Web UI 并打开浏览器；通过 SSH 启动时只打印主机地址，因为本地端口转发由 SSH 客户端或编辑器负责。加上 --no-open 可以只启动服务、不打开浏览器。

从源码运行

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 直接使用这些产物启动，不会重新构建。

插件与社区

• 插件仓库建议添加 dsh-plugin topic，方便被检索到。
• 反馈与 Bug 报告走 GitHub Discussions。
• 可加入官方 Discord 社区交流。

开发与文档

• 开发指南：docs/development.md
• 架构文档：docs/architecture.md
• 面向 Agent 的协作说明：AGENTS.md
• pnpm run dev:web 可在监听源码变更的同时构建并重新打包客户端；make help 会列出 Web 与 Desktop 对应的 Make 目标。

适用人群

适合希望搭建可扩展 AI Agent 的开发者、想研究插件化 Agent 架构的工程师，以及准备为 dsh 编写插件的贡献者。由于项目仍在快速演进，建议关注版本变更再投入生产使用。