资料核对日期:2026-11-16;未做本地安装实测。本文适用于通过命令行启动 DeepSeek Harness Web UI 的首次运行场景,依据官方仓库提交 39163dd30f703a79079e2d2446545cff3c453738 整理。该提交中的项目仍标注为开发者预览,可能出现破坏兼容性的变更,不能将主分支或本提交视为稳定版本。
准备条件
准备一套 Node.js 环境。仓库根目录的 package.json 要求 Node.js 版本为 >=24.9.0;具体安装方式和版本检查命令未在本次采用的官方说明中给出,请按 Node.js 官方方式完成安装与核对。
还需准备有效的 DeepSeek API 密钥。不要把示例文字、占位符或脱敏后的密钥预览当作实际密钥。官方提供的最小配置路线是在 Web UI 的“设置 → 模型”中填写并保存密钥,而不是使用未经当前资料确认的环境变量命令。
启动 Web UI
在终端执行官方 README 给出的命令:
npx @deepseek-ai/dsh web
默认情况下,Web UI 会在 http://127.0.0.1:3080 启动,并在本机调用默认浏览器打开页面。如果浏览器没有自动打开,可手动访问该地址。通过 SSH 启动时,程序只打印宿主机 URL;本地转发地址由 SSH 客户端或编辑器管理,不能直接假定宿主机 URL 在本地可访问。
本步骤的预期结果是能够打开 DeepSeek Harness Web UI。官方来源没有规定必须出现的终端日志原文,因此不要以某条自拟日志作为唯一验收依据。如果页面无法访问,而进程也未提供可判断的信息,应转到官方 Web UI 指南或 GitHub Discussions 核对当前提交的启动要求,不使用未经确认的端口参数或替代命令。
配置 DeepSeek 模型
打开“设置 → 模型”,在 DeepSeek 卡片中输入真实 API 密钥并保存。密钥保存后是只写的:页面只会获得脱敏描述符,不能再显示或复制明文。模型配置会在下一次请求时生效,不需要重启服务器。
随后选择一个已配置的 DeepSeek 模型。官方说明指出,选择模型也会把它设为新会话的默认模型。新会话入口的具体按钮名称待确认;如果当前界面文案不同,应以该提交对应的官方 Web UI 指南为准。
完成对话与最小任务
进入一个新会话后,先输入一条普通对话,例如:“请用一句话说明你能帮助我完成什么。”预期结果是界面产生一条对应的模型回复,而不是认证错误。
再输入一个边界清楚的文本任务:“把‘启动、配置、验收’按原顺序改写为三项有序列表,不要增加其他项目。”成功时,回复应保留原顺序,并且只包含启动、配置、验收三项。这里验收的是首次请求、连续对话和基本指令遵循,不据此宣称工具调用、文件操作或复杂智能体任务已经可用。
成功验收与失败检查
完成验收需同时看到三个结果:Web UI 可以打开;DeepSeek 密钥已经保存并选中可用模型;普通对话和最小文本任务都返回回复,且第二条回复满足项目数量与顺序要求。本文不以虚构日志、截图或“亲测成功”作为证据。
若请求返回 MISSING_CREDENTIAL,先回到“设置 → 模型”,重新填写并保存有效密钥,再发起下一次请求,无需重启服务。若密钥已保存但仍失败,应确认当前选择的是已配置模型。密钥检测状态本身不验证凭据,也不测试连接,因此看到已检测提示不等于请求一定成功。其他错误代码、模型可用范围以及当前版本限制,应以官方模型配置指南和仓库文档为准。