前言¶
在 DeepSeek Harness（DSH）中使用本地服务时，通常需要打开终端执行命令，或者手动打开浏览器访问服务地址。这种手动操作在频繁切换或需要固定访问入口的场景下效率较低。
dsh-shortcut-creator 插件解决了这个问题。它允许用户在 DSH 的设置页面直接生成 Windows 桌面快捷方式，通过双击图标即可启动服务并自动打开浏览器，同时提供任务栏固定的能力。
插件介绍¶
该插件由 Yvesgao 维护，属于客户端类插件。其核心目标是简化本地服务的启动流程，将原本需要手动敲击命令或打开浏览器的操作转化为桌面上的双击动作。
插件通过内置的 PowerShell 脚本实现快捷方式生成与任务栏固定逻辑，无需用户进行额外的脚本编写。
核心功能¶
插件主要提供以下四个核心能力：
-
设置页 UI
在 DSH 设置中注册了名为「Desktop Shortcut」的配置区块。用户可以在该区块填写表单，包括服务名称、启动命令、访问 URL 以及工作目录。 -
Host JSON API
提供两个 JSON API 接口：POST /plugins/desktop-shortcut/api/install：负责执行 PowerShell 引擎，生成桌面快捷方式。.../status：用于上报当前平台状态。
-
启动器生成
插件会生成一个.cmd启动器文件。- 该文件会启动指定的服务命令，并在控制台窗口中保持存活（关闭窗口即停止服务）。
- 启动器内置端口检查逻辑，等待服务就绪后自动打开默认浏览器。
- 如果检测到服务已在运行，则直接打开浏览器，避免重复启动。
-
任务栏固定
插件会尝试将生成的快捷方式固定到 Windows 任务栏。如果系统策略阻止了程序化固定，插件会打印兜底指引，告知用户手动固定运行中窗口的步骤。
安装与启用¶
安装该插件需要重启 DSH 的 Web 进程。请根据环境选择以下命令之一执行：
# 方式一：使用 GitHub 源码安装（推荐）
dsh plugin --profile web add github:Yvesgao/dsh-shortcut-creator#main
# 方式二：使用 npm 包安装
dsh plugin --profile web add dsh-shortcut-creator
安装完成后，执行 dsh web 重启 Web 服务，然后在浏览器中打开设置页面即可找到「Desktop Shortcut」区块。
典型用法¶
- 打开 DSH 设置页面，导航至「Desktop Shortcut」区块。
- 在表单中填写信息：
- 名称：自定义快捷方式显示的名称（如「DeepSeek Harness」）。
- 命令：启动服务的命令（如
node app.js）。 - URL：浏览器访问的地址（如
http://localhost:3000）。 - 工作目录：服务的运行目录。
- 点击「Create desktop shortcut」按钮。
- 在桌面生成对应的
.lnk文件，双击即可启动服务并自动打开浏览器。
注意事项¶
- 仅支持 Windows：该插件依赖 Windows 原生的 PowerShell 引擎，因此仅能在 Windows 平台上正常使用。
- 平台兼容性：虽然设置页 UI 在所有平台都会出现，但在非 Windows 平台执行时会报错。建议在 Windows 环境下使用。
- 权限与安全：插件以当前 DSH 进程的权限运行，建议在安装前检查源码与许可证（MIT）。
