用途：跟踪 token 使用量、估算成本，并跨会话与用户分析 AI 消费情况。
聊天命令：/usage 查看当前会话，可加 today、week、month；/usage breakdown [today] 按模型看成本明细，/usage by-model 与 /usage by-user 分别为按模型、按用户的别名；/usage history [days] 查历史（默认 7 天）；/usage estimate <model> <in> <out> 估算指定模型输入输出 token 的费用；/usage user <id> [today] 查指定用户；/usage reset 清除全部用量数据。
TypeScript API：用 createUsageService 创建服务，storage 可选 sqlite、postgres、memory，dbPath 指定路径，pricing 按每 100 万 token 配置输入与输出价格，footerMode 可选 off、tokens、full。record 记录请求（userId、sessionId、model、inputTokens、outputTokens、durationMs、cached）。getSessionUsage 返回会话请求数、输入输出与总 token、预估成本、总耗时；getUserUsage 支持 period 为 day、week、month、all；getTotalUsage 支持 from、to；getUsageByModel 支持 period；formatFooter 生成如“Tokens: 1.5k in / 800 out | Cost: ~$0.02”的页脚；formatSummary 生成摘要；estimateCost 估算单次请求成本。
内置单价（每 100 万 token，输入/输出）：claude-3-opus 15/75，claude-3-sonnet 3/15，claude-3-haiku 0.25/1.25，gpt-4 30/60，gpt-4o 5/15，gpt-4o-mini 0.15/0.60。footerMode 中 off 不显示，tokens 只显示 token，full 显示 tokens 与成本。
预算告警：setBudget 可设 userId、monthly 与 alertAt 比例数组（如 0.5、0.8、0.95），checkBudget 返回 limit、used、percent、remaining。
建议：定期每周检查用量、设置预算避免意外支出、简单任务选 Haiku 等低成本模型、尽量缓存减少重复查询、按用户排查高消耗。限制：资料未提供安装命令、认证方式、价格随供应商变化时的更新机制及除上述外的平台支持。