dlssjdyka0019/dsh-launcher

DSH Launcher

管理多个隔离的 DeepSeek Harness (DSH) 实例的 Windows 桌面工具

Go
React
Vite
License
dsh-plugin

DSH Launcher 是一个 Windows 系统托盘应用，用于管理多个隔离的 DeepSeek Harness 实例。每个实例拥有独立的配置、插件和模型目录，互不干扰。

开发者的话
本软件纯 DSH + DeepSeek-V4-Flash 制作，开发者一行代码没看。
开发初衷是 DSH 加插件崩溃了每次要用 Codex 修，现在可以让 DSH 自己修了。
不要问为什么后端是 Go 前端不直接用 Go，因为前端 AI 用 Go 写不明白，我让 AI 换个技术重写了。
作者是个看见黑窗口（CLI / 命令行终端）就会死的人，所以软件提供了 DSH 快速安装和 DSH 依赖的快速安装。
秉持着 DSH 轻量化、插件化的精神，同样采取了 WebUI（前端美术风格也差不多）。

功能

- 多实例管理 — 创建、启动、停止、删除多个 DSH 实例
- 实例隔离 — 每个实例拥有独立的 $DSH_HOME 目录和 DSH 安装副本
- 配置复制 — 从一个实例复制配置到另一个，快速搭建开发环境
- 实时日志 — WebSocket 实时流式查看实例日志，支持过滤和搜索
- 运行中实例发现 — 自动扫描系统中已在运行的 DSH 实例
- 系统托盘 — Windows 托盘图标，快速访问实例列表
- 主题支持 — 深色/浅色/跟随系统
- 单端口架构 — 统一管理界面端口 :4750

快速开始

前置条件

| 工具 | 版本要求 |
|------|---------|
| Go | >= 1.23 |
| Node.js | >= 22.19.0 |
| pnpm | >= 7.11.0 |
| Git | >= 2.0 |
| DeepSeek Harness | 任意版本 |

构建

完整构建
.\scripts\build.ps1

开发模式（前端 HMR 热更新）
.\scripts\build.ps1 -Dev

运行

正常模式（带系统托盘）
.\build\dsh-launcher.exe

无头模式（仅 HTTP API）
.\build\dsh-launcher.exe --headless

前端开发模式（终端 1：Go 后端）
.\build\dsh-launcher.exe --headless --dev-frontend http://localhost:4751

前端开发模式（终端 2：Vite HMR）
cd web
pnpm run dev

打开 http://127.0.0.1:4750 即可使用。

架构

dsh-launcher.exe (Go 二进制)
├── 系统托盘 (getlantern/systray)
│   ├── Open Dashboard
│   ├── 实例列表（动态更新）
│   └── Quit（确认退出）
├── HTTP 服务器 (chi)
│   ├── REST API /api/*
│   ├── WebSocket /api/instances/{id}/logs
│   ├── 发现接口 /api/discover
│   └── React SPA /（内嵌或代理到 Vite）
└── 实例管理器
├── 实例创建/删除/启动/停止
├── Node.js 子进程管理
├── 配置深拷贝（settings + credentials + profiles）
├── 实例注册表 JSON 持久化
└── 运行中实例发现 (discover.go)

实例隔离

每个实例拥有独立的 $DSH_HOME 目录，所有实例共享同一 DSH 构建产物（不重复 clone）：

~/.dsh-launcher/instances/
├── /
│   ├── settings.yaml              ← 独有配置
│   ├── .credentials.yaml          ← 独有凭据
│   ├── profiles/                  ← 独有 profile 配置
│   ├── sessions/                  ← 独有会话数据
│   ├── storages/                  ← 独有存储数据
│   └── .dsh-install/              ← 独有 DSH 安装副本
│       ├── apps/cli/              ← 复制
│       ├── packages/              ← 复制
│       ├── vendor/                ← 复制
│       └── node_modules/          ← junction → 共享安装目录
└── ...

DSH 进程启动命令

$env:DSH_HOME = "~/.dsh-launcher/instances/"
node /apps/cli/lib/bin.js web --port  --no-open

配置复制

- 深拷贝：settings.yaml、.credentials.yaml、profiles/、.agent-presets/
- 不拷贝：sessions/、storages/（历史数据不共享）
- 插件也要能复制：profiles 目录包含完整的 bundle 配置

端口管理策略
- 默认起始端口：3080
- 自动递增直到找到空闲端口
- 用户可自定义端口
- 启动器管理界面端口：4750（可配置）

进程管理

- 每个 DSH 实例 = 独立 Node.js 子进程
- 启动器关闭不影响运行中的 DSH 实例
- 停止实例：先 SIGTERM，超时 10s 后强制 SIGKILL
- 日志捕获：stdout + stderr 分开记录，带时间戳

运行中实例发现

- 通过 wmic 扫描 Node.js 进程命令行，匹配 bin.js / dsh 关键字
- 通过 TCP 端口扫描常见 DSH 端口（3080-3085, 3100, 3200）
- 发送 HTTP 请求验证是否为 DSH Web UI
- 在仪表盘底部展示已发现的实例，支持一键打开

API 接口

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | /api/instances | 列出所有实例 |
| POST | /api/instances | 创建新实例 |
| GET | /api/instances/{id} | 获取实例详情 |
| PUT | /api/instances/{id} | 更新实例元数据 |
| DELETE | /api/instances/{id} | 删除实例 |
| POST | /api/instances/{id}/start | 启动实例 |
| POST | /api/instances/{id}/stop | 停止实例 |
| POST | /api/instances/{id}/copy-config | 复制配置到实例 |
| WS | /api/instances/{id}/logs | WebSocket 日志流 |
| GET | /api/discover | 发现已在运行的 DSH 实例 |
| GET | /api/env | 环境检测状态 |
| POST | /api/env/install-dsh | 获取 DSH 安装指引 |
| POST | /api/env/build-dsh | 获取 DSH 构建指引 |
| GET | /api/settings | 获取启动器设置 |
| PUT | /api/settings | 更新启动器设置 |
| GET | /api/versions | 列出已注册的 DSH 版本 |
| POST | /api/versions | 注册 DSH 版本 |
| DELETE | /api/versions/{id} | 删除 DSH 版本 |
| POST | /api/versions/download | 下载并安装 DSH 版本 |

项目结构

dsh-launcher/
├── cmd/dsh-launcher/       # Go 入口
├── internal/
│   ├── api/                # HTTP API 处理
│   │   ├── router.go       # Chi 路由器 + 前端服务
│   │   ├── instances.go    # 实例 CRUD + WebSocket 日志
│   │   ├── env.go          # 环境检测 API
│   │   ├── settings.go     # 设置 API
│   │   └── versions.go     # 版本管理 API
│   ├── manager/            # 实例生命周期管理
│   │   ├── manager.go      # 实例注册表 + 持久化 + 配置复制
│   │   ├── instance.go     # 实例数据模型
│   │   ├── process.go      # Node.js 子进程管理
│   │   ├── discover.go     # 运行中实例发现
│   │   ├── version.go      # 版本管理器
│   │   └── version_download.go  # 版本下载器
│   ├── envdetect/          # 环境检测
│   │   └── detect.go       # 检测 Node.js/pnpm/Git/DSH
│   ├── config/             # 启动器配置
│   │   └── config.go       # 配置持久化
│   └── tray/               # Windows 系统托盘
│       └── tray.go         # Systray 集成
├── web/                    # React 前端源码
│   ├── src/
│   │   ├── App.tsx         # 根组件
│   │   ├── api/            # API 客户端
│   │   ├── hooks/          # React Hooks
│   │   ├── types/          # TypeScript 类型
│   │   └── components/     # 页面组件
│   ├── index.html
│   ├── vite.config.ts
│   └── package.json
├── webembed/               # Go embed 前端构建产物
│   ├── assets.go           # //go:embed dist/
│   └── dist/               # 构建产物
├── scripts/
│   ├── build.ps1           # 构建脚本
│   └── download-deps.ps1   # 依赖下载脚本
├── go.mod
├── Makefile
└── LICENSE

技术栈

| 层 | 技术 |
|----|------|
| 后端 | Go 1.23+, chi router, gorilla/websocket |
| 前端 | React 18, TypeScript, Vite 6, CSS Modules |
| 托盘 | getlantern/systray |
| 样式 | --dsw-* CSS 自定义属性体系 |

依赖清单

Go 依赖

| 包 | 用途 |
|---|------|
| github.com/go-chi/chi/v5 | HTTP 路由器 |
| github.com/go-chi/cors | CORS 中间件 |
| github.com/getlantern/systray | 系统托盘 |
| github.com/gorilla/websocket | WebSocket 实时日志流 |
| github.com/google/uuid | UUID 生成 |

前端依赖

| 包 | 用途 |
|---|------|
| react ^18.3.1 | UI 框架 |
| react-dom ^18.3.1 | DOM 渲染 |
| clsx ^2.1.1 | CSS 类名拼接 |
| @vitejs/plugin-react ^4.3.4 | Vite React 插件 |
| typescript ^5.6.3 | 类型检查 |
| vite ^6.0.0 | 构建工具 |

许可证

MIT