芯片测试与射频走线设计：从开尔文连接到阻抗匹配的工程实践
2026/8/29 15:05:15
AgentsView usage命令全参考：daily、breakdown、statusline逐个精讲
【免费下载链接】agentsviewLocal-first session search, analytics, insights, and token use statistics for coding agents, supporting Claude Code, Codex, and more than 20 other agents.项目地址: https://gitcode.com/GitHub_Trending/ag/agentsview
AgentsView 是一款本地优先（local-first）的编码代理 Token 使用统计工具，可为 Claude Code、Codex 等 20 多种编码代理记录会话、搜索、分析并统计 Token 消耗与费用。本文精讲它最实用的agentsview usage命令族：daily日报表、--breakdown模型维度下钻、statusline今日花费速览，帮你快速算清"AI 编程到底花了多少钱"。
一分钟了解 usage 命令族
AgentsView 在索引会话文件时，会把每条消息的输入、输出、缓存写入、缓存读取 Token 数写入本地 SQLite 数据库，usage命令直接查询这份预索引数据，无需每次重新解析 JSONL 日志，因此在大型历史上也能秒级出报告。
| 子命令 | 用途 | 典型场景 |
|---|---|---|
usage daily | 按天汇总 Token 与估算费用 | 终端里查看最近 30 天花费 |
usage daily --breakdown | 在日报表中展开每个模型的明细行 | 找出某天是哪个模型烧了钱 |
usage statusline | 输出一行"今日花费" | 嵌入 Shell 提示符 / tmux 状态栏 |
usage cursor | 导入 Cursor Admin API 的计费事件 | 团队级 Cursor 账单归集 |
核心实现位于 cmd/agentsview/usage.go，完整文档见 docs/token-usage.md 与 docs/commands.md。
核心命令一：agentsview usage daily
agentsview usage daily默认统计最近 30 天，输出一张对齐的终端表格：
DATE INPUT OUTPUT CACHE_CR CACHE_RD COST MODELS ---- ----- ------ -------- -------- ---- ------ 2026-04-01 77116868 2220604 39278251 887929665 $867.5794 claude-opus-4-6, gpt-5.4, ... 2026-04-02 39512998 2052183 32282358 669276138 $639.0390 claude-opus-4-6, gpt-5.4, ... ---- ----- ------ -------- -------- ---- ------ TOTAL 369376132 18650016 288882628 6114711413 $5814.8710每行包含四类 Token（输入 / 输出 / 缓存写入 / 缓存读取）、当日估算费用，以及当天参与计费的模型列表（按花费从高到低排序）。
常用参数速查表
| 参数 | 默认值 | 说明 |
|---|---|---|
--since | 30 天前 | 窗口起点，支持28d时长或YYYY-MM-DD日期（含当天） |
--until | 今天 | 窗口终点，语法同上 |
--all | 关闭 | 扫描全部历史，覆盖默认 30 天窗口 |
--agent | 全部 | 按代理名过滤，如claude、codex |
--breakdown | 关闭 | 每天下方缩进显示逐模型明细行 |
--format/--json | human | 输出 JSON，方便脚本处理 |
--offline | 关闭 | 跳过在线价格目录刷新，使用内置兜底价 |
--no-sync | 关闭 | 跳过查询前的按需增量同步，最快路径 |
--timezone | 系统时区 | IANA 时区名，用于按天归组 |
实用调用示例
agentsview usage daily # 最近 30 天 agentsview usage daily --all # 全部历史 agentsview usage daily --since 14d # 最近 14 天 agentsview usage daily --since 2026-04-01 --breakdown agentsview usage daily --json --agent claude # 只看 Claude Code agentsview usage daily --since "$(date +%Y-%m-01)" --json \ | jq '.totals.totalCost.microdollars / 1000000' # 本月总花费（美元）几个容易踩坑的细节：
- 只有同时未指定
--since、--until、--all时才会套用默认 30 天窗口；只传--until表示"直到某天的全部历史"。 --since的时长形式是相对--until锚点回溯计算的，且起点晚于终点会直接报错，而不是返回空表。- JSON 中的费用是精确的微美元（
microdollars）整数对象，除以 1,000,000 即美元，避免浮点误差。 - 若过滤到的代理（如某些 Copilot 记录）本身不记录逐条消息 Token，命令会在 stderr 打印提示，而不是默默给你一张零值表。
核心参数：--breakdown 按模型下钻
想知道"某一天的钱具体被哪个模型烧掉"，加上--breakdown即可：
agentsview usage daily --all --breakdown每个日期行下方会缩进输出该日的逐模型子行，结构与主行一致：
2026-04-01 77116868 2220604 39278251 887929665 $867.5794 claude-opus-4-6, gpt-5.4, ... claude-opus-4-6 28102 124901 287441 2812004 $8.4123 gpt-5.4 21598 98204 113882 1102507 $0.5230在 JSON 输出中，--breakdown的作用更强：每天的projectBreakdowns、agentBreakdowns、machineBreakdowns数组都会被填充，多机器共享归档的花费也能一次查询拆分清楚。modelBreakdowns则始终存在，每个模型固定一行。
核心命令二：agentsview usage statusline
agentsview usage statusline输出一行"今日花费"，专为 Shell 提示符、tmux 状态栏、窗口标题设计：
$9.61 today配合--agent过滤时，会带上代理名：
$6.42 today (claude)脚本场景推荐--json，费用以精确微美元输出，无需解析格式化字符串：
{ "date": "2026-08-04", "cost": { "microdollars": 9610000 } }接入 Starship 提示符（最快配置方法）
在~/.config/starship.toml中加入一个自定义模块：
[custom.agentsview] command = "agentsview usage statusline --offline --no-sync" when = "true" format = "$output " style = "bold green"两个参数是关键：--no-sync让提示符渲染永不被同步阻塞；数据库的新鲜度交给常驻的agentsview serve或周期性的agentsview sync任务。
预算超支告警示例
budget_usd=25 spent=$(agentsview usage statusline --json --offline --no-sync \ | jq -e '.cost.microdollars') || exit 1 if [ "$spent" -gt $((budget_usd * 1000000)) ]; then printf 'AgentsView: $%d.%02d today (over $%d)\n' \ $((spent / 1000000)) $((spent % 1000000 / 10000)) "$budget_usd" >&2 exit 1 fi整型比较 + 非零退出码，可以无缝接入 cron、launchd、systemd timer 等任何通知渠道。
扩展命令：agentsview usage cursor（团队版账单导入）
团队使用 Cursor 时，可以按账号把 Admin API 的计费事件拉回本地归档：
agentsview usage cursor # 最近 30 天 agentsview usage cursor --since 2026-05-01 --until 2026-05-31 agentsview usage cursor --all --email you@example.comAPI Key 通过~/.agentsview/config.toml的cursor_admin_api_key或环境变量AGENTSVIEW_CURSOR_ADMIN_API_KEY提供。导入的行会以agent = cursor进入 Usage 面板和usage daily报表，费用直接采用 Cursor 返回的chargedCents，即使模型不在价格目录中也能出数；按事件指纹去重，重复导入同一窗口是安全的。
数据从何而来：性能与隐私说明 📊
- 数据来源：消息级 Token 存放在 SQLite 的
messages表，价格缓存在小而快的model_pricing表。价格目录在线刷新失败时会沿用最近一次快照，--offline则直接使用随版本内置的兜底价。 - 按需同步：没有
agentsview serve常驻时，usage查询前会做一次仅覆盖上次同步以来变更文件的增量同步（含 10 秒安全余量）；若检测到数据版本变化（如刚升级）会先全量重建索引。 - 速度参考：官方基准中，22,000 个会话、31 万条含 Token 消息的数据库上，
agentsview usage daily --json --all --offline约 0.53 秒完成。 - 隐私：会话数据全部留在本机，唯一的出站请求是价格目录拉取，可用
--offline完全关闭。
常见问题速答 📝
Q：为什么某些会话在日报里是 0 花费？A：AgentsView 只能统计代理自己写入本地日志的 Token 元数据；没有输出 Token 数的代理（或部分 Copilot 记录）不会产生成本行，命令会给出明确的 stderr 提示而非伪造空数据。
Q：daily 的表格和网页版 Usage 面板数字不一致？A：两者读取同一份数据库与价格表，数字应完全一致。若出现差异，通常是查询窗口或过滤条件不同（网页端默认同样是滚动 30 天）。
Q：想要某一行完整数据而不是一行摘要？A：statusline固定只覆盖当天；要完整的一日行，用agentsview usage daily --since $(date +%Y-%m-%d)即可。
掌握daily、--breakdown、statusline三件套，你就可以在终端里随时回答"昨天 AI 编程花了多少、花在哪个模型上"。更多细节（自定义模型价格、分段定价、Web 搜索附加费等）可参阅 docs/token-usage.md。
【免费下载链接】agentsviewLocal-first session search, analytics, insights, and token use statistics for coding agents, supporting Claude Code, Codex, and more than 20 other agents.项目地址: https://gitcode.com/GitHub_Trending/ag/agentsview
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考