桌面客户端caizefan34/DSH-Desktop

DSH Desktop 🚀

把你的 DeepSeek Harness 变成一款真正的原生桌面应用

一个轻量、优雅的 Electron 桌面客户端，让 DSH 摆脱浏览器标签页，拥有系统托盘、自动服务管理和快捷键等原生体验。

GitHub stars
License
OS
Electron
Node

✨ 为什么需要它？

dsh web 默认在浏览器中运行，每次都要开个标签页、容易误关、没法后台常驻。DSH Desktop 把它封装成独立的原生窗口，带来更专注、更顺手的体验。

| 痛点 | DSH Desktop 的解法 |
|------|------------------|
| 🧩 浏览器标签页混乱 | 独立窗口，任务栏单独切换 |
| 🙈 误关页面丢上下文 | 关闭即最小化到托盘，永不丢失 |
| 🚀 每次手动起服务 | 一键自动检测 + 启动 DSH Web |
| 🔄 服务掉线无感 | 自动重连 + 托盘状态指示 |
| ⌨️ 刷新要动鼠标 | F5 / Ctrl+R 快捷键随时刷新 |

🎯 核心特性

- 🪟 原生窗口 — 独立桌面窗口，多任务更顺畅，可记忆位置/大小/最大化状态
- 🎯 系统托盘 — 关闭窗口自动最小化到托盘，后台常驻，双击即回
- ⚡ 零配置启动 — 自动检测 http://127.0.0.1:3080，未运行则拉起 dsh web
- 🖥️ 单实例 — 重复双击只会聚焦已有窗口，不再开一大堆
- 🔗 智能外链 — 页面里的外部链接自动跳转默认浏览器
- 🚨 掉线重连 — 服务断开自动重试，托盘图标实时显示状态
- 🔔 贴心通知 — 最小化到托盘时系统通知提示
- ⌨️ 快捷键 — F5 刷新 · F12 开发者工具 · Ctrl+R 重载 · Ctrl+Shift+I 调试

🚀 快速开始

前置要求

- Windows 10 / 11
- Node.js 18+（推荐 24）
- 已配置好 DeepSeek Harness（应用会自动拉起，也可手动先启动）

方式一：一键启动（推荐）

git clone https://github.com/caizefan34/DSH-Desktop.git
cd DSH-Desktop
npm install

双击 start.bat
或在 PowerShell 中运行：
powershell -ExecutionPolicy Bypass -File start.ps1

启动器会自动完成：环境检查 → Electron 依赖安装 → DSH 服务检测/启动 → 打开桌面窗口，全程彩色进度提示 ✅

方式二：直接运行

npm start

方式三：打包成安装程序

npm run dist:win

安装包（NSIS）生成在 dist/ 目录，可自定义安装路径、自动创建桌面/开始菜单快捷方式。

🎨 启动器界面预览

start.ps1 提供彩色终端启动界面：

| 步骤 | 效果 |
|------|------|
| 环境检查 | ✅ Node.js v24 · ✅ Electron 就绪 |
| 服务检测 | ✅ DSH Web 运行中 http://127.0.0.1:3080 |
| 启动 | 🚀 打开桌面窗口 |

⌨️ 快捷键

| 快捷键 | 功能 |
|--------|------|
| F5 | 刷新页面 |
| F12 | 切换开发者工具 |
| Ctrl+R | 重新加载 |
| Ctrl+Shift+I | 切换开发者工具 |

📁 项目结构

DSH-Desktop/
├── main.js          # Electron 主进程（窗口 / 托盘 / 服务管理 / 快捷键）
├── preload.js       # 安全 IPC 桥接（contextBridge）
├── start.ps1        # 🎨 彩色 PowerShell 启动器（推荐）
├── start.bat        # 🪟 批处理启动入口
├── package.json     # npm 项目配置
├── assets/          # 图标与图片资源
│   ├── icon.png / icon.ico   # 应用图标
│   ├── banner.png            # README 横幅
│   └── social-preview.png    # 社交分享预览图
└── docs/            # （计划中）更多文档

🛠️ 技术栈

| 组件 | 技术 | 说明 |
|------|------|------|
| 🖼️ 桌面框架 | Electron 33 | 跨平台桌面容器 |
| ⚙️ 后端服务 | DeepSeek Harness | AI 助手运行时 |
| 🔌 进程通信 | Electron IPC + contextBridge | 安全的渲染进程隔离 |
| 📦 打包 | electron-builder + NSIS | 一键构建安装包 |

🗺️ 路线图

- [ ] 跨平台支持（macOS / Linux）
- [ ] 多窗口 / 多会话管理
- [ ] 自定义主题与深色模式跟随系统
- [ ] 全局快捷键唤出窗口
- [ ] 开机自启动选项
- [ ] 自动更新（electron-updater）

欢迎在 Issues 提出想法或投票 💡

🤝 参与贡献

任何形式的贡献都欢迎！详见 CONTRIBUTING.md。

- 🐛 报告 Bug
- 💡 提交功能建议
- 📖 完善文档

⭐ 给我一个 Star

如果这个项目帮到了你，欢迎点亮右上角的 ⭐ Star！这对我很重要，也能让更多人发现它 🙏

📄 许可证

MIT © 2025 Zefan Cai