桌面版安装与更新
桌面版下载、安装、升级与自动更新概览
概述
桌面版提供完整的离线工作体验，支持 Windows、macOS 和 Linux 三大平台。安装后自动检测新版本并提示升级。
请根据你的操作系统选择对应的安装说明：
| 平台 | 安装包格式 | 安装说明 |
|---|---|---|
| Windows | .exe 安装向导 | Windows 版安装与更新 |
| macOS | .dmg 磁盘映像 | macOS 版安装与更新 |
| Linux | .tar.gz（AppImage + deb + install.sh） | Linux 版安装与更新 |
下载
访问 下载页面 选择对应平台的安装包下载。
各平台安装要点
Windows
双击 .exe 按向导安装即可。手动升级时无需先卸载旧版，直接双击新版覆盖安装。
macOS
双击 .dmg 将「吾智作」拖入 Applications（应用程序）。首次打开若提示“无法验证开发者”，到 系统设置 → 隐私与安全性 → 仍要打开。手动升级时直接替换 Applications 中的旧应用即可。
Linux
Linux 安装方式灵活（一键脚本 / deb / AppImage），但升级时必须先卸载旧版本，再安装新版本，否则可能出现旧文件残留、程序无法覆盖、版本混杂导致启动异常。
# Linux 升级流程（务必按顺序）
sudo /opt/agent-os-desktop/uninstall.sh # 1. 卸载旧版（保留用户数据）
tar xzf agent-os-desktop-linux-sqlite-新版本-*.tar.gz # 2. 解压新版
cd agent-os-desktop-linux-sqlite-新版本
sudo ./install.sh # 3. 安装新版详细步骤见 Linux 版安装与更新。
自动更新
桌面版每次启动时会自动检测是否有新版本可用：
- 检测到新版本后弹出提示
- 用户确认升级
- 下载升级包
- 自动安装并重启
Linux 平台建议按上述流程手动卸载旧版再安装新版，以确保程序文件完整一致。
系统要求
| 平台 | 最低要求 | 推荐配置 |
|---|---|---|
| Windows | Windows 10 64 位, 4GB RAM | Windows 11, 8GB RAM |
| macOS | macOS 12+, 4GB RAM | macOS 14+, 8GB RAM |
| Linux | Ubuntu 20.04+ / Debian 11+, 4GB RAM | Ubuntu 22.04+, 8GB RAM |
常见问题
安装后无法启动？
- Windows：确认系统为 64 位并安装最新 Visual C++ 运行库
- macOS：检查 系统设置 → 隐私与安全性 中是否允许打开
- Linux：确认系统依赖齐全（见 Linux 版安装说明 中的提示命令）
如何手动检查更新？
在桌面版设置中点击“检查更新”，系统会调用 /api/desktop/updates 接口获取最新版本信息。
企业内网如何部署？
将 desktop-releases.json 中的下载链接指向内网文件服务器即可。版本检测接口同样支持内网部署。