DeepSeek Harness 怎么下载？官方渠道、安装包与源码获取全指南
DeepSeek Harness（简称 dsh）是 DeepSeek AI 开源的一款 Agent 运行框架，核心设计是 "一切皆插件"：模型、工具、Agent 循环都能自由组合。很多朋友第一反应是找安装包下载，其实它和常见软件不太一样——不是下载一个安装程序，而是通过命令安装。本文把官方渠道和几种获取方式一次讲清楚。
一、先说明：dsh 不是 "下载安装包" 的模式
dsh 是开源项目，主要通过 npm 包分发，官方没有提供传统意义上的 "安装包" 文件。你可以从两个地方拿到它：
- 官方 GitHub 仓库：https://github.com/deepseek-ai/deepseek-harness（源码）
- 官方 npm 包：@deepseek-ai/dsh（安装用）
二、方式一：npm 一键获取（最推荐）
这是官方主推的方式，不需要手动下载任何文件，一条命令自动拉取并启动：
npx @deepseek-ai/dsh web执行后：
- npx 自动从 npm 源下载 @deepseek-ai/dsh 包
- 启动 Web UI，浏览器打开默认地址 http://127.0.0.1:3080
- 首次使用在 $DSH_HOME（默认 ~/.dsh）下自动初始化配置
前提：先安装 Node.js（建议最新 LTS 版本），命令行执行 node --version 能输出版本号即可。
三、方式二：GitHub 下载源码
想获取完整源码，到官方仓库 https://github.com/deepseek-ai/deepseek-harness 操作：
1. 直接下载压缩包
在仓库首页点击 Code → Download ZIP，解压即可得到源码。适合只想浏览代码的场景。
2. Git 克隆（推荐开发者）
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness克隆下来后构建运行：
pnpm install
pnpm run build
pnpm dsh web这种方式方便随时 git pull 更新到最新版本。
四、方式三：安装 Python SDK
需要程序化调用 dsh 能力（CI、批量任务等场景），可以获取官方 Python SDK：
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
python -m venv .venv
. .venv/bin/activate
python -m pip install deepseek-harness-sdk前置要求：Python 3.10 或更高版本、Git、Linux x64/arm64 或 macOS 14+ 的 arm64 系统。装好后运行时自带，不需要系统再装 Node.js。
五、怎么确认下载成功
启动后看到浏览器打开 Web UI 界面即成功。命令行方式验证：
dsh --profile headless "Say hello in one line."能看到 agent 的回复就说明整条链路正常。
六、常见疑问
Q：需要付费吗？
不需要。dsh 本身开源免费（MIT 协议），你只需要自己有模型 API 密钥（如 DeepSeek 官方 API）。
Q：为什么没有 Windows 安装包？
dsh 是跨平台的 Node.js 项目，不依赖系统安装程序。在 Windows 上同样是先装 Node.js，再执行 npx 命令即可。
Q：下载失败怎么办？
多为网络问题。确认能访问 npm 源，必要时配置国内镜像源后重试。
总结
DeepSeek Harness 的获取方式以命令为主：普通用户执行 npx @deepseek-ai/dsh web 即可自动下载并启动（默认 http://127.0.0.1:3080）；开发者可以从 GitHub 克隆源码构建；程序化场景装官方 Python SDK。它开源免费，没有安装包，但有清晰可靠的官方渠道。
