deepseek-harness-shortcut
English | 中文
<p align="center"> <img src="assets/icon.jpg" alt="DeepSeek Harness 快捷方式图标" width="128"> </p>
一个 DeepSeek Harness（DSH）插件，可以在桌面创建一个一键启动/打开本地 DSH Web 界面的快捷方式（仅 Windows）。
双击快捷方式：
- 如果 DSH 服务已在运行 → 直接打开浏览器；
- 如果未运行 → 自动启动服务（默认
npx --yes @deepseek-ai/dsh web），等待端口 3080 就绪后打开浏览器。
快捷方式图标：[assets/icon.jpg](assets/icon.jpg) · [assets/icon.ico](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