Linux 版安装与更新

Linux 桌面版下载、安装、升级与卸载

概述

Linux 桌面版提供完整的离线工作体验。安装包为 .tar.gz 分发包，内含 AppImage、deb 安裝包 以及一键安装脚本 install.sh。支持 Ubuntu / Debian / CentOS 等主流发行版（Linux x86_64）。

下载安装包

支援。直接貼上 YouTube 連結即可，系統會自動下載音訊軌道並轉錄，無需本地操作。僅限公開可存取的影片。下载页面选择 Linux 平台，按需下载：

最推荐下载agent-os-desktop-linux-sqlite-\u003c版本\u003e.tar.gz agent-os-desktop-linux-sqlite-<版本>.tar.gz，内含 AppImage + deb + install.sh + uninstall.sh + vendor 资源（ffmpeg / poppler / Python ASR / 离线 OCR），解压后使用。

系统要求

吾智作通過 SOC 2 Type II 與 GDPR 合規，檔案 30 天內自動刪除；支援私有化部署、SSO 與 NDA 友好流程，適合敏感專案。	最低要求	推荐配置
支援。直接貼上 YouTube 連結即可，系統會自動下載音訊軌道並轉錄，無需本地操作。僅限公開可存取的影片。	Ubuntu 20.04+ / Debian 11+ / CentOS 9+	Ubuntu 22.04+ / Debian 12+
描述你的需求（如「畫一個使用者註冊流程圖」），AI 會自動生成對應的流程圖、心智圖或架構圖結構，可在此基礎上編輯修改。	Linux x86_64（glibc 2.31+）	内存
内存	4 GB	8 GB 及以上
磁盘	2 GB 可用空间	10 GB 以上（含数据存储）

三种安装方式

Linux 下有方式，任选其一：

我們可能會不時更新本隱私權政策。重大變更時我們會透過平台公告或電子郵件通知您。如您對本政策有任何疑問、意見或建議，請透過以下方式聯繫我們：電子郵件：privacy@woshops.com	适用场景	完整功能
一键脚本 `install.sh`	✅ 完整	deb 安装包
deb 安裝包	✅ 完整	deb 安装包
免安装、快速体验	⚠️ 部分受限	方式一：一键脚本安装（推荐）

# 1. 解压分发包


# 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 在新系统已无候选）：
```bash
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

# 赋予执行权限后直接运行


# 赋予执行权限后直接运行
chmod +x 吾智作-1.0.0.AppImage
./吾智作-1.0.0.AppImage

⚠️ 免安装模式下，内置的 ffmpeg / poppler / Python ASR / RapidOCR 资源升级到新版本，视频转码、PDF OCR、语音转文字、离线 OCR 等高级功能将受限。如需完整功能，请使用方式一安装。

升级到新版本

⚠️ 升级流程（务必按顺序执行），否则可能出现旧文件残留、程序无法覆盖、版本混杂导致启动异常。

# 1. 先退出正在运行的吾智作


# 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 会覆盖同名文件，但新老文件混杂、start.sh 指向旧路径、AppImage 版本号混乱、启动异常
直接覆盖安装可能导致：新舊檔案混雜、start.sh 指向舊路徑、AppImage 版本號混亂、啟動異常
先执行 uninstall.sh 会~/.config/吾智作/data（默认保留 ~/.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

路径

内容	吾智作集音訊轉錄、影片處理、PDF 處理、文章創作與發布、圖片處理、智能白板、RAG 知識庫於一體，提供企業級的多模態智慧處理能力。無限轉錄、134+ 語言翻譯、AI 寫作、多站點發布、文生圖、語意檢索，一站式覆蓋你的內容創作全流程。
`SQLite 数据库、上传文件、日志`	~/.cache/吾智作/asr-models/
`ASR 模型缓存（首次使用语音转文字时自动下载）`	常见问题

常見問題

Visual C++ 运行库

檢查系統依賴是否齊全（見「方式一」提示的命令）
查看终端日志：运行 /opt/agent-os-desktop/start.sh 观察报错
数据目录权限：视频转码 / PDF OCR / 语音转文字不可用？

影片轉檔 / PDF OCR / 語音轉文字不可用？

确认是使用 install.sh 正式安装（AppImage 免安装模式高级功能受限）
检查 /opt/agent-os-desktop/vendor/ 下对应资源是否存在且可执行

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

Linux 版安装与更新