SuperAPI AI 工具集

analytics-clear

办公与效率

查看项目

更新于 10-16 09:18

技能介绍

用途

analytics-clear 是 claude-plugins 中的一个命令技能,用于重置分析数据,删除已有跟踪历史和统计数据,使统计从空白状态重新开始记录。

主要能力

  • 检查分析数据是否存在:读取 ${HOME}/.claude-analytics 目录。
  • 读取概览信息:若存在 summary.json,读取其中的 total_invocations(累计调用次数)和 tracking_since(统计起始时间)并打印当前统计概况。
  • 无数据时安全退出:若目录不存在,输出「No analytics data to clear.」并以 0 退出。
  • 确认保护:默认情况下会提示将永久删除所有分析数据,并列出删除范围(所有命令/技能使用历史、成功/失败统计、耗时数据),要求用户输入 yes 才继续;取消则退出。
  • 可选跳过确认:提供 --confirm 参数,传入后不再交互确认。
  • 执行清除:删除 ${HOME}/.claude-analytics 整个目录,并提示数据已清除。
  • 自动重启收集:清除后,统计会在下次使用命令或技能时自动重新开始收集。

使用方式

以命令形式调用:/analytics:clear。可通过参数 $ARGS 传入可选标志 --confirm 以跳过确认。执行逻辑基于 bash 脚本,使用 jq 解析 summary.json,使用 rm -rf 删除分析目录。

适用场景

  • 希望清空原有统计记录、从零开始收集数据时。
  • 需要删除全部使用历史、成功/失败统计与耗时数据时。
  • 在脚本或自动化流程中通过 --confirm 无交互清理数据时。

限制

  • 删除操作是永久性的,执行后无法恢复原有数据。
  • 删除范围为整个 ${HOME}/.claude-analytics 目录,包含其中的 summary.json 及所有统计数据。
  • 默认不带 --confirm 运行需要用户手动输入 yes 确认。
  • 该技能没有后置操作(Post-actions),清除后的重新收集由后续命令/技能使用自动触发。