dsh-launcher: DeepSeek Harness 一键启动器

前言¶

DeepSeek Harness 生态强调“一切皆插件”。在进行智能体开发或调试时，通常需要手动检查后台进程是否运行、启动 dsh web、等待服务就绪，最后再打开浏览器。这些步骤重复且耗时。dsh-launcher 通过自动化这一流程，减少手动操作。

这是什么¶

dsh-launcher 是 DeepSeek Harness 的一键启动器，由 shaun5297 维护。

它提供两种形态：
1. CLI 工具：提供 dsh-launcher 命令，用于检测后台状态、启动服务、等待就绪并打开浏览器。
2. Harness 插件 Bundle：通过 dsh plugin add 安装后，为 agent 提供 harness_launch 工具，让 agent 能够自行拉起或恢复 Harness 环境。

该工具仅依赖 dsh-tools，无其他运行时依赖。

核心功能¶

• 自动化流程：检测后台 → 启动 dsh web → 等待就绪 → 打开 Chrome。
• 插件集成：提供 harness_launch 工具，嵌入到 Harness 插件生态中。
• 零依赖：仅依赖 @deepseek-ai/dsh-tools。
• 跨平台：macOS 和 Windows 支持完整；Linux 代码已适配。
• 桌面快捷方式：支持生成 .command（macOS）、.cmd（Windows）或 .desktop（Linux）文件。
• 环境变量配置：支持自定义监听地址、端口和浏览器。

安装与启用¶

作为 CLI 工具¶

全局安装：

npm install -g git+https://github.com/shaun5297/dsh-launcher.git

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

作为 Harness 插件¶

在 Harness 环境中添加插件：

dsh plugin --profile web add dsh-launcher

刷新页面或重启 dsh web 后，agent 即可获得 harness_launch 工具。

典型用法¶

基础操作¶

# 检测后台 → 启动（若未运行）→ 等待就绪 → 打开 Chrome
dsh-launcher

# 等价写法
dsh-launcher start

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

# 查看后台状态（-- 输出标准格式）
dsh-launcher status
dsh-launcher status --

高级选项¶

# 生成桌面快捷方式
dsh-launcher make-shortcut

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

# 演练模式：打印命令但不执行
dsh-launcher --dry-run

环境变量¶

插件支持以下环境变量覆盖默认配置：

注意事项¶

• 平台实测：macOS 和 Windows 支持完整已实测。Linux 平台代码已适配但未实测。
• macOS 权限：首次运行生成的 .command 文件时，若被系统拦截，需在“系统设置 → 隐私与安全性”中允许执行权限，或右键选择打开。
• 依赖项：需要 Node.js >= 18，并依赖 @deepseek-ai/dsh-tools。
• 许可证：MIT 许可证。