Linux 版安装与更新
Linux 桌面版下载、安装、升级与卸载
概述
Linux 桌面版提供完整的离线工作体验。安装包为 .tar.gz 分发包，内含 AppImage、deb 安装包 以及一键安装脚本 install.sh。支持 Ubuntu / Debian / CentOS 等主流发行版（Linux x86_64）。
下载安装包
访问 下载页面 选择 Linux 平台，按需下载：
| 分发包 | agent-os-desktop-linux-sqlite-<版本>.tar.gz | 完整分发包（含 AppImage + deb + install.sh + 全部离线资源），推荐 |
| AppImage | 吾智作-<版本>.AppImage | 免安装、直接运行，部分高级功能受限 |
| deb 安装包 | 吾智作-<版本>.deb | Debian / Ubuntu 安装包 |
最推荐下载完整分发包
agent-os-desktop-linux-sqlite-<版本>.tar.gz，内含 AppImage + deb +install.sh+uninstall.sh+ vendor 资源（ffmpeg / poppler / Python ASR / 离线 OCR），解压后使用。
系统要求
| 项目 | 最低要求 | 推荐配置 |
|---|---|---|
| 系统 | Ubuntu 20.04+ / Debian 11+ / CentOS 9+ | Ubuntu 22.04+ / Debian 12+ |
| 架构 | Linux x86_64（glibc 2.31+） | 同左 |
| 内存 | 4 GB | 8 GB 及以上 |
| 磁盘 | 2 GB 可用空间 | 10 GB 以上（含数据存储） |
安装方式
Linux 下有 三种安装方式，任选其一：
| 方式 | 适用场景 | 完整功能 |
|---|---|---|
一键脚本 install.sh | 推荐，正式安装 | ✅ 完整 |
| deb 安装包 | Debian / Ubuntu 用户 | ✅ 完整 |
| AppImage 直接运行 | 免安装、快速体验 | ⚠️ 部分受限 |
方式一：一键脚本安装（推荐）
# 1. 解压分发包
tar xzf agent-os-desktop-linux-sqlite-1.0.0-*.tar.gz
cd agent-os-desktop-linux-sqlite-1.0.0
# 2. 一键安装到 /opt/agent-os-desktop/
sudo ./install.sh安装完成后，从应用菜单找到「吾智作」启动，或在终端运行：
/opt/agent-os-desktop/start.sh首次启动 AppImage 可能需要系统依赖，按脚本提示安装即可。Ubuntu 24.04+（t64 迁移）请使用带
t64后缀的包名（libasound2在新系统已无候选）：# Ubuntu 24.04+（推荐） sudo apt install -y libnss3 libatk1.0-0t64 libatk-bridge2.0-0t64 libcups2t64 libdrm2 \ libxkbcommon0 libxcomposite1 libxdamage1 libxrandr2 libgbm1 \ libpango-1.0-0 libcairo2 libasound2t64 libfuse2t64 # 旧系统（Ubuntu 22.04 及更早） # sudo apt install -y libnss3 libatk1.0-0 libatk-bridge2.0-0 libcups2 libdrm2 \ # libxkbcommon0 libxcomposite1 libxdamage1 libxrandr2 libgbm1 \ # libpango-1.0-0 libcairo2 libasound2 libfuse2💡 新系统（Ubuntu 23.10+）默认不安装 FUSE（libfuse2），AppImage 挂载运行依赖它。若点击图标无反应，先安装上面的
libfuse2t64；start.sh 已自动检测并可在缺失时切换为解包运行模式，无需手动干预。
方式二：deb 安装包
Debian / Ubuntu 用户也可以直接安装 .deb：
# 首次安装
sudo dpkg -i 吾智作-1.0.0.deb
# 若有依赖缺失，修复依赖
sudo apt-get install -f方式三：AppImage 直接运行（免安装）
# 赋予执行权限后直接运行
chmod +x 吾智作-1.0.0.AppImage
./吾智作-1.0.0.AppImage⚠️ 免安装模式下，内置的 ffmpeg / poppler / Python ASR / RapidOCR 资源不会被使用，视频转码、PDF OCR、语音转文字、离线 OCR 等高级功能将受限。如需完整功能，请使用方式一安装。
升级到新版本
⚠️ 重要：Linux 升级必须先卸载旧版本，再安装新版本，否则可能出现旧文件残留、程序无法覆盖、版本混杂导致启动异常。
升级流程（务必按顺序执行）
# 1. 先退出正在运行的吾智作
# 2. 卸载旧版本（保留用户数据）
sudo /opt/agent-os-desktop/uninstall.sh
# 3. 解压新版本分发包
tar xzf agent-os-desktop-linux-sqlite-新版本-*.tar.gz
cd agent-os-desktop-linux-sqlite-新版本
# 4. 安装新版本
sudo ./install.sh为什么必须先卸载旧版本？
- 旧版本安装在
/opt/agent-os-desktop/，新版install.sh会覆盖同名文件，但旧版本的启动脚本、桌面图标、vendor 资源可能与新版本不一致 - 直接覆盖安装可能导致：新老文件混杂、start.sh 指向旧路径、AppImage 版本号混乱、启动异常
- 先执行
uninstall.sh会干净地清除旧程序文件与桌面图标（默认保留~/.config/吾智作/data用户数据），再安装新版本即可确保程序完整一致
用户数据存放在
~/.config/吾智作/data，卸载不会删除（除非加--purge），升级后数据自动保留。
自动更新
桌面版每次启动时自动检测新版本。Linux 下检测到新版后，仍建议按上述流程手动卸载旧版再安装新版，以确保程序文件完整。
卸载
# 方式一：使用卸载脚本（推荐，保留用户数据）
sudo /opt/agent-os-desktop/uninstall.sh
# 方式二：手动删除（保留用户数据）
sudo rm -rf /opt/agent-os-desktop ~/.local/share/applications/吾智作.desktop
# 彻底清除（同时删除用户数据，请谨慎）
sudo /opt/agent-os-desktop/uninstall.sh --purge数据目录
| 路径 | 内容 |
|---|---|
~/.config/吾智作/data/ | SQLite 数据库、上传文件、日志 |
~/.cache/吾智作/asr-models/ | ASR 模型缓存（首次使用语音转文字时自动下载） |
常见问题
安装后无法启动？
- 检查系统依赖是否齐全（见“方式一”提示的命令）
- 查看终端日志：运行
/opt/agent-os-desktop/start.sh观察报错 - 数据目录权限：
sudo chown -R $USER:$USER ~/.config/吾智作
视频转码 / PDF OCR / 语音转文字不可用？
- 确认是使用
install.sh正式安装（AppImage 免安装模式高级功能受限） - 检查
/opt/agent-os-desktop/vendor/下对应资源是否存在且可执行
升级后版本还是旧的？
大概率是未先卸载旧版本导致的文件残留，请严格按照“升级流程”先卸载再安装。