DeepSeek Harness 安装与 Web UI 启动指南

最短安装方式 DeepSeek Harness 官方当前推荐通过 npx 启动 Web UI，不要求先全局安装 DSH： 启动成功后访问 http://127.0.0.1:3080。本文适用于官方源码版本 0.1.0 rc.5；DSH 是 Developer Preview，若未来版本改变命令，应以官方 README 为准。 检查 Node.js 版本 根包声明的 Node.js 范围不是笼统的“Node 22+”，而是 ^22.19.0 =24.0.0。执行： 符合条件的例子包括 Node 22.19.0 及之后的 22.x，以及 Node 24 或更高版本。Node 23 不在官方声明范围内。版本不符合时先切换 Node，再处理 DSH 错误，否则容易把运行时问题误判成项目故障。 选择启动目录 在准备作为默认 workspace 根目录的项目目录中运行启动命令： Windows PowerShell、macOS 和 Linux 的核心命令一致，路径写法按各自终端调整。启动目录提供默认工作区位置，但新的 Web UI 仍要求你在界面中添加并选中 workspace；没有选中时输入区可能不可用。 验证 Web UI 浏览器打开 http://127.0.0.1:3080，然后依次验证：页面能加载；Settings → Models 可用；能添加并选择测试 workspace；输入区变为可用；配置模型后能完成只读任务。 输入框不可用时看工作区未选择修复；地址打不开且终端提示端口冲突时看3080 端口占用修复。 修改端口 默认 3080 已被占用时，可以指定另一个本地端口： 然后访问 http://127.0.0.1:8080。官方 CLI 当前有意拒绝 host 0.0.0.0，因此不能把普通 Web 框架的监听参数直接套用到 DSH。 trusted host 增加的是浏览器 API 接受的具名 authority，并不等价于开放监听地址。 从源码运行 需要参与开发或审计源码时，官方步骤是： 源码运行需要 pnpm；普通 npx 快速启动与插件管理不是同一个流程。CLI 的插件管理命令会把参数转发给 pnpm，因此准备安装第三方插件时也必须保证 pnpm 在 PATH 中。 安装完成后做什么 继续按DeepSeek Harness 中文入门配置模型和第一次任务。API Key、Provider 或模型 ID 有问题时，进入模型与 Provider 配置指南。 不要把“Web UI 打开”当作完整验收。真正的完成条件是：版本符合、模型路由有效、工作区明确、任务结果可验证，并且没有把凭据或敏感目录暴露给不必要的工具。