第二節 下載、執行與系統要求

[!ref] 新手教學:分步安裝與首次登入的手把手引導見快速上手指南「安裝與登入」節;本節按平台給出系統要求、下載與執行方式的完整說明。

2.1 系統要求

類別 要求
操作系統 Windows 10(1809)及以上;macOS 12.0 Monterey 及以上;主流 Linux 發行版(Ubuntu 22.04 / Debian 12 / CentOS Stream 9 及更新)
國產化操作系統 銀河麒麟桌面 V10 SP1(Kylin-Desktop-V10-SP1-2503);統信 UOS V20(Uos-Desktop-V20-1060)
處理器架構 x86-64(64 位);macOS 同時支持 Apple Silicon(arm64)
執行階段相依 Windows:系統自帶 WebView2 執行階段;Linux:webkit2gtk(4.0 / 4.1,按發行版選對應構建);macOS:系統內置 WebKit,無需額外安裝
記憶體 最低 8 GB,推薦 16 GB
磁碟 最低 1 GB 可用空間,推薦 2 GB 以上(本機工作階段 / 技能 / 記錄檔 / 程式碼索引)
顯示 建議 1280 × 720 及以上解析度
網路 首次啟動需連網獲取模型列表;日常需可存取帳號服務與所選模型供應商接口(可離線使用的能力見相應章節)

2.2 下載與執行(免安裝)

AVL Code 免安裝、下載即用 —— 沒有安裝向導。到官網下載頁 www.avlcode.cn/#download 選擇對應平台的構建後直接執行即可(內測版走 alpha 渠道,各平台鏈接恆為最新構建):

平台 / 構建 執行方式
Windows x64 下載後直接雙擊執行(免安裝、無向導)
macOS 一般版(Universal) Intel 與 Apple 芯片一般;拖入 應用程式 後執行
macOS Apple 芯片版(arm64) 僅 Apple 芯片、體積更小;拖入 應用程式 後執行
Linux x64 一般 解壓縮後直接執行
Linux AppImage 免安裝單文件,加執行權限(chmod +x)後直接執行
Linux Snap Snap 包(snap install
Linux WebKit 4.1 面向較新發行版(相依 webkit2gtk-4.1
銀河麒麟 V10 SP1 國產化專門構建(Kylin-Desktop-V10-SP1-2503,x86)
統信 UOS V20 國產化專門構建(Uos-Desktop-V20-1060)
  • Windows / Linux:下載即執行,無需安裝。
  • macOS:建議把應用拖進 應用程式 資料夾再執行 —— 否則從「下載」/「桌面」直接執行階段,檢查更新會被系統 App Translocation 機制鎖住(見 §27.7.2)。
  • 國產化環境:銀河麒麟 V10 SP1、統信 UOS V20 提供專門構建。

文件見 www.avlcode.cn/docs(使用者手冊 / 快速上手指南 / 參考手冊)。

首次啟動時會進行少量本機初始化,整個過程對使用者透明,無需額外操作。

2.3 首次啟動

啟動後將看到主介面三大分區:

  • 左側欄:工作區列表 + 登入入口 + 設置入口。
  • 中央工作階段區:工作階段分頁頁 + 訊息流 + 輸入框。
  • 右側浮層(按需彈出):計畫 / 待辦、助手配置、簽核彈窗等。

如果是首次啟動,建議先點擊左下角的「登入」按鈕完成帳號綁定(見第三節)。未登入狀態下也可以用,但需要在 設置 → 模型 中手動配置 API Key。

2.4 命令列入口(高階)

除桌面應用之外,AVL Code 還提供一組命令列入口,供希望指令碼化或在遠端伺服器上協同使用的使用者。命令列版本與桌面版共享同一份工作階段與配置,互相之間可以接力。命令列入口的具體獲取方式與子命令清單見 設置 → 資料 → 命令列工具

主二進制內置的 TUI 子命令(無需額外安裝):

命令 用途
AVL-Code tui 在終端機裡啟動 AVL Code 的 TUI 版本,與桌面版共享同一份工作階段
AVL-Code zagent-tui 直接啟動批處理對話 TUI,適合指令碼化驅動