一键启动器sloppy-boy/dph-launcher

DPH 一键启动器

双击一个图标，启动 DeepSeek Harness（dsh）的 Web 界面，自动打开浏览器；服务已在运行时则直接打开界面。附带可自定义的桌面图标。

效果

- 双击 DPH 图标 → 自动启动 dsh web（控制台窗口显示日志）→ 首页就绪后自动打开浏览器
- 再次双击（服务已在运行）→ 检测到端口占用 → 直接打开浏览器，不会起第二个实例
- 停止：在控制台窗口按 Ctrl+C，或直接关闭窗口

依赖（只需一次）

1. 安装 Node.js（自带 npx）
2. 首次在命令行执行一次，完成 dsh 的初始化安装：
npx @deepseek-ai/dsh web

看到 dsh web: http://127.0.0.1:3080 后按 Ctrl+C 退出即可（初始化完成后，之后都交给本启动器）

安装

把本文件夹放到任意位置，然后双击运行 install.ps1（若被系统拦截，右键 → 用 PowerShell 运行），桌面上就会出现 DPH 图标。

说明：脚本基于 $PSScriptRoot 定位自身，放到任何目录都能用；dsh 工作区（workspace）为脚本所在目录。

使用

| 操作 | 结果 |
|---|---|
| 双击桌面 DPH | 启动服务 + 自动开浏览器 |
| 服务已运行时再双击 | 直接打开浏览器 |
| Ctrl+C / 关窗口 | 停止服务 |

自定义图标

1. 准备一张正方形图片（推荐 512×512 以上）
2. 生成多尺寸 .ico（可用 icoconverter.com 等在线工具，或任意图标生成器）
3. 覆盖 assets\dph-app.ico，重新运行 install.ps1 重建桌面快捷方式

文件说明

dph-launcher/
├── start-dph.ps1              # 启动器（端口检测 -> 定位 dsh -> 启动服务 -> 自动开浏览器）
├── open-browser-when-ready.ps1 # 看门狗：首页就绪后打开浏览器
├── install.ps1                # 一键创建桌面快捷方式
├── assets/
│   └── dph-app.ico            # 多尺寸桌面图标（鲸鱼娘）
└── README.md

图标来源与许可

- 默认图标为 鲸鱼娘（DeepSeek Harness 主题），来自 fornarwhal/deepseek-whale-girl-icon
- 角色形象：上善无形（原创 OC「溟月」）；DeepSeek 元素二创：ZipZipPipe；改进修复：QYQCAMIAO
- 图标素材以 CC BY-NC-SA 4.0 授权（须署名、非商用、相同方式共享）
- 本仓库脚本（.ps1 / README）以 MIT 授权；两者相互独立

常见问题

- 提示"未找到 dsh"：先执行一次 npx @deepseek-ai/dsh web 完成初始化。
- 端口被占用但不是 DPH：启动器会误判为"已有实例"，请先确认 3080 端口没有被其他程序占用。
- 浏览器没自动打开：等几秒后手动访问 http://127.0.0.1:3080。
- 想改端口：编辑 start-dph.ps1 与 open-browser-when-ready.ps1 中的 3080。

许可

MIT License