用途：arkcli-usage 是 ARK CLI 中查看存量调用结果与消耗的入口，定位为日级/聚合分析，不用于实时预算、限流或告警（实时控制应读推理命令返回的 .usage 字段）。
主要能力：usage stats 查询按 token 计费的推理用量（Token/请求数，5–30 分钟延迟）；usage plan 查询订阅套餐额度快照（AgentPlan/CodingPlan，含用了多少、还剩多少、刷新时间）；usage plan-details 查询 AgentPlan 个人版与团队版按模型/套餐内外的时间序列明细；usage balance 以 --type free-quota / media-asset / plan 查看免费额度、媒资库容量、套餐余额；usage seats 以 admin 视角查看团队席位用量。
使用方式：执行前须先用 Read 读取 ../arkcli-shared/SKILL.md 及各命令对应的 references 文件。查“我的用量”前先按 profile 路由：用 arkcli auth whoami --format json 读取 profile.type，再按类型与模态决定先查套餐桶还是 endpoint 桶。usage stats 与 usage plan-details 必带 --start（格式 YYYY-MM-DD），缺失会报 required flag；usage stats 的 --end 缺省为今天。endpoint 维度查询用 arkcli usage stats --start <YYYY-MM-DD> --mine，返回 data_count=0 时可重试 --mine-by=apikey，禁止退化为不带 --mine 的全量查询。
适用场景：查看指定日期范围的推理用量、套餐配额消耗与重置时间、AgentPlan 套餐内外按模型拆分、按模型/接入点/API Key 分组统计、Token 消耗趋势与对账。
限制：数据有 5–30 分钟延迟；Coding Plan 不提供按模型套餐明细，只能用 usage plan --product coding-plan（团队版 coding-plan-team）给 quota 快照并说明边界，禁止用 usage stats 冒充；语音模型（TTS/ASR 等）当前仅支持 models search 发现，不支持用量或费用查询；套餐未订阅时套餐桶为空，自然落到 usage stats --mine。席位管理（列表/绑定/分配/轮换 Key）走 arkcli-plans。价格、账单、认证、配置等分别转对应技能。