用量审计、配额查询与成本管控
通过 magpie quota 极速核对额度，使用终端 TUI 查看真实 Token 消耗、缓存命中率与账单节省。
在密集使用 AI 编程助手的研发过程中，清晰透明的开销与配额追踪至关重要。无论是个人开发者关注“今天到底花了多少钱”，还是团队负责人需要排查“哪个任务消耗了海量 Token”，亦或是高频调用下监控“账号距离被限流还有多少额度”，都需要一个强有力的观测中心。
传统方式下，开发者必须在 OpenAI、Anthropic、DeepSeek、Moonshot 等多个厂商的后台反复登录切换，查看零散且格式不一的用量账单。
Magpie AI 将所有经过本地网关（127.0.0.1:3425）的请求进行了统一的全链路审计与配额归一化处理，提供 magpie quota 极速配额查询、终端 TUI 实时用量看板以及全量本地日志审计能力。
极速配额查询：magpie quota
通过 CLI 命令，你可以在终端中以秒级速度获取所有已配置供应商和挂载账号的实时配额状态：
# 查询所有供应商与账号的额度与速率限制
magpie quota
典型输出如下：
PROVIDER / ACCOUNT STATUS QUOTA REMAINING RATE LIMIT (RPM/TPM) WINDOW RESETS
claude-pro-personal ACTIVE 82% (41 msgs left) -- in 2h 14m
deepseek-commercial ACTIVE $48.20 / $50.00 60 RPM / 100k TPM --
kimi-api-key ACTIVE ¥126.50 120 RPM --
chatgpt-plus-team ACTIVE 100% (Ready) -- Ready
命令亮点：
- 多厂商聚合一览：商业 API 余额（美元/人民币）与网页订阅会话（如 Claude Pro 剩余消息数、限流重置倒计时）同屏并列；
- 低额度预警提示：当某个账号额度低于 15% 或距离频控触顶时，状态栏会自动标黄提醒；
- 极速响应：直接读取本地网关维护的配额缓存状态机，无需每次等待远程网页加载。
终端 TUI 实时用量与成本看板
在终端输入 magpie tui，按 Tab 切换至 「Usage」 面板，你将看到一个高度交互式的实时观测仪表盘：
┌─── Magpie AI Usage & Metrics ────────────────────────────────────────────────────────┐
│ TODAY'S TOKENS: 1,428,950 EST. COST: $0.38 (Saved ~$9.40 via DeepSeek & Cache) │
│ CACHE HIT RATIO: 76.4% SUCCESS RATE: 99.8% AVG LATENCY: 340ms │
├──────────────────────────────────────────────────────────────────────────────────────┤
│ Token Hourly Trend: │
│ 200k ┤ ╭─╮ │
│ 150k ┤ ╭──────────╯ │ ╭╮ │
│ 100k ┤ ╭─────────╯ ╰─╯│ │
│ 50k ┤ ╭───────╯ ╰──────── │
│ 0 ┴────┴───────┴─────────┴────────────┴──┴──────── │
│ 09:00 12:00 15:00 18:00 21:00 │
├──────────────────────────────────────────────────────────────────────────────────────┤
│ Top Active Agents & Models: │
│ - Claude Code -> deepseek/deepseek-v4-pro : 1,120,400 tokens (84 requests) │
│ - Codex -> kimi/kimi-k2.5 : 215,300 tokens (32 requests) │
│ - OpenCode -> openai/gpt-4o : 93,250 tokens (11 requests) │
└──────────────────────────────────────────────────────────────────────────────────────┘
关键观测指标：
- 真实消耗 Tokens（Total Tokens）： 输入 Token + 输出 Token + 提示词缓存创建 Token + 缓存读取 Token 的精确汇总。
- 提示词缓存命中率（Cache Hit Ratio）： 在长代码库分析中，Anthropic Prompt Caching 与 DeepSeek 深度上下文缓存能复用 70%~90% 的重复代码上下文。Magpie 独立计算出缓存读取 Token 的比例，直观展现降本成效。
- 等效节省金额（Est. Cost Saved）： 通过内置的官方模型比价数据库，Magpie 会自动计算出“如果使用官方原厂 Claude 3.5 Sonnet 需要花费多少”，与当前“实际花费”做对比，帮助开发者量化实际节省的真金白银。
本地网关日志全量审计
有时候开发终端报错，我们想知道“刚刚这笔请求到底被路由到了哪儿？为什么返回了 400？”。
Magpie AI 在本地记录了每一笔经过网关的 API 请求元数据：
# 查看最近 20 笔请求的简明流水
magpie logs
# 实时追踪流式日志输出（类似 tail -f）
magpie logs -f
# 展开查看某笔失败请求的完整 Payload 与上游报错详情
magpie logs show req_abc12345
日志审计包含的信息：
- Request Metadata：请求发起的本地 Agent（如 Claude Code）、时间戳、耗时毫秒数；
- Routing Path：实际路由到的供应商别名与具体模型 ID（如通过
group/opus-anywhere最终落入deepseek/deepseek-v4-pro）； - Token Breakdown：清晰切分
prompt_tokens、completion_tokens与cache_read_tokens； - HTTP Diagnostics：完整的上游响应 HTTP Code（如 200、429、502）以及具体的错误信息体。
隐私与数据安全原则
- 所有日志仅存留本地：Magpie 的审计日志与用量统计数据库存储于本地机器（
~/.magpie/data/），绝不会上报或上传到任何第三方云服务。 - 脱敏日志保障：如果开启了 提示词隐私脱敏，审计日志中的明文敏感 Key、密码与内网 IP 会同步以占位符形式记录，确保本地日志本身同样符合安全合规要求。
- 日志生命周期可控：你可以在配置中随时设置日志保留天数（默认保留 14 天）或随时一键清理：
magpie logs clear。
常见问题
Q：magpie quota 查询到的网页订阅（如 Claude Pro）剩余额度准确吗？
A：非常准确。对于挂载的网页订阅账号，Magpie 会直接同步官方会话中的剩余消息数与窗口重置倒计时，并结合本地发包情况进行内存级实时校验，帮助开发者在限流前及时分流。
Q：提示词缓存（Prompt Caching）能带来多大的实际降本？
A：在全仓库多步分析中，通常能带来 70%~90% 的上下文成本下降。由于大型工程上下文基本固定，Anthropic 与 DeepSeek 对命中缓存的输入 Token 仅收取常规单价的 10%，Magpie 通过独立计算缓存命中率，能直观展现真实节省的美元金额。
Q：长期运行产生的本地审计日志会占满磁盘吗？
A：不会。Magpie 采用了紧凑的本地嵌入式存储，且内置了 14 天滚动清理策略，过期数据会自动淘汰。如果你需要立即释放空间，随时执行 magpie logs clear 即可一键抹除所有历史日志。