前言¶
使用 DSH web 时，本地服务启动和浏览器打开通常是两个步骤：先启动服务，再等端口可用，最后打开页面。Ho11ow8/deepseek-harness-shortcut 是一个 Windows 下的 DSH 插件，它在聊天中提供 /desktop-shortcut 命令，生成桌面快捷方式和启动器。双击快捷方式后，它会判断 DSH 服务是否已运行：已运行则直接打开浏览器，未运行则启动服务并等待端口就绪。
这是什么¶
Ho11ow8/deepseek-harness-shortcut 由 Ho11ow8 维护，分类为客户端，许可证为 MIT。它用于在 Windows 下为本地 DSH web UI 创建一键启动或打开的桌面快捷方式。插件以 DSH bundle 形式发布，安装后自动激活到 profile。package.json 要求 Node >=18.0.0，并有 peerDependency @deepseek-ai/cordis ^4.0.1。
核心功能¶
- 提供
/desktop-shortcut命令，生成桌面快捷方式和启动器。 - 智能启动器会判断 DSH 服务是否已运行：已运行则直接打开浏览器；未运行则启动服务并等待端口就绪。
- 默认启动命令为
npx --yes @deepseek-ai/dsh web，默认等待端口3080最长30秒。 - 支持配置
shortcutName、url、port、iconPath、launcherDir、workdir、command、waitSeconds。 - 零运行时依赖，仅使用
Node >=18内置能力。
安装与启用¶
安装命令如下：
dsh plugin --profile web add github:Ho11ow8/deepseek-harness-shortcut
安装后重启 dsh web，在聊天中运行：
/desktop-shortcut
插件会在 workspace 生成 start-dsh.bat，并在桌面生成 DeepSeek Harness.lnk。
典型用法¶
下面按常见路径操作。
生成默认快捷方式¶
运行 /desktop-shortcut 后，桌面出现 DeepSeek Harness.lnk，workspace 中生成 start-dsh.bat。双击桌面快捷方式时，插件按当前服务状态选择打开浏览器或启动服务。
覆盖配置¶
通过 profile 的 cordis.patch.yml 可以覆盖配置。例如：
- id: desktop-shortcut
config:
shortcutName: My Harness
url: 'http://127.0.0.1:8080'
port: 8080
iconPath: 'C:\icons\my.ico'
launcherDir: 'D:\launchers'
workdir: 'D:\DeepseekHarness'
command: 'npx --yes @deepseek-ai/dsh web'
waitSeconds: 45
常用配置项包括：
shortcutName：快捷方式文件名；url：启动器打开的地址；port：用于判断服务是否已运行的端口；iconPath：快捷方式图标路径；launcherDir：生成start-dsh.bat的目录；workdir：启动器工作目录；command：启动 DSH 服务的命令；waitSeconds：等待服务就绪的秒数。
更换图标¶
将 .ico 或 .png 放入 workspace，或在配置中指定 iconPath，然后重新运行：
/desktop-shortcut
图标修改后，Windows 桌面可能会缓存旧图标，可能需要刷新桌面。
npm 访问慢¶
若 npm 访问慢，可先执行：
npm config set registry https://registry.npmmirror.com
再运行 /desktop-shortcut 或启动流程。
适用场景与注意¶
这个插件适合在 Windows 下长期使用本地 DSH web UI、需要一个桌面入口的场景。插件以当前 dsh 进程权限运行；安装前建议查看 GitHub 源码和许可证。
其他注意点：
- README 限定 Windows 场景。
- 许可证为 MIT。
package.json要求Node >=18.0.0，并有peerDependency @deepseek-ai/cordis ^4.0.1。
