Dinis0214/dsh-desktop-lite

DSH Desktop Lite（DeepSeek Harness 轻量化桌面）

Platforms
Architecture
dsh-plugin
License: MIT

DeepSeek Harness (DSH) Web UI 的超轻量跨平台原生桌面客户端，专为极致性能与高效协同设计。

一、项目概述

本项目为 DeepSeek Harness (DSH) Web UI（默认运行在 http://127.0.0.1:3080）提供了专属的原生桌面客户端（全面支持 macOS、Linux 与 Windows）。

🌟 核心亮点

- 系统级原生轻量架构：
- macOS：基于 Swift (AppKit + WebKit) 原生单进程实现，产物仅 ~500KB，DMG 安装包仅 ~276KB。
- Linux：基于 GTK3 + WebKit2GTK，无缝适配 GNOME / KDE / XFCE 等各大主流桌面环境。
- Windows：基于 Microsoft Edge WebView2 原生内核与 C# 启动器，安装包仅 (KeepAlive)[默认启用] | - macOS：由系统 launchd 进行守护（KeepAlive: true, ThrottleInterval: 5s）。- Linux：由 systemd --user 用户服务进行常驻守护。- Windows：系统托盘常驻守护 + 进程看护自动拉起。- 关窗不中断：关闭界面仅退出前端窗口，后台 AI 挂机任务和远程/局域网连接保持 24/7 运行；再次打开窗口即可瞬间接入。 | 长期挂机运行大任务、需要手机或远程设备随时随地通过网络访问。 |
| 随窗模式(On-Demand) | - 窗口为主进程。- 打开客户端时启动后端服务并加载界面。- 关闭窗口时立即停止后台服务并释放端口与系统内存。 | 临时本地轻量使用、使用完毕后希望完全释放系统资源。 |

如何切换模式？
- macOS：在屏幕顶部主菜单栏点击 【运行模式】，勾选 常驻模式 (Cmd+1) 或 随窗模式 (Cmd+2)。
- Linux / Windows：在窗口菜单栏/标题栏点击 【运行模式】 即可实时切换。
- 偏好设置会自动保存至用户配置目录。

三、快速安装与使用指南

💡 自动就绪特性：本项目安装脚本内置环境检测引擎，会自动探测并在必要时协助配置 @deepseek-ai/dsh 核心服务，实现全自动一键就绪。

🍎 macOS

方式 1：一键安装（推荐）
在项目根目录下执行以下命令，脚本将自动完成依赖检测、双架构编译并部署至 /Applications：
bash scripts/install.sh
启动方式：在启动台/程序坞中点击 DSH Web，或在终端执行 open -a "DSH Web"。

方式 2：下载 DMG 安装包
前往 GitHub Releases 下载 DSH-Web-Desktop-macOS.dmg，双击后将 DSH Web.app 拖入 Applications 文件夹即可。

🐧 Linux

1. 安装基础依赖
- Ubuntu / Debian：
sudo apt update && sudo apt install -y libgtk-3-0 libwebkit2gtk-4.1-0 python3-gi

- Fedora / RHEL：
sudo dnf install -y gtk3 webkit2gtk4.1 python3-gobject

- Arch Linux：
sudo pacman -S gtk3 webkit2gtk-4.1 python-gobject

2. 一键安装
bash scripts/install.sh
安装后将自动注册应用启动器图标与 systemd --user 用户级常驻守护，亦可在终端直接运行 dsh-web 启动。

🪟 Windows
方式 1：一键安装至开始菜单（推荐）
在 PowerShell 中运行安装脚本：
powershell -ExecutionPolicy Bypass -File scripts\install-windows.ps1
安装后可在 Windows「开始菜单」中直接点击 DSH Web 图标启动。

方式 2：免安装即时启动
powershell -ExecutionPolicy Bypass -File windows\launcher.ps1

四、目录结构

dsh-web-desktop/
├── app/                                   # macOS 原生 App 源码与资源
│   ├── Contents/
│   │   ├── Info.plist                     # macOS App 元数据
│   │   └── Resources/
│   │       └── icon.icns                  # macOS Squircle 图标
│   └── launcher/
│       └── main.swift                     # macOS Swift 原生启动器与生命周期
├── linux/                                 # Linux 原生客户端
│   └── src/
│       ├── main.c                         # Linux C + WebKitGTK 客户端源码
│       └── dsh-web.py                     # Linux Python + GTK 跨发行版客户端
├── windows/                               # Windows 原生客户端
│   ├── DshWeb.csproj                      # Windows .NET 8 WebView2 工程
│   ├── src/
│   │   └── Program.cs                     # Windows C# 原生主程序与托盘看护
│   └── launcher.ps1                       # Windows 免编译快速启动脚本
├── assets/
│   ├── ai.deepseek.dsh-web-desktop.plist  # macOS 登录自启模板
│   ├── dsh-web.desktop                    # Linux XDG 桌面项
│   ├── dsh-web.service                    # Linux systemd 用户守护服务模板
│   └── icons/                             # 包含 icns, ico, PNG 全套多分辨率图标
├── configs/
│   ├── ai.deepseek.dsh-web.plist.template # macOS KeepAlive 守护模板
│   └── config.example.json                # 客户端配置示例
├── scripts/                               # 全平台构建与安装运维脚本
│   ├── assemble.sh                        # 编译 macOS Universal 2 应用
│   ├── build-icon.sh                      # 重新绘制全套 icns, ico, PNG 图标
│   ├── build-linux.sh                     # 构建 Linux 客户端
│   ├── build-windows.ps1                  # 构建 Windows 客户端
│   ├── package-dmg.sh                     # 打包 macOS .dmg 安装包
│   ├── install.sh                         # 跨平台一键安装入口 (macOS & Linux)
│   ├── install-windows.ps1                # Windows 一键安装脚本
│   ├── uninstall.sh                       # 跨平台卸载与清理工具
│   ├── uninstall-windows.ps1              # Windows 卸载脚本
│   ├── enable-autostart.sh                # 启用开机自启
│   ├── disable-autostart.sh               # 禁用开机自启
│   ├── ensure-dsh.sh                      # 依赖检测与自动安装引擎
│   └── check-service.sh                   # 诊断 3080 端口与进程服务状态
├── .github/workflows/build.yml            # GitHub Actions 多平台自动化 CI/CD
├── LICENSE                                # MIT 开源协议
└── README.md                              # 项目说明文档

五、配置自定义（可选）

客户端配置文件路径：
- macOS：~/Library/Application Support/DSH Web/config.json
- Linux：~/.config/dsh-web/config.json
- Windows：%APPDATA%\DSH Web\config.json

{
"keepAlive": true,
"port": 3080,
"dshPath": null,
"nodePath": null
}
- keepAlive：true（常驻模式） / false（随窗模式）。
- port：自定义服务监听端口（默认 3080）。
- dshPath：显式指定 dsh 可执行文件路径（留空则自动探测）。
- nodePath：显式指定 node 可执行文件路径（留空则自动探测）。

六、开源协议
本项目基于 MIT License 开源。