# dsh-desktop
**Repository Path**: xuanding/dsh-desktop
## Basic Information
- **Project Name**: dsh-desktop
- **Description**: dsh-desktop · DeepSeek Harness 桌面工作台
🤖 AI 打工人的快乐老家 —— 双击即用，255+ 像素专家天团（独立插件）可一键加装
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: gitee
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 2
- **Created**: 2026-10-24
- **Last Updated**: 2026-10-24
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
会动的桌面：508 位像素专家在办公室里走来走去、互相闲聊、随时听你差遣
---
> **一句话读懂**：基于官方 [deepseek-harness](https://github.com/deepseek-ai/deepseek-harness) 套一个**自包含桌面壳**——内置 Node sidecar 自动拉起 dsh、窗口加载其 Web UI，**不 fork、不改源码**，官方更新即用。
>
> 🧠 **记忆核心**（`dsh-memory-eternal`）· 🎨 **主题皮肤**（`dsh-theme`）· 🦾 **驯兽师内核**（`dsh-ui-three-body`）· 🧑💼 **像素办公室**（`dsh-ui-agents-pixe`）——四个原创插件按需一键加装，桌面壳默认不内置、不捆绑。
---
## 🔥 先看痛点：为什么需要「桌面壳」？
| # | 痛点（用 DSH 的每个人都遇到过） | 没桌面壳的后果 |
|---|---|---|
| 1 | **装 Node、装 npm、记命令** | 新人第一步就被劝退，终端黑窗口劝退一半 |
| 2 | **手动启动 `dsh web`** | 关掉就掉线，每次开会都要重新拉 |
| 3 | **dsh 引擎更新滞后** | 自己 `npm i -g @deepseek-ai/dsh` 才知道有新版本 |
| 4 | **没有桌面壳自动更新** | 装包后永远停在旧版本，要手动下载新安装包 |
| 5 | **没有托盘常驻** | 关窗口 = 进程没了，下次还得重新拉 |
| 6 | **无法离线零依赖** | 没有 Node、没有 WebView2 的客户电脑直接跑不起来 |
> 这不是 DSH 的硬伤，是「桌面壳」这一层本就该有人做。**解法，正是 dsh-desktop**：双击图标 = 全套环境就位 + 自动更新 + 托盘常驻 + 离线可选。
---
## ✨ 装上桌面壳之后：六道痛点逐一被解决
| 痛点 | 装上 dsh-desktop 后 | 靠什么实现 |
|---|---|---|
| ① 装 Node / 记命令 | **双击图标就完事**，终端、命令、Node 全消失 | Rust + Tauri 2 + 内置 node sidecar |
| ② 手动拉服务 | 启动自动拉起 dsh，**关窗口最小化到托盘**，进程常驻 | `tauri-plugin-shell` sidecar + tray-icon |
| ③ dsh 引擎更新滞后 | 启动后台查官方 npm 最新版，**设置窗口一键升级**，不打断 | 自动检测 + 手动一键，与终端 dsh 命令同源 |
| ④ 桌面壳自身更新 | 启动自检新版本 → **一键下载安装 → 自动重启**，不打扰 | `tauri-plugin-updater` + 双源互备（GitHub + Gitee） |
| ⑤ 没有托盘常驻 | **托盘常驻、秒开**；右键打开主窗口 / 设置 / 检查更新 / 退出 | tray-icon + 命令行管理 |
| ⑥ 无法离线 | 离线安装包内置 Node + WebView2 + dsh，**断网可装、断网可跑** | `tauri.offline.json` + 内置 dsh resources |
```mermaid
flowchart LR
A["用户双击图标"] --> B["Tauri 窗口创建"]
B --> C{"运行模式"}
C -- "在线" --> D["首次安装 dsh 到全局 npm
后续直接用内置 node 启动"]
C -- "离线" --> E["resources 内置 dsh
直接启动"]
D & E --> F["dsh web :57222"]
F --> G["WebView2 加载 Web UI"]
G --> H["用户在窗口里对话"]
H -. "每轮结束" .-> I["可选插件
记忆·主题·驯兽师·像素人"]
```
---
## 🧬 桌面壳设计：为什么是「Rust + Tauri 2」
桌面壳**不重新发明轮子**——对话、模型、agent 引擎全部交给官方 DSH，自己只做「拉起 + 窗口 + 自动更新 + 托盘」这一层。安装包小、内存占用低、跨平台原生 WebView。
| 维度 | 手 `npx dsh web` | Electron 壳 | **本壳（Tauri 2）** |
|---|---|---|---|
| 装 Node | 要 | 免 | **免** |
| 自动启动 dsh | ❌ 手动 | ✅ | ✅ |
| dsh 引擎更新 | 手动 npm | 手动 | **✅ 在线后台检查 + 多版本下拉一键升级；离线 `just update-offline` 一键** |
| 桌面壳自动更新 | ❌ | 手动 | **✅ 启动自检 + 一键更新** |
| 托盘常驻 / 秒开 | ❌ | 部分 | **✅** |
| 离线零依赖 | ❌ | 部分 | **✅（离线方案）** |
| 内置插件（开箱彩蛋） | ❌ 需自装 | ❌ 需自装 | ❌ 需自装（独立插件一键加装） |
| 像素人 / 508 角色管理 | ❌ | ❌ | ❌ 需自装（`dsh-ui-agents-pixe`） |
| 安装包体积 | — | ~200MB+ | **壳 ~12MB（+运行时）** |
| 内存占用 | — | 高 | **低** |
> **不内置任何插件**：桌面壳只做「壳」，所有功能由官方 DSH + 可选插件提供；插件想装哪个装哪个，不捆绑、不抢模型。
---
## 🖼️ 界面预览 · 原创插件全家桶
> 📸 全部真实抓屏。会动的桌面、主题、记忆、驯兽师内核都由**可选插件**提供，桌面壳默认不内置。
桌面壳本身只做「拉起 + 窗口 + 自动更新 + 托盘」，**不内置**任何可选插件（不抢模型、不堆功能）；以下四个原创插件按需一条命令加装，全部从 GitHub 源安装（不走 npm 避免重下 dsh）：
```sh
just install-plugins # 一键装齐 4 个原创插件（Windows 也可双击 scripts/install-plugins.ps1）
```
### 🧑💼 会动的桌面 · 像素办公室（[dsh-ui-agents-pixe](https://github.com/EternalNight996/dsh-ui-agents-pixe)）
**508 张完整角色卡**（The Agency 255 + agency-agents-zh 253，17 部门）；Canvas 2D 像素小人可站立、打字、踱步，浮层可拖动折叠缩放，选人即入列，闲聊可接 AI。
### 🎨 主题皮肤（[dsh-theme](https://github.com/EternalNight996/dsh-theme)）
内置主题 / 静态图 / **动态 360 跟随视频**，一键换肤，桌面更像「活」的。
### 🧠 记忆核心（[dsh-memory-eternal](https://github.com/EternalNight996/dsh-memory-eternal)）
对话自动沉淀**知识卡**到本地 Markdown Vault（去重 / 检索 / 知识图谱），零人工干预，纯本地。
### 🦾 驯兽师内核（[dsh-ui-three-body](https://github.com/EternalNight996/dsh-ui-three-body)）
把「人话」翻译给智能体：第一性原理 + 需求剖析 + 极简沟通 + 最少 token；左上角悬浮一只萌宠做开关，设置面板可配内核档位。
### ⚙️ 自动更新
「更新设置」入口由内置 dsh 客户端插件经官方槽位挂载，双处常驻：**DSH 侧边栏底部**（工作区左下角）与**设置页左侧栏底部**（设置 → 左侧栏最下「更新设置」）。点开即弹出独立**设置·更新设置窗口**：内置桌面壳与 dsh 双更新入口、版本与运行方式一览、随时一键升级。关闭主窗口会最小化到托盘，更新设置常驻托盘与设置窗口。
---
## 🚀 三步上手
| 步骤 | 做什么 | 多久 |
|---|---|---|
| **1️⃣ 下载** | 从 [Gitee Releases](https://gitee.com/eternalnight996/dsh-desktop/releases)（或 [GitHub Releases](https://github.com/EternalNight996/dsh-desktop/releases)）选你的平台 | 1 分钟 |
| **2️⃣ 安装** | 双击安装包，一路下一步 | 1 分钟 |
| **3️⃣ 双击运行** | 图标一点，自动启动，**直接开聊** | 10 秒 |
| 平台 | 安装包 |
|---|---|
| Windows | `*-setup.exe` / `.msi` |
| macOS | `.dmg` / `.app` |
| Linux | `.deb` / `.AppImage` / `.rpm` |
**安装小贴士**：
- **Windows**：双击 `setup.exe` → 一路「下一步」。若弹出 SmartScreen「已阻止运行」→ 点「更多信息」→「仍要运行」（未签名版正常现象）；装完桌面会出现图标。
- **macOS**：打开 `.dmg` → 把 App 拖进「应用程序」；首次打开提示「无法验证开发者」→ 右键图标 →「打开」。
- **Linux**：`.deb` 用 `sudo dpkg -i xxx.deb`（或双击）；`.AppImage` 先 `chmod +x` 再运行。
> 💡 想要完全离线？下载**离线安装包**（文件名带 `offline`）：Node + WebView2 + dsh 全内置，断网也能装、也能跑。
---
## 🎨 扩展：插件市场 + 更多插件
桌面壳**不内置**任何插件；所有插件都用统一 `dsh` 命令安装（桌面壳已把终端 `dsh` 统一到同一份，**零下载，不会重装 dsh**）。想第一个装**插件市场**（界面浏览/搜索/一键安装所有插件）：
```sh
dsh plugin add dshmarket
```
安装后重启桌面壳，设置页出现「插件市场」入口（[dsh-market/dsh-market](https://github.com/dsh-market/dsh-market)）。
**原创插件全家桶**（会动的桌面 / 主题 / 记忆 / 驯兽师内核）见上方「界面预览 · 原创插件全家桶」，`just install-plugins` 一键装齐；也可单独装某个：`dsh plugin --profile web add github:EternalNight996/<仓库名>`。
---
## ❓ 常见疑问（大白话版）
**Q：我需要会编程吗？**
A：完全不用。这是给「人」用的，双击就完事。
**Q：它和 DeepSeek Harness 是什么关系？**
A：它是 DeepSeek Harness 的「桌面皮肤 + 保姆」：负责帮你拉起服务、开窗口、加彩蛋；对话、模型配置还是官方原汁原味。
**Q：我的数据会传出去吗？**
A：角色、状态全在**本机**（`~/.dsh/`），纯本地、零外传、零 LLM 开销。
**Q：官方更新了怎么办？**
A：在线版桌面壳启动时**直接使用全局安装的 dsh**（`%APPDATA%\npm`，与终端 dsh 命令同源；首次联网自动安装到全局，后台只检查版本，发现新版提示你点击「更新 dsh」一键升级），桌面壳自身也自动更新——你不用管，永远最新；离线版由维护者 `just update-offline` 更新内置 dsh 后重新打包。
**Q：像素人会偷懒吗？**
A：会摸鱼（下班躺床），但该干活时打字飞快 —— 这才是真实的打工人。
**Q：关闭主窗口就退出了吗？**
A：不会。默认**最小化到托盘**、dsh 服务随桌面壳一并常驻后台；真正退出才用托盘右键「退出」。这也是「随叫随到」的实现。
---
## 🛠 命令速查（开发者）
| 命令 | 作用 |
|---|---|
| `just setup` | 安装 Tauri CLI（`cargo install tauri-cli --locked`）+ 全局化 dsh CLI |
| `just setup-dsh` | 仅全局化 dsh CLI（终端 `dsh` 命令直用） |
| `just setup-linux` | Ubuntu/Debian 系统依赖（仅 Linux） |
| `just vendor` | 准备运行时（node/npm sidecar + 内置 dsh） |
| `just install-plugins` | 一键部署 4 个原创插件到 web profile |
| `just dev` | 开发运行（Rust 热重载） |
| `just run` | 一键本地启动调试：增量构建后直接运行 debug 版 exe（比 dev 更快） |
| `just dist` | 当前平台 debug 构建 |
| `just release-win` | Windows NSIS 安装包（mac/linux 同理：`release-mac` / `release-linux`） |
| `just dist-offline` / `release-*-offline` | 离线构建（内置 WebView2 + dsh） |
| `just update` | 自动查 npm 官方 dsh 最新版并升级**全局 dsh**（`%APPDATA%\npm`，与桌面壳在线 dsh 同源） |
| `just update-offline` | 拉取最新 dsh 到离线 runtime（`vendor/dsh-runtime`） |
| `just keygen` | 生成更新签名密钥（一次性；私钥 `.tauri/updater.key` 已 gitignore） |
| `just icon` | 从 `assets/logo.png` 生成全套图标 |
| `just release-publish "说明"` | Windows 一键发布（带签名 NSIS → latest.json → GitHub Releases → 打 tag） |
完整构建流程 + 安装部署教程见 [docs/rules/09-user-manual.md](docs/rules/09-user-manual.md) 与 [docs/rules/05-adr/](docs/rules/05-adr/)。
---
## 📦 发布记录（精简版）
- **v0.7.0**：**桌面壳更新升级为多版本下拉**（列 GitHub/Gitee 全部发布版本，任选下载安装）+ **Gitee/GitHub 双源支持**（版本列表 Gitee tags 优先、下载 Gitee/GitHub 双源兜底，国内网络可选），下载后 **minisign 签名校验通过才安装**；**dsh 安装进度条实时化**（改 `--loglevel=http` 解析 npm http fetch 行，实时显示已下载包数）
- **v0.6.1**：dsh 更新升级为**多版本下拉选择**——设置窗口一键拉取 npm 官方全部版本（绿=正式 / 黄=预发布 / 蓝=当前已装），任选版本安装 + 一键到 latest tag + npm 安装进度实时显示；**适配 dsh alpha 的 token 认证**（Web UI 根路径带 token 才可进，桌面壳自动解析并导航，修复升级预发布版后卡加载页）；升级流程改为**先停 dsh 再安装**（防运行时锁住原生 `.node` 文件导致 EBUSY 半装损坏）+ 失败回滚重拉
- **v0.5.0**：三道防线根治「崩溃没画面」——① 看门狗：dsh 进程崩溃后退避自动重启（1s→5s），用户无感恢复；② HTTP 200 真探活：替代 TCP ping，杜绝半死服务被复用导致白屏；③ 失败降级：连续崩溃后加载页显示崩溃原因（含插件名）+ 重试按钮；④ 客户端错误注入：SPA 模块加载失败时触发壳侧重启；⑤ 自动修复：一键移除问题插件条目并重启；⑥ 启动状态轮询：加载页实时感知后端状态
- **v0.4.x**：自动更新 + 双源互备；GitHub Actions 跨平台三平台构建签名 + Gitee 镜像同步；Gitee 大文件回退 GitHub 直链；非 Windows 平台编译门控修复
- **v0.3.x**：原创插件一键部署脚本 + README 重设计；压缩主 GIF 27MB→6.2MB
- **v0.2.x**：终端 dsh 命令路径自动统一；统一 `dsh` 命令替换 `npx`；自动更新 + 设置窗口实战打磨
- **v0.1.x**：首个 Tauri 2 桌面壳 + 离线 / 在线两套打包方案
## 🔧 v0.8.0 修复
- **dsh 引擎版本下拉默认选中错乱**：已装旧 alpha（如 0.1.2-alpha.4）+ 官方 latest 是更新预发布版本（如 0.1.2-rc.1）时，下拉默认选中已装版本，按钮置灰成「已是当前版本」，用户以为「更新不到指定版本」。改为按 dist-tag 优先级（latest → alpha → 当前已装）默认选中，按钮直接可用。
- **dsh 安装进度条不真实**：原进度条只显示「已下载 N 个包」、条本身几何脉动让用户感觉「不动」。改为前端伪百分比：90s 定时器主推到 99% 停下，事件触发时按真实包数 ×0.96 当下界保证不被定时器「超车」，99% 留缓冲给 reify/integrity。
- **Tauri 2 capabilities/permissions 同步**：v0.7.0 加的多版本下拉与终端 dsh 命令统一 4 个新命令（list_app_versions / install_app_version / get_dsh_cli_status / unify_dsh_cli）补齐对应 permission 注册。
详细版本见 [GitHub Releases](https://github.com/EternalNight996/dsh-desktop/releases)。
---
## 📄 License
[MIT](LICENSE)
---
如果这个「桌面壳 + 原创插件全家桶」对你有帮助，点个 ⭐ Star，或分享给同样需要它的朋友～
