用途：分析 Claude Code 会话日志，衡量 token 使用效率，标记浪费与优化机会。适用于用户提出“分析 token 使用”“检查 token”等需求时。
主要能力：从成本、缓存效率、对话冗长、模型选择、输出效率和会话模式六个维度评估，输出带评分的报告，包含风险、机会与可操作建议。
使用方式：步骤一确定范围。默认分析当前工作目录的会话；用户提到“所有项目”“全部”“所有仓库”“整体”时切换为全局范围。默认时间窗口为 30 天；用户指定其他周期时覆盖（如“上周”对应 7 天，“最近三个月”对应 90 天）。
步骤二运行分析脚本。项目范围：python3 "${CLAUDE_PLUGIN_ROOT}/scripts/tokeneconomics.py" --days <N>；全局范围：python3 "${CLAUDE_PLUGIN_ROOT}/scripts/tokeneconomics.py" --all --days <N>。
步骤三展示结果。将完整报告内联显示，不要隐藏在文件路径后；随后指出当前最高影响的单项行动，以及需要关注的严重（评分 1）或较差（评分 2）维度。
步骤四提供深入分析。可读取浪费分类参考 references/waste-taxonomy.md，查看评分基准 references/benchmarks.md，或用不同时间窗口、项目过滤条件重新运行。
限制：报告使用 API 定价作为参照；对订阅用户，成本应表述为影响使用额度的“相对 token 消耗”，而非实际账单。不要超出数据本身进行主观发挥。若未找到使用数据，检查项目 slug 是否匹配，并建议使用 --all 查看所有项目。其他平台与限制资料暂未提供。