dsh_desktop

把 DSH 里最好用的一批插件，做成一个开箱即用的桌面客户端

不是一个「只换皮」的 DSH 壳：我们替你挑插件、调兼容、做整合、压进一个安装包。 装好即用——不用装 Node.js，不用逐个找插件，也不用为版本冲突折腾。

[!IMPORTANT] v1.0.9：随包内核升到 0.2.2-rc.1。 官方 dsh 运行时与 33 个精选伴随插件随包交付： DeepSeek-Bot（主 Bot + 长期 Bot + 群聊）、Better Sidebar 文件工作台、Free Search、 插件商店、Prompt Optimizer、会话地图、桌面通知、MCP 工具箱……全部开箱可用， 并能在「设置 → 插件 → 内置插件」里统一查看、启停和检查更新。 架构仍是 Tauri 2 + 内置 Node：安装包更小、启动更快，坏插件 / 坏配置也永不白屏打不开。

Gitee 镜像 ·

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

✨ 为什么是「插件整合包」

DSH 的插件生态很好，但「好」和「装好就能用」之间隔着选型、兼容、版本、配置四道墙。 DSH Pack 把这件事做完：精选，整合，随包交付。

精选，而不是堆积

• 33 个伴随插件，逐个选过 — 不以数量取胜：每个内置件都经过宿主兼容验证、许可核对和真机启动检查， 清单、上游与判定记录在 内置插件清单。
• 一个安装包，一套完整体验 — Bot 团队与群聊（DeepSeek-Bot）、文件工作台（Better Sidebar）、 免费多引擎搜索（Free Search）、插件商店、提示词优化、会话地图、桌面通知、MCP / 技能工具箱、 余额与费用、会话归档、峰谷价格卫士……装完即齐。
• 统一管理，不再各自为政 — 「设置 → 插件 → 内置插件」逐条查看版本、启停、检查更新； 更新源与排除项由一张表统一维护，避免同一插件在不同入口看到不同状态。
• 上游可追溯 — 每个随包插件都标注来源仓库、版本与许可证；第三方许可见 THIRD_PARTY_NOTICES.md，兼容性判定与实测证据见清单 §五。

开箱即用

• 零环境依赖 — 内置独立 Node 运行时与 npm CLI，目标机器不需要安装 Node.js / pnpm。
• 完整 dsh，离线可用 — 打包官方 @deepseek-ai/dsh 与官方插件全集，断网也能启动。
• 双击即用 — 自动复用上次端口，内核就绪后载入原生窗口；提供安装版与便携版两种形态。
• 客户端级更新 — 右上角 ⋯ 一键检查并安装更新，双源 GitHub / Gitee 自动切换， sha256 fail-closed 校验；内核随客户端整体分发，没有另一条独立更新链。

桌面体验

• Tauri 2 原生壳 — 深色玻璃无边框窗口、自绘标题栏、Win11 圆角，关闭默认驻留托盘。
• 文件工作台 — Better Sidebar 把资源管理器、编辑器、Diff 与「在本地打开」接进右栏， 折叠 / 展开与快捷键都按桌面习惯重做。
• Bot 团队 — DeepSeek-Bot 把主 Bot、长期 Bot 和群聊装进同一个客户端： @ 转交、群共享记忆、能力库与用量页，适合把 DSH 当成长期协作工作台。
• 通知与余额 — dsh-notify 接管回合完成 / 审批 / 出错通知，点击回到对应会话； 对话底部实时显示「本轮费用 · 余额」。

工程韧性

• 守护瀑布 — 内核 boot 链逐级自愈：坏插件自动修复、坏配置自动重建、内核崩溃环原地重启， 任何不兼容形态都不退出。
• 崩溃自愈 — 渲染层假死心跳检测自动重载；内核由 supervisor 探活 + 指数退避拉起。
• 历史兼容 — 自动修补会话事件词汇表，第三方插件写入的事件不破坏会话历史。
• 数据不动 — 升级覆盖安装保留 profile 与会话；插件启停只改 patch，不碰用户数据。

📸 界面一览

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

🚀 开始使用

系统要求：Windows 10 / 11（x64）；macOS 12+（Apple Silicon / Intel）。无需预装 Node.js。

下载安装

到 GitHub Releases 下载最新版 1.0.9：

• 覆盖安装：自动定位旧目录、保留数据并装回原位置；profile、会话与插件配置不迁移、不丢失。
• 便携版：Windows 另有 DSH-Desktop-Portable-1.0.9-win-x64.zip，解压即用，数据存在 exe 旁 data\。
• 首次启动：从安装包内的 assets/plugins 同步 33 个精选插件到 profile；之后可在 「设置 → 插件 → 内置插件」里查看、启停和检查更新。
• 数据位置：Windows 安装版在 %APPDATA%\DSH Desktop\，便携版在 exe 旁 data\； macOS 在 ~/Library/Application Support/DSH Pack/。设置 DSH_HOME 可强制指定 dsh 配置目录。

v1.0.0 起不再同步 Gitee 代码与 Release 资产；Gitee 上的历史版本仅作存档。

💬 社区交流

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

🛠 从源码构建

前置：Rust 工具链 + dsh-desktop/ 已 npm install（内核 payload 源）。

# 测试（当前基线：Rust 607 / sidecar 21 / Node 2253）
cd dsh-tauri
cargo test --workspace
node --test sidecar/cli.test.js
cd ../dsh-desktop && npm test

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

# 打包 win-x64 NSIS 安装包 + 安装态冒烟
bash dsh-tauri/scripts/stage-payload.sh
cd dsh-tauri && 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 等）见开发手册。

🤖 发布

唯一发布入口是推 v* tag → tauri-release.yml： 三平台构建（Windows NSIS / 便携版、Linux AppImage / deb、macOS dmg）→ 版本 / 测试 / 路径门禁 → 汇总并校验 7 个资产 → 发布 Release。版本号三处同步（dsh-desktop/package.json、 Cargo.toml 的 workspace.package.version、tauri.conf.json），漏改直接 fail-fast。

预发布版不进 GitHub releases/latest，而壳侧更新器轮询的正是 latest —— 因此预发布不会被自动推给 稳定版用户，这是刻意设计。完整流程、转正与回滚见 发布 Runbook。

📦 安装包形态

🧩 内置插件生态

内置伴随插件在册共 33 个（v1.0.0 内置线，2026-10-08 裁定：插件源整树进安装包，装机后首次开机由 boot 的同步链镜像进 profile，开箱可用；2026-10-22 移除「临时对话」side-session、新增 DeepSeek-Bot（bot）；2026-11-08 按用户要求移除 quest-ui / auto-compact / zcode-migrate 三件，34 → 31；2026-11-09 按用户要求新增 dsh-context 与 ds-harness-remote，31 → 33；交付面门禁见 THIRD_PARTY_NOTICES 第 4 节，完整第三方组件清单同文件）。下表按 scripts/lib/companion-plugins.js 的在册顺序逐名列出，包名与版本取自各插件 package.json 实值；「上游 / 许可」一列只到「包内自己怎么说」这一层，逐条原仓库可达性与许可原文实测见 内置插件清单 §三，逐条对 0.2.2-rc.1 宿主的兼容判定见 §五：

[!NOTE] v1.0.0 精简：内置插件由 39 个减为 28 个（用户于 2026-10-07 点名移除）。不再内置的 11 个： 可视化插件市场（dsh-community-market）与其桌面服务桥（dsh-market-desktop-bridge）、插件中枢（dsh-hub）、 知识图谱记忆（graph-memory）、知识中心（dsh-cardian）、桌面宠物（harness-pet）、内置识图 VLM 转述（dsh-vision）、 拖入文件（dsh-file-drop）、图片粘贴发送（dsh-image-paste）、会话内终端标签（@deepseek-ai/dsh-terminal-tab）、 文件变更一键还原（@deepseek-ai/dsh-client-file-changes）。其中 @deepseek-ai/dsh-client-file-changes 与 @deepseek-ai/dsh-terminal-tab 与内核官方同名包重叠，镜像副本会遮蔽官方包，故一并撤回。 相近能力仍在包内：手机同屏 = dsh-pocket，文件变更追踪 = dsh-file-changes（仅其「一键还原」半边依赖已移除的壳侧 file_revert）。