AfanSama/dsh-launcher

README 摘要

DSH 启动器 · DeepSeek Harness 桌面版启动器（macOS） deepseek-harness 启动器 / DeepSeek Harness 桌面版 / DSH 桌面启动器 一个面向 macOS 的桌面启动器：双击图标即可启动 DeepSeek Harness 的 Web UI（默认 http://127.0.0.1:3080 ）， 无需每次打开终端 。 DeepSeek Harness（ dsh ）是 DeepSeek AI 开源的 agent harness。本启动器把 pnpm dsh web 封装成一个原生 macOS 应用（AppleScript stay-open applet），提供与普通桌面软件一致的使用体验。 特性 - 🖱️ 双击启动 ：桌面 DSH.app 图标，双击即后台启动 Web UI 并自动打开浏览器 - 🔂 严格单实例 ：三层保障（App 级 applet.pid 全局锁 / 启动器级原子锁 / 端口接管检查），任意情况下同时只有一个实例、一个服务 - 🔁 重复点击直接打开 ：已运行时再次点击图标 → 打开浏览器； 30 秒内重复点击不会刷出多个标签页 - 🛑 Cmd+Q 停止 ：Dock 图标在服务存活期间常驻；退出即停止由启动器管理的服务，且不会误杀终端里手动启动的服务 - 🤝 自动接管 ：服务已在运行（包括终端启动的）→ 接管并记录监听者 PID，绝不重复启动 - 🧠 环境自愈 ：自动重建 Finder 启动环境缺失的 PATH，并在 nvm 各版本中挑选满足仓库要求（Node ^22.19 =24 ）的版本 - 🚀 就绪才开浏览器 ：确认首页真的返回了 GUI 页面（含 DSH BOOT 引导标记）后再打开，避免"页面打不开要手动刷新" - 📋 日志与状态 ： /Library/Logs/dsh-web.log （自动滚动），状态文件在 /Library/Application Support/DSH Launcher/ 安装 方式一：下载 Release（推荐） 1. 在 Releases 下载 DSH.app.zip 2. 解压得到 DSH.app ，放到桌面或拖入「应用程序」 3. 双击启动（首次需要本机已安装 DeepSeek Harness，见下方前置条件） 方式二：从源码构建 前置条件： - Node.js ^22.19 =24 （推荐 nvm） - pnpm - 已克隆并构建好的 deepseek-harness： 然后构建启动器： 项目目录探测顺序： /deepseek-harness → /Downloads/dshai/deepseek-harness → /dev code projects work/deepseek-harness ，或用环境变量 DSH DI…

分类