386842536/dsh-launcher

DSH 启动器 · DSH Launcher

双击即可启动 DeepSeek Harness Web UI（默认 http://127.0.0.1:3080）并自动打开浏览器。
双击一次即可启动 DeepSeek Harness Web UI（默认 http://127.0.0.1:3080）并打开你的浏览器。

一个极简、透明、纯脚本的 macOS DeepSeek Harness 启动器——不打包运行时，不用 Electron/Tauri，无需编译。它封装你从 npm 安装的 dsh CLI（npm install -g @deepseek-ai/dsh），为你找到它，在后台启动，等待就绪，然后打开浏览器。

功能特点 / Features

| | |
| --- | --- |
| 🖱️ 双击启动 | 无终端窗口，后台运行，就绪后自动打开浏览器 / 无终端窗口；在后台运行并自动打开浏览器 |
| 🔀 双形态 | .app 面板模式（原生对话框）与 .command 终端菜单模式 / 面板模式（.app，原生对话框）+ 终端菜单模式（.command） |
| 🆕 自检更新 | 联网对比 npm 最新版，确认后升级再启动；从不自动升级你已装的 dsh / 检查 npm 上的新版本；仅在你确认后升级 |
| 🧭 自适应 PATH | Finder 双击环境极简，自动补齐 node/dsh 路径（~/.npm-global、/usr/local、/opt/homebrew、~/.nvm）/ 为 Finder 启动的 shell 修复 PATH，并自动定位 node/dsh |
| 🍎 Apple 芯片修复 | 规避 LaunchServices 用 Rosetta 运行脚本型 .app 导致的 incompatible architecture 崩溃，强制原生 arm64 / 强制使用原生 arm64，以避免 Apple Silicon 上因 Rosetta 导致的 incompatible architecture 崩溃 |
| 📡 端口感知 | 端口已监听 → 视为已运行，只打开浏览器，绝不重复启动 / 检测到已在运行的实例时，只打开浏览器 |
| 🧩 可配置 | DSH_LAUNCHER_PORT / _LOG / _WORKSPACE / _BIN / _INSTALL_VERSION 环境变量全覆盖 / 可通过环境变量全面配置 |
| 🔒 透明 | 纯 shell 脚本，不联网、不上传任何数据；你的凭据只留在本机 ~/.dsh / 纯 shell，无遥测；凭据保留在 ~/.dsh |
| 🆓 零依赖 | 只要求 macOS + Node.js 20+（dsh 由「安装 DSH.command」代装）/ 仅需 macOS + Node.js 20+ |

与其他项目的关系 / Relationship to other projects

DSH 启动器 不与其他 DeepSeek Harness 客户端竞争，它是一个"轻到不能再轻"的启动包装器：

| | DSH 启动器（本仓库） | deepseek-harness-desktop | dsh-desktop |
| --- | --- | --- | --- |
| 形态 | 纯 shell 脚本 + 极简 .app 壳 | Tauri 原生桌面应用（Rust + Web） | 桌面应用（自带 Node 运行时） |
| 运行时 | 使用你已装的 dsh CLI（npm 全局），不打包任何运行时 | 自带并管理本地 Harness 实例 | 自带运行时，无需自装 Node.js |
| 安装体积 | 约 200 KB（zip），无二进制依赖 | 原生应用体积 | 应用体积 |
| 跨平台 | 仅 macOS | Windows / macOS / Linux | 桌面 |
| 插件市场 | 无（保持极简，用官方 dsh plugin 或 dsh-market） | 内置插件市场 | 内置插件市场 |
| 定位 | 给"已在命令行用 npm 装了 dsh"的用户一个双击入口 | 给不想自己装 Node.js 的用户一个完整客户端 | 给不想自己装 Node.js 的用户一个完整客户端 |

一句话：DSH 启动器 只做一件事——把你已经装好的 dsh 变成"双击就能用"。 它刻意不打包运行时、不写 GUI、不内置插件市场，因而几乎零学习成本、零风险、代码可完全审查。如果你想要一个自带全部运行时、跨平台的完整桌面客户端，请使用上面的桌面项目。

安装 / Install

接收者需要：macOS + Node.js 20+。

1. 从 GitHub Releases 下载 DSH启动器-分发.zip，解压；
2. （可选但推荐）双击「安装 DSH.command」自动安装 @deepseek-ai/dsh（或手动 npm install -g @deepseek-ai/dsh）；
3. 双击「DSH 启动器.app」→ 选择"现有版本运行"→ 浏览器自动打开 Web UI；
4. 首次使用请在页面里登录 / 配置你自己的 DeepSeek 账号凭据（只存在本机 ~/.dsh）。

首次打开提示"无法验证开发者"：右键 → 打开；或终端执行
xattr -dr com.apple.quarantine ~/Desktop/"DSH 启动器.app"。

使用说明 / Usage

| 文件 | 作用 |
| --- | --- |
| DSH 启动器.app | 主启动器：双击启动，无终端窗口，后台运行，就绪后自动打开浏览器 |
| DSH 启动器.command | 备用启动器：双击后在终端前台运行，日志直接可见，关窗口即停止 |
| DSH 停止.command | 停止正在运行的 DSH Web UI（端口 3080） |
| 安装 DSH.command | 给新电脑用的：检查 Node.js 并安装 @deepseek-ai/dsh |
| 使用说明.txt | 给接收者看的图文说明（含 Gatekeeper 首次打开的处理） |

环境变量 / Env vars

| 变量 | 默认 | 说明 |
| --- | --- | --- |
| DSH_LAUNCHER_PORT | 3080 | dsh 监听端口 |
| DSH_LAUNCHER_LOG | ~/.dsh/launcher.log | 运行日志路径（含 dsh 版本号） |
| DSH_LAUNCHER_WORKSPACE | $HOME | dsh 的启动工作区根目录 |
| DSH_LAUNCHER_BIN | $(command -v dsh) | 指定 dsh 可执行文件 |
| DSH_INSTALL_VERSION | latest | 固定 dsh 安装/升级版本 |
| DSH_LAUNCHER_AUTORUN | 0 | 1 时跳过选择面板直接运行 |

例：DSH_LAUNCHER_PORT=8080 open ~/Desktop/"DSH 启动器.app"

从源码构建 / Build from source

git clone https://github.com//dsh-launcher
cd dsh-launcher

1. 重新生成图标（纯 Python 标准库 → scripts/icon-1024.png）
python3 scripts/make-icon.py

2. 打包分发版 → dist/DSH启动器-分发.zip（含 .app、三个 .command、使用说明.txt）
bash scripts/package.sh

核心逻辑有桩测试（test/ 目录，stub 版 dsh/open/osascript）。

工作原理 / How it works

dsh-launcher.sh 是唯一的逻辑核心：

1. 补全 PATH → 定位 node / dsh（Apple 芯片上强制 arch -arm64）；
2. 检测端口 3080：已在监听 → 只开浏览器；
3. 未监听 → nohup dsh web --host 127.0.0.1 --port 3080 后台启动；
4. 轮询就绪（90 秒上限）→ 打开浏览器 / 通知失败并指向日志。

安全 / Security

- 启动器只是包装脚本：不做任何联网、不上传数据，只负责启动本机已安装的 dsh 并打开本机浏览器；
- 你的 API 凭据仅保存在自己电脑的 ~/.dsh，脚本从不读取或转发；
- 全部代码可审查，总行数 < 400。

License

MIT