用途:通过 cawplan CLI 查询或记录 CawPlan 业务指标,覆盖订阅、工单、QA、工作流、token/额度、API 用量等域。
主要能力:查询指标趋势(支持 --granularity day/hour/minute 聚合、--tag 过滤、--group_by 分组、--fields 选择字段),可输出结构化数据行、汇总数字,或生成 SVG/PNG 图表文件;也可写入单条指标事件。
使用方式:先运行 cawplan skill check 引导。查询示例:cawplan metrics query --domain <domain> [--metric <metric>] --start <iso> --end <iso> --granularity day [--tag key:value ...] [--group_by <k1,k2>] [--fields value,count]。写入示例:cawplan metrics ingest --domain <domain> --metric <metric> --value 1 [--dimensions '{"product":"<product_id>"}'] [--tags '{"from_plan":"basic","to_plan":"pro"}']。时间范围必须同时提供 --start 和 --end(RFC3339),相对范围需自行换算。按产品/工作区过滤时先用 cawplan products list --search "<product name>" 解析 ID。
适用场景:查询业务指标趋势、按产品/工作区拆分统计、生成图表文件、记录单条指标事件。
限制:设备/应用指标(安装量、崩溃率等)已停用,无法通过本技能获取。部分域已定义但无生产者写入(如 cawplan_workflow、cawplan_token、cawplan_user、cawplan_csm、cawplan_purchase),查询返回零行。写入无撤销,且该存储为报表用途,非权威账本。需检查 data.truncated,若为 true 应缩小范围或提高 --limit。--preview 仅适用于真实终端,不适用于聊天环境。