本地 AI 运行平台 rootkiller6788/dsh-launcher

DeepSeek Harness Launcher

DeepSeek Harness 的本地运行时与生态管理器 —— 运行时、实例、模型服务商、插件、技能、MCP、启动环境，全都在这里。

不用手动配环境，开箱即用。桌面外壳只是驱动它的一种方式；运行时、实例和生态内容都由 DSHL 管理。

DeepSeek Harness Launcher 把 DeepSeek Harness 的本地 Web UI、宿主服务和插件系统整合成一个原生桌面应用。窗口、托盘、运行时、工作配置和更新都由它负责，再通过 DeepSeek Harness 提供的插件机制与上游能力组合。它锁定并原样运行某个上游版本 —— 不 fork，也不改动上游行为。

下载与安装

安装包目前支持 Windows x64（Ubuntu 支持即将到来）。不需要额外运行时 —— 下载、安装、直接用。

| 平台 | 下载 | 安装 |
| Windows x64 | 下载安装程序 | 运行 NSIS 安装程序，按提示操作 |

从源码构建

环境要求：Node ≥ 22、pnpm ≥ 10、Rust（MSVC 工具链）、WebView2（Windows 11 已自带）。

pnpm install # frontend dependencies
cargo build --workspace # compile every Rust crate
pnpm build # tauri build → NSIS setup.exe
output: apps/desktop/src-tauri/target/release/bundle/nsis/-setup.exe

功能

- 开箱即用的运行时 —— 安装程序内置 Node 22；DSH 按四层链路解析（设置覆盖 → 内置 → 托管的 runtimes/<ver>/ → PATH）。不需要 Node，不需要 pnpm，不需要拉取源码。
- 托管运行时 —— 可同时安装、切换、删除、校验多个 DSH 版本；每个实例固定使用自己的版本。
- 多实例隔离 —— 每个实例都有自己的 $DSH_HOME；插件和配置不会在实例之间串用。支持创建、重命名、克隆、删除、切换。
- 模型服务商 —— API key 存放在 Windows 凭据管理器，绝不以明文落盘；内置服务商库，外加模型目录同步。
- 插件市场 —— 五个目录（插件 / 皮肤 / 技能 / MCP / 组合包）；支持浏览注册表、智能搜索（LLM 重排序），并通过 cordis.patch.yml 层安装 / 卸载 / 热启用停用，该层不会被 dsh plugin 的对账流程覆盖。
- MCP 生态 —— 安装时探测检测，配置缺口明确暴露（两个信号：自报的降级状态和 0 工具计数），提供配置对话框补齐，值存入操作系统凭据库并注入启动环境。
- 内嵌 DSH 窗口 —— DSH 渲染在启动器自己的窗口里，而不是浏览器标签页；关闭窗口即停止 harness。
- 双向主题同步 —— 浅色 / 深色 / 跟随系统，一个开关：在启动器或 DSH 任一侧修改，两边同步。
- 加固的进程树 —— Windows Job Objects（KILL_ON_JOB_CLOSE）+ 递归 taskkill /T /F 兜底 + 启动前僵尸进程清扫。连续十次启动 / 停止循环，零残留。
- 启动历史 —— 会话记录写入 SQLite，包含开始和结束时间戳以及崩溃 / 退出状态。

快速开始

1. 安装并启动 AI Harness Launcher。
2. Preferences → Providers —— 粘贴你的 DeepSeek API key（存入 Windows 凭据管理器）。
3. Home —— 选择实例，点击 Launch。

DSH 在自己的窗口中启动；Activity 面板实时输出 stdout/stderr。再次点击同一个按钮 —— 或关闭窗口 —— 即可停止。

仓库结构

dsh-launcher/
├── apps/desktop/ Tauri 2 application
│ ├── src/ React 19 + TS frontend (Vite, Tailwind v4, Zustand)
│ └── src-tauri/ Rust shell: commands/, state/, tauri.conf.json, vendor/node
├── crates/
│ ├── launcher-core/ 与框架无关的核心：paths/settings/instance/provider/process/runtime/market/mcp │ └── dsh-adapter/ DSH 专用适配器（RuntimeAdapter 实现）：runtimes/theme/mcp probe/import/resolver ├── tui/ dsh-tauri 参考镜像（嵌入式窗口机制） ├── scripts/ 开发辅助脚本（图标生成、目录生成、解析器） └── docs/ 文档

语言边界是刻意划定的： TypeScript 负责 UI，Rust 负责系统（进程、文件系统、网络、密钥、SQLite）。所有系统操作都走带类型的 Tauri IPC —— 见 CONTRIBUTING.md。

数据目录

默认所有内容都放在 %LOCALAPPDATA%/AIHarnessLauncher/ 下。在便携（绿色）模式下，根目录就是 exe 所在目录 —— 把 exe（连同打包资源）丢到任何地方，所有数据都留在它旁边，整个启动器可以装进 U 盘随身带走。

<root>/
├── settings.json 应用设置（DSH 路径覆盖、主题、最近实例） ├── providers.json 服务商元数据（API 密钥在凭据管理器中，绝不放在这里） ├── launcher.db SQLite 启动历史 ├── runtimes/ 托管的 DSH 版本 + 内置 node ├── instances/<id>/ instance.json + workspace/（= 该实例的 $DSH_HOME） ├── cache/ 注册表 + 下载缓存 └── logs/launcher.log 应用日志（panic 时另有 crash-.txt）

环境变量

| 变量 | 用途 |
| AHL_HOME | 覆盖数据根目录（默认 %LOCALAPPDATA%/AIHarnessLauncher；开发 / 测试用） |
| AHL_PORTABLE | 设为真值（1、yes、on 等）强制启用便携模式：数据根目录 = exe 自身所在目录 |
| DSH_CLI_BIN | 覆盖 DSH 命令行入口（…/apps/cli/lib/bin.js） |

便携（绿色）模式

在启动器 exe 旁边新建空的 portable（或 .portable）文件，下次启动就切换到便携模式：runtimes/、instances/、settings.json、cache/、logs/ 和 launcher.db 全部落在 exe 旁边。删掉这个标记文件就回到按用户存放的布局。当前模式可以在「偏好设置 → 数据存储」里看到。API 密钥始终留在 Windows 凭据管理器中，不会跟着文件夹一起走。

参与贡献

欢迎提交 PR —— 先读 CONTRIBUTING.md（分支 / 提交约定、PR 流程、代码与测试规范）。

许可证

MIT © 2026 dsh-launcher contributors。