dsh_desktop

把 DeepSeek Harness 装进桌面（Windows / macOS）的开箱即用客户端

内置完整 dsh 运行时与全部官方插件，免装 Node.js，双击即用

[!IMPORTANT] 🎉 v0.5.0 —— 全架构迁移与重构：桌面壳从 Electron 全面迁移至 Tauri 2（Rust），更稳定、更好用—— 安装包更小、内存更低、启动更快；「守护瀑布」让坏插件 / 坏配置也永不白屏打不开。 用户数据与旧版完全兼容，覆盖安装即完成无痛升级（详见 迁移指南 与 架构）。 v0.5.0 之前的 Electron 版本仍可在 Releases 下载，此后仅维护 Tauri 架构。

Gitee 镜像 · · 宣发落地页

[!TIP] 🧩 推介：dsh-hotplug-hub —— 我们推介的 dsh 启动管理器。

---

✨ 特性

开箱即用

• 零依赖 — 内置独立 Node 运行时与 npm CLI，目标机器无需安装任何环境
• 完整 dsh — 打包 @deepseek-ai/dsh 及全部官方插件，离线可用
• 一键启动 — 双击即启 dsh web，优先复用上次端口，就绪后载入原生窗口
• 双形态 — 便携版（免安装、可放 U 盘）+ 安装版（桌面/开始菜单快捷方式）

体验增强

• 深色玻璃无边框窗口 — 自绘标题栏、Win11 圆角，关闭默认隐藏到系统托盘
• 桌面宠物 — 随行小鲸鱼常驻桌面，陪伴工作（设置 → 插件可一键开关）
• 侧边会话浮窗 — 随时唤起独立会话窗口，与主会话互不干扰
• 会话管理 — 归档 / 恢复 / 删除对话，历史不再堆积
• 余额小部件 — 对话底部实时显示「本轮费用 · 余额」，支持 OpenCode Go 订阅额度，点击直达充值
• 完成通知 — agent 任务跑完弹 Windows 系统通知，点击回到窗口

工程韧性

• 守护瀑布 — 内核 boot 链逐级自愈：坏插件自动修复、坏配置自动重建、内核崩溃环原地重启，任何不兼容形态都不退出（v0.5.0 Tauri 架构核心特性）
• 崩溃自愈 — 渲染层假死心跳检测自动重载；内核由 supervisor 探活 + 指数退避拉起
• 历史兼容 — 自动修补会话事件词汇表，第三方插件写入的事件不破坏会话历史
• 双源更新 — agent 版本检查（菜单就地比对 npm registry latest）+ 客户端自更新（tauri-plugin-updater，minisign 签名链 fail-closed）；升级安装自动装回旧位置，零配置丢失
• 快捷方式自愈 — 桌面与开始菜单快捷方式缺失即自动补建

📸 界面一览

开箱即用（原生 dsh web）vs DSH Desktop：

能力	原生 dsh web	DSH Desktop
启动	手动安装 Node.js、敲命令	双击即用，内置独立运行时
界面	浏览器标签页	桌面原生窗口 · 深色玻璃无边框
会话管理	仅归档	归档 / 恢复 / 删除
余额	无	实时「本轮费用 · 余额」+ OpenCode Go
桌面能力	无	托盘常驻 / 完成通知 / 桌面宠物 / 侧边浮窗
更新	手动	agent 版本检查 + 客户端签名更新链（minisign fail-closed）

🚀 快速开始

系统要求：Windows 10 / 11（x64），无需预装 Node.js。

下载 v0.5.0（Tauri 架构，2026-08-21 已发布）

平台	下载
💻 Windows x64	DSH.Desktop_0.5.0_x64-setup.exe（NSIS 安装包，约 87 MB，currentUser 模式免管理员，内嵌 WebView2 引导器）

• v0.5.0 由 Tauri 发布流水线 云端构建发布，本轮上线 Windows x64；Linux / macOS 产物与便携版将随后续版本陆续产出（见发布）。
• 从任意旧版（Electron 0.1.x–0.4.x）覆盖安装 v0.5.0：自动定位旧目录、静默卸载保数据、装回原位置，用户数据零迁移（详见迁移指南）。

国内用户（Gitee）

[!NOTE] Gitee 镜像当前最新为 Electron 版 v0.4.1——v0.5.0（Tauri）安装包暂未同步，请先从 GitHub Releases 下载。

Gitee 单文件限制 100 MB，Electron 安装包拆为分片（.part1/.part2/...），全部下载后双击该版本附件中的 merge.bat 自动合并，SHA256SUMS 校验。请到 Gitee Releases 页选择版本下载。

旧版下载（Electron 0.4.x 及更早）

GitHub Releases 保留全部历史版本。旧版命名规则：win- = Windows，macos- = macOS（.exe 一定是 Windows，.dmg / .zip 一定是 macOS）；x64 = Intel/AMD，arm64 = ARM 芯片（Windows ARM 设备如 Surface Pro X、Apple Silicon Mac 选 arm64）。形态含 portable（免安装便携版）与 setup（安装版）。

macOS 版暂未签名，Apple Silicon 首次打开会提示「无法验证开发者」——请右键点击 App → 打开，或终端执行：

xattr -dr com.apple.quarantine "/Applications/DSH Desktop.app"

数据位置：Windows 便携版在 exe 旁 data\；安装版在 %APPDATA%\DSH Desktop\。macOS 在 ~/Library/Application Support/DSH Desktop/。设置环境变量 DSH_HOME 可强制指定 dsh 配置目录。

💬 社区交流

遇到问题、想反馈建议或与其他用户交流？欢迎加入 QQ 交流群（群号 926561802）：

🛠 从源码构建

v0.5.0（Tauri 架构）——前置：Rust 工具链 + dsh-desktop/ 已 npm install（内核 payload 源）：

# 测试（Rust 全量 + sidecar + 共享脚本）
cd dsh-tauri
cargo test --manifest-path src-tauri/Cargo.toml   # Rust 142 例（CI 跳 4 集成例 → 138）
node --test sidecar/cli.test.js                    # sidecar 13 例
cd ../dsh-desktop && node --test scripts/test/unit-*.test.js  # 共享脚本回归

# 开发运行
cd src-tauri/src/app && cargo run

# 打包 win-x64 NSIS 安装包 + 安装态冒烟
bash dsh-tauri/scripts/stage-payload.sh
npx --yes @tauri-apps/cli build --config src-tauri/src/app/tauri.conf.json \
  --target x86_64-pc-windows-msvc
bash dsh-tauri/scripts/smoke-installed.sh

完整流程（含调试开关 DSH_TAURI_DIAG / DSH_TAURI_DEVTOOLS 等）见开发手册 §6。

🤖 发布

v0.5.0 起发布走 Tauri GitHub Actions 云端流水线（tauri-release.yml）：推 v* tag → 三平台构建（统一 vendor node v24.15.0 + 完整 stage-payload.sh + compat 构建 fail-fast）→ 自动汇总产物发布 Release。v0.5.0 已由此流水线发布（2026-08-21，本轮上线 Windows x64 NSIS 安装包；Linux / macOS 产物流水线已接，待后续版本产出）。Electron 时代的 release.yml 流水线随架构退役。CI 之外的手动本地打包路径见上方从源码构建（stage-payload → tauri build → 安装态冒烟三步）。

📦 Tauri 架构可导出的安装包形式

由 tauri.conf.json 的 bundle.targets 决定，按需增删即可扩展产物形式：

平台	安装包形式	状态
Windows x64	NSIS 安装包（DSH.Desktop_<版本>_x64-setup.exe）——LZMA 压缩实测 ~87 MB；currentUser 模式免管理员安装；WebView2 引导器内嵌，离线机器也能装；升级链自动装回旧目录保数据	✅ v0.5.0 已发布（CI 产出，过安装态冒烟）
Windows arm64	NSIS 安装包（--target aarch64-pc-windows-msvc 交叉构建）	🔜 Tauri 原生支持，待实测
Windows	MSI（WiX 工具链，targets 加 "msi"）	🔜 Tauri 原生支持，待开启
Linux x64	.AppImage / .deb	🔶 CI 已接（x86_64-unknown-linux-gnu），v0.5.0 未产出，待后续版本
macOS（Apple Silicon）	.app / .dmg 磁盘映像	🔶 CI 已接（aarch64-apple-darwin），v0.5.0 未产出，待后续版本

便携版（免安装、可放 U 盘）不是 Tauri 内置 target——Tauri 版以 NSIS currentUser 安装为默认形态，独立便携包规划中以后续版本提供。

🧩 内置插件生态

随安装包分发（完整第三方组件清单见 THIRD_PARTY_NOTICES.md）：

插件	说明	来源
dsh-session-manager	会话归档 / 恢复 / 删除管理	内置
dsh-better-sidebar	侧边栏增强	omdsh-dev/DSH-better-sidebar
dsh-super-injector	开发注入 / 热重载工具链	@dsh-external 社区
dsh-vision	OpenAI 兼容识图（OCR / 看图 / 读图表）	@dsh-external 社区
dsh-side-session	侧边会话浮窗，三档上下文	hzhz314159/dsh-side-session
billion-context-dsh	上下文压缩（compaction）增强	Tyan66666/billion-context-dsh
dsh-navbar	导航栏替换	vlln/dsh-navbar
dsh-hub	插件中枢：更新引擎 / 全局记忆 / 图谱与市场挂载	ARFCON/dsh-hub-DSH
harness-pet	桌面宠物	cakeni/harness-pet

🏗 架构

v0.5.0 起为 Tauri 2（Rust）架构——Electron 壳已退役，其全部职责（窗口 / IPC / 更新 / 打包）由 Rust 侧逐 crate 复刻，契约先行（dsh-tauri/contracts/ 五份硬契约为接口唯一事实源）：

┌──────────────────────────────────────────────────────────┐
│  Tauri 2 壳（Rust · 7 个单向依赖 crate + 装配根）          │
│  · supervisor：boot 守护瀑布 → spawn 内核 → 就绪换页       │
│    → 探活 → 崩溃环原地重启（任何不兼容形态都不白屏）        │
│  · shell-core        路径 / 设置（损坏自愈）/ 单实例        │
│  · kernel-process    spawn 规格 / 就绪行 / Job Object 杀树  │
│  · bridge            Electron IPC 43 通道 → Tauri command  │
│                     全量映射 + 垫片 JS（window.dshDesktop） │
│  · fence / preview-server / session-watcher /              │
│    sidecar-orchestrator（boot 时序 + Node sidecar 复用     │
│    dsh-desktop/scripts 内核侧逻辑，零重写）                 │
└──────────────────────┬───────────────────────────────────┘
                       │  dsh web --host 127.0.0.1 --port <复用端口>
                       ▼
            内置 node + @deepseek-ai/dsh
            路径解析：用户目录 overlay > 内置包
                       │  就绪行检测
                       ▼
            原生窗口加载 Web UI（仅本机回环访问）

分层铁律：crates 不依赖 tauri 运行时、可独立单测（Rust 142 例全绿，CI 环境跳过 4 个本机集成用例后 138 例；sidecar Node 13 例 + 共享脚本 unit 69 文件 899 例）；装配根只接线不实现；内核侧 Node 逻辑全部活在 dsh-desktop/scripts/。开发手册见 dsh-tauri/docs/development.md。

📄 License

MIT。基于 @deepseek-ai/dsh（MIT）。

---

⭐ 如果 DSH Desktop 帮到了你，欢迎 点个 Star 支持我们；使用中遇到任何问题，请到 Issues 反馈。