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-launchercreate_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