DeepSeek Harness 安装

DeepSeek Harness 安装

DeepSeek Harness 提供四种安装方式。普通用户优先用官网桌面版，无需装 Node.js；希望在浏览器使用本地 Web UI 的开发者可选 npm。官网当前将 Harness 标注为预览版，界面与安装包可能变化。

安装方式怎么选

方式	操作系统	需要 Node.js	适用场景
官方桌面版（新手推荐）	Windows 64 位、macOS Apple 芯片	否	日常办公、文件处理、AI 编程
npm 安装	Windows、macOS、Linux	需要 24.9+	命令行启动本地 Web UI
源码安装	支持的开发环境	需要 24.9+	研究源码、开发插件
Python SDK	Linux x64/arm64、macOS 14+（Apple 芯片）、Windows x64	否（自带运行时）	通过 Python 集成 Agent

准备事项：桌面版要求 macOS 13+（Apple 芯片）或 64 位 Windows；源码方式还需 Git 与 pnpm（corepack enable 可启用仓库固定版本）；Python SDK 要求 Python 3.10+。请提前准备模型服务凭据，不要把 API Key 提交进 Git 仓库。

方式一：官方桌面版（推荐）

进入官网下载对应安装包：macOS 打开 DMG 把应用拖入「应用程序」；Windows 双击 EXE 按向导安装。首次打开后先配置模型，再选一个测试目录作为工作区，先发只读任务验证，确认正常后再尝试写操作。注意：不要把生产目录、密钥或含隐私资料的文件夹当作首次测试工作区。

方式二：npm 安装并启动 Web UI

npm install -g @deepseek-ai/dsh
dsh web

免安装快速体验：

npx @deepseek-ai/dsh web

首次运行自动初始化 web 配置模板并打印访问地址（默认 http://127.0.0.1:3080），浏览器打开看到界面即成功。小贴士：建议先 cd 到项目目录再启动，dsh 会把调用目录作为默认文件系统位置。

方式三：从源码安装

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install     # 安装依赖（可用 corepack enable 启用仓库固定的 pnpm）
pnpm run build   # 构建包与前端产物
pnpm dsh web     # 以源码方式启动 Web UI

其他入口：pnpm dsh --profile headless "run the tests" 一次性跑任务；pnpm dsh --profile web --dump-config 查看完整配置树。要求 Node.js 24.9+、Corepack 启用的 pnpm（仓库固定 11.28.5）与 Git 2.26+。

方式四：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

export DEEPSEEK_API_KEY=sk-your-key-here
# 若走 OpenAI 兼容代理而非默认 DeepSeek 端点：
# export DEEPSEEK_BASE_URL=http://127.0.0.1:8000/v1

SDK 自带运行时，无需系统 Node.js。

首次配置三步走

1. 配置模型：设置 → 模型，填入 DeepSeek API 密钥保存，路由立即生效、无需重启。
2. 选择工作区：添加启动 dsh 时所在的项目目录并选中（选中前输入框不可用）。
3. 运行任务：从轻量指令开始，如 "Summarize this repository and identify its main packages."，越权操作会先征求审批。

常见问题

• 打不开 127.0.0.1:3080：确认 dsh 进程仍在运行；端口被占用用 dsh --profile web --port 8080 换端口（--port 0 自动选空闲端口）。
• npx 找不到包或版本过旧：先 node -v 确认 ≥ 24.9，再用 npx @deepseek-ai/dsh@latest --version 核对版本。
• 源码构建失败：确认已 corepack enable，网络受限时配置镜像源。
• 输入框不可用 / agent 无法读写文件：多半是没选工作区，或尚未保存有效 API 密钥。
• Python SDK 报缺 Node.js：SDK 自带运行时，确认安装的是同版本完整包并满足系统要求。

参考来源与说明

本文根据 runoob 公开教程的核心信息进行原创整理与改写，原文地址：DeepSeek Harness 安装。具体细节以 DeepSeek Harness 官方文档为准。