token-report 是做什么的?
使用此插件的脚本构建本地 Claude Code 使用报告。
该报告读取 Claude Code 会话转录文件和保留的本地捕获历史记录。 其标题使用记录的提示计数:基础输入加上缓存创建加上缓存 读取。其构成视图是一个带标签的 UTF-8 字节清单,而非 Claude token 归属。它不发送任何内容,也不安装任何依赖。
使用 Python 3.8 或更高版本。在 Windows 上运行:
python "${CLAUDE_SKILL_DIR}/scripts/report.py" --no-open
在 macOS 或 Linux 上运行:
python3 "${CLAUDE_SKILL_DIR}/scripts/report.py" --no-open
仅添加用户请求支持的选项:
--since YYYY-MM-DD和--until YYYY-MM-DD选择包含的捕获本地日期。--session PREFIX选择一个会话族,包括其捕获的子代理和延续。--style clinical、--style matisse或--style nocturne选择开场风格。--json PATH写入详细数字和数据质量计数器。--metrics-only跳过文本字节清单。--no-account完全跳过账户文件。--sessions-root PATH选择另一个转录根目录及其独立的本地状态。--live-only显示当前存在的转录;保留的历史记录仍会被捕获。--no-cache绕过一次性索引。--rebuild仅清除一次性索引,重新提取实时文件,并合并而不删除保留的历史记录。--doctor检查路径、解析支持和本地状态,不进行写入或发送。--out PATH选择 HTML 输出目标。
对于 Windows 命令变体使用 python,对于 macOS/Linux 使用 python3。
保持脚本路径的引号完全如图所示。
在描述结果之前,先读取终端摘要和材料数据质量计数器。 链接生成的 HTML 和任何请求的 JSON。解释缺失或部分测量结果。 将美元数字称为 API 列表值,而非支出或账单。区分记录的 token 计数与字节组成、推断的图像计数和拟合的响应时间数字。
默认包含捕获的历史记录,因为 Claude Code 可能会修剪转录。 不要声称完整的账户或日历使用情况。不要清除历史记录来修复索引。
本地页面可能根据允许列出的电子邮件或组织元数据命名账户。 公开输出和分享隐藏该身份。历史记录仅保留账户计划字段 和解析的订阅创建日期。
历史计划标签使用捕获的账户观察结果。脚本仅在观察到规则和订阅创建守卫通过时提供计划;否则使用 null。不要虚构计划标签或日期声明。
如果订阅创建日期保持不变,计划变更在后续运行观察到新等级之前是无法检测的。因此,在此运行之前结束的时间段可能携带旧计划。该日期在升级或降级时是否变化尚未验证。
切勿打开 .credentials.json、其他凭证文件、外部工具结果文件或图片 URL。切勿检查或重复提示、输出、推理或工具内容。
不要获取价格或安装包。
如需在 tokenusage.dev 上公开分享,请仅在用户明确要求分享、发布、更新或删除其公开使用数据时使用单独的 token-share 技能。运行此报告不授权分享。