jiangrz77
DSHLauncher
No description
- Stars
- 0
- Language
- Swift
- Created
- Aug 14, 2026
- Updated
- Aug 14, 2026
Introduction
DSH Launcher
一键在后台启动 DeepSeek Harness 的网页版,并用 DSH Launcher 自带的原生面板(WKWebView 窗口)打开 —— 不需要 Safari,也不改动系统默认浏览器。
需要什么(依赖)
| 依赖 | 用途 | 安装方法 |
|---|---|---|
| macOS 12+ | 运行环境 | 系统自带 |
| Xcode 命令行工具 | 编译启动器 | 终端运行 xcode-select --install |
| dsh(DeepSeek Harness) | 被启动的服务 | 装好 Node.js 后运行 npm i -g @deepseek-ai/dsh |
其实不装
dsh也能用:启动器会自动探测command -v dsh或 npx 缓存,只有都找不到时才需要装。
快速开始
-
构建(只需一次):
bash build-app.sh -
双击 DSHLauncher.app:
- 服务没在跑 → 自动后台启动
dsh web,就绪后在原生面板中打开http://127.0.0.1:3080 - 服务已经在跑 → 面板直接显示(重复双击安全)
- 关掉面板窗口 = 退出启动器 = 停止它自己启动的服务(已经在跑的服务不受影响)
- 服务没在跑 → 自动后台启动
-
想停掉后台服务:
bash stop-dsh.sh
配置(可选)
首次运行会自动生成 ~/.dsh-launcher.conf,需要时改这几项:
PORT=3080 # 端口
OPEN_MODE=panel # panel=原生面板(默认);browser=改用 BROWSER 打开
BROWSER=Safari # 仅 OPEN_MODE=browser 时使用
DSH_CMD= # 自定义 dsh 命令(留空自动探测)
START_TIMEOUT=120
CHECK_INTERVAL=2
想回到用 Safari 打开:把
OPEN_MODE改成browser即可(依旧不会改系统默认浏览器)。
常见问题
- 双击提示「无法打开」:系统设置 → 隐私与安全性 → 点「仍要打开」。
- dsh / node 找不到:装好依赖后重试,或用
DSH_CMD写死完整命令。 - 端口被占用:改配置里的
PORT。 - 面板里点外链:非本地链接会用系统默认浏览器打开。
- 面板内快捷键:
⌘C / ⌘V / ⌘X / ⌘A / ⌘Z(⇧⌘Z重做)在输入框和文本上可用,另有⌘R刷新页面、⌘W关闭窗口、⌘Q退出。 - 想改图标:改
src/AppIcon.svg后运行bash make-icon.sh(需 Chrome),再bash build-app.sh。 - 看日志:
~/Library/Logs/dsh-web.log。