启动加载页 Polar-Zhang/dsh-launchpad

dsh-launchpad

DeepSeek Harness 插件：为 Web UI 增加优雅的启动加载页和就绪状态接口，并附赠 Windows 桌面启动脚本——双击启动 DSH，关闭浏览器标签 DSH 自动退出。

✨ 跟随系统主题的启动页

启动页自动匹配系统主题——深色 / 浅色，配官方 DeepSeek 鲸鱼：

| 🌙 深色 | ☀️ 浅色 |
| 加载页深色 | 加载页浅色 |

- 官方 DeepSeek 鲸鱼 logo——prefers-color-scheme 自动明暗切换，等待时轻轻浮动
- 四段进度条对应真实启动阶段：清理 → 启动 → 就绪 → 进入
- 零窗口秒开——双击快捷方式，浏览器瞬间出现加载页，服务就绪自动跳转进入 DSH
- 图标随心换——桌面快捷方式可挂上仓库附带的官方鲸鱼圆角图标，或任意你喜欢的图标：

桌面图标

包含什么

| 组件 | 作用 |
| GET /launchpad | 启动加载页：官方 DeepSeek 鲸鱼 logo（prefers-color-scheme 自动明暗切换）、四段进度条（清理 → 启动 → 就绪 → 进入）、等待计时。 |
| GET /launchpad/status | JSON 就绪探测接口，加载页轮询它；服务一就绪立即跳转进入。 |
| scripts/start-dsh.cmd | 静默启动器：清理 3080 端口残留 → 隐藏启动 dsh web → 浏览器打开加载页。 |
| scripts/watch-dsh-idle.cmd | 隐藏监控：浏览器断开 3080 约 10 秒后自动杀 dsh。关标签 = 停服务。 |
| scripts/hide-run.vbs | 3 行隐藏运行工具（Windows 没有纯 cmd 的完全隐藏后台进程方案）。 |
| scripts/stop-dsh.cmd | 应急停止：杀掉占用 3080 端口的进程。 |

安装

快速安装——插件本体

dsh plugin --profile web add dsh-launchpad

部署启动脚本 + 桌面快捷方式

把启动脚本和加载页部署到 ~/.dsh：

:: 在包目录里执行
scripts\install.cmd

或者手动把 assets/loading.html 和 scripts/* 复制到 %USERPROFILE%\.dsh\。

创建桌面快捷方式，体验双击即开：

wscript.exe "%USERPROFILE%\.dsh\hide-run.vbs" "cmd /c %USERPROFILE%\.dsh\start-dsh.cmd"

把快捷方式图标换成官方鲸鱼圆角图标（本仓库已附带）：右键快捷方式 → 属性 → 更改图标 → 选择上图（或装有鲸鱼娘皮肤时的 %USERPROFILE%\.dsh\icons\whale-girl.ico）。

🤖 或者让 AI 帮你安装

把下面的代码块整段复制给你的 AI 助手（DSH agent 会话、Claude 等均可）。指令自包含——AI 可以先拉取本仓库再按步骤正确安装。

请帮我安装 DeepSeek Harness 的 dsh-launchpad 插件（Windows），仓库地址： https://github.com/Polar-Zhang/dsh-launchpad

1. 拉取仓库：git clone https://github.com/Polar-Zhang/dsh-launchpad.git 到临时目录；或直接用
dsh plugin --profile web add github:Polar-Zhang/dsh-launchpad
从 GitHub 安装。
2. 检查 bundle 列表：读取 <DSH_HOME>/profiles/web/package.json （DSH_HOME 默认是 %USERPROFILE%\.dsh）。dsh.profile.bundles 数组必须包含 dsh-launchpad（该包声明了 dsh.bundle.patch）。注意：
dsh plugin add 不一定会自动把它加进 bundles——如果缺失，手动在
该数组里补上这个字符串（与其他 bundle 名并列）。pnpm 的 peer 依赖警告是预期现象、无害（运行时由 dsh 提供这些 peer）。
3. 部署启动脚本：运行仓库里的 scripts/install.cmd（若是通过 npm/GitHub 装的，则运行 call "%USERPROFILE%\.dsh\profiles\web\node_modules\dsh-launchpad\scripts\install.cmd"）。
它会把 loading.html、start-dsh.cmd、watch-dsh-idle.cmd、 hide-run.vbs、stop-dsh.cmd 复制到 %USERPROFILE%\.dsh\。
4. 创建桌面快捷方式（双击即启动、无控制台窗口）： wscript.exe "%USERPROFILE%\.dsh\hide-run.vbs" "cmd /c %USERPROFILE%\.dsh\start-dsh.cmd" （可选：在快捷方式属性里把图标换成用户喜欢的 .ico）。
5. 重启 dsh web profile 让 bundle 生效——如果 dsh 正在运行，先用 %USERPROFILE%\.dsh\stop-dsh.cmd 停止，再重新启动（例如用新建的快捷方式）。
6. 验证：GET http://127.0.0.1:3080/launchpad/status 应返回 "ok":true 的 JSON；GET http://127.0.0.1:3080/launchpad 应返回加载页。
最后打开 http://127.0.0.1:3080/ 确认应用正常。

使用

1. 启动：双击快捷方式（或运行 start-dsh.cmd）。全程无窗口——浏览器瞬间打开加载页，四段进度条走完，就绪后自动进入 DSH 界面。
2. 停止：直接关闭浏览器标签。约 10 秒后 dsh 自动退出。
3. 应急：stop-dsh.cmd。

加载页预览

start "" "%USERPROFILE%\.dsh\loading.html?p"

?p 为预览模式（不轮询、不跳转）。切换 Windows 深浅色模式可看主题联动。

接口

GET /launchpad → 加载页 (text/html) GET /launchpad/status → {"ok":true,"service":"dsh","pid":...,"uptime":...,"time":...}

自定义

加载页是单个自包含 HTML——改 assets/loading.html（logo、配色、阶段文案、超时）重新部署即可。全部内联，无 CDN 依赖，离线可用。

为什么是"插件 + 脚本"

- 插件部分跑在 DSH 进程内（Cordis bundle）：通过 DSH web server 托管加载页和就绪接口，同源零 CORS 摩擦。
- 脚本部分本质是操作系统级：进程无法自己启动自己，启停 dsh 必须借助 Windows shell 工具。它们随包一起发布，一站式安装。

License

MIT