> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# 用量与额度

计量上限、预付额度与账单界面。

## 读取用量状态

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% 时每月通知一次所有者与管理员。


## 验证与排障

检查接近上限的计量项、耗尽的额度余额，以及使用默认预算的工作区。被阻止的操作必须指向拒绝它的那个计量项，而不是泛泛的错误。

[原生购买与恢复](https://supastack.dev/zh/docs/mobile/revenuecat.md)


## 下一篇

[内容管理](https://supastack.dev/zh/docs/mobile/content.md)