shaun5297/dsh-launcher

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 工具

# 从 git 仓库（推荐，一键复制）
npm install -g git+https://github.com/shaun5297/dsh-launcher.git

# 或从本地路径
npm install -g /path/to/dsh-launcher

安装后即可使用 dsh-launcher 命令。

作为 Harness 插件

dsh plugin --profile web add dsh-launcher

刷新页面（或重启 dsh web）后，agent 即获得 harness_launch 工具：检测后台 → 启动（若未运行）→ 等待就绪 → Chrome 新窗口打开主页面。插件配置可通过环境变量覆盖：

用法

# 一键启动（默认命令）：检测 → 启动后台（若未运行）→ 等待就绪 → Chrome 新窗口
dsh-launcher

# 等价写法
dsh-launcher start

# 后台已在运行时，仅打开主页面（不开新后台）
dsh-launcher open

# 查看后台状态（--json 输出 JSON 便于脚本化）
dsh-launcher status
dsh-launcher status --json   # {"running":true,"url":"http://127.0.0.1:3080/",...}

# 在桌面生成一键启动快捷方式（macOS .command / Windows .cmd / Linux .desktop）
dsh-launcher make-shortcut

macOS 提示：首次双击生成的 .command 文件，若被系统拦截，请在「系统设置 → 隐私与安全性」中允许，或右键 → 打开。

常用选项

# 指定端口、补丁文件
dsh-launcher --port 3080 --patch ./enable-skills.yml --patch ./extra.yml

# 指定浏览器（默认 Chrome，新窗口打开）
dsh-launcher --browser "Microsoft Edge"

# 只启动后台，不打开浏览器
dsh-launcher --no-open

# 演练模式：只打印将要执行的命令，不做任何事
dsh-launcher --dry-run

完整帮助：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 <url>
   • Windows：start chrome --new-window <url>
   • Linux：google-chrome --new-window <url>（找不到 Chrome 时回退 xdg-open）
   • 浏览器打开失败时自动回退默认浏览器。

日志：~/Library/Logs/dsh-launcher.log（macOS）或 ~/.dsh/dsh-launcher.log（Windows / Linux）。

平台支持

浏览器打开失败时会自动回退系统默认浏览器。

从桌面图标一键启动

dsh-launcher make-shortcut

在桌面生成「DeepSeek Harness 一键启动」图标，双击即完成整套启动 + 打开流程（相当于把上面的 CLI 封装成双击即可用的桌面入口）。

开发

npm test          # 运行单元测试
node bin/dsh-launcher.js --help

License

MIT