第三節 帳號、用量與計費
[!ref] 新手教學：首次登入的分步引導見快速上手指南「安裝與登入」節；本節詳解各登入方式、額度與用量計費機制。
AVL Code 推薦通過統一管理後台完成登入，登入這一步會自動為本機分配一份套餐額度，無需手動配置 API Key。
3.1 登入方式
帳號頁未登入區分兩段切換：手機登入（預設）| 密碼登入。
| 方式 | 流程 |
|---|---|
| 手機號驗證碼（預設，最快） | 輸入手機號 → 收簡訊驗證碼 → 輸入驗證碼登入。沒有帳號會自動註冊，無需單獨走註冊流程。驗證碼 60 秒重發倒數計時；觸發風控時自動切出圖形驗證碼（點圖可重新整理） |
| 使用者名稱 + 密碼 | 設定 → 帳號 → 密碼登入 tab → 輸入帳號密碼 → 提交 |
| SSO 單點登入 | 設定 → 帳號 → SSO 登入，自動開啟瀏覽器完成認證，回跳後桌面端自動接收憑證 |
三種方式得到的額度完全等價（取 key、狀態同步一致），體驗差異只在登入環節本身。
3.2 套餐額度與個人額度
登入成功後，帳號即帶有一份套餐額度。套餐額度按週期計量（5 小時與 7 天兩級視窗），週期內用盡會提示「套餐額度已用盡」，等週期恢復後即可繼續；購買用量點券不受套餐限額。目前套餐與可用點數顯示在 設定 → 帳號 面板上。
如果你希望使用自有的模型 API Key（例如個人訂閱的 OpenAI / Anthropic / 阿裡雲模型服務），可以在 設定 → 模型 → 服務提供方 裡新增，AVL Code 會優先使用你自己配置的 Key，自動復原到套餐額度作為兜底。
3.3 用量監控
設定 → 帳號 面板自動展示三檔用量統計：
- 24 小時
- 7 天
- 30 天
每分鐘重新整理一次；如果你觸發了某些例外，例如短時間內大量呼叫，點數餘額面板上會以提示色醒目顯示，方便定位例外。
3.3.1 配額提示按用量 / 重設時間分層
配額耗盡前的提示不再只有一檔，而是按「當前用量百分比 + 距離重設時間」分層顯示：
- 輕量提示：用量未緊、距重設還遠 → 僅狀態點變色，不打擾。
- 中度提示：用量近上限或重設時間即將到來 → 輸入框上方訊息條提示，可直接看到「剩餘 N 點 · 還有 M 分鐘重設」。
- 強提示：用量已近耗盡且重設仍遠 → 橫幅 / 卡片提示，附建議（切換備用 Provider / 續兌換碼）。
提示文案會把重設時間用本機時區直觀展示（如「今天 18:00 重設」），不再只說「即將耗盡」。
3.4 憑證過期
登入憑證有效期約 24 小時。
- 離過期不到 1 小時時，左側欄狀態點變為琥珀色。
- 過期後下一次操作會彈出"登入已過期"提示並自動跳到登入頁。
- 重新登入不會丟失會話或配置。
3.4.1 兌換碼與用量點券
設定 → 帳號 新增「兌換碼」區塊：
- 輸入兌換碼 → 點「兌換」。
- 結果就地回饋（成功 / 失效 / 已用過等 12 種情況都有明確的在地化提示）。
- 下方可檢視「我的用量點券」清單：面額、有效期、永久券（明確標註「永久」）。
[!note] 帳號面板上的「可用點數」直接取伺服器端的展示口徑，與網頁端帳號頁顯示的數字一致；用戶端不再自行把券清單相加，因此不會出現「面板數字和網頁對不上」的情況。
3.4.2 用量不足時一鍵去買
點數不足 / 套餐週期額度用盡時，不必自己去翻網頁找入口 —— 介面會就地給出去處：
| 位置 | 你會看到 |
|---|---|
| 對話裡的報錯塊 | 當這一輪失敗的原因是「餘額不足」或「週期額度已用盡」時，錯誤塊下方直接出現「購買點券」「升級 · 訂閱套餐」兩個按鈕（限流、驗證、上游故障等其它錯誤不會掛這兩個按鈕 —— 花錢也修不好） |
| 訊息流裡的低餘額預警 | 使用內置 AVL-Zero 時，可用點數低於 50 會在本會話最新一條回復下方給出一行預警「AVL Zero 可用點數僅剩 §xx.xx，即將用盡」，附「購買點券」「升級 · 訂閱套餐」兩個按鈕；已顯示用量不足報錯的那條、正在輸出時、餘額未知時都不重復提示 |
| 設定 → 帳號 · 帳號卡 | 餘額旁常駐「購買點券」入口，看到餘額的那一刻就能補充；帳號卡的餘額行固定單行顯示，餘額未知時也不會折成兩行 |
| 設定 → 帳號 · 用量區 | 「購買點券」「升級 · 訂閱套餐」兩個按鈕 |
| 版本過期鎖屏 | 同樣給出這兩個入口 |
點擊後先在應用內彈出選檔框（「選一檔，在瀏覽器裡確認並付款」），選好檔位後在系統預設瀏覽器裡直接開啟該檔的「確認購買」頁完成付款，少一步中轉；需要聯絡銷售的套餐會轉到訂閱套餐頁，框底的「前往服務頁面」則開啟完整的購券 / 訂閱頁。之所以不在應用內嵌QR Code，是因為付款鏈接本身過長、生成的QR Code密度太高，真機掃碼識別率差；交給瀏覽器反而最穩。
落點跟隨你配置的帳號服務地址，自建部署同樣正確。
3.5 登出
設定 → 帳號 → 登出。結束後本機會清除登入憑證與套餐額度的存取能力，但本機工作區、會話、技能、設定全部保留，下次登入後無縫繼續。