Receipts Control 是一个用于在开发者机器上操作 Receipts 可观测性栈的技能。它的用途是帮助开发者控制、查看、查询和维护 Receipts 的可观测性数据,包括启动或停止采集器、追踪日志、回填历史、检查状态以及更新仓库。
主要能力
该技能覆盖以下操作:快速检查采集器是否运行、查看最近的日志、启动 Collector(无需守护进程)、将数据导出到 Loki、追踪 Codex 会话、回填 Codex 历史、查询本地存储的 JSONL 日志,以及更新 Receipts 仓库。
使用方式
检查采集器是否运行: pgrep -f "otelcol-contrib" || true
查看最近日志: ls -la otel-logs
启动 Collector(无需守护进程): ./scripts/receipts-collector.sh configs/otel-collector.yaml
用于 Loki 导出: ./scripts/receipts-collector.sh configs/otel-collector.loki.yaml
追踪 Codex 会话: agent-otel tail-codex
回填历史: agent-otel backfill-codex
查询本地存储的 JSONL: rg '"gen_ai.tool.name"' otel-logs/interactions.jsonl
更新 Receipts: 使用更新脚本: ./scripts/receipts-update.sh main 或使用最新发布标签: ./scripts/receipts-update.sh release
适用场景
该技能适用于需要在开发机上运行和维护 Receipts 可观测性采集流程的场景,例如检查采集器状态、查看日志、追踪 Codex 会话、回填历史数据、查询本地交互日志以及更新仓库版本。
限制与注意事项
在执行以下操作前,必须始终先询问用户:修改 ~/.claude/settings.json、将日志导出到远程 Loki 端点、更改脱敏(redaction)设置。资料中未提供关于收费、价格、平台支持范围或具体效果的更多信息。