本地離線知識庫的最小依賴 Linux下不聯(lián)外網(wǎng)裝包跑通Linux 上把察元AI 桌面單機版裝起來這件事比 Windows 和 macOS 多一些細(xì)節(jié)。一來發(fā)行版多glibc 版本差異不可忽視二來 GUI 應(yīng)用對 GTK、WebKit 這些底層依賴有要求三來政企內(nèi)網(wǎng)經(jīng)常不開外網(wǎng)只允許從內(nèi)部源拿包。這一篇專門給 Linux 用戶一份裝包流程覆蓋國產(chǎn)化支持下的常見發(fā)行版。先看 chayuan-desktop 在 Linux 上的形態(tài)。release 通常會出 deb 包、rpm 包和 AppImage。x86_64 是默認(rèn)架構(gòu)aarch64 在國產(chǎn)化清單里也有。安裝包里同樣是兩段Tauri 主進(jìn)程二進(jìn)制、PyInstaller 打的嵌入式 Python sidecar。第一步看依賴。在 Ubuntu 22.04 或 Debian 12 上裝 deb 包前確認(rèn)這幾個包齊libwebkit2gtk-4.1-0、libssl3、libsqlite3-0、ca-certificates、libgtk-3-0、libayatana-appindicator3-1。命令行 dpkg -l | grep webkit2gtk 看一眼。如果是內(nèi)網(wǎng)無外網(wǎng)環(huán)境提前從可信鏡像拿好這些 debcp 到目標(biāo)機器后用 dpkg -i 安裝依賴問題用 dpkg --get-selections 對賬。第二步裝 chayuan-desktop。sudo dpkg -i chayuan-desktop_x.y.z_amd64.deb遇到依賴缺失會報錯根據(jù)提示 sudo apt-get install -f 補依賴但 -f 這一步在無外網(wǎng)環(huán)境下會失敗必須提前把所有依賴 deb 一起帶過來。第三步首啟動。GUI 環(huán)境下雙擊桌面圖標(biāo)命令行環(huán)境下運行 /usr/bin/chayuan-desktop。FirstRunSetup 跳出來CHAYUAN_ROOT 指到 ~/.local/share/chayuan-desktop 或者一個獨立分區(qū)。第四步無外網(wǎng)環(huán)境的特別處理。chayuan-desktop 在首啟動會下載內(nèi)嵌的 bge-m3-onnx 嵌入模型和 RapidOCR 權(quán)重文件總大小約一個 G。如果這臺機器沒外網(wǎng)需要從一臺有外網(wǎng)的機器先把模型拉下來再拷貝到目標(biāo)機器的 CHAYUAN_ROOT/models 目錄下。模型文件結(jié)構(gòu)在倉庫 packaging 文檔里有詳細(xì)列。這一步是無外網(wǎng)部署的關(guān)鍵跳過就會卡在首啟動模型加載。第五步配置模型供應(yīng)商。無外網(wǎng)情況下外部廠商鑰匙都用不上只能配本地推理。在內(nèi)網(wǎng)先部署一臺 Ollama 或 vLLM 服務(wù)把模型權(quán)重拷進(jìn)去讓它監(jiān)聽內(nèi)網(wǎng)某個 IP 端口?；氐?chayuan-desktop 的設(shè)置新建 OpenAI 兼容路由供應(yīng)商地址填內(nèi)網(wǎng)那臺機器的 http://10.x.x.x:11434/v1保存。這種內(nèi)網(wǎng)拓?fù)涫钦蟛渴鸩煸狝I 的常見做法。第六步測試一句對話。新建對話挑剛配的模型問一句話。流式輸出正常說明全棧跑通。再拖一份 PDF 進(jìn)去做 RAG 測試看引用氣泡是否能展開。本地離線知識庫 默認(rèn)使用 sqlite-vecKB 數(shù)據(jù)全部在本機。第七步排查工具。內(nèi)網(wǎng)裝包出了問題不好搜資料給一份本地診斷命令清單。systemctl status 看 sidecar 是不是被 systemd 起了ss -ltnp | grep 62581 看端口ldd /usr/lib/chayuan-desktop/chayuan-server | grep not 找缺失的動態(tài)庫strace -e traceopenat /usr/bin/chayuan-desktop 看啟動時找哪些文件失敗。這幾條命令是 Linux 裝包問題排查的萬能錘。國產(chǎn)化支持下的幾個特別情況。麒麟 V10 GA 上 webkit2gtk 版本不一定夠新需要從軟件商店或者社區(qū) ppa 裝更新一份。統(tǒng)信 UOS 1060 自帶的 webkit 版本通常足夠但需要打開 Wine 兼容關(guān)相關(guān)選項。openKylin 上情況類似 Ubuntu問題不大。loongarch64 架構(gòu)的發(fā)行版需要專門的 chayuan-desktop 二進(jìn)制構(gòu)建這個由發(fā)行渠道單獨提供。WPS AI 插件 chayuan-wps 在 Linux 上目前需要 Linux 版 WPS Office但 WPS Office Linux 版本對加載項的支持還不如 Windows。建議 Linux 上先把 chayuan-desktop 桌面端跑穩(wěn)加載項作為后期補充。免費開源的AI軟件 在 Linux 上的優(yōu)勢是裝機靈活劣勢是細(xì)節(jié)散給自己留半天時間裝第一臺。