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

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

類別	要求
操作系統	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）；銀河麒麟 ARM64（V10 SP1 與 V11 各有對應構建）
處理器架構	x86-64（64 位）；macOS 同時支持 Apple Silicon（arm64）；國產化平台另有 ARM64（aarch64）構建
執行階段相依	Windows：系統自帶 WebView2 執行階段；Linux：`webkit2gtk`（4.0 / 4.1，按發行版選對應構建）；macOS：系統內置 WebKit，無需額外安裝。Linux 的 DEB 包自帶可重定位的 WebKit 4.1 執行階段，目標機沒有合適的 `webkit2gtk-4.1` 也能跑；目標機已裝有時自動改用系統函式庫（見 §27.1）
記憶體	最低 8 GB，推薦 16 GB
磁碟	最低 1 GB 可用空間，推薦 2 GB 以上（本機會話 / 技能 / 記錄檔 / 程式碼索引）
顯示	建議 1280 × 720 及以上解析度
網路	首次啟動需連網獲取模型清單；日常需可存取帳號服務與所選服務提供方接口（可離線使用的能力見相應章節）

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）
銀河麒麟 ARM64（壓縮檔）	國產化 ARM64（aarch64）免安裝構建，解壓縮後直接執行
銀河麒麟 V10 ARM64（DEB）	國產化 ARM64 安裝套件（`avlcode_v10_<版本>_arm64.deb`），隨包自帶 WebKit 4.1 執行階段

Windows / Linux：下載即執行，無需安裝。
macOS：建議把應用拖進 應用程式 資料夾再執行 —— 否則從「下載」/「桌面」直接執行階段，檢查更新會被系統 App Translocation 機制鎖住（見 §27.7.2）。
國產化環境：銀河麒麟 V10 SP1、統信 UOS V20 提供專門構建；ARM64（aarch64）機器有獨立的國產化 ARM64 渠道（壓縮檔 + V10 DEB 兩種形態），升級檢查也走這條獨立渠道，不與 x86 混用。
Linux Wayland 會話：在 Wayland 下執行階段視窗保持應用自繪的無邊框外觀，不會退回系統標題列。

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

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

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

首次啟動精靈：每次啟動時，只要沒有可用的模型（例如尚未登入，內置 AVL-Zero 還沒有 key），就會自動彈出三步精靈：

步驟	內容
1. 登入	手機號登入（未註冊的號碼自動建立帳號）；已登入時顯示當前帳號與可用點數，可「下一步」或「切換帳號 / 重新登入」。已有自己的模型服務時點「前往手動設定」，精靈暫離並開啟設定 → 模型 → 服務提供方，關掉設定頁即回到第 2 步
2. 建立專案 / 開啟專案	有歷史專案時預設列出「開啟歷史專案」；也可「新增專案」（名稱預設 `Project_NN`，存放位置優先用上次新增時的目錄）或「連線遠端伺服器（SSH）」
3. 發起首次會話	給出幾個範例與「自己輸入」；點範例只把文字填進輸入框，不會自動發送

右上角 ×（或 {{kbd:Esc}}）為「略過精靈」；第 1 步可「略過此步」，第 2 步可「稍後再說」。關閉只對本次啟動有效，問題沒解決下次啟動還會彈。
想再走一遍：設定 → 帳號 底部「首次啟動精靈」區塊的「重新執行精靈」，或命令面板裡的「執行首次啟動精靈」。
Windows 存放位置預設取最後一個本機固定盤，自動排除 U 盤、移動硬碟、讀卡器、網路盤等可移除介質，以及 BitLocker 鎖定或未就緒的盤。專案所在盤被 BitLocker 鎖定時，清單裡該項置灰並標「BitLocker 已鎖定」，點一下即調起系統的解除鎖定對話框，解除鎖定後自動開啟該專案；標「磁碟機尚未就緒」的盤暫不能開啟。

不想用精靈也可以直接點擊左下角的「登入」按鈕完成帳號綁定（見第三節）。未登入狀態下也可以用，但需要在 設定 → 模型 → 服務提供方 中手動配置 API Key。

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

主二進位內置的 TUI 子命令（無需額外安裝）：

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

終端機版現在和桌面版是同一份資料，日常該有的都有：

會話直接寫進桌面版的會話函式庫 —— 終端機裡跑的對話，回桌面就能接着看、接着聊；/sessions 列最近會話、/resume <會話 ID> 切過去、{{kbd:F2}} 開新會話、啟動時 -session <ID> 復原指定會話。
上下文折疊（/compact）與會話目標（/goal）與桌面版同源，折疊快照跟着會話走。
登入與帳號：/login（使用者名稱密碼 / /login phone <手機號> 簡訊驗證碼）、/sso、/logout、/usage 看用量、/redeem <兌換碼>、/feedback <內容> 提回饋；啟動時顯示公告橫幅。
Hook 與簽核：工作區層 hooks 生效，需要批准時在終端機裡行內決策 —— y 本次允許 / a 永久允許 / n 拒絕（Esc 同 n，30 秒未選自動拒絕）。「永久允許」寫進工作區的批准文件，與桌面端互認。
沙箱附加：/attach <路徑> [ro|rw] 給本次會話附加工作區之外的目錄 / 文件（缺省只讀），/attach 無參數列出當前清單，/detach <路徑> 解除。
終端機版會自行拉起所需的工具鏈並在結束時回收，狀態顯示在底部狀態列。

[!ref] 完整的命令清單與參數見參考手冊「命令列入口」節。

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