资料核对日期:2026年11月18日。本文依据仓库提交 ca33fd6843b205e279c7ccb6cb73a472c78f5760 对应的官方文档整理,未做本地安装实测。该提交是本文的文档核对基线,不应被表述为稳定版本;项目当前明确处于开发者预览阶段,后续可能发生破坏兼容性的变更。
先分清框架与模型
DeepSeek Harness(命令名为 dsh)的官方定位是开源 agent harness,即智能体运行框架。它采用“一切皆插件”的架构,并由 Cordis 驱动。模型则是智能体可能使用的能力来源,不能与承载插件、组合配置并启动应用的 Harness 本身混为一谈。
因此,首次打开 Web UI 只能用于确认 Harness 的 Web profile 已启动,不能据此宣称某个模型已经接入、API 密钥已经配置或模型调用已经成功。模型插件、服务商、密钥字段及调用验证不在本次最小启动路线中;相关配置应继续按对应插件及官方用户指南核对,密钥示例或占位符不得作为真实凭据使用。
环境与版本边界
本次任务需要本机已经安装 Node.js,但当前官方入门页没有给出明确的最低或推荐版本,具体版本要求为待确认。通过源码运行还需要 Git 与 pnpm,其版本要求同样为待确认。
运行命令时所在目录会成为默认 workspace 根目录,因此应先进入准备作为工作区的目录。首次使用 web profile 时,CLI 会从随附模板自动初始化该 profile;这属于 Harness 的首次配置过程,不代表模型配置已完成。
最小启动路线
在预定工作区中执行官方原文命令:
npx @deepseek-ai/dsh web
预期结果是 Web UI 在 http://127.0.0.1:3080 启动。本机启动时,默认浏览器还会自动打开页面。如果只希望运行服务器而不自动打开浏览器,可执行:
npx @deepseek-ai/dsh web --no-open
通过 SSH 启动时,终端只会打印宿主机 URL;本地转发地址由 SSH 客户端或编辑器掌握。此时不能仅以“浏览器没有自动打开”判断启动失败。
固定仓库版本与源码运行
官方文档给出的源码流程如下:
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web
其中 pnpm run build 准备仓库产物,随后 pnpm dsh web 直接使用已构建产物,不会重新构建。不过,上述克隆命令本身没有固定到本文核对的提交。若任务要求精确复现 ca33fd6843b205e279c7ccb6cb73a472c78f5760,固定检出步骤为待确认,不能把默认分支直接称为稳定版本或固定版本。
失败检查
若命令未正常启动,先查看进程是否以非零状态退出。官方说明,无效命令、混用其他模式的选项,以及致命配置或启动错误都会导致非零退出。其次确认当前目录是否确实是预期 workspace,并检查首次初始化后再启动是否仍然失败。若终端报告端口冲突,应按官方 Web UI 指南核对可用应用参数,不使用未经当前资料确认的参数组合。源码路线还应确认 pnpm run build 已成功完成,因为生产运行需要已构建的包和前端产物。仍无法定位时,可通过项目的 GitHub Discussions 提交反馈或 bug 报告,并附上实际命令、退出状态及原始错误信息。