shaun5297/dsh-launcher

README 摘要

dsh-launcher DeepSeek Harness 一键启动器，双形态： - CLI 工具 ：检测后台是否在运行 → 未运行则自动启动 dsh web → 等待就绪 → 在 Chrome 新窗口 中打开主页面。 - Harness 插件（bundle） ： dsh plugin add 可安装，为 agent 提供 harness launch 工具（同样的检测→启动→等待→打开逻辑），让 agent 自己也能拉起/恢复 harness。 平台支持 ：macOS / Windows 完整支持（已实测）；Linux 已适配代码（ google-chrome 新窗口、 .desktop 快捷方式）但尚未在真实环境验证，遇到问题欢迎提 issue。 安装 作为 CLI 工具 安装后即可使用 dsh-launcher 命令。 作为 Harness 插件 刷新页面（或重启 dsh web ）后，agent 即获得 harness launch 工具：检测后台 → 启动（若未运行）→ 等待就绪 → Chrome 新窗口打开主页面。插件配置可通过环境变量覆盖： 环境变量 默认值 说明 DSH LAUNCHER HOST 127.0.0.1 后台监听主机 DSH LAUNCHER PORT 3080 后台监听端口 DSH LAUNCHER BROWSER Chrome 打开的浏览器 用法 macOS 提示：首次双击生成的 .command 文件，若被系统拦截，请在「系统设置 → 隐私与安全性」中允许，或右键 → 打开。 常用选项 完整帮助： dsh-launcher --help 。 工作原理 1. 检测 ：TCP 探测 --host:--port （默认 127.0.0.1:3080 ）是否已在监听。 2. 启动 ：未运行则 detached 启动 dsh --profile web --host … --port … --no-open （浏览器由本工具负责，避免重复打开），stdout/stderr 追加到 /Library/Logs/dsh-web.log （macOS）或 /.dsh/dsh-web.log 。 3. 等待 ：轮询 HTTP 就绪，默认超时 60 秒（ --timeout 可调）。 4. 打开 ：在当前平台以 新窗口 打开主页面： - macOS： open -na "Google Chrome" --args --new-window - Windows： start chrome --new-window - Linux： google-chrome --new-window （找不到 Chrome 时回退 xdg-open ） - 浏览器打开失败时自动回退默认浏览器。 日志： /Library/Logs/dsh-launcher.lo…

分类