安装 DeepSeek Harness（DSH）
本指南带你从零跑通 DeepSeek Harness Web UI。检索别名包括 DSH、DS Harness、deepseek-harness；实际启动的包名是 @deepseek-ai/dsh。下列命令对应公开的开发者预览版，若上游变更请以官方 GitHub README 为准。
前置条件
- Node.js ^22.19.0 或 >=24.0.0（node -v）；过旧的 18/20 常在 engines 失败
- 能访问 npm（镜像落后时改用官方 registry）
- 如需调用模型，准备官方平台的 DeepSeek API Key
- 准备允许 Agent 读写的本地目录——第一次不要指向整个用户主目录
按系统一键
Windows（PowerShell）
若没有 Node，可用 winget install OpenJS.NodeJS.LTS 或 nodejs.org 安装包，重开终端后执行 npx @deepseek-ai/dsh web。建议先 cd 到项目目录再启动，默认工作区更近。
macOS（终端）
用官方 pkg 或 Homebrew 安装 Node，再跑 npx。不要一上来就开「完全磁盘访问」；先用可丢弃仓库试验。
Linux / WSL
用 nvm 或发行版的 Node 22/24 包，然后 npx。不要用 root 跑 Agent。WSL 请把工作区放在 Linux 文件系统，减少权限意外。
用 npx 快速体验
1. 启动 Web UI
在终端执行：
npx @deepseek-ai/dsh web
CLI 会拉取开发者预览包并启动本地服务。使用期间保持终端运行。
2. 打开本地界面
浏览器访问 http://127.0.0.1:3080。你应看到对话、设置与工作区选择界面。
3. 配置模型
打开「设置 → 模型」（文案随版本可能略有差异），填入 DeepSeek API Key 并选择模型。不要把密钥提交到 git。
4. 选择工作区
添加项目目录。第一次评估权限与 Shell 工具时，建议用可丢弃的示例仓库。
5. 发送第一个任务
先做低风险操作（列文件、总结 README），确认工具调用符合预期后再做编辑与测试。随后可用 Trajectory 审查模型所见内容。
如何确认安装成功
成功标志：:3080 可打开，模型配置能保存，工作区可见，简单提示能返回结果（可含工具轨迹）。若端口占用，检查是否有其他进程占用 3080。
从源码安装
贡献者与插件作者可克隆 https://github.com/deepseek-ai/deepseek-harness 并按仓库说明安装。源码安装更适合调试 Cordis 插件。
排错
npx 很慢或超时
换稳定网络重试，或按地区配置 npm 镜像。确认 Node 在 PATH 中。
对话后 API 报错
核对密钥、模型 ID 与官方平台额度。本站不发放 API Key。
Agent 看不到文件
重新选择工作区根目录并检查系统权限。首次不要指向整个用户主目录。
下一步
继续阅读教程了解架构与模式，浏览插件页了解 dsh-plugin，若从 Claude Code 迁移可参考对比页。