DeepSeek Harness（简称 dsh）是 DeepSeek AI 开源的 Agent Harness，8 月 13 日发布开发者预览版，MIT 协议，核心设计是「Everything is a Plugin」——工具、记忆、工作流都以插件形式挂载，底层由开源框架 Cordis 驱动。仓库发布后一周多已获得超过 16 万 star，目前处于快速迭代的开发者预览阶段，接口可能随时变化。

第一步：准备环境

dsh 是 Node.js 项目，先装好 Node.js（建议 20+）。用 npm 方式最省事，无需克隆仓库。

第二步：npm 一键启动

npx @deepseek-ai/dsh web

命令会启动 Web UI 并默认在浏览器打开，本地地址为 http://127.0.0.1:3080。不想自动打开浏览器就加 --no-open。首次运行会下载依赖，稍等片刻即可。这是体验 dsh 最快的方式。

第三步：从源码运行

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 里，Agent 的每一项能力（工具、记忆、工作流、界面组件）都是插件。插件通过 npm 包分发，可以在 GitHub 上用 dsh-plugin 这个 topic 检索社区插件，也可以在 Web UI 的插件面板里管理启用状态。官方文档放在 docs/ 目录，遇到问题优先查 GitHub Discussions。

第五步：常见问题

  • 端口被占用：换端口运行，或先关掉占用 3080 的进程
  • 版本不兼容：开发者预览阶段可能有破坏性变更，升级前看 GitHub Releases 说明
  • 需要离线/内网：源码方式 + 本地模型接入更可控，参考官方 architecture 文档
  • 找插件：GitHub 搜 topic:dsh-plugin，或去社区推荐列表筛选
把 Agent 的每个能力都变成可插拔的积木——这就是 DeepSeek Harness 对 Harness 赛道的回答。