liub13160-dotcom/deepseek-harness-launcher

dsh-launcher

面向 DeepSeek Harness 的跨平台多命令启动器

一条命令启动 · 自动打开浏览器 · 检查状态 · 干净停止

GitHub stars
license
node

为什么需要它？

DeepSeek Harness 的 Web UI 通过 dsh web 启动——但这需要你自己打开浏览器、记住端口（3080），还得费劲找到如何停止它。本工具将其封装为一个真正的跨平台 CLI：

- start → 启动 harness，并在就绪时自动打开浏览器
- status → 告诉你它是否正在运行
- stop → 干净地停止它（不用再费劲找 PID）
- list → 显示你的配置文件
- doctor → 诊断你的环境

支持 Windows / macOS / Linux——无需 shell 脚本，无需平台特定的 hack。

安装 / 运行

需要 Node.js ≥ 16（你肯定已经有了，因为 DeepSeek Harness 基于 npm）。

直接运行——无需安装
node dsh-launcher.mjs

或安装一次作为全局命令
npm link                    # 或：npm install -g .
dsh-launcher

用法

dsh-launcher start                # 启动 web 配置文件并打开浏览器
dsh-launcher start tui            # 启动另一个配置文件
dsh-launcher start --port 8080    # 自定义端口
dsh-launcher status               # 它正在运行吗？
dsh-launcher stop                 # 停止它
dsh-launcher list                 # 列出配置文件
dsh-launcher doctor               # 环境诊断
dsh-launcher help

| 命令 | 默认值 | 选项 |
|---|---|---|
| start [profile] | web | --port、--host、--no-open、--detach |
| status | — | — |
| stop | — | — |
| list | — | — |
| doctor | — | — |

Windows 双击

Windows 用户可以双击 启动DeepSeek-Harness.bat——等同于 node dsh-launcher.mjs start。

该 .bat 文件采用 GBK 编码以适配中文控制台，因此在 GitHub 上显示为乱码，但在本地可以正常工作。

工作原理

start 首先探测端口。如果端口已经启动 → 直接打开浏览器。否则它会运行
dsh --profile  --host  --port  --no-open，然后轮询直到端口响应，并
打开你的浏览器。stop 通过 pidfile（--detach）或端口监听进程
（netstat / lsof）找到进程。零第三方依赖——仅使用 Node 内置模块。

文件

- dsh-launcher.mjs — CLI（单文件，零依赖）
- 启动DeepSeek-Harness.bat — Windows 包装脚本
- package.json — npm 打包 / bin

许可证

MIT