dsh 一键启动器

English | 中文

一个 DeepSeek Harness 插件：在 Windows 桌面生成一键启动本地 Harness Web 服务的快捷方式。

为什么做这个

平时启动 DeepSeek Harness Web 需要：打开终端 → 敲 dsh web → 等启动 → 再手动打开浏览器。这个插件把这些全部去掉：

• 启动时自动写入 ~/.dsh/launch-dsh.bat —— 一个会"在正确的时机打开浏览器"的启动脚本；
• 并在桌面创建指向它的快捷方式（.lnk），图标可自定义。

以后双击桌面图标即可，完事。

特性

• 不盲等：脚本每秒轮询一次端口，服务一就绪立刻开浏览器；如果服务已经在运行，直接打开浏览器。
• 绝不提前开浏览器：失败时显示逐秒等待计数，120 秒后给出清晰提示。
• 自动收尾：浏览器打开后启动器窗口自动退出；最小化的 DSH Server 窗口就是服务本体（关闭它=停止服务）。
• 默认鲸鱼图标：快捷方式默认使用黑色鲸鱼图标；插件还附带一个蓝色（#4176e6）变体，也支持你自备任意 .ico（见自定义图标）。
• 零依赖、无需构建：纯 ESM JavaScript，可以直接从 GitHub 安装。

环境要求

• Windows 10/11（启动器是 .bat + .lnk）
• 已安装 dsh CLI
• pnpm（dsh plugin 内部转发给 pnpm）

安装

# 安装进 web profile（或其他任意 profile）
dsh plugin --profile web add dsh-one-click-launcher

直接从 GitHub 安装（无需构建脚本）：

dsh plugin --profile web add github:cheng249hx/dsh-one-click-launcher

从 tarball 安装：

pnpm pack
dsh plugin --profile web add ./dsh-one-click-launcher-0.1.0.tgz

重启 dsh web。启动时插件会：

1. 写入 ~/.dsh/launch-dsh.bat；
2. 把两个内置鲸鱼图标复制到它旁边——~/.dsh/DeepSeek Harness.ico（黑色，默认）和 ~/.dsh/DeepSeek Harness Blue.ico（蓝色 #4176e6）；
3. 在桌面创建带黑色鲸鱼图标的 DSH Web 快捷方式。

使用

双击桌面上的 DSH Web 快捷方式即可。

• 关闭最小化的 DSH Server 窗口会停止服务。
• 浏览器打开后，启动器窗口会自动退出。
• 修改配置后想重新生成快捷方式：先从桌面删除它，再重启 dsh web。

自定义图标

三种方式，从简到繁：

1. 切换两个内置鲸鱼之一。 在插件配置里设置 icon：

- update:
    - id: desktop-launcher
      config:
        icon: blue        # 'black'（默认）或 'blue'（#4176e6）

图标位于 %USERPROFILE%\.dsh\DeepSeek Harness.ico 和 %USERPROFILE%\.dsh\DeepSeek Harness Blue.ico。

2. 使用你自己的 .ico。 用 iconPath 指向任意图标文件：

- update:
    - id: desktop-launcher
      config:
        iconPath: 'D:\icons\my-whale.ico'

3. 在桌面直接换，无需配置。 右键快捷方式 → 属性 → 快捷方式 选项卡 → 更改图标… → 选择任意 .ico → 确定。纯外观修改，重启后依然生效。

在配置里修改 icon/iconPath 之后，先从桌面删除快捷方式，再重启 dsh web，插件会用新图标重新生成。

配置

编辑你 profile 的 cordis.patch.yml（例如 ~/.dsh/profiles/web/cordis.patch.yml），或用 --patch overlay：

- update:
    - id: desktop-launcher
      config:
        icon: 'blue'                         # 'black'（默认）或 'blue'
        iconPath: 'D:\icons\my-whale.ico'    # 自定义 .ico（优先级高于 icon）
        shortcutName: 'DSH 网页端'            # 快捷方式文件名（不含 .lnk 后缀）
        port: 3080                           # 启动器等待的端口

字段	默认值	说明
icon	black	内置鲸鱼图标：black 或 blue（#4176e6）
iconPath	(见 icon)	自定义 .ico 的绝对路径；优先级高于 icon
shortcutName	DSH Web	桌面快捷方式名称（不含 .lnk）
port	3080	打开浏览器前等待的端口
launcherDir	~/.dsh	launch-dsh.bat 和图标的写入位置
desktopDir	系统桌面	快捷方式创建位置（主要用于测试）
dshCommand	自动检测	生成脚本使用的 dsh 命令
enabled	true	设为 false 可禁用文件生成

工作原理

本包是一个 Cordis 组合包：package.json 声明 dsh.bundle.patch，cordis.patch.yml 插入插件行，index.js（零依赖纯 ESM）在启动时的 apply() 里写入启动器文件。

生成的 .bat 刻意使用纯 ASCII + CRLF 行尾，保证在任何 Windows 语言环境下都能被正确解析。

License

MIT