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

DeepSeek Harness Launcher

DeepSeek Harness 的本地运行时与生态系统管理器——运行时、实例、模型提供商、插件、技能、MCP 和启动环境的统一管理平台。

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

DeepSeek Harness Launcher 将 DeepSeek Harness 本地 Web UI、宿主服务和插件系统集成到原生桌面应用程序中。它掌管窗口、托盘、运行时、工作配置和更新，并通过 DeepSeek Harness 提供的插件机制与上游能力组合。它按原样固定并运行特定的上游版本——不进行分叉，不改变上游行为。

下载与安装

安装程序目前适用于 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// → PATH）。无需 Node、无需 pnpm、无需检出源码。
- 托管运行时 —— 可并行安装、切换、删除和验证多个 DSH 版本；每个实例都固定使用自己的版本。
- 多实例隔离 —— 每个实例都有自己的 $DSH_HOME；插件和配置绝不会在实例之间相互干扰。支持创建、重命名、克隆、删除、切换。
- 模型提供商 —— API 密钥保存在 Windows 凭据管理器中，绝不会以明文形式写入磁盘；内置提供商库以及模型目录同步。
- 插件市场 —— 五个目录（插件 / 皮肤 / 技能 / MCP / 捆绑包）；支持注册表浏览、智能（LLM 重排序）搜索，以及通过 cordis.patch.yml 层进行安装 / 卸载 / 热启用-禁用，该层在 dsh plugin 进行协调后依然保留。
- MCP 生态 —— 安装时进行探测检测，明确暴露配置缺口（两个信号：自报告的降级状态和 0 工具计数），提供配置对话框来填写这些缺口，并将值存储在操作系统凭据存储中并注入到启动环境中。
- 嵌入式 DSH 窗口 —— DSH 在启动器自己的窗口内渲染，而不是浏览器标签页；关闭窗口即停止 harness。
- 双向主题同步 —— 浅色 / 深色 / 跟随系统，一个开关：在启动器或 DSH 任一侧更改，双方都会跟随。
- 强化的进程树 —— Windows 作业对象（KILL_ON_JOB_CLOSE）+ 递归 taskkill /T /F 作为后备 + 启动前僵尸进程清扫。连续十次启动/停止循环后零残留。
- 启动历史 —— 会话记录在 SQLite 中，包含开始和结束时间戳以及崩溃 / 退出状态。

快速开始

1. 安装并启动 AI Harness Launcher。
2. 首选项 → 提供商 —— 粘贴你的 DeepSeek API 密钥（存储在 Windows 凭据管理器中）。
3. 主页 —— 选择一个实例并点击启动。

DSH 会在自己的窗口中启动；活动面板会实时流式显示 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 盘上随身携带。

/
├── settings.json            应用设置（DSH 路径覆盖、主题、最近实例）
├── providers.json           提供商元数据（API 密钥在凭据管理器中，绝不在此处）
├── launcher.db              SQLite 启动历史
├── runtimes/                受管理的 DSH 版本 + 捆绑的 node
├── instances//          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 CLI 入口（…/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 贡献者。