前言¶
DSH 的理念是「一切皆插件」。DSH 社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。对经常使用 DSH Web 的开发者来说，已有做法通常是：打开终端，运行 dsh web，等待服务就绪，再手动打开浏览器。
下面介绍 cheng249hx/dsh-one-click-launcher：一个 DSH 插件，在 Windows 桌面生成一键启动本地 Harness Web 服务的快捷方式。
这是什么¶
dsh-one-click-launcher 是面向 Windows 10/11 的 DSH 插件，仓库位于 cheng249hx/dsh-one-click-launcher，许可证为 MIT，package.json 版本为 0.1.0。
它解决的是重复启动流程：安装并启用后，启动时写入 ~/.dsh/launch-dsh.bat 启动脚本，并在桌面创建指向该脚本的快捷方式（.lnk）。桌面快捷方式名称默认为 DSH Web。
运行环境要求：
- Windows 10/11
- 已安装
dshCLI - 已安装
pnpm
核心功能¶
- 启动时写入
~/.dsh/launch-dsh.bat - 创建指向启动脚本的桌面快捷方式（
.lnk） - 默认使用黑色鲸鱼图标，并提供蓝色
#4176e6变体 - 支持使用自定义
.ico图标 - 启动脚本每秒轮询一次端口，服务就绪后打开浏览器
- 等待失败时逐秒计数，120 秒后给出提示
- 零依赖、无需构建，使用纯 ESM JavaScript
- 关闭最小化的
DSH Server窗口会停止服务
安装与启用¶
确认 Windows 10/11 环境、dsh CLI 和 pnpm 已可用后，执行下面的安装命令：
dsh plugin --profile web add github:cheng249hx/dsh-one-click-launcher
该命令使用 --profile web，从 GitHub 安装插件。下面重启 dsh web，让插件在启动阶段生成文件：
dsh web
启用后，插件会在启动时写入 ~/.dsh/launch-dsh.bat，默认图标和启动脚本位于 ~/.dsh，并在桌面生成默认名称为 DSH Web 的快捷方式。
典型用法¶
1、安装后重启 dsh web：
dsh web
2、双击桌面上的 DSH Web 快捷方式启动服务。
3、服务启动后，脚本会等待端口就绪并打开浏览器；如果等待失败，会逐秒计数，120 秒后给出提示。
4、关闭最小化的 DSH Server 窗口可停止服务。
自定义图标¶
有三种可复现方式。
方式一：切换内置蓝色图标。在插件配置中设置：
icon: blue
icon 用于选择内置鲸鱼图标；blue 对应蓝色 #4176e6 变体。
方式二：使用自定义 .ico。在插件配置中设置：
iconPath: 'D:\icons\my-whale.ico'
iconPath 指向一个自定义 .ico 文件。
方式三：直接在桌面快捷方式上换图标。右键桌面快捷方式，打开“属性 → 快捷方式 → 更改图标”，选择任意 .ico 后确定。
注意：在配置中修改 icon 或 iconPath 后，需要先从桌面删除快捷方式，再重启 dsh web 重新生成：
dsh web
适用场景与注意¶
适合在 Windows 10/11 上长期使用 DSH Web、希望从桌面直接启动的开发者。
使用前注意：
- 插件以当前
dsh进程权限运行。安装前请检查源码与许可证。 - 修改配置后需要重启
dsh web才会重新生成快捷方式。 - 生成的
.bat使用纯 ASCII 和 CRLF 行尾，用于兼容 Windows 多语言环境。 - DSH 社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。
参考链接¶
目录页（来自插件线索）：
https://www.skillhub.cn/plugins/cheng249hx/dsh-one-click-launcher
GitHub：
https://github.com/cheng249hx/dsh-one-click-launcher
