第二節 下載、執行與系統要求
[!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,適合指令碼化驅動 |
