桌面客户端部署：开箱即用的本地体验
三种官方图形化方案（桌面客户端、启动器、云平台镜像）里，桌面客户端最接近「装个软件」的体验：下载安装包、双击安装、跟着向导走完。
它的定位
官方对桌面客户端的定义是「适合本地快速部署和使用」，支持 Windows、macOS、Linux 三端。特点很明确：
- 多平台安装包，下载后直接安装使用
- 图形化界面配置，首次部署成本低
- 适合作为本地常驻客户端
同时官方也划了边界：不建议用于服务器长期运行或生产环境。要 7×24 挂在云服务器上的，去看 Docker 部署。
适合谁
- 想快速本地体验、优先用图形界面的用户
- 不想手动维护 Docker 或 Python 环境的新手
- 个人设备长期在线，个人或小团队日常使用
安装步骤
- 打开项目组织下的 AstrBot-desktop 仓库的 Releases 页面
- 下载与你系统对应的安装包：Windows 是 .exe，macOS 是 .dmg，Linux 按发行版选 .rpm 或 .deb
- 安装完成后启动桌面客户端，按向导完成初始化
macOS 如果提示「已损坏，无法打开」，是安全机制拦截了未认证应用。打开终端执行解除隔离属性的命令（对应用路径执行 xattr -dr com.apple.quarantine），再重新打开即可——启动器一节有现成命令格式可参考。
数据在哪
桌面客户端的数据目录在家目录下的 .astrbot 目录：
- Windows：C:\Users\你的用户名\.astrbot
- macOS / Linux：/Users/你的用户名/.astrbot 或 /home/你的用户名/.astrbot
配置文件、数据库、日志都在这里面，备份整个 .astrbot 目录等于备份全部状态。