MarcoG-h/DSH-Launcher · 上手攻略
- 仓库：MarcoG-h/DSH-Launcher
- 链接：https://github.com/MarcoG-h/DSH-Launcher
- 分类：DeepSeek Harness · 启动器 · Windows 桌面应用
- 作者：Jay
- 更新：2026-08-21
是什么
DSH-Launcher 是一个 DeepSeek Harness（DSH）Windows 桌面启动器，基于 Electron + 内置 Node.js 运行时实现"一键部署、多实例并行"的 DeepSeek Harness 使用体验。无需安装 Node.js 或任何其他运行时环境，下载 exe 后点两下即可启动完整的 DSH Web 界面。支持多实例并行（不同插件组合的独立 DSH 环境）、内置精选插件整合包（小白一键装机）、带分类筛选的插件市场，以及完整的客户端界面（系统托盘、悬浮球、余额小部件）。
从"启动器"升级为「多实例管理中枢」——一套客户端内并行运行多套互相隔离的 DSH 实例。
解决什么问题
DeepSeek Harness（DSH）本身是纯命令行的 CLI 工具，虽然功能强大，但存在以下使用门槛： - 需要手动安装 Node.js、pnpm 等运行时 - 多插件组合管理靠手动复制配置文件 - 没有图形界面，每次用要敲命令 - 想同时跑"写代码"和"日常聊天"两套不同配置的 DSH 需要手动切换 DSH_HOME
DSH-Launcher 把这一切变成下载安装 → 点击"快速离线部署" → 启动 → 用 DSH，全程不需要任何命令行操作。
快速安装
方式一：下载安装版（推荐新手）
前往 Releases 页面 下载最新安装版：
| 文件 | 说明 | 大小 |
|---|---|---|
DSH.Launcher.Setup.{version}.exe |
NSIS 安装版，自动创建桌面/开始菜单快捷方式 | ~100 MB |
DSH.Launcher.Setup.2.0.3.exe |
简单版（不带多实例），适合只需单个 DSH 的用户 | ~100 MB |
当前最新版本：v3.0.3
最低系统要求：Windows 10/11 (x64)，不需要预装 Node.js 或任何运行时，4GB+ 内存（推荐）。
方式二：开发模式构建
# 需要 pnpm（Node.js 开发环境）
pnpm install # 首次需要下载 Electron，网络慢时配置镜像
pnpm dev # 开发模式，热更新
pnpm build # 构建 main/preload/renderer 到 out/
pnpm dist # electron-vite build + electron-builder --win → release/
⚠️ 网络受限时，Electron 镜像配置：
$env:ELECTRON_MIRROR='https://npmmirror.com/mirrors/electron/'
核心用法
首次使用步骤
- 下载安装版 exe，双击安装
- 启动 DSH Launcher（出现开屏动画）
- 进入「设置 → 快速离线部署」，点击「快速离线部署」 - 自动下载并安装便携 Node + pnpm + dsh 运行环境 - 部署完成后自动切换为内置模式并回填路径
- 回到「控制台」点击「启动」
- 就绪后自动进入 DSH 界面，填写 API Key 即可使用
多实例管理（核心亮点）
DSH-Launcher v3 的核心创新：一套客户端并行运行多个互不干扰的 DSH 实例，每个实例拥有独立配置与端口。
使用场景举例： - 实例 A：写代码专用（CodePilot 插件组合） - 实例 B：日常聊天（轻量插件组合） - 实例 C：跑测试（隔离环境）
新建实例模式（原理参考 DSH_HOME 隔离指南）：
| 模式 | 说明 |
|---|---|
| 共享（Shared） | 沿用现有数据目录（共享会话记录、预设、设置选项等） |
| 独立（Independent） | 创建全新数据目录，会话、插件与其余实例彻底隔离 |
注意：使用「共享」模式的实例，同一时间只能有一个在工作（不能同时开两个共享实例）。
整合包一键装机
内置两个精选插件整合包，一键下载后： - 自动创建独立实例 - 自动装齐整合包内全部插件 - 整合包内插件相互隔离，附带补丁修复已知兼容性问题
整合包由社区作者 @baihejiangnan 维护，详情见 插件包仓库。
插件市场
- 分类标签快速筛选（写作、代码、学术等）
- 三种插件下载源：GitHub、Deepseek1024、dshfind（提供中文插件简介）
- 插件详情内嵌预览，一键安装归档到本地插件库
客户端界面功能
- 系统托盘：常驻托盘 + 三态状态灯、全屏沉浸模式、关闭至托盘
- 悬浮球：快速操作入口
- 余额小部件：监控 DSH API 消费
- 控制台：一键启动/重启/关闭实例
数据目录说明
- 安装版数据目录：
%APPDATA%\dsh-launcher - DSH 会话数据默认沿用
~\.dsh（即DSH_HOME） - 强制指定 DSH 配置目录：启动前设置环境变量
DSH_HOME（行为与 dsh CLI 一致）
升级
- 覆盖安装新版 exe 即可，数据不会丢失，安装器自动结束旧进程
- 「更新内置 dsh」功能只升级内置配套插件，不覆盖
~\.dsh里的第三方插件与cordis.patch.yml手动条目
典型适用场景
- 不想折腾命令行的 DSH 潜在用户：下载 exe 点两下就能用完整功能
- 需要多角色隔离：同时跑写代码/日常聊天/测试三个不同配置的 DSH 实例
- Windows 优先用户：项目明确只提供 Windows exe，适合 Windows 环境使用
- 快速试用插件：通过整合包一键装机，不需要研究每个插件的依赖兼容性
坑与注意
- 仅限 Windows：项目目前只有 Windows exe，macOS / Linux 用户无法使用此启动器，只能用原生
dshCLI。 - 多实例「共享」模式不支持同时工作：两个共享模式实例不能同时在一个会话工作，只能串行切换。
- 离线部署需要稳定网络：首次"快速离线部署"需下载 Node/pnpm/dsh 等依赖（约 200-300 MB），网络不稳定时建议提前备好。
- API Key 自己管：DSH-Launcher 本身不提供 DSH API Key，需要用户自行从 DeepSeek 平台获取并填写。
- Electron 镜像配置：国内网络环境建议配置 Electron 镜像，否则首次安装 pnpm install 可能极慢。
- v3.0.3 为最新稳定版：README 显示内置版本；升级前建议阅读 Release Note，尤其是多实例行为变更。
- 插件兼容性问题：非整合包内的第三方插件，DSH-Launcher 不担保兼容性，使用前建议在独立实例中测试。
与同类对比
| 方案 | DSH-Launcher | 原生 dsh CLI | DeepSeek Web |
|---|---|---|---|
| 操作系统 | Windows 专属 | 跨平台 | 浏览器 |
| 安装门槛 | 下载 exe 即用 | 需装 Node.js + pnpm | 无（仅 Web） |
| 图形界面 | ✅ 原生窗口 | ❌ 纯命令 | ✅ Web UI |
| 多实例并行 | ✅ 核心功能 | ❌ 需手动切换 DSH_HOME | ❌ 不支持 |
| 插件管理 | ✅ 可视化 + 整合包 | ⚠️ 纯 CLI | ⚠️ 官方市场 |
| 自托管 | ❌ 不支持 | ✅ 支持 | ❌ DeepSeek 官方 |
| 内网离线 | ✅ 可离线部署 | ✅ | ❌ 需联网 |
核心差异：DSH-Launcher 是 Windows 用户专用的 DSH 最简入口，把原本需要折腾 Node.js 环境 + 命令行的 DSH，变成了"下载即用、多实例并行、插件一键装"的全功能桌面应用，尤其适合不想碰命令行的 Windows 用户。
一句话推荐结论
Windows 用户想零门槛用 DeepSeek Harness，选 DSH-Launcher——下载 exe → 点快速离线部署 → 启动就能用，还能多开几个不同插件配置的实例同时跑，彻底省掉 Node.js 环境的折腾。
⚠️ 注意：多实例「共享」模式不能同时工作；API Key 需自行从 DeepSeek 平台获取；网络受限时记得配 Electron 镜像。