dsh-desktop-shortcut

在 DSH 设置页一键创建 Windows 桌面快捷方式 —— 把任意本地服务（DeepSeek Harness、开发服务器、npx 工具）变成双击启动的桌面图标，自动打开浏览器，还能固定到任务栏。

功能

把「打开 PowerShell → 敲命令 → 再开浏览器」变成双击一下。在 设置 → Desktop Shortcut 里填一个小表单，插件自动完成：

1. 生成 .cmd 启动器 —— 在控制台窗口里启动命令、等 URL 就绪后自动打开默认浏览器、保持窗口存活（关窗即停服）；服务已在运行则直接打开浏览器。
2. 创建桌面 .lnk 快捷方式 —— 指向启动器（DeepSeek Harness 用 Node.js 图标）。
3. 尝试固定到任务栏 —— 目标类型无法程序化固定时，打印「固定运行中窗口」的兜底指引（永远有效）。

核心逻辑由打包内置的、自包含的 assets/New-DesktopShortcut.ps1 完成（零外部依赖，也可独立运行）。

能力清单

能力	说明
设置页 UI	settings.section「Desktop Shortcut」：名称 / 命令 / URL / 工作目录表单
Host JSON API	POST /plugins/desktop-shortcut/api/install 执行 PowerShell 引擎；.../status 上报平台
启动器生成	带端口检查的 .cmd，自动开浏览器，兼容「已在运行」场景
任务栏固定	尽力程序化固定 + 「固定运行中窗口」兜底指引

安装（bundle 形态，需重启 web）

# git 源（lib/ 已入库）
dsh plugin --profile web add github:Yvesgao/dsh-desktop-shortcut#main

# 或 npm
dsh plugin --profile web add dsh-desktop-shortcut

重启 web（dsh web）后，打开 设置 → Desktop Shortcut，填好表单点 Create desktop shortcut 即可。

仅支持 Windows —— PowerShell 引擎是 Windows 组件。设置页在所有平台都会出现，但在非 Windows 平台会报错提示。

开发

pnpm install
pnpm build        # tsc（host lib）+ tsdown（client bundle lib/client.js）
pnpm typecheck

官方插件开发契约与可参考的社区插件源码已收集在 docs/references/。

插件管理

已装插件推荐用 plugin-registry 的薄控制台管理（浏览器面板）：bundle 层栈 + insert 行 + 启停，无需手改配置。

dsh plugin --profile web add 
/packages/plugin/console

截图

发布前在此补充设置页截图（docs/preview/settings.png）。

License

MIT

---

English

Create a one-click Windows desktop shortcut from the DSH Settings page — launch any local server (DeepSeek Harness, dev servers, npx tools) with a double-click, auto-open the browser, and pin it to the taskbar.