DeepSeek Harness
如何安装和运行 DeepSeek Harness
按照已核验的 npm 和源码流程安装 DeepSeek Harness，并在 Web UI 中配置模型与工作区。
你将学会
- Use npx for a quick Web UI trial; use pnpm when developing from source.
- A first Web UI task requires both a saved model key and a selected workspace.
- Node and pnpm versions are part of the reproducible setup.
开始前需要
- Basic HTTP and API knowledge
Leave with a concrete implementation checklist and a testable starting point.
先看结论
- 快速试用用 npx，源码开发用 pnpm。
- 首次使用 Web UI 需要保存模型 Key 并选择工作区。
- Node 和 pnpm 版本是可复现安装的一部分。
选择安装路径
快速试用可以安装 Node.js 后执行 `npx @deepseek-ai/dsh web`。README 说明默认会在 `http://127.0.0.1:3080` 启动 Web UI；加上 `--no-open` 可以禁止自动打开浏览器。
如果要修改源码，则克隆仓库，执行 `pnpm install`、`pnpm run build`，再运行 `pnpm dsh web`。最后一步使用已构建产物，不会隐式重新构建。
第一次打开 Web UI
启动后进入 Settings → Models，填写 DeepSeek API Key 并保存。然后选择启动 dsh 时所在的项目目录；使用指南说明未选择工作区前，Session Composer 不可用。
可以先发送“总结这个仓库并列出主要包”这样的具体任务。Web UI 能读写工作区、运行命令、委派工作和维护计划，审批行为由当前权限策略决定。
用证据排查问题
如果浏览器没有自动打开，使用进程打印的 URL，并检查 3080 端口是否已被占用。源码启动失败时，先核对开发指南中的 Node 引擎和 pnpm 版本，不要直接改依赖。
不要把真实凭据提交到 issue 或仓库。开发指南记录了 `DEEPSEEK_API_KEY` 和可选的 `DEEPSEEK_BASE_URL`，并说明没有 key 时真实 API 测试会跳过。
如何选择
| 比较维度 | 方案 A | 方案 B |
|---|---|---|
| Use this path | npx when evaluating the current published package | pnpm source flow when changing code or docs |
| Main checkpoint | Server prints a local URL | typecheck/build succeeds before dsh starts |
实施步骤
- 1
安装支持的 Node.js；源码开发时启用 Corepack pnpm。
- 2
执行 npm 命令，或克隆、安装、构建并从源码启动。
- 3
在 Settings → Models 配置 DeepSeek Key。
- 4
先选择工作区并运行只读任务。
可复制示例
# Fast local launch
npx @deepseek-ai/dsh web --no-open
# Source checkout
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web常见问题
默认端口是多少？
README 记录的默认本地地址是 http://127.0.0.1:3080；实际使用进程打印的 URL。
资料来源
- DeepSeek Harness README run guide来源核查 2026-08-27
- DeepSeek Harness development guide来源核查 2026-08-27
- DeepSeek Harness Web UI guide来源核查 2026-08-27