在 DSH 中开发或运行本地服务时,通常需要打开 PowerShell、输入命令并等待服务启动,然后再打开浏览器访问。dsh-shortcut-creator 把这个流程压缩到了设置页的一个表单里。它通过 PowerShell 在本地生成启动脚本,并创建桌面快捷方式,支持自动打开浏览器和尝试固定到任务栏。
插件简介¶
- 名称:dsh-shortcut-creator
- 维护者:Yvesgao
- 类别:客户端
- 许可证:MIT
- 定位:在 DSH 设置页一键创建 Windows 桌面快捷方式,把任意本地服务变成双击启动的桌面图标,自动打开浏览器,还能固定到任务栏。
核心功能¶
-
设置页 UI
插件在 DSH 设置页注册settings.section「Desktop Shortcut」,提供一个表单,用于填写名称、命令、URL 和工作目录。 -
Host JSON API
通过POST /plugins/desktop-shortcut/api/install执行 PowerShell 引擎,并使用.../status接口上报平台状态。 -
启动器生成
生成带端口检查的.cmd启动器。如果服务已在运行,则直接打开浏览器;否则等待服务启动后打开浏览器,并保持窗口存活(关闭窗口即停止服务)。 -
任务栏固定
尝试程序化固定快捷方式。当目标类型无法程序化固定时,会打印「固定运行中窗口」的兜底指引。
安装与启用¶
使用 bundle 形式安装,安装后需要重启 web 进程。
dsh plugin --profile web add github:Yvesgao/dsh-shortcut-creator#main
安装完成后,重启 dsh web 进程,插件生效。
使用方法¶
- 打开 设置 → Desktop Shortcut。
- 填写表单信息,包括名称、命令、URL 和工作目录。
- 点击创建,插件会生成
.cmd启动器、桌面.lnk快捷方式,并尝试固定到任务栏。
适用场景与注意¶
- 平台限制:仅支持 Windows 平台。设置页在所有平台会出现,但非 Windows 平台会报错提示(依赖 PowerShell 引擎)。
- 进程重启:安装后必须重启 web 进程才能加载新插件。
- 插件管理:已装插件推荐使用 plugin-registry 的薄控制台进行管理(浏览器面板),支持堆栈管理、插入行和启停操作,无需手动修改配置。