For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /zh-tw/docs/mobile/usage.md (or send Accept: text/markdown).
用量與額度
計量上限、預付額度與賬單介面。
讀取用量狀態
GET /api/mobile/usage 返回以微單位十進位制字串表示的 AI 預算 —— budgetMicrounits、committedMicrounits、heldMicrounits 與 keyMode —— 預付額度餘額、含 label、used、limit、cap、planLimit、description 的逐項計量行，以及當前週期邊界。介面上計量器在 80% 標記警告、100% 標記危險。
這些值是十進位制字串而非 JSON 數字 —— 比較或格式化前先解析，大額預算才不會失精度。
預付額度臺賬
GET /api/mobile/credits 返回工作區的預付餘額與最近五十條臺賬記錄。餘額供“設定 → 賬單”與首頁用量卡片使用；臺賬的引用 id 不會下發給客戶端。
首頁與賬單介面
首頁複用 GET /api/workspace/metrics —— 與 Web 儀錶板渲染的同一組統計：月度 AI 支出、任務與執行緒數、成員、待處理邀請、計劃狀態與未讀通知。用量卡片顯示 AI 行加上有上限的計量項，快捷操作磁貼連結到聊天、助手、內容、電商、通知、反饋與設定。
“設定 → 賬單”顯示計劃、到期時間、額度餘額與用量計量，解釋商店計費與 Web 計費的區別，並連結到付費牆。一個服務端計劃任務每十五分鐘掃過所有工作區，並在 AI 預算達到 80% 與 100% 時每月通知一次所有者與管理員。
驗證與排障
檢查接近上限的計量項、耗盡的額度餘額，以及使用預設預算的工作區。被阻止的操作必須指向拒絕它的那個計量項，而不是泛泛的錯誤。