meter-history 用于显示 CocoMeter 的历史会话数据。
用途:在已初始化 CocoPlus 的项目中,查看过去若干次会话的 CocoMeter 统计记录,帮助回顾工具调用、SQL 执行与写入活动的历史情况。
主要能力:读取 .cocoplus/meter/history.jsonl 中按行存储的 JSON 记录,取最近 N 条(N 由参数指定,默认 10),输出会话历史表格,包含 Session、Started、Duration、Tools Called、SQL Statements、Writes 六列,并在底部给出所展示会话的汇总:工具调用总数、SQL 语句总数、写入总数、估算 token 总数。
使用方式:命令为 $meter history [n],n 为要显示的会话数量,默认 10。执行前会检查 .cocoplus/ 是否存在;若不存在,输出“CocoPlus not initialized in this directory. Run $pod init to begin.”并停止。若 history.jsonl 不存在或为空,输出无历史记录的提示,说明 CocoMeter 在会话结束时记录历史,需确保已启用($meter on)并完成一次会话,然后停止。
适用场景:需要回顾近期会话的 CocoMeter 指标、核对工具与 SQL 使用量、或汇总多次会话的 token 估算时使用。应始终遵守 N 的限制,避免在大型项目中输出过多行。
限制:依赖 .cocoplus/ 初始化与 CocoMeter 历史文件存在且有记录;无历史文件或空文件时不会展示表格;不提供除最近 N 条外的查询或过滤能力;估算 token 为汇总值,具体计算方式资料未提供。