Ho11ow8/deepseek-harness-shortcut

deepseek-harness-shortcut

一个 DeepSeek Harness（DSH）插件，可以在桌面创建一个一键启动/打开本地 DSH Web 界面的快捷方式（仅 Windows）。

双击快捷方式：

- 如果 DSH 服务已在运行 → 直接打开浏览器；
- 如果未运行 → 自动启动服务（默认 npx --yes @deepseek-ai/dsh web），等待端口 3080 就绪后打开浏览器。

快捷方式图标：assets/icon.jpg · assets/icon.ico

功能特性

- ✅ 一个命令：/desktop-shortcut
- ✅ 智能启动脚本（自动判断"启动或打开"，等待就绪，最长 30 秒）
- ✅ 高度可配置：快捷方式名称、URL、端口、图标、工作目录、启动命令
- ✅ 零运行时依赖（仅使用 Node ≥ 18 内置模块）
- ✅ 以 DSH bundle 形式分发：安装后自动在 profile 中激活

安装

从 GitHub 安装

dsh plugin --profile web add github:Ho11ow8/deepseek-harness-shortcut

从本地目录安装

dsh plugin --profile web add file:D:\DeepseekHarness\deepseek-harness-shortcut

然后重启 dsh web，在对话界面输入：

/desktop-shortcut

插件会在你的工作区生成 start-dsh.bat 启动脚本，并在桌面创建 DeepSeek Harness.lnk 快捷方式。

Bundle 自动激活：dsh plugin 会把声明了 dsh.bundle 的依赖自动追加到 profile 的 dsh.profile.bundles 层栈中。（参见 dsh --help / dsh plugin --help。）

生成说明

插件不内置现成的启动脚本——运行 /desktop-shortcut 会在你的电脑上现场生成以下文件：

| 生成的文件 | 位置 | 作用 |
|---|---|---|
| start-dsh.bat | 工作区（或 launcherDir） | 智能启动脚本：检测端口 3080 → 服务已在运行则直接打开浏览器，否则启动服务并等待就绪 |
| DeepSeek Harness.lnk | 桌面 | 双击时运行 start-dsh.bat 的快捷方式 |

图标解析优先级（命中即止）：

1. 配置中的 iconPath（如果设置了）；
2. launcherDir 中找到的第一个 .ico/.png；
3. 插件自带的 assets/icon.ico（随插件一起分发）——即使没有自己的图标，每个用户也能获得好看的默认图标。

随时可以重新运行 /desktop-shortcut 刷新快捷方式（例如修改配置或更换图标后）。

启动慢？切换到国内 npm 镜像源

启动脚本用 npx --yes @deepseek-ai/dsh web 启动服务，而 npx 每次启动都要联网到 npm 仓库解析 @deepseek-ai/dsh 的版本。如果你的网络访问 registry.npmjs.org 很慢或不稳定（国内很常见），这一步可能要花好几秒——赶上连接被重置、npm 退避重试时会拖得更久。

把 npm 源切换到国内镜像（npmmirror.com，阿里巴巴维护的 npmjs.org 官方同步镜像）：

npm config set registry https://registry.npmmirror.com

该命令会把 registry=https://registry.npmmirror.com 写入你的用户级 .npmrc（Windows 下为 C:\Users\\.npmrc），之后你所有的 npm/npx 操作都会走镜像。可用 npm config get registry 验证。

- 包内容与官方完全一致（镜像同步 npmjs.org），本地 npm 缓存依然有效；
- 新版本发布后，镜像同步可能有几分钟到几小时的延迟；
- 想恢复官方源：npm config set registry https://registry.npmjs.org/。

镜像只加速 dsh 启动前的 npx 联网步骤，不影响 web UI 本身：服务启动后，浏览器加载的全部资源都来自本地 127.0.0.1:3080，与 registry 无关。

配置

在 profile 的 cordis.patch.yml 中通过后续 patch 行覆盖任意配置项：

- 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 | DeepSeek Harness | 快捷方式文件名（不含扩展名） |
| url | http://127.0.0.1:3080 | 启动脚本打开的 URL |
| port | 3080 | 用于判断"启动或打开"的探测端口 |
| iconPath | "" | 快捷方式的 .ico/.exe/.dll 图标（未设置时回退到 launcherDir 中第一个 .ico/.png） |
| launcherDir | 工作区 | 生成的 start-dsh.bat 所在目录 |
| workdir | 启动脚本目录 | 启动脚本使用的工作目录 |
| command | npx --yes @deepseek-ai/dsh web | 启动服务的命令 |
| waitSeconds | 30 | 等待服务就绪的最长秒数 |

更换图标

两种方式使用你自己的图标：

方式 A：把图标放进工作区（最简单）

1. 将你的图标（.ico 或 .png）复制到工作区（运行 dsh web 的目录，例如 D:\DeepseekHarness）；
2. 重新运行命令：

/desktop-shortcut

插件会自动使用工作区中找到的第一个 .ico/.png。如果存在多个图标，请先删除旧的，或确保你的新图标排序在前。

方式 B：用 iconPath 指定确切路径

在插件配置中设置 iconPath：

- id: desktop-shortcut
config:
iconPath: 'D:\my-icons\my-custom.ico'

然后重启 dsh web，重新运行 /desktop-shortcut。

更换图标后如果桌面仍显示旧图标，请刷新桌面（按 F5）或右键桌面 → 刷新——Windows 会缓存图标。建议使用 .ico 格式，各种尺寸下渲染都清晰。

License

MIT