dsh-launcher

为 DeepSeek Harness（DSH）Web 界面提供「一键启动」的启动器和插件。

默认图标是一个原创的小火箭（蓝底圆角方块 + 白色火箭 + 橙色尾焰），不涉及任何第三方商标；你也可以自定义图标。

---

一、它做了什么

双击工作区里的 Start DSH.bat，脚本会依次完成下面这些事：

1. 生成图标：如果脚本旁边没有 DSH.ico，就从内嵌数据里还原出默认小火箭图标；
2. 创建桌面快捷方式（可关闭）：用 PowerShell 在桌面生成 DSH.lnk，指向脚本自己，并挂上图标；
3. 检查服务是否已启动：用 curl 探测 http://127.0.0.1:<端口> 是否已有响应，已启动就直接跳到第 5 步；
4. 启动 DSH：没有响应就 start dsh web，然后轮询等待服务就绪（最多约 30 秒）；
5. 打开浏览器：用默认浏览器打开 DSH 地址。

关键点：桌面快捷方式指向的是工作区里的脚本文件本身，而不是一份拷贝。所以以后你在图形界面里改了地址或图标，重新保存脚本后，桌面图标会自动指向新内容（下次双击即生效）。

---

二、图形界面（自动提供，无需打包）

插件注册了一个名为 dsh-launcher 的设置命名空间，DSH 自带的「插件配置」面板（设置 → 插件 / Plugins）会自动把它渲染成一张可编辑的表单卡片：

字段	说明
url	启动地址，留空则自动取当前端口
workspace	工作区（脚本保存位置），留空则用当前工作区
createShortcut	是否在桌面创建快捷方式（布尔开关）
customIcon	自定义图标（.ico 完整路径），留空用默认小火箭

改动保存后（applies: live）插件会立刻用新配置重新生成脚本；如果勾选了「创建快捷方式」，下次双击脚本就会用新图标重建桌面快捷方式。

这个表单由 DSH 自带的 ui-settings-plugins 插件渲染——只要宿主插件注册了设置命名空间就会出现，不需要额外的客户端打包或构建步骤。

---

三、两种使用方式

方式 A：直接用脚本（最简单）

只要电脑上装了 dsh，把 Start DSH.bat（以及它自带的图标）放到任意目录，双击即可。不需要装任何插件。

方式 B：作为 DSH 插件安装

这个仓库本身也是一个 DSH profile bundle，装进 profile 后：

• 启动时自动在工作区生成 Start DSH.bat；
• 注册一个 create_dsh_shortcut 工具，让 AI 也能随时（重新）生成脚本；
• 注册 dsh-launcher 设置命名空间，DSH 设置面板里会出现可编辑的配置卡片（见上文）。

# 从 npm 安装（发布后）
dsh plugin add dsh-launcher

# 或安装本地目录
dsh plugin add /path/to/dsh-launcher

create_dsh_shortcut 工具按当前设置生成脚本；要改地址 / 工作区 / 图标，直接到「设置 → 插件 → dsh-launcher」卡片里改即可。

---

四、环境要求

• dsh 在 PATH 中（npm i -g @deepseek-ai/dsh 安装）；
• curl（Windows 10/11 自带）；
• PowerShell（Windows 自带）。

---

五、隐私说明

脚本和插件都不包含任何个人数据：没有用户名、绝对路径、API 密钥、会话 ID。脚本里只有 http://127.0.0.1:<端口>（本机回环地址）和 dsh web 命令，图标只是图片数据。可以放心公开。

---

六、目录结构

dsh-launcher/
├── package.json         # 声明 dsh.bundle.patch，可被 dsh plugin add 识别
├── cordis.patch.yml     # 组合行：把插件挂进 profile
├── lib/index.js         # Host 插件代码（生成脚本 + 注册工具）
├── README.md            # 本说明
└── LICENSE              # MIT 许可

License

MIT