CocoMeter Chargeback 是 CocoPlus 体系下的一个技能,面向 Snowflake 环境中的用量分摊与 FinOps 治理。命令入口为 $meter chargeback refresh、$meter chargeback invoice 和 $meter chargeback onboarding。
用途与数据来源:该技能从 Snowflake Cortex Code 的用量历史(CLI、Desktop、Snowsight)读取 token 用量,并在 includeWarehouse 启用时通过 query_tag.app 与 QUERY_ATTRIBUTION_HISTORY.CREDITS_ATTRIBUTED_COMPUTE 关联仓库计算 credits。若存在 SNOWFLAKE.LOCAL.AI_OBSERVABILITY_EVENTS 中的 CodingAgent.Step-0 span,可用于近实时可观测性。SYSTEM、沙箱运行和后台元数据查询流量会被排除。
主要能力:refresh 执行 35 天回溯的删除/插入刷新,首次加载 60 天,并建议将 Snowflake 任务调度为每日 06:00 UTC。本地校验或 dry-run 可使用 invoke cocometer/chargeback-refresh --input <fixture.json>,其规则与仓库实现一致:持久化提示前剥离 system-reminder 块、从工具参数数组提取 SQL、按“显式用户映射→用户对象标签→角色映射→UNMAPPED”的顺序解析成本中心,并产出可直接开票的按用户汇总。invoice 为每位用户生成一份 HTML 和一份 CSV 发票包,包含 token credits、启用时的仓库 credits、总 credits、费率金额、成本中心与未映射状态。onboarding 报告 schemaReady、factHasData、costCentersMapped、unmappedUsers、spansPresent,在清单全部通过或明确列出剩余缺口前,不应宣称“已可分摊”。
使用方式:先确认 .cocoplus/ 目录存在,否则输出“CocoPlus not initialized. Run $pod init first.”并停止。随后按需调用上述三个子命令。
适用场景:需要按用户核算 AI 编码工具 token 与仓库计算成本、生成成本中心分摊发票、以及在 Snowflake 内做 FinOps 治理审计的团队。
限制与注意:技能明确反对若干捷径,例如仅按用户对全部仓库查询计费、在提示中保留系统提醒、自动映射未知用户、忽略缺失 span;UNMAPPED 是有意的治理信号而非需隐藏的错误。费用费率、价格、具体平台支持范围等细节资料未提供。