桌面快捷启动器 DBQDSS/dsh-desktop-shortcut

DeepSeek Harness 本地部署与桌面快捷方式设置

点击下方按钮切换至中文版本

Click the button below to switch to the Chinese version

本仓库的目的：为本地部署的 DeepSeek Harness（dsh）创建一个带有 DeepSeek 图标的 Windows 桌面快捷方式。双击该快捷方式即可启动 dsh Web UI（默认位于 http://127.0.0.1:3080，服务就绪后会自动在默认浏览器中打开）。

文件列表

├── Install_DSH.bat # 一键安装脚本（单文件，图标已内嵌） ├── assets/ │ ├── deepseek_logo.ico # DeepSeek 图标（16/24/32/48/64/128/256） │ └── icon_preview.png # 图标预览 ├── LICENSE ├── README.md # 本文档 └── README_zh.md # 中文版本

结果

- 在桌面上创建一个“DeepSeek Harness”快捷方式，使用 DeepSeek 鲸鱼标志作为其图标；
- 双击它会依次执行以下操作：切换到 D:\DSH\deepseek-harness → 调用 pnpm dsh web；
- Web UI 在 http://127.0.0.1:3080 启动并自动打开浏览器；控制台窗口保持打开，以便你可以实时查看服务日志。

前提条件

我在自己机器上运行的配置：

| 依赖项 | 版本 | 备注 |
| Windows | 10 / 11 | 快捷方式通过 WScript.Shell 创建 |
| Node.js | 24.11.0 | 从源码安装 dsh 所需 |
| npm | 11.6.1 | 从源码安装 dsh 所需 |
| Git | 2.54.0 | 用于克隆源码仓库 |

第 1 步：将 dsh 部署到本地路径

目录结构规划如下：

D:\
└── DSH\
├── pnpm\ # pnpm 运行时（包含 pnpm.cmd 的目录） ├── .pnpm-store\ # pnpm 存储（从 D:\.pnpm-store 迁移而来；参见第 2 步） ├── deepseek-harness\ # dsh 源代码 ├── Install_DSH.bat └── deepseek_logo.ico

1. 安装 pnpm

将 pnpm 安装到专用目录（本教程中为 D:\DSH\pnpm）：先设置 npm 全局安装前缀，然后运行安装：

1. 创建目录
mkdir D:\DSH\pnpm

2. 将 pnpm 安装到该目录（通过 npm）
npm install -g pnpm --prefix D:\DSH\pnpm

3. 验证安装 D:\DSH\pnpm\pnpm.cmd --version 如果打印出版本号，则说明安装成功。
在 Windows 上，全局可执行文件（pnpm.cmd）直接生成在前缀目录中，即 D:\DSH\pnpm\pnpm.cmd。将该目录（D:\DSH\pnpm）添加到“环境变量 → 系统变量”下的 PATH 中。

2. 克隆源代码并构建

cd D:\DSH
git clone https://github.com/deepseek-ai/deepseek-harness.git
pnpm install
pnpm run build

pnpm run build 会生成运行时所需的库文件和前端资源。这是启动 Web UI 的强制前提，绝不能跳过。此步骤耗时较长，请耐心等待。

3. 验证启动

pnpm dsh web

默认情况下，Web UI 会在 http://127.0.0.1:3080 启动并自动打开浏览器。确认页面正常加载后，停止服务并继续下一步。

步骤 2：将 pnpm-store 迁移到 D:\DSH（可选）

首次执行 pnpm install 后，D 盘根目录下会出现一个 .pnpm-store 文件夹。这是 pnpm 的内容寻址存储：pnpm 通过硬链接复用依赖文件，而硬链接要求存储和项目的 node_modules 位于同一卷上。因此，当项目位于 D 盘时，pnpm 会自动在 D 盘根目录创建该存储。

关于“链接”的说明：node_modules 与存储之间的关系不是符号链接，而是硬链接。在同一卷内移动文件夹不会破坏硬链接，因此无需逐个修复任何链接；迁移过程中真正需要更改的是 pnpm 配置中的 store-dir 设置。操作顺序必须是“先更新配置，再移动文件夹”——如果直接移动文件夹，pnpm 会在下次运行时在旧路径重新创建一个空存储并重新下载所有依赖，使迁移后的文件夹成为孤立的冗余数据。

迁移步骤（操作前请关闭所有正在运行的 pnpm / dsh 进程）：
1. 检查当前存储位置（默认输出 D:\.pnpm-store）
pnpm store path

2. 将存储指向新位置（写入用户级全局配置）
pnpm config set store-dir D:\DSH\.pnpm-store

3. 移动文件夹（同一卷内移动是瞬时的，且硬链接保持有效） move D:\.pnpm-store D:\DSH\.pnpm-store

4. 验证配置已生效；应输出 D:\DSH\.pnpm-store\v11（v11 是我的版本）
pnpm store path

补充说明：
- store-dir 设置会写入用户级配置文件（%USERPROFILE%\.npmrc），并适用于所有项目。它与 pnpm 自身的安装位置无关，重新安装 pnpm 不会丢失此设置；
- 不建议将存储放在 D:\DSH\pnpm（pnpm 程序目录）内：将程序与其数据混在一起，会在未来的升级或迁移过程中带来误删风险。将 D:\DSH\.pnpm-store 保留为独立目录是更安全的选择。

步骤 3：创建桌面快捷方式

从本仓库下载 Install_DSH.bat 并双击运行。该脚本会自动完成两件事：

1. 将内嵌的 DeepSeek 图标（Base64 编码）提取到 D:\DSH\deepseek_logo.ico；
2. 通过 WScript.Shell 在桌面上创建“DeepSeek Harness.lnk”，其属性如下：

| 属性 | 值 |
| 目标 | powershell.exe -NoExit -Command Set-Location D:\DSH\deepseek-harness; D:\DSH\pnpm\pnpm.cmd dsh web |
| 起始位置 | D:\DSH\deepseek-harness |
| 图标 | D:\DSH\deepseek_logo.ico |

当你看到两行 [OK] 输出时，安装即完成。

Windows 可能会针对未签名的脚本显示 SmartScreen 提示；直接确认继续即可。最终结果如右图所示。

许可证

本仓库中的脚本依据 MIT 许可证 发布。上游 DeepSeek Harness 仓库同样采用 MIT 许可证。DeepSeek 图标的所有权利归 DeepSeek 所有；此处使用它仅出于个人桌面便利之目的——在任何公开再分发之前，请自行核实 DeepSeek 的商标使用政策。

参考资料

- DeepSeek Harness 官方仓库：