多版本启动器 dsh-plugins/dsh-launcher

DSH Launcher

桌面启动器，让多个 DeepSeek Harness (DSH) 版本和实例并排运行。

Tauri 2 + Vue 3 + TypeScript + Sass + vue-router + vue-i18n + Arco Design Vue。

预览

Preview

功能

- 多版本安装：查询 npm registry，把多个 @deepseek-ai/dsh 版本装进互相隔离的目录，彼此永不干扰。
- 多实例管理：每个版本可以建多个实例，各自拥有独立的名称、配置档和运行时环境变量。
- 三种 DSH_HOME 模式：
- 复用/共享已有的 DSH_HOME；
- 自动采用用户默认的 ~/.dsh；
- 为每个实例单独创建 DSH_HOME（自动在应用数据目录下创建并注册）。
- 一键启动：在首页选好实例和配置档即可启动；启动器解析 dsh web 打印的 URL，在专用 webview 窗口里打开 DSH Web GUI。
- 环境变量覆盖：在实例设置页增删运行时环境变量，启动时注入子进程（DSH_HOME 是保留项，始终由启动器按所选 DSH_HOME 注入）。
- 插件市场：浏览发布到 DSH plugin market 的插件（https://dsh-plug.in/api/plugins.json），按名称/描述搜索，并安装到任意实例的配置档：
- 三个版本通道，用彩色图标字母区分 —— stable（releases / npm latest，绿色 R）、beta（pre-releases / npm next，黄色 B）和 alpha（GitHub 上最新 commit，红色 A）；
- 安装流程是一个向导：选插件 → 选版本通道/版本 → 选实例 → 选配置档 → 创建任务 → 开始安装；
- 自动放行依赖构建脚本（onlyBuiltDependencies: ['']），并把装好的插件登记到配置档的 package.json（dsh.profile.bundles + dependencies），非 bundle 插件还会在 cordis.patch.yml 里插入一行。
- 按配置档管理插件（实例设置 → Plugins 标签页）：按配置档筛选，查看其中已安装的插件，单独启用/禁用，也可多选批量启用/禁用。核心 @deepseek-ai/ 包会被隐藏。
- 系统托盘：
- 左键点击启动器托盘：打开并聚焦启动器窗口；
- 右键菜单：「Running profiles」子菜单为每个运行中的实例提供 Open / Stop，外加「Open launcher / Quit launcher」。
- 退出启动器会终止所有实例进程，不留孤儿进程。
- 每个运行中的实例一个托盘图标（issue #72，可在设置里关闭）：
- 图标用实例自己的自定义图标，没有则回退到启动器图标；
- 悬停时显示 <instance> · <profile> · running (N active conversations)；数量来自实例的 DSH 会话索引，每约 15 秒刷新一次；
- 左键单击打开实例的 Web GUI（TUI 配置档则打开其终端窗口），窗口已打开时将其置前；
- 右键单击提供「Open instance」/「Stop instance」。
- 关闭到托盘（可在设置中禁用）。
- 登录时启动（设置开关，通过 autostart 插件真实注册）。
- i18n：简体中文 / English；JSON 语言文件会被自动发现、热重载，并由 @intlify/unplugin-vue-i18n 通过 Vite 预编译。
- WSL2 实例（实验性）：在 WSL2 发行版内创建 DSH 实例——Node.js / pnpm / 固定版本会自动安装到发行版内，实例的 DSH_HOME 位于发行版的 ~/.dsh-launcher/homes 下。创建完成后，HOME 的用法与本地实例一致（配置档增删改查、插件安装/启用/禁用/卸载、技能、MCP、图标、日志、整合包导出/导入、内嵌终端）；文件通过 \\wsl$\ UNC 共享访问，已停止的发行版会自动启动。

界面

- Home：左侧面板（实例状态 → 关联实例/配置档下拉框 → 大号启动按钮 → 实例列表 / 实例设置）；右侧预留给新闻区。
- Download：侧边栏含「Create instance / Download plugins」；创建页按 stable/prerelease 分组展示可安装版本；点击某个版本打开命名页（实例名、DSH_HOME 选择、底部的「Start download」）。插件页即市场；三步向导（插件 → 版本通道 → 实例/配置档）创建安装任务。
- Instances：名称、版本、DSH_HOME、配置档、运行状态与 URL、编辑/删除。
- Instance settings → Plugins：按配置档筛选、启用/禁用插件、多选批量启用/禁用（@deepseek-ai/* 核心插件隐藏）。
- Settings：五个分区——Startup（启动行为、数据目录、DSH_HOME 管理、环境导入、日志）、Personalization（语言、主题、新闻源、启动器图标）、Network（代理）、Resources（SKILL 仓库、插件目录源）和 About（版本、更新通道与检查、仓库 / issues / releases 链接）。

WSL 实例的插件与整合包依赖安装会在发行版内运行 pnpm（拉取 Linux 平台二进制），SKILL 仓库安装则用发行版自带的 git 克隆；从 Windows 侧通过 UNC 读写文件要求发行版处于运行状态，启动器会自动将其启动。

已知限制：WSL HOME 暂不支持存储重定向（storage 标签页）（需要在发行版内创建并验证符号链接）；该页面会显示能力提示，而不是报错。

开发

前置条件：Node ≥ 20、pnpm、stable Rust（MSVC 工具链）、WebView2。

pnpm install
pnpm tauri dev # dev mode (Vite frontend + debug backend)
pnpm tauri build # bundle (produces exe / msi / nsis installers)

在浏览器里预览前端，不启动后端（mock 层由 localStorage 支撑）：

pnpm dev # open http://localhost:1420

运行时数据

- 启动器配置与数据：%APPDATA%\in.dsh-plug.dsh-launcher\
- config.json：DSH_HOMEs / versions / instances / settings
- versions/<version>/：每个版本的独立安装目录
- homes/<instance name>/：专用 DSH_HOME（选用时）
- logs/<instance id>.log：实例运行时日志

架构

- src/：Vue 3 前端（页面、store、API 封装、i18n）
- src/api/index.ts：统一 API 层 —— Tauri 下走 invoke，普通浏览器里走 localStorage mock
- src-tauri/src/
- config.rs：配置模型与原子持久化
- commands.rs：全部 Tauri 命令（CRUD / 版本安装 / 实例启停 / 设置）
- plugins.rs：插件市场 —— 拉取目录、按渠道取版本（npm dist-tags + GitHub commits）、安装任务、profile manifest 注册与启用/停用
- tasks.rs：后台任务系统（create-instance / install-plugin），带进度与日志事件
- process.rs：实例进程管理（spawn / kill / URL 解析 / 环境变量注入 / 日志）
- tray.rs：系统托盘与动态菜单
- windows.rs：实例 webview 窗口管理

License

MIT