前言¶
DSH 的理念是「一切皆插件」。对智能体开发者来说，启动 harness 的常见做法是先执行 CLI 或源码命令；如果需要从终端一键启动，并自动打开浏览器，可以安装 dsh-launcher。下面介绍它的定位、安装方法、配置项和注意事项。
这是什么¶
dsh-launcher 是一个轻量的 dsh（DeepSeek Harness）插件：安装一个终端命令，输入 dsh-go 即可启动 harness 并自动打开浏览器。
它零依赖，包体积约 9 KB。仓库路径为 LvienOeria/dsh-launcher，许可证为 MIT。桌面双击版在独立包 dsh-desktop-launcher。
核心功能¶
生成终端命令与启动脚本¶
插件以 bundle 方式加载。插件 apply 会在每次 harness 启动时收敛生成产物；配置未变时为空操作。
生成的文件包括：
- 启动脚本：
~/.dsh-launcher/dsh-start.command - 终端命令：
~/.local/bin/dsh-go
安装来源¶
支持从 npm、GitHub 或本地路径安装。
可配置项¶
可通过 profile patch 配置以下项目：
command
url
sourceDir
startCommand
autoOpenBrowser
ensurePath
启动命令解析顺序¶
启动命令按下面顺序解析：
1、startCommand
2、sourceDir
3、源码目录
4、PATH 上的 dsh CLI
5、回退 dsh --profile web
安全与失败处理¶
- 对已有文件，如果没有
managed by dsh-launcher标记，会先备份为.bak再替换。 - 非法配置会报错。
- 安装失败只记录日志，不导致 harness 启动失败。
安装与启用¶
前置条件是 dsh CLI 和 pnpm >= 9。harness 固定 pnpm 11；如果本机版本较旧，可执行：
corepack enable
先确认已满足前置条件，再从 npm 安装：
dsh plugin --profile web add dsh-launcher
如果从 GitHub 安装：
dsh plugin --profile web add github:LvienOeria/dsh-launcher
如果本地已有插件目录：
dsh plugin --profile web add ./dsh-launcher
安装后启动一次 harness，插件会据此生成启动器：
dsh --profile web
# 或
pnpm dsh web
经过上面的步骤，终端里就可以使用 dsh-go。
典型用法¶
在终端中启动：
dsh-go
停止方式是关闭终端窗口，或按 Ctrl+C。
需要修改启动命令、URL、路径或浏览器行为时，编辑 profile patch 文件：
~/.dsh/profiles/<profile>/cordis.patch.yml
后层覆盖前层。示例如下：
- id: dsh-launcher
config:
command: dsh-go
url: "<Web UI 地址>"
sourceDir: "<harness 源码目录>"
startCommand: ""
# autoOpenBrowser: true/false
# ensurePath: true/false
这里只列出可配置项，实际值按自己的 Web UI 地址、源码目录和 shell 配置填写。
command 是终端命令名，默认是 dsh-go，不占用 harness CLI 的 dsh 命令名。
适用场景与注意¶
适合需要在终端里一键启动 DSH Web UI，并且不想要桌面应用的场景。
注意：
- 不支持 Windows：不会安装任何文件，只打一条警告。
- 该插件以当前 dsh 进程权限运行；它会生成本地文件，安装前应检查仓库源码和 MIT 许可证。
- 状态哈希保存在
~/.dsh-launcher/state.json。
资料给出的卸载命令如下：
dsh plugin --profile web remove dsh-launcher
rm -rf ~/.dsh-launcher ~/.local/bin/dsh
其中 rm -rf ~/.local/bin/dsh 与默认命令 dsh-go 的对应关系未进一步说明。
短结尾¶
dsh-launcher 的作用是把 harness 启动收敛为一个 dsh-go 命令，同时保持零依赖和约 9 KB 的包体积。
GitHub 仓库：https://github.com/LvienOeria/dsh-launcher
已核实资料未提供目录页 URL，本文不列出不确定的链接。
