文档

分析与仪表板

如何监控 token 节省量、解读仪表板、运行基准测试和分享报告。

lean-ctx 跟踪所有会话中节省的每一个 token。本指南介绍如何通过终端仪表板、Web UI、年度报告和基准测试来访问、解读和分享您的节省数据。

所有数据本地存储在 ~/.lean-ctx/stats.json，跨会话和重启持久保存。

终端仪表板 - lean-ctx gain

查看节省量的主要方式。在任意终端运行 lean-ctx gain，即可看到带颜色、柱状图、迷你折线图和美元估算的可视化仪表板。

$ lean-ctx gain

  ◆ lean-ctx  Token Savings Dashboard
  ────────────────────────────────────────────────────────

   7.8M          67.8%          3,994        $43.14
   tokens saved  compression    commands     USD saved

  Top Commands
  ──────────────
  curl     328x  ████████████████████  3.2M saved
  git      412x  ██████████████        1.8M saved
  cargo    156x  ██████████            1.1M saved
  npm       89x  ████                  420K saved

  30-day sparkline: ▁▃▅▇██▇▅█▇▃▁▅▇██▇▅█▇▃▁▅▇██▇▅█▇▃▁▅▇██▇▅█▇▃▁

数据含义说明

指标含义
tokens saved所有会话中从 LLM 上下文中去除的 token 总数。
compressiontoken 平均去除百分比。越高越高效。
commandsshell 钩子压缩的命令总数。
USD saved基于平均 token 价格（$2.50/百万输入 token）的估算成本节省。
Top Commands按总节省量排名，显示哪些 CLI 工具节省了最多 token。
30-day sparkline30 天每日节省活动的可视化趋势。

实时模式 - lean-ctx gain --live

每 2 秒自动刷新的仪表板。

$ lean-ctx gain --live

  ◆ lean-ctx  LIVE  refreshing every 2s
  ────────────────────────────────────────────────────────

   7.8M          67.8%          3,994        $43.14
   tokens saved  compression    commands     USD saved

  Session: 42 cmds | 89.2K saved | 94.1% rate ▁▃█▇██▁█

  Press q to quit

使用时机：在编码会话期间在侧边终端运行，实时监控节省情况。

图表与表格

lean-ctx gain --graph

30 天节省图表，包含每日柱状图。

$ lean-ctx gain --graph

  Token Savings (30 days)
  ──────────────────────────────

  03-20 │ ██████████████████████ 1.0M
  03-21 │ ███████████████       690K
  03-22 │ ████████████████████████ 1.1M
  03-23 │ █                       9.4K
  03-24 │ ██████████████████████ 1.7M

lean-ctx gain --daily

带边框的逐日表格，包含 token 节省量、压缩率、命令数和美元数据列。

$ lean-ctx gain --daily

  ┌────────────┬──────────┬───────┬──────┬────────┐
  │ Date       │ Saved    │ Rate  │ Cmds │ USD    │
  ├────────────┼──────────┼───────┼──────┼────────┤
  │ 2026-03-28 │ 1.7M     │ 72.4% │ 412  │ $4.25  │
  │ 2026-03-27 │ 1.1M     │ 68.9% │ 289  │ $2.75  │
  │ 2026-03-26 │ 690K     │ 71.2% │ 187  │ $1.73  │
  └────────────┴──────────┴───────┴──────┴────────┘

Web 仪表板 - lean-ctx dashboard

在 http://localhost:3333 的交互式浏览器仪表板。

lean-ctx dashboard              # default port 3333
lean-ctx dashboard --port=8080  # custom port

仪表板面板

面板内容
统计概览总 token 节省量、压缩率、美元、命令数--与 gain 数据相同
MCP 活动最近的 MCP 工具调用、使用最多的工具、响应时间
活跃代理当前通过 ctx_agent 注册的 AI 代理。显示代理名称、角色、状态和心跳。
项目知识通过 ctx_knowledge 存储的事实，按类别分组并附带置信度分数。

API 端点

仪表板提供 JSON API，您可以直接查询：

端点数据
GET /api/statsToken 节省统计（与 gain --json 相同）
GET /api/mcpMCP 工具使用数据
GET /api/agents活跃代理注册表
GET /api/knowledge项目知识库

年度报告 - lean-ctx wrapped

您 token 节省量的 "Spotify Wrapped"。生成可分享的报告卡片。

lean-ctx wrapped           # current week
lean-ctx wrapped --week    # current week (explicit)
lean-ctx wrapped --month   # current month
lean-ctx wrapped --all     # lifetime stats

输出示例

$ lean-ctx wrapped --month

  ◆ Your March 2026 Wrapped
  ────────────────────────────────

  4.9M tokens saved
  3,241 commands compressed
  $12.16 USD saved

  Top pattern: curl (97% compression)
  You're in the top 5% of lean-ctx users

  Best day: March 24 - 1.7M tokens saved
  Most used mode: map (42% of reads)

CEP 报告 - lean-ctx cep

Cognitive Efficiency Protocol 报告展示 lean-ctx 如何优化 LLM 推理。

$ lean-ctx cep

  CEP Impact Report
  ────────────────────────────────

  Score trend:  ▁▃▅▇██▇█  (improving)
  Cache hits:   94.2% (re-reads served from cache)
  Mode distribution:
    full:        42%  ████████████████
    map:         31%  ████████████
    signatures:  18%  ███████
    diff:         9%  ███

基准测试

使用 tiktoken 测量真实项目文件的精确 token 节省量。

lean-ctx benchmark run [path] [--json]

$ lean-ctx benchmark run src/

  Benchmarking 42 files...

  src/auth.ts (123 lines)
    full:       3,517 tokens
    map:          412 tokens (88% saved)
    signatures:   252 tokens (93% saved)
    entropy:      312 tokens (91% saved)

  src/server.ts (456 lines)
    full:       8,234 tokens
    map:          891 tokens (89% saved)
    signatures:   534 tokens (94% saved)

  ── Summary ──────────────────────
  42 files | 89,412 total tokens
  Average savings: map 87% | signatures 92% | entropy 85%

lean-ctx benchmark report [path]

生成 Markdown 报告，可分享或提交到您的代码仓库。

lean-ctx benchmark report src/ > BENCHMARK.md

报告包含逐文件分解、模式对比和汇总统计。

JSON 导出 - lean-ctx gain --json

将所有统计数据导出为 JSON，用于脚本、CI/CD 集成或自定义仪表板。

lean-ctx gain --json > stats.json

JSON 包含：

  • 总 token 节省量和压缩率
  • 逐命令分解（命令名、次数、token 节省量）
  • 每日历史（日期、节省量、压缩率、命令数）
  • 美元估算

示例：在 CI 脚本中提取总节省量：

SAVED=$(lean-ctx gain --json | jq '.total_saved')
echo "lean-ctx saved $SAVED tokens this session"

美元计算

lean-ctx 基于平均 LLM 输入 token 价格估算美元节省量。默认费率为每百万输入 token $2.50。

计算公式：

USD saved = (tokens saved / 1,000,000) × $2.50

这是保守估算--如果您使用更贵的模型，实际节省可能更高；使用更便宜的模型则可能更低。