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/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% 时每月通知一次所有者与管理员。
验证与排障
检查接近上限的计量项、耗尽的额度余额,以及使用默认预算的工作区。被阻止的操作必须指向拒绝它的那个计量项,而不是泛泛的错误。