用途
meter-estimate 用于在真正执行一个计划中的操作之前，先做“预检”式的 token 与成本估算。它面向 CocoPlus（snowflake-labs/cocoplus）项目中的流水线或用户描述的操作，帮助使用者在投入执行前了解预计消耗与预算情况。
主要能力
- 流程估算：未提供参数时，读取 .cocoplus/flow.json，统计阶段数量，并按各阶段对应的人设估算 token，例如 data-engineer 约 8,000 tokens/阶段、analytics-engineer 约 6,000、data-scientist 约 12,000、data-analyst 约 4,000、bi-analyst 约 3,000、data-product-manager 约 2,000、data-steward 约 3,000、chief-data-officer 约 2,000。
- 指定操作估算：提供参数时（如
$meter estimate "run 3-stage pipeline"），估算所描述的操作。 - 准确度校准：若存在 .cocoplus/meter/adjustment-factor.json 且 sample_size >= 2，则用校准因子乘以原始总量得到校准估算，并标注基线值与校准来源；否则直接使用原始总量，并提示为保守估算、尚无校准数据。
- Snowflake 信用估算：按估算的 SQL 调用次数乘以 0.00001 计算 credits。
- 预算检查：从 cost-tracker.monitor.json 读取配置阈值，比较估算值与阈值，输出 WITHIN 或 EXCEEDS by N%。
- 预检日志：将 session_id、估算 token、估算 credits、ISO 8601 时间戳写入 .cocoplus/meter/preflight-log.jsonl。
- 输出结构：以“Pre-flight Estimate”为标题，包含 Action、分阶段 Token 估算（每阶段带人设标签）、总量、信用估算、预算检查，并提示估算受响应长度、查询复杂度、数据量影响，可用
$meter accuracy查看校准历史。
使用方式
- 先确认 .cocoplus/ 目录存在；若不存在，输出“CocoPlus not initialized in this directory. Run $pod init to begin.”并停止。
- 不传参数时估算整个流水线；传参数时估算所描述的操作。
- 按上述流程读取配置、计算、写日志并输出结果。 文档还强调两点：不应跳过按阶段拆分而只给单一总量，因为不同人设的 token 占用差异很大，会造成成本集中被隐藏；也不应跳过预算阈值检查，因为预检的核心价值就是判断是否应继续执行。
适用场景
适用于 CocoPlus 驱动的数据工程、分析建模、数据科学、BI、数据治理等流水线执行前的成本预估与预算把关。
限制
该技能依赖 .cocoplus 目录及其中的 flow.json、adjustment-factor.json、cost-tracker.monitor.json 等文件；文档明确估算为预估值，实际用量取决于响应长度、查询复杂度与数据量。其他平台支持、收费方式与价格信息暂未提供。