dsh-launcher

English | 中文

一个轻量的 DeepSeek Harness 插件：安装一个终端命令，一个字启动 harness —— 输入 dsh-go，自动启动 Web UI 并打开浏览器。Everything is a plugin，这个插件本身就是一个 bundle。

轻量： 零依赖，包体积约 9 KB。只碰终端侧 —— 不产生任何桌面图标、不捆绑应用。桌面双击版是独立的 dsh-desktop-launcher 包，想要什么装什么，绝不捆绑。

它能做什么

以 bundle 方式加载后，插件的 apply 会在每次 harness 启动时收敛以下产物（幂等：配置没变就是快速空操作）：

产物	位置	说明
启动脚本	~/.dsh-launcher/dsh-start.command	启动 dsh → 轮询 Web UI 地址 → 就绪后自动打开浏览器
终端命令	~/.local/bin/dsh-go	终端里输入 dsh-go 就是这个效果

安装

前置条件：dsh CLI + pnpm ≥ 9（harness 固定 pnpm 11 —— 版本旧的话执行 corepack enable）。

从 npm 安装：

dsh plugin --profile web add dsh-launcher

从 GitHub 安装 —— 纯 JS、无构建步骤，无需任何 allowlist：

dsh plugin --profile web add github:LvienOeria/dsh-launcher

本地路径安装也可以（零依赖）：

dsh plugin --profile web add ./dsh-launcher

然后启动一次 dsh，插件会自动生成启动器：

dsh --profile web      # 已安装 CLI
# 或
pnpm dsh web           # 源码目录（自动检测）

搞定。终端输入 dsh-go 即可启动 harness；关闭那个终端窗口即停止（Ctrl+C 也可以）。

自定义

编辑 profile 的 patch 层（~/.dsh/profiles/<profile>/cordis.patch.yml）—— 后层覆盖前层，patch 会整体替换某行的 config：

- id: dsh-launcher
  config:
    command: dsh-go                      # 终端命令名（默认 dsh-go）
    url: http://127.0.0.1:3080           # Web UI 地址（轮询 + 打开）
    sourceDir: /path/to/deepseek-harness # 从源码目录执行 `pnpm dsh web`
    startCommand: ''                     # 完全自定义启动命令（单行）
    autoOpenBrowser: true
    ensurePath: true                     # 自动把 binDir 加入 shell 配置 PATH

启动命令的解析顺序

1. startCommand（显式指定）
2. sourceDir → cd <目录> && pnpm dsh web
3. 当前目录是带 dsh script 的源码检出
4. PATH 上已安装的 dsh CLI（排除我们自己的 binDir —— 防递归）
5. 回退 dsh --profile web（带警告）

安全性设计

• 每个生成文件都带 # managed by dsh-launcher vX 标记；没有该标记的已有文件会被先备份为 <path>.bak 再替换（绝不静默覆盖）。
• 配置未变 → 不重写任何文件（状态哈希存在 ~/.dsh-launcher/state.json）。
• 非法配置（类型错误、url 非 http(s)、startCommand 含换行）会响亮失败并给出清晰报错。
• 安装失败只打日志，绝不会拖垮 harness —— dsh 照常启动。

卸载

dsh plugin --profile web remove dsh-launcher
rm -rf ~/.dsh-launcher ~/.local/bin/dsh

说明

• 终端命令默认是 dsh-go 而不是 dsh —— dsh 是 harness CLI 的命令名，启动器绝不抢占它。想改别的名字，用 command 配置即可。
• 想要桌面双击应用（带鲸鱼图标），而不是 / 或者同时要终端命令？安装 dsh-desktop-launcher。
• 不支持 Windows（不会安装任何文件，只打一条警告）。

License

MIT —— 见 LICENSE。