dsh-desktop-lite

三、快速安装与使用指南

💡 自动就绪特性：本项目安装脚本内置环境检测引擎，会自动探测并在必要时协助配置 @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

---

五、配置自定义（可选）

客户端配置文件路径：

• 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 可执行文件路径（留空则自动探测）。

---