@linxin666/dsh-desktop-launcher

English | 中文

在桌面创建一个一键启动图标：双击图标启动 dsh web（未运行时），等待 GUI 就绪后自动打开浏览器到配置的地址。支持 Windows（.lnk）、macOS（.command） 与 Linux（.desktop）。

是什么

• 设置 → 插件配置 → Web UI 插件 卡片内有「创建桌面图标」按钮；host 把启动脚本 写到 ~/.dsh/desktop-launcher/，并把图标放到桌面。
• 双击行为：先探测 GUI 地址；已在响应则直接打开浏览器且不启动新进程；否则后台启动 dsh web --no-open（Windows 隐藏窗口），最多轮询 30 秒后由启动器只打开一个浏览器标签。关闭标签不会结束后台服务；需要退出 DSH 时使用页面内的关机按钮。找不到 dsh 命令时弹提示，而不是静默失败。
• 每次点按钮都会按当前设置重新生成启动脚本，因此 dshCommand / url / profile 修改后重新创建即生效，无需手动改图标目标。
• Windows 启动器与快捷方式安装脚本使用带 BOM 的 UTF-8 写出，兼容 Windows PowerShell 5.1 和非 ASCII 用户路径。命令解析优先选择 npm 的 dsh.cmd/可执行 shim，而不是 dsh.ps1；仅剩 PowerShell 脚本时会显式经 powershell.exe 调用，不触发系统文件关联。
• Windows 快捷方式使用 DeepSeek Harness 鲸鱼图标（白底），启动时弹出深色风格的「启动中」小窗代替黑窗：实时显示进度（启动 dsh、等待 GUI 就绪），失败时（找不到命令 / 超时）红字提示并提供「确定」按钮。

安装

从 npm 安装（推荐）

dsh plugin --profile web add @linxin666/dsh-desktop-launcher

从仓库安装（开发调试）

git clone https://github.com/zhu1090093659/dsh-web.git
cd dsh-web
pnpm install
pnpm -r build
dsh plugin --profile web add link:$(pwd)/packages/dsh-desktop-launcher

重启 dsh web，打开「设置 → 插件配置 → Web UI 插件」，先开启插件（默认关闭），再点「创建桌面图标」。

配置

所有字段都在插件设置卡片（或组合条目）中：

字段	默认值	含义
enabled	false	插件总开关；默认关闭。
announceToAgent	false	按需开启：开启后在系统提示词中公告本插件。
dshCommand	dsh	启动 dsh 的命令，需在 PATH 中。
url	http://127.0.0.1:3080	启动器等待就绪并打开的 GUI 地址。