模型用量

模型用量把已记录的消耗整理成趋势、模型分布和会话分析。先看哪段时间、哪个模型用得多，再展开会话区分主代理与子代理，帮助判断下一步该检查哪里。

数据从哪里来

插件读取 Pi Desk 可访问的会话记录，汇总其中的输入、输出、缓存和成本数据。它不是服务商实时账单，也不会重新向服务商查询费用。

费用只能作为记录中的估算成本参考。 没有价格或成本记录时，页面可能显示 $0；这不等于免费，也不等于实际账单为零。记录缺失或无法读取时，统计也可能不完整。

先看用量总览

先安装插件 @jetcrab/pi-desk-usage，按提示加载。下方以假项目“轻舟”的导出任务为例，模型、会话和全部数值均为示意，不读取真实历史或账户。

在左侧栏底部快捷区找到 “用量”，打开“模型用量”总览。手机上先展开侧栏；快捷入口较多时，也可能收在底部“更多”中。

1. 选择时间范围：在“24 小时、今天、7 天、30 天、本月”之间切换。“24 小时”按最近完整小时统计；要包含当前小时，切到“今天”。本月模式可以翻到之前的月份。
2. 看趋势与模型：关注输入总量、缓存命中率和费用。点击趋势时间段或日历日期可缩小范围；点击模型条目可筛选，再次点击或“清除筛选”返回。
3. 展开会话：在“Session 用量”中选择一条会话，查看主代理自身和子代理的消耗，而不是把整项用量都算给主代理。

再分析当前会话

总览的会话条目只展开用量，不直接跳转分析。关闭总览，回到要检查的聊天窗口，从**输入框“更多 → 会话分析”**打开单会话面板。

• 趋势：查看 Token、调用、费用或命中率随时间的变化；可筛选代理、选中一段并放大，之后返回全会话。
• 代理：分别查看主代理与各子代理的 Token、费用、调用和运行情况。
• 事件：对照模型调用、工具过程和子代理活动，判断某一时段发生了什么；只展示记录中可观测的活动。

单会话分析不沿用总览的模型筛选。看完关闭面板，就能继续原来的对话；需要更新统计时，点击对应页面的“刷新”。

按问题调整筛选

插件没有独立设置页，不需要配置费率。可调整的是页面中的时间范围、模型、趋势指标和代理筛选，时间显示沿用 Pi Desk 当前生效的时区。

读数时注意口径：总览的输入总量包含缓存读取与缓存写入，缓存命中率是缓存读取占这部分输入的比例；会话分析的“总 Token”还包含输出，不是当前上下文占用。

如果出现无法读取部分会话的提示，先处理记录问题再刷新。示例中的 360k 输入、165k 总 Token 和费用只用于说明操作，不能作为实际用量或价格标准。