star-chase / dsh-web-launcher

DSH Web 懒人一键启动

为「懒人」设计的 DeepSeek Harness 一键启动器:双击即启动服务 + 打开浏览器;再双击即停止。 One-click launcher for DeepSeek Harness: double-click to start the web UI and open your browser, double-click to stop.

特性 / Features

• 🖱️ 双击即用,零命令行 — 唯一前置:Node.js LTS
• ⚡ 幂等 — 重复双击不会起多个服务(端口已就绪则直接开浏览器)
• 🚀 自动拉取 — 首次运行自动通过 npx 安装 @deepseek-ai/dsh
• 🛑 一键停止 — 按端口 3080 精准关闭,附系统监视器(GUI)备选
• 🪟 三平台 — Windows / macOS / Linux

前置条件 / Prerequisite

• Node.js LTS(自带 npx)
• Windows 10+ / macOS / Linux 自带 curl

使用方法 / Usage

平台	启动	停止
Windows	双击 launch.bat	双击 stop.bat,或任务管理器结束 Node.js
macOS	双击 launch.command	双击 stop.command,或活动监视器结束 node
Linux	双击/运行 launch.sh	双击/运行 stop.sh,或系统监视器结束 dsh

启动后浏览器自动打开 **http://127.0.0.1:3080/**;服务日志在 ~/.dsh-web.log(Windows 为 %USERPROFILE%\.dsh-web.log)。

提示 / Notes

• 首次运行较慢:npx 需联网下载 DSH(约 1–4 分钟),请耐心等待。
• 端口占用:若 3080 已被其他服务占用,启动脚本会视为「已就绪」直接开浏览器;请先释放端口再使用。停止脚本按端口 3080 操作,确认 3080 归 DSH 所有再点停止。
• Windows 可视化取消:启动后任务栏会有一个最小化窗口「DSH Web」,关闭它即可停止服务——最直观的「关窗口即停」。
• macOS Gatekeeper:首次双击被拦截时,右键 → 打开;或终端执行 xattr -d com.apple.quarantine launch.command。
• 停止后立刻重启:等 1 秒让端口释放,再点启动(启动脚本自带最长 90s 幂等轮询,可自愈)。

工作原理 / How it works

npx --yes @deepseek-ai/dsh web   # 后台启动 DSH Web(服务常驻)
# 等待 http://127.0.0.1:3080/ 就绪后,调用系统默认浏览器打开

「停止」按端口精准结束进程,不影响其他 Node 程序。

授权 / License

• 代码:MIT,见 LICENSE。
• 图标 icons/dsh-whale-girl.png:CC BY-NC-SA 4.0(署名 / 非商用 / 相同方式共享),见 NOTICE.md。

关联 / Related

• deepseek-ai/deepseek-harness
• fornarwhal/deepseek-whale-girl-icon(图标来源)