Windows 安装 DSH（DeepSeek Harness），一键安装、双击启动（附工具包hsx-dsh-tools-v0.1.2）
文章目录
1. hsx-dsh-tools 简介
DeepSeek Harness（命令行工具名 dsh）是深度求索（DeepSeek）官方开源的智能体（Agent）开发框架，2026 年 8 月正式开源后迅速走红，GitHub 星标已突破 21 万。它秉持"一切皆插件"（Everything is a Plugin）的设计理念，把大模型接入文件、终端、网页与各类工具，由框架统一编排上下文、工具调用与任务执行，官方用"Agent = 大模型 + Harness"概括其定位。这样一个功能强大的框架，日常却要在命令行里一步步配置 Node.js、全局安装 @deepseek-ai/dsh、再手动启动服务，对没有开发经验的新手并不友好。
hsx-dsh-tools（寒水馨 DeepSeek Harness 工具集）正是为消除这道门槛而生。作者把"装环境、装框架、启动服务、保持最新"这四件事封装成三个双击即可的 exe，让没有任何 Node.js 经验的用户也能在 Windows 上一键跑起 DeepSeek Harness 的 Web 界面。整套工具用 Go 编写，绿色免安装、不写注册表，全中文界面并内置应用图标。
hsx-dsh-tools 的核心特点：
- 一键安装：自动检测并安装 Node.js（缺失时从国内镜像下载 LTS 版静默安装）、全局安装
@deepseek-ai/dsh，并创建桌面快捷方式 - 一键启动：启动 DeepSeek Harness 的 Web 界面，自动打开浏览器
- 一键升级：把
@deepseek-ai/dsh升级到 npm 最新版并校验 - 国内镜像加速：npm 自动切换到国内镜像源，下载与安装更快更稳
- 全中文界面：控制台彩色输出（
[OK]绿 /[警告]黄 /[失败]红），步骤提示清晰 - 绿色免安装：解压即用，删除文件夹即可卸载，无注册表残留
2. v0.1.2 版本亮点
hsx-dsh-tools v0.1.2 是首个对外正式发布版本，整合了 0.1.0 / 0.1.1 / 0.1.2 的全部功能与修复；目前仅支持 Windows 10 / 11（x86_64），macOS 与 Linux 暂未提供。
2.1 一键三连：三个免安装 exe
工具包内包含三个独立程序，按需双击即可：
安装DeepSeekHarness.exe：首次部署，一键准备好运行环境启动DeepSeekHarness.exe：日常使用，启动 Web 界面升级DeepSeekHarness.exe：有新版时一键升级
三个 exe 均为绿色免安装独立程序，解压即用、自带多分辨率图标；控制台全程中文分步提示，exe 的属性信息（版本、文件说明、语言）同样为中文。安装完成后还会在桌面创建「启动 DeepSeek Harness」快捷方式。
2.2 关键修复与改进
- 修复全新机器安装失败：此前安装器未提权就静默执行需要管理员的 Node MSI，导致 msiexec 退出码 1603；本版启动时会自动请求一次 UAC，以管理员身份完成安装
- 升级程序同步自提权：
npm update -g需写入 Program Files，此前会因权限不足失败，现已修复 - 可排查性：msiexec 保留详细日志，若安装仍失败会给出日志路径便于定位
- 构建自动化：exe 的版本 / 语言资源由构建脚本按统一版本号自动生成，与
--version、发行包命名保持一致
2.3 面向新手的细节
- 自动安装 Node.js：检测到系统缺少 Node.js 时，自动从国内镜像下载 LTS 版（Node 24.x）并静默安装
- 国内镜像加速：npm 自动切换国内源，下载与安装更快更稳
- 安装可靠：自动处理 UAC 提权后的等待、校验下载文件完整性，避免装到一半失败
3. 获取工具包
如果访问 GitHub 不便，工具包及中文文档：https://hanshuixin.org/go/225Y（内含三个 exe、README 中英对照、发布说明中英对照和 LICENSE）。
hsx-dsh-tools 其他版本：https://hanshuixin.org/resource/software_integrated_package/Windows/hsx-dsh-tools
Windows安装hsx-dsh-tools-v0.1.2（工具包hsx-dsh-tools-v0.1.2）.zip
├── hsx-dsh-tools-windows-x64-0.1.2/ ← 程序文件夹（解压后进入此文件夹运行）
│ ├── 安装DeepSeekHarness.exe ← 首次部署先双击
│ ├── 启动DeepSeekHarness.exe ← 日常使用，双击启动 Web 界面
│ ├── 升级DeepSeekHarness.exe ← 有新版时双击升级
│ └── LICENSE
├── Windows安装hsx-dsh-tools-v0.1.2（工具包hsx-dsh-tools-v0.1.2）.pdf
├── README/
│ ├── README.md
│ └── README-中文版.md
├── 发布说明/
│ ├── RELEASE-NOTES.md
│ └── RELEASE-NOTES-中文版.md
└── LICENSE适用于 Windows 10 / 11 x86_64（x64）。安装与升级过程需要联网。
4. 安装
4.1 环境要求
- 操作系统：Windows 10 / 11（64 位）
- 网络：安装与升级需要联网（工具已内置国内 npm 镜像加速）
本工具为绿色免安装包：无需安装程序、不写注册表。把工具包解压后得到的整个文件夹放到任意位置（例如
C:\Program Files\hsx-dsh-tools\）；日后删除该文件夹即可卸载。
4.2 一键安装
进入工具包解压后的程序文件夹 hsx-dsh-tools-windows-x64-0.1.2/，双击 安装DeepSeekHarness.exe（需要联网；若弹出 UAC 提示，请点击"是"）。
工具会自动完成四件事：
- 检测系统是否已安装 Node.js，缺失时自动从国内镜像下载 LTS 版并静默安装；
- 将 npm 切换到国内镜像源；
- 全局安装
@deepseek-ai/dsh； - 在桌面创建「启动 DeepSeek Harness」快捷方式。
看到控制台输出绿色 [OK] 即安装完成。安装一般需要 1-2 分钟，请保持窗口打开等待结束。
安装成功之后，桌面会出现一个快捷方式，方便后续使用时直接在桌面启动：
三个 exe 均为控制台程序：运行后请保持窗口打开，关闭窗口即停止服务。
5. 使用
5.1 一键启动 Web 界面
双击程序文件夹中的 启动DeepSeekHarness.exe（或桌面「启动 DeepSeek Harness」快捷方式），它会先检查 dsh 是否已安装并显示版本，再启动 DeepSeek Harness 的 Web 服务。
服务启动后，浏览器会自动打开 Web 界面（默认地址 http://127.0.0.1:3080）；如未自动打开，可手动访问该地址。
点击“继续”
首次使用时，需配置 DeepSeek API Key
首次运行 Web 界面需要配置一个 DeepSeek 的 API key：
打开 DeepSeek 开放平台 https://platform.deepseek.com/api_keys，登录后点击"创建 API key"，命名后创建并复制生成的 key（只完整显示一次，请及时保存）。
回到 Web 界面，在自动弹出的窗口中粘贴该 API key（之后也可随时在界面"设置 - 模型"中更换），选择要使用的模型后即可开始对话。
建一个文件夹作为默认工作区
输入要求，点击发送，开始工作
编程结果展示
5.2 一键升级
有新版发布时，双击程序文件夹中的 升级DeepSeekHarness.exe，它会自动把 @deepseek-ai/dsh 升级到 npm 上的最新版并完成校验（同样走国内镜像，更快更稳）。
5.3 常见问题排查
- 双击启动后提示"未检测到 @deepseek-ai/dsh"：先运行
安装DeepSeekHarness.exe完成环境部署。 - Web 界面打不开：确认启动窗口仍然开着（关闭窗口 = 停止服务），并确认访问地址是
http://127.0.0.1:3080。 - 安装 Node.js 时卡住或报错：多为网络问题，请检查网络后重试，也可前往 npmmirror 的 Node 下载页（npmmirror.com/mirrors/node/）手动下载对应版本
.msi安装。 - 网页提示没有 API key：按 5.1 小节在 DeepSeek 开放平台创建 API key，并在 Web 界面的模型设置中填入。