安装 DeepSeek Harness:Node、Web UI 与首次检查
使用官方 @deepseek-ai/dsh 启动器,从要检查的项目目录运行固定版本 0.2.0-rc.2。先确认 Node 和 npm 能执行,再等待进程打印本地地址,选择工作区并配置模型。包安装、Web 页面可访问和真实模型请求是不同验收阶段;本站保留的 0.1.0-rc.7 Linux HTTP 200 记录不会移植到新发布版本。
分享仅包含公开链接,不携带本地进度或私人配置。
使用此命令开始
使用前阅读下方检查步骤,再修改参数、凭据或配置。
npx @deepseek-ai/dsh@0.2.0-rc.2 web安装前确认终端和运行时
当前包快照没有声明 engines.node,不应自行补一个“官方最低版本”。先确认 Node 与 npm 可执行,按官方 README 使用 npm 启动流程;遇到原生依赖或运行时错误时,记录实际版本再定位。
- Windows 明确是在 PowerShell 还是 WSL,不混用两侧路径。
- macOS 和 Linux 先进入要交给 Agent 检查的项目目录。
- 网络或代理出错时,记录它发生在下载阶段还是进程启动后。
node --version
npm --version预期检查: 两条命令应各输出版本号并正常退出。command not found 表示当前终端尚未找到工具;版本号出现只证明运行时可执行。
固定启动版本,等待服务地址
首次下载可能需要时间,观察终端是否仍在下载、是否已经退出,以及是否打印服务地址。不要把浏览器没有自动打开当作进程失败;手动访问终端地址。下方输出描述是官方流程的预期检查,未冒充当前包的本机运行日志。
npx --yes @deepseek-ai/dsh@0.2.0-rc.2 web --no-open预期检查: 进程正常启动后应打印 Web 地址并继续运行。默认地址为 http://127.0.0.1:3080,以本次终端实际输出为准;--no-open 刻意关闭浏览器自动打开。
区分本地浏览器与远程终端
本机终端启动后,打开它打印的 127.0.0.1 地址;SSH 终端的 127.0.0.1 指远端,应按你的 SSH 或编辑器设置转发端口。PowerShell 中可用 Get-Location 检查当前目录,Unix shell 用 pwd。保留项目目录中的文件并确认选中的工作区是同一路径。
选择工作区、提供商与模型
打开页面后,通过 Choose workspace 添加并选择项目。再进入 Settings → Models 保存实际提供商的凭据,选择模型并创建新会话。页面加载成功不会自动完成这两项设置;自定义网关先核对地址、协议与模型 ID。
用一个只读任务完成首次验收
请求“指出这个仓库的测试命令和定义文件,暂时不要修改文件”。人工检查文件和命令后再扩大任务。若缺凭据去修复模型路由,若模型未知核对 ID,若服务启动就退出查看启动诊断,不为所有错误重复重装 Node。
安装流程的分阶段检查
| 阶段 | 可观察结果 | 结果不符合时 |
|---|---|---|
| Node 与 npm | 命令输出实际版本并退出 | 检查安装与当前终端 PATH |
| 下载与启动 | 固定包版本启动,进程打印地址 | 记录下载错误或启动诊断 |
| 浏览器与工作区 | 页面可访问且项目被选中 | 检查地址、转发或工作区设置 |
| 模型与第一个任务 | 所选模型返回可核对的事实 | 按凭据、模型 ID、协议排查 |
常见问题
npx 下载很久,是否一定是 Web 超时?
先看进程阶段。包还在下载时,问题属于 registry、网络或包管理器;已经启动但地址打不开时,再查服务、端口或转发。不要把不同阶段合为同一个 timeout。
浏览器没有自动打开,如何继续?
检查终端是否打印了地址且进程仍在运行;--no-open 本就关闭自动打开,SSH 启动也可能只打印地址。按当前运行位置手动打开或转发地址。
网页能打开,但为什么不能发送任务?
先确认工作区已经选择,再检查提供商凭据和模型选择。页面可访问只完成了服务阶段,不证明模型请求已准备好。
安装固定版本是否意味着网站已验证这个版本?
不是。固定版本利于复现;本站另标实际测试的版本与环境。当前元数据和官方文档说明不能替代一次真实执行。
官方资料
使用新版本前,打开以下固定版本或注明核验日期的资料。