| description | 显示 ZCode token 用量(当前会话/今日/近几天/按会话/按工作区/指定会话明细) | |
|---|---|---|
| argument-hint |
|
查询 ZCode token 用量,把返回的报表原样整理后回复;用户要详细表格时用完整数值(带千分位),不要自行缩写。
取数顺序:
- 优先调用 MCP 工具
token_usage(zcode-token-usage-statusbar提供的 stdio server,部分宿主暴露为mcp__zcode-token-usage-statusbar__token_usage)。 - 若该工具不可用(未启用/未注册),退回用 Bash 直接跑 CLI:
python3 ~/.zcode/zcode-token-usage-statusbar/zusage.py <子命令>(Windows 上python3可能是 Microsoft Store 存根会静默失败,依次改用python、py -3;macOS/Linux 用python3)
参数规则($ARGUMENTS),括号内为 CLI 子命令对照:
- 为空或 "now" → scope="current"(子命令 now)
- "today" → scope="today"(子命令 today)
- "week" → scope="week"(子命令 days 7);"近N天" → scope="days:N"(N=天数;用户没给 N 就用 week)
- "sessions" → scope="sessions";"最近N个会话" → scope="sessions:N"(子命令 sessions [N])
- "models" → scope="models";"按模型近N天" → scope="models:N"(子命令 models [days])
- "session:<会话id前缀>" → 原样传入(返回该会话总量+按模型+子代理明细)(子命令 session <前缀>)
- 统计某个工作区/项目(如"XX 工作区/项目用了多少 token")→ scope="workspace:<目录关键词>"。用户用中文或简称称呼工作区时,先从需求推断实际目录名的特征子串(缩写式称呼可直接传,工具支持单词首字母缩写匹配);未命中时工具会列出候选目录,照着换更准的子串重试(子命令 workspace <关键词>)
- 用户明确要查 WorkBuddy 的用量(如"workbuddy 今天用了多少")→ 额外传 host="workbuddy";其余情况不传 host(跟随配置,默认 ZCode)。WorkBuddy 可给上下文占比、credit、token 分项、近似速度、工具调用与预估费用(价表未收录的模型报表标「不可得」);缺
wb_usage.py的精简部署只剩上下文与 credit。照报表如实转述 - 其他输入 → 原样作为 scope 传入
用户附加要求:$ARGUMENTS