SuperAPI AI 工具集

usage-tracker

数据与分析

查看项目

更新于 10-16 04:02

技能介绍

用途

Usage Tracker 用于按时间跟踪和分析工具或资源的使用指标,涵盖带时间戳的日志记录、报告生成与趋势检测。它适合需要观察一段时间内使用量变化的场景,例如生成日度、周度或月度使用报告、监控配额或限额、分析使用模式,以及为仪表盘提供数据基础。

主要能力

  • 带时间戳的使用日志记录。
  • 生成使用汇总报告,示例中包含按日期统计 opus、sonnet、haiku 次数并输出为表格的实现。
  • 趋势检测与使用模式分析。
  • 生成建议(示例中通过 generate_recommendations 输出)。
  • 提供多个子技能:Basic Usage Logging、Usage Summary Reports、Trend Analysis、Best Practices。

使用方式

该技能以 Bash 脚本形式呈现。示例中配置了 USAGE_DIR 与 USAGE_LOG,日志文件位于 ${HOME}/.usage-monitor/usage.log。报告生成逻辑使用 date、grep、wc 等命令遍历最近数天,统计各模型使用次数并写入输出文件,最后追加推荐内容和生成时间。完整示例名为 usage-monitor,包含颜色变量和核心函数。

适用场景

  • 需要跟踪工具/资源随时间的使用情况。
  • 生成日度、周度、月度使用报告。
  • 监控配额或限额。
  • 分析使用模式。
  • 构建仪表盘。

限制

不适合实时指标(应使用专门的监控工具)、高频事件(每秒超过 100 次),以及未经加密的敏感数据。