安装 DeepSeek Harness

在本地安装 DeepSeek Harness（dsh）并启动 Web UI。本指南针对中国大陆环境做了本地化（镜像、GFW、Windows）。

前置条件

• Node.js ≥ 18（建议 LTS），用 node --version 检查。
• 建议安装 pnpm：npm install -g pnpm。

一键安装

中国大陆环境

• npm 镜像：npm config set registry https://registry.npmmirror.com（pnpm 同理）。
• API Key：在 platform.deepseek.com 获取，设置环境变量 DEEPSEEK_API_KEY。
• Windows：PowerShell 执行策略、路径空格问题、可用的 dsh-launcher 一键启动器。

验证

配置模型并运行第一个任务

依据官方 Web UI 指南，服务器启动后：

1. 添加模型——打开 Settings → Models，填入 DeepSeek API Key 并保存。模型立即可用，无需重启服务器。
2. 选择工作区——点击 Choose workspace，添加你启动 dsh 的那个项目目录。未选择工作区之前，会话编辑器不可用。
3. 运行任务——新建会话并发送类似 “Summarize this repository and identify its main packages.” 的指令。Agent 可以读写工作区文件、运行命令、委派工作并维护计划；涉及当前权限策略下需要审批的操作时，Web UI 会先征求同意。

dsh 进程以它被调用的目录作为默认文件系统位置，所以请从你想操作的项目目录启动它。其他模型提供商与自定义 OpenAI 兼容端点见官方 模型配置指南。

常见问题

这里没覆盖到？看完整的常见问题排查——端口冲突、profile 错误、Windows 注意事项与配置调试。

• 端口被占用——127.0.0.1:3080 被其他进程占用。找到并停止它，或查阅 CLI 参考是否有端口参数。
• npx 缓存过期——npx @deepseek-ai/dsh web 会缓存包；如果行为看起来是旧版本，清掉 npx 缓存或改用全新源码检出。
• 预览版不稳定——dsh 处于开发者预览阶段，迭代很快；固定你依赖的版本，并关注更新日志。

下一步

• 插件开发——写出你的第一个插件。
• 插件注册表——490+ 个真实插件。
• 更新日志——版本追踪。