用量统计

用量统计按客户端、模型和项目统计 Paseo agent 的 token 用量与美元费用，并展示 agent 之间的协作：哪些 agent 派出了子 agent、协作树的宽度和层级，以及有多少花费发生在子 agent 上。

功能

• 侧边栏底部的统计页，也可从命令中心打开，显示费用、tokens（输入、输出、缓存读、缓存写）、请求数和有活动的 agent 总数。
• 按客户端、模型、项目分组的明细表，可按费用或 tokens 排序，点击一行即按其筛选。
• 时间范围：近 24 小时（默认）、7 天、30 天、90 天、全部或自定义。
• 客户端、模型、项目的可搜索多选筛选，组合后作用于整页所有数字。
• 多 agent 协作：协作任务、子 agent、平均与最大扇出、层级、子 agent 费用占比、客户端组合（如 Claude → Codex），以及按费用排序的协作任务与成员明细。Codex 子线程、Claude Code 子代理等客户端自带的子代理单独计数，并归到发起它们的 Paseo agent 名下。
• 按模型看协作：每个模型作为编排者、子 agent、客户端子代理时各自的花费、协作占比，以该模型为主的编排者委派了多少子 agent 及其花费与扇出，以及按模型或客户端的父子组合。点击模型即可按其筛选。
• 拓扑图：按层级展示 agent 之间的派生关系，每层按模型或客户端归组。连线粗细表示子 agent 数量，虚线节点是客户端子代理，点击节点会高亮并列出其上下游。排行中的每个协作任务也可切换为 agent 级拓扑，点击节点打开对应 agent。

工作方式

Paseo 不保存用量历史，插件读取客户端在守护进程所在机器上写的会话日志，并按会话关联到 Paseo agent：

• Claude Code：~/.claude/projects（或 CLAUDE_CONFIG_DIR）
• Codex：~/.codex/sessions 与 archived_sessions（或 CODEX_HOME）
• Pi：~/.pi/agent/sessions（或 PI_CODING_AGENT_DIR）
• Oh My Pi：~/.omp/agent/sessions

用量会写入 ~/.paseo/plugin-data/paseo-stats 下的账本，因此客户端清理旧日志后总量仍然保留。插件在每轮 agent 结束后、守护进程运行期间每 10 分钟，以及打开或刷新页面时同步。插件安装之前产生的用量，只有日志仍存在时才能读到。

项目与父 agent 信息来自 Paseo。协作树依据 Paseo 记录的父 agent 关系，即一个 agent 通过 Paseo 启动另一个 agent 时留下的关系。

费用

费用为估算值。日志自带费用时（Pi 和 Oh My Pi）直接采用；否则使用设置中的自定义单价，或 LiteLLM 公开价格表中的价格，包含缓存读和缓存写的价格。没有价格的模型标记为未定价，按 0 美元计。

设置

• 获取公开价格：每天最多一次从 GitHub 下载 LiteLLM 价格表并缓存。关闭后完全离线。不会上传任何用量数据。
• 自定义单价：按每百万 tokens 填写输入、输出、缓存读、缓存写的美元价格，适用于中转或私有模型名，或按你的实际账单校准。
• 自动更新：每 6 小时检查一次本插件的 GitHub 发布，并通过 paseo plugin update 安装新版本。插件会重新加载，守护进程无需重启。默认关闭。

网络访问

插件从守护进程发起两类外部请求，都不包含用量数据、提示词或凭据：

• raw.githubusercontent.com：LiteLLM 公开价格表，在开启公开价格时每天最多一次。
• api.github.com：本插件的最新发布信息，在打开页面时、每 6 小时或手动检查时。

更新

存在更新的 GitHub 发布时，统计页会显示提示、更新说明链接和更新按钮。执行更新会带着发布 tag 运行 paseo plugin update，随后插件重新加载，守护进程继续运行。插件会在守护进程的 PATH 和常见安装位置查找 paseo 命令，也支持用 PASEO_CLI 指定。插件内更新适用于直接从 GitHub 或 npm 安装的副本；从本地目录安装的副本会提示手动更新；从本市场安装的副本由市场审核固定版本，通过 Paseo 的插件列表或市场发布的新版本更新。

限制

其他客户端（如 Grok、Kimi Code CLI）会在数据说明中标记为暂不支持，不计入统计。token 数取决于各客户端日志的记录方式；订阅套餐按 API 标价展示。