MIHassan3/DSH-Launcher

DSH-Dock

你的 DeepSeek Harness 启动台。

DSH-Dock 是官方 DeepSeek Harness（@deepseek-ai/dsh）的桌面启动器。它在后台运行 harness，并在原生窗口中显示其 UI——无需终端，无需复制粘贴命令，关闭启动器时也不会丢失你的 harness。

DSH-Dock 是一个包装器，而非分支。它管理 harness 的生命周期，但从不修改 harness 本身。

界面预览

仪表盘

在简洁的原生窗口中控制 harness——启动它、停止它、查看正在运行的版本，并在准备好时打开其 UI。

启动 harness

点击 Start Harness，仪表盘会在 harness 启动时显示实时进度。首次启动会安装 harness；后续启动会快得多。

运行中

harness 启动后，仪表盘会显示其版本、进程 ID、端口 URL 和启动时间。harness 在后台运行——关闭启动器不会停止它。

DeepSeek Harness UI

harness 会在自己的原生窗口中打开，运行在嵌入式 webview 中。这是官方 UI——未经修改。

两个窗口

启动器作为控制面板保留。harness 拥有自己的空间。

状态：技术预览版（v0.5.0）

这是一个 Phase 1 里程碑。启动器已能端到端完成其核心用例，但周边功能尚未构建。

✅ 已实现的功能

- 一键在原生窗口中启动 DeepSeek Harness
- 该 harness 以分离模式在后台运行
- 该 harness 在启动器关闭后仍能继续运行——重新打开启动器会立即接管它
- 首次运行时自动安装 @deepseek-ai/dsh 的最新 RC 版本
- 原生仪表盘，带有启动 / 停止 / 打开控件

❌ 此预览版中不包含的内容

- 没有版本选择器——始终使用最新的 RC 渠道
- 没有设置界面
- 没有系统托盘图标
- 启动器本身没有自动更新
- 仅限 Windows——macOS 和 Linux 将在第 4 阶段推出
- 未签名的二进制文件——首次启动时预计会出现 SmartScreen 警告
- 必须手动安装 Node.js v22.19+（捆绑运行时将在第 4 阶段推出）

完整的版本管理库、渠道选择器和设置界面将在后续阶段推出。请参阅 docs/PROJECT_DSH-DOCK.md 了解路线图。

安装

先决条件

| 要求 | 原因 | 获取途径 |
| :--- | :--- | :--- |
| Windows 10 或 11（x64） | 启动器目前仅支持 Windows | — |
| Node.js v22.19+ LTS | harness 本身运行在 Node 上；DSH-Dock 在第 1 阶段会调用它 | nodejs.org |
| WebView2 Runtime | 启动器在 WebView2 内渲染其 UI | Win 10/11 已预装。如果缺失，请从此处获取 |

步骤

1. 下载安装程序。

前往最新发布版并下载 the latest version。

注意： 该二进制文件未签名，因此 Windows SmartScreen 会在首次运行时发出警告。点击 More info → Run anyway。

2. 运行安装程序。

该安装程序按用户安装，因此不需要管理员权限。它会将 DSH-Dock 安装到 %LOCALAPPDATA%\Programs\DSH-Dock\，并添加一个开始菜单快捷方式。

3. 启动 DSH-Dock。

首次启动会下载并安装最新的 DeepSeek Harness 发布版（约 370 MB）。根据你的网络连接情况，这需要几分钟。

首次运行很慢。这是预期内的。 后续启动是即时的——harness 已经在磁盘上了。

4. 点击 Start Harness。

仪表盘会在 harness 启动时显示进度。一旦徽章显示 RUNNING，点击 Open Harness 以在其自己的窗口中启动 DeepSeek Harness。

常见问题

我的数据存放在哪里？

DSH-Dock 将其自身状态保存在：

%LOCALAPPDATA%\DSH-Dock\
├── runtime-state.json     # which harness is running, on what port
├── versions\              # installed harness versions
├── logs\                  # launcher and harness logs
└── .npm-cache\            # npm download cache
你的 DeepSeek Harness 数据绝不会被触碰。 会话、配置、凭据和插件都存放在 %USERPROFILE%\.dsh\（或 $DSH_HOME 指向的任何位置），而 DSH-Dock 绝不会在该目录内读取、写入或缓存任何内容。

我可以同时运行官方 DeepSeek Harness 和 DSH-Dock 吗？

理论上可以，但两者会使用同一个 %USERPROFILE%\.dsh\ 配置文件，并且在构建插件树时可能会发生冲突。建议： 在启动 DSH-Dock 之前先关闭官方 harness。

第二阶段将加入显式的配置文件隔离。

如果出了问题怎么办？

日志位于 %LOCALAPPDATA%\DSH-Dock\logs\：

- launcher.log — 启动器自身的生命周期事件
- harness-.log — harness 的标准输出
- harness-.launcher.log — 启动器关于 harness 的诊断信息

如果仪表盘显示错误，请先检查 launcher.log。报告 bug 时，请同时附上 launcher.log 和最新的 harness-*.log。

如何卸载？

在 Windows 上使用 设置 → 应用 → DSH-Dock，或运行开始菜单中的卸载程序。

如果还想删除你的 harness 数据，请手动删除 %USERPROFILE%\.dsh\。

DSH-Dock 会向服务器回传数据吗？

不会。没有遥测，没有分析，没有云同步。唯一的外部请求是在安装或检查 harness 更新时发往 npm 注册表（registry.npmjs.org）。

从源码构建

你需要：

- Rust 1.84+ — rustup.rs
- Node.js v22.19+ LTS — nodejs.org
- Tauri CLI v2 — cargo install tauri-cli --version "^2"
- MSVC C++ 构建工具 — Visual Studio 2022 Build Tools，"使用 C++ 的桌面开发"工作负载

然后：

git clone https://github.com/MIHassan3/DSH-Launcher.git
cd DSH-Launcher
npm install
cargo tauri build

安装程序最终会生成在 src-tauri\target\release\bundle\nsis\。

有关架构细节、阶段计划和开发约束，请参阅 docs/PROJECT_DSH-DOCK.md。

路线图

| 阶段 | 状态 | 交付内容 |
| :--- | :--- | :--- |
| 第 0 阶段 — 基础 | ✅ 已完成 | Tauri 外壳、sidecar IPC、"hello world" |
| 第 1 阶段 — MVP 核心 | ✅ 已完成 | 安装 + 启动 + 接管、嵌入式 webview、v0.5.0 预览版 |
| 第 2 阶段 — 版本库 | 🔄 下一步 | 多版本下载、切换、缓存限制 |
| 第 3 阶段 — 设置与更新 | ⏳ 计划中 | 版本管理器 UI、更新偏好、自更新器 |
| 第 4 阶段 — 打磨与发布 | ⏳ 计划中 | 系统托盘、macOS + Linux 构建、v1.0.0 |

安全

DSH-Dock 仅与 127.0.0.1（以及 npm 注册表）通信。它从不修改 harness，从不触碰你的 $DSH_HOME，并且 harness 窗口无法访问启动器的内部。

完整安全策略请参阅 SECURITY.md。

遗留
此仓库此前发布了一个仅限 Windows 的 PowerShell 启动器（v0.1.1 及更早版本）。它已被 DSH-Dock 取代，并作为未维护的版本保留在 legacy/ 中。

如果你仍在使用旧启动器，可以安全地切换到 DSH-Dock——你在 %USERPROFILE%\.dsh\ 中的 harness 数据不会受到影响。

许可证

MIT——参见 LICENSE。