入门与配置 · 独立指南

安装 DeepSeek Harness:Node、Web UI 与首次检查

使用官方 @deepseek-ai/dsh 启动器,从要检查的项目目录运行固定版本 0.2.0-rc.2。先确认 Node 和 npm 能执行,再等待进程打印本地地址,选择工作区并配置模型。包安装、Web 页面可访问和真实模型请求是不同验收阶段;本站保留的 0.1.0-rc.7 Linux HTTP 200 记录不会移植到新发布版本。

核验 2026年10月4日开发预览版独立指南
资料状态: 依据官方资料核验;运行实测版本与当前发布版本分别标注。 新版本发布后请重新核对官方资料。
保存设置进度 →

分享仅包含公开链接,不携带本地进度或私人配置。

使用此命令开始

使用前阅读下方检查步骤,再修改参数、凭据或配置。

公开命令 · 不含密钥
npx @deepseek-ai/dsh@0.2.0-rc.2 web

安装前确认终端和运行时

当前包快照没有声明 engines.node,不应自行补一个“官方最低版本”。先确认 Node 与 npm 可执行,按官方 README 使用 npm 启动流程;遇到原生依赖或运行时错误时,记录实际版本再定位。

  1. Windows 明确是在 PowerShell 还是 WSL,不混用两侧路径。
  2. macOS 和 Linux 先进入要交给 Agent 检查的项目目录。
  3. 网络或代理出错时,记录它发生在下载阶段还是进程启动后。
检查命令
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 启动也可能只打印地址。按当前运行位置手动打开或转发地址。

网页能打开,但为什么不能发送任务?

先确认工作区已经选择,再检查提供商凭据和模型选择。页面可访问只完成了服务阶段,不证明模型请求已准备好。

安装固定版本是否意味着网站已验证这个版本?

不是。固定版本利于复现;本站另标实际测试的版本与环境。当前元数据和官方文档说明不能替代一次真实执行。

官方资料

使用新版本前,打开以下固定版本或注明核验日期的资料。

下一步阅读