Документация

Аналитика и панели управления

Как отслеживать экономию tokens, интерпретировать панели, запускать бенчмарки и делиться отчётами.

lean-ctx отслеживает каждый сэкономленный token во всех сессиях. Это руководство объясняет, как получить доступ к данным экономии, интерпретировать их и делиться ими через терминальные панели, веб-интерфейс, отчёты Wrapped и бенчмарки.

Все данные хранятся локально в ~/.lean-ctx/stats.json и сохраняются между сессиями и перезапусками.

Терминальная панель - lean-ctx gain

Основной способ проверить экономию. Выполните lean-ctx gain в любом терминале, чтобы увидеть визуальную панель с цветами, столбцами, спарклайнами и оценками в USD.

$ 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Общее количество tokens, удалённых из контекста LLM за все сессии.
compressionСредний процент удалённых tokens. Чем выше - тем эффективнее.
commandsОбщее количество команд shell, сжатых shell hook.
USD savedОценка экономии в стоимости на основе средней цены tokens ($2,50/1M входных tokens).
Top CommandsКакие CLI-инструменты сэкономили больше всего tokens, ранжированные по общей экономии.
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

Таблица по дням с колонками: сэкономленные tokens, коэффициент сжатия, количество команд и USD.

$ 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  │
  └────────────┴──────────┴───────┴──────┴────────┘

Веб-панель - lean-ctx dashboard

Интерактивная панель в браузере на http://localhost:3333.

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

Панели управления

ПанельСодержимое
Обзор статистикиОбщее количество сэкономленных tokens, коэффициент сжатия, USD, количество команд - те же данные, что и в gain
Активность MCPПоследние вызовы MCP-инструментов, наиболее используемые инструменты, время ответа
Активные агентыAI-агенты, зарегистрированные через ctx_agent. Показывает имя, роль, статус и heartbeat агента.
Знания проектаФакты, сохранённые через ctx_knowledge, сгруппированные по категориям с оценками уверенности.

Конечные точки API

Панель предоставляет JSON API, к которому можно обращаться напрямую:

Конечная точкаДанные
GET /api/statsСтатистика экономии tokens (то же, что gain --json)
GET /api/mcpДанные использования MCP-инструментов
GET /api/agentsРеестр активных агентов
GET /api/knowledgeХранилище знаний проекта

Отчёты Wrapped - lean-ctx wrapped

«Spotify Wrapped» для вашей экономии tokens. Генерирует отчёт-визитку для публикации.

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

Отчёт 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%  ███

Бенчмаркинг

Измерьте точную экономию tokens на реальных файлах проекта с помощью tiktoken.

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 включает:

  • Общее количество сэкономленных tokens и коэффициент сжатия
  • Разбивка по командам (имя команды, количество, сэкономленные tokens)
  • Ежедневная история (дата, экономия, коэффициент, команды)
  • Оценки в USD

Пример: извлечение общей экономии в CI-скрипте:

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

Расчёт в USD

lean-ctx оценивает экономию в USD на основе средней стоимости входных tokens LLM. Ставка по умолчанию - $2,50 за 1M входных tokens.

Формула:

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

Это консервативная оценка - реальная экономия может быть выше при использовании более дорогих моделей или ниже при использовании более дешёвых.