Yvesgao/dsh-shortcut-creator

dsh-shortcut-creator

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

功能

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

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

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

效果演示

demo

能力清单

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

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

方式一：npm（推荐）

dsh plugin --profile web add dsh-shortcut-creator

方式二：GitHub 源（lib/ 已入库）

dsh plugin --profile web add github:Yvesgao/dsh-shortcut-creator#main

方式三：Windows 一键安装包（给小白同事）

从 GitHub Releases 下载 DeepSeekHarnessSetup.exe → 双击安装（自动装 Node.js + dsh + 插件）→ 桌面出现「DeepSeek Harness」图标 → 双击即用。

重启 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.

What it does

Turns "open PowerShell, type a command, then open the browser" into a double-click. From Settings → Desktop Shortcut you fill in a small form and the plugin:
1. 生成一个 .cmd 启动器——在控制台窗口中启动命令，等待 URL 响应，打开你的默认浏览器，并保持窗口打开（关闭窗口即停止服务器）。如果服务器已在运行，则仅打开浏览器。
2. 创建一个指向该启动器的桌面 .lnk 快捷方式（DeepSeek Harness 使用 Node.js 图标）。
3. 尝试将快捷方式固定到任务栏，并在目标类型无法以编程方式固定时打印手动回退步骤。

繁重的工作由捆绑的、自包含的 assets/New-DesktopShortcut.ps1 完成（无外部依赖，也可独立运行）。

演示

demo

功能

| 功能 | 描述 |
| --- | --- |
| 设置界面 | settings.section“桌面快捷方式”，包含名称 / 命令 / URL / 工作目录表单 |
| 宿主 JSON API | POST /plugins/desktop-shortcut/api/install 运行 PowerShell 引擎，.../status 报告平台 |
| 启动器生成 | 经过端口检查的 .cmd，自动打开浏览器并处理已在运行的情况 |
| 任务栏固定 | 尽力而为的编程式固定，附带始终有效的“固定正在运行的窗口”回退说明 |

安装（捆绑包，需要重启 Web）

方式 1：npm（推荐）

dsh plugin --profile web add dsh-shortcut-creator

方式 2：GitHub 源码（已提交 lib/）

dsh plugin --profile web add github:Yvesgao/dsh-shortcut-creator#main

方式 3：Windows 一键安装程序（面向非技术用户）

从 GitHub Releases 下载 DeepSeekHarnessSetup.exe → 双击安装（自动安装 Node.js + dsh + 插件）→ 桌面上出现“DeepSeek Harness”图标 → 双击即可使用。

重启 Web UI（dsh web）。然后打开 设置 → 桌面快捷方式，填写表单并点击 创建桌面快捷方式。

仅限 Windows——PowerShell 引擎是 Windows 组件。设置部分在所有平台上都会显示，但在其他平台运行时报告错误。

开发

pnpm install
pnpm build        # tsc (host lib) + tsdown (client bundle lib/client.js)
pnpm typecheck

参考契约（官方插件开发指南 + 一个可用的社区插件）收集在 docs/references/ 下。

插件管理

使用插件注册表的 精简控制台（浏览器面板）管理已安装的插件：捆绑层堆栈 + 插入行 + 启用/禁用，无需手动编辑配置。

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

截图

_在发布前，在此处添加设置部分的截图（docs/preview/settings.png）。_

许可证

MIT