安装并启动 Harness
准备 Node.js、独立练习目录,使用 npx 启动本地 Web UI。
先准备运行环境
以下操作在你准备好的隔离测试环境中进行。需要联网下载软件、安装权限,以及后续调用模型时使用的 DeepSeek API 密钥。调用可能计费;没有密钥可以先读教程,不要向陌生人购买共享密钥。
本教程选用 Node.js 24 LTS。官方当前源码声明支持 Node.js 22.19 所在的 22.x 版本线或 24 及以上;旧 Node.js 20 不在这个范围内。已有业务项目依赖旧版本时,请使用独立环境,不要直接覆盖。
打开练习文件夹和终端
没有显示版本号时,先关闭并重开终端;仍提示找不到命令,请回到 Node.js 安装说明,不要继续粘贴后续命令。
- 在测试环境里新建 harness-practice 空文件夹。不要选择整个桌面、文档目录或含真实工作资料的项目。
- 用 VS Code 打开这个文件夹,选择顶部“终端 → 新建终端”。这里输入的是电脑命令,不是发给 AI 的消息。
- Mac 可使用默认终端;Windows 可使用 PowerShell。先逐行运行下面两条命令,确认都能显示版本号。
node --version
npm --version启动浏览器操作界面
npx 会获取并运行 npm 上的 @deepseek-ai/dsh 包。首次运行可能询问是否安装;核对包名无误后再同意,等待终端输出访问地址。无需克隆源码,也不需要先全局安装 dsh。
默认地址是 http://127.0.0.1:3080。浏览器未自动打开时,把终端实际打印的地址复制到地址栏。127.0.0.1 指当前这台电脑,不是一个可发给别人访问的网站。
终端持续运行而没有回到输入提示符,是本地服务在工作。先不要关闭它;下一篇会在浏览器里配置密钥和工作区。首次下载失败时不要用管理员权限反复重试,查看排错页。
npx @deepseek-ai/dsh web停止与再次启动
暂时不用时,回到启动服务的终端按 Ctrl+C(Mac 也是 Control+C,不是 Command+C)。仅关闭浏览器标签不等于停止服务;若任务正在运行,先在界面中停止任务并检查文件。
下次使用时,重新打开同一个练习文件夹和终端,再运行启动命令,然后访问终端打印的地址。若遇到更新后的界面差异,先核对官方说明;更新前保留练习文件副本。
不要把服务改为对公网开放,也不要为了远程访问随意关闭认证或网络防护。