Windows 安装 DSH

下载官方 Windows x64 安装包，完成安装、模型配置和首次任务验证。

本页内容

先下载 Windows 桌面版

官方 EXE 安装包已包含运行环境，无需另装 Node.js。准备可联网的 Windows x64 电脑和模型服务商凭据；模型 API 额度需自行准备。

第 1 步

在浏览器下载列表中找到 dsh-latest-windows-x64.exe，确认来源为 download.deepseek.com，并等待文件下载完成。
双击 EXE，按照安装程序提示完成安装。
从 Windows 开始菜单打开 DeepSeek Harness，再按下方步骤配置模型。

更新前备份 Desktop 数据

有 Windows 用户报告从 0.2.1-rc.5 更新至 0.2.2-rc.1 后，工作区记录、会话和插件状态消失，项目文件仍在。原因与官方修复尚未确认。更新前请退出 DSH，确认实际 DSH_HOME 路径，并将数据备份到独立位置；备份可能包含凭据，请妥善保管。查看用户报告 ↗

第 2 步

打开官方 DeepSeek Harness Desktop，按应用内首次启动提示完成设置。模型 API Key 在下一步配置。

检查启动结果

能看到 DSH 对话主界面。应用打不开或闪退时，查看桌面端排错。

第 3 步

API Key 是 DSH 调用 DeepSeek 时使用的密钥。没有的话，先到 DeepSeek API Keys 创建。

回到 DSH，打开设置（Settings）→ 模型（Models）→ DeepSeek，粘贴 API Key 并保存。随后打开模型选择器，选中 DeepSeek 下可用的模型。

不要把真实 API Key 放进截图、代码仓库或公开的求助消息。API 余额不足时，即使保存了 Key，也无法完成请求。

检查模型选择

模型选择器显示已选模型的名称，而不是 Select model。

第 4 步

在文件资源管理器中新建空文件夹 dsh-test。回到 DSH，点击选择工作区（Choose workspace），添加并选中这个文件夹。第一次不要选重要项目。

检查工作区

界面显示已选中的 dsh-test。如果输入框仍是灰色，检查工作区和模型是否都已选中。

第 5 步

复制下面这句话发给 DSH：

请使用工具读取当前工作区的完整路径，并列出这个文件夹里的文件。不要创建、修改或删除任何文件。

检查测试结果

模型正常回复，工具返回的路径与 dsh-test 完整路径一致，文件列表也与电脑上的文件夹一致。仅在回答中出现文件夹名称，还不能确认工具读取成功。

检查通过后，可以继续创建第一个文本文件。如果请求失败，按下面的症状排查。

这与桌面安装包是两种独立的启动方式。已经打开 DSH Desktop 的用户，不需要再执行以下命令。

打开 Node.js 下载页，选择 Node 24 LTS 和当前操作系统的安装包。运行 Windows Installer（.msi）。安装完成后重新打开终端。
按 Windows 键，搜索 Terminal，打开 Windows Terminal 并使用 PowerShell。
运行 node --version 和 npm --version。对于 v0.2.2-alpha.2，Node 需不低于 24.9.0；旧版请核对对应包的要求。
运行 npx @deepseek-ai/dsh web。
首次运行可能需要下载 DSH。如果出现 Ok to proceed?，核对包名后输入 y。浏览器未自动打开时，复制终端打印的完整地址（包括可能附带的访问令牌）。默认本机端口是 3080。
保持终端运行，从配置 API Key继续。结束使用后，在终端按 Ctrl+C 停止服务。