SuperAPI AI 工具集

meter-report

数据与分析

查看项目

更新于 10-23 23:07

技能介绍

用途

meter-report 是一个用于生成 CocoMeter 用量报告的技能。其目标是生成当前会话的完整 CocoMeter 使用报告,并可选地覆盖最近 N 个会话,报告内容包括按模型细分、按操作成本以及总计数据。

主要能力

该技能会输出一份结构化报告,包含以下部分:

  • 当前会话(CURRENT SESSION):状态(Active 或 Inactive)、会话 ID、开始时间、持续时间、Token 用量(输入、输出、总计)、工具活动(工具调用次数、最常用工具)、模型细分(各模型的输入/输出 Token 及调用次数)。
  • 操作日志(ACTIONS LOG):最近 10 条操作记录,格式为时间、模型、操作、输入→输出 Token。
  • 会话历史(SESSION HISTORY):最近 5 个会话的日期、持续时间、总 Token 数、工具调用次数。
  • 总计(TOTALS):所有已记录会话的会话数、总 Token 数、总工具调用次数、平均每会话 Token 数。
  • 预估成本(ESTIMATED COST,可选):仅在项目上下文中存在 Snowflake Cortex Token 定价数据时附加,显示当前会话与所有会话的预估金额,并注明估算基于已发布的 Cortex Token 定价,实际账单可能不同。

使用方式

技能执行流程如下:

  1. 预检(Pre-flight Check):检查 .cocoplus/ 目录是否存在。若不存在,输出“CocoPlus not initialized in this directory. Run $pod init to begin.”并停止。
  2. 读取会话数据:读取 .cocoplus/meter/current-session.json(若存在);读取 .cocoplus/meter/history.jsonl,解析最近 10 个会话(若不足则解析全部)。若完全没有任何 meter 数据,输出“No CocoMeter data found. Use $meter on to enable tracking, then use $meter to see current usage.”并停止。
  3. 生成报告:按上述结构输出报告。
  4. 成本估算(可选):若项目上下文中存在 Snowflake Cortex Token 定价数据,则附加预估成本部分;否则省略该部分并注明“Cost estimation requires Snowflake Cortex pricing data. Check your Snowflake account for actual billing.”

适用场景

适用于需要了解 CocoMeter 在会话中 Token 消耗、工具调用与模型使用情况的开发者,尤其是需要跨会话趋势来理解成本模式的场景。

限制与注意事项

  • 该技能明确反对两种捷径:仅显示当前会话而跳过历史(会遗漏累计影响),以及在缺少定价数据时编造成本估算(虚构数字比没有数字更糟,定价数据不可用时始终省略成本部分)。
  • 成本估算依赖 Snowflake Cortex 定价数据,实际账单可能不同。
  • 退出标准要求报告必须包含当前会话块(状态、Token 用量、工具活动、模型细分)、会话历史块(最近 5 个会话的表格形式)、总计块(累计会话、Token、工具调用),以及在有定价数据时包含预估成本部分,否则以说明性注释替代。