SuperAPI AI 工具集

receipts-control

部署与运维

查看项目

更新于 10-15 11:20

技能介绍

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)设置。资料中未提供关于收费、价格、平台支持范围或具体效果的更多信息。