ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

AgentsView usage命令全参考:daily、breakdown、statusline逐个精讲

AgentsView usage命令全参考:daily、breakdown、statusline逐个精讲 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/agentsviewAgentsView 是一款本地优先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 dailyagentsview 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输入 / 输出 / 缓存写入 / 缓存读取、当日估算费用以及当天参与计费的模型列表按花费从高到低排序。常用参数速查表参数默认值说明--since30 天前窗口起点支持28d时长或YYYY-MM-DD日期含当天--until今天窗口终点语法同上--all关闭扫描全部历史覆盖默认 30 天窗口--agent全部按代理名过滤如claude、codex--breakdown关闭每天下方缩进显示逐模型明细行--format/--jsonhuman输出 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 statuslineagentsview 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_usd25 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 youexample.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 花费AAgentsView 只能统计代理自己写入本地日志的 Token 元数据没有输出 Token 数的代理或部分 Copilot 记录不会产生成本行命令会给出明确的 stderr 提示而非伪造空数据。Qdaily 的表格和网页版 Usage 面板数字不一致A两者读取同一份数据库与价格表数字应完全一致。若出现差异通常是查询窗口或过滤条件不同网页端默认同样是滚动 30 天。Q想要某一行完整数据而不是一行摘要Astatusline固定只覆盖当天要完整的一日行用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),仅供参考
返回列表