DeepSeek Harness plugin

dsh-launcher

一个轻量的 dsh(DeepSeek Harness)插件:安装一个终端命令,输入 dsh-go 即可启动 harness 并自动打开浏览器。零依赖,约 9 KB。(桌面双击版在独立的 dsh-desktop-launcher 包)

Jump to install

Source facts

Repository
LvienOeria/dsh-launcher
Latest update
Aug 14, 2026
Category
Tools & Capabilities
GitHub stars
3
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/LvienOeria/dsh-launcher
Plugin: dsh-launcher
Author: LvienOeria

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

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. sourceDircd <目录> && 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](LICENSE)。