吾WuZhiZuo

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 GB8 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/ 下对应资源是否存在且可执行

升级后版本还是旧的？

大概率是未先卸载旧版本导致的文件残留，请严格按照“升级流程”先卸载再安装。