# cache-stats

Плагин cache-stats для GitHub Copilot показывает в сессии повторное использование промпт-кэша, его истечение, состав токенов и стоимость в AI Credits. Обновляется локально каждые две секунды.

- плагин · `type=plugin` · GitHub Copilot
- Автор: Arafat Tehsin
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/arafattehsin/cache-stats-extension
- Обновлён: 2026-10-11
- Проверка безопасности: автоматическая, 2026-11-16 (текст и 4 файла скриптов) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/plugins/cache-stats

## Что делает

Плагин рисует canvas с тремя экранами: Live Cache (состояние кэша, повторное использование, цена перестройки префикса), Composition (разложение токенов на свежий ввод, чтение и запись кэша, вывод и reasoning) и Turn History (холодные старты и стоимость перестройки по ходам). Данные берутся из локального хранилища сессий `~/.copilot/session-store.db`, открытого только на чтение.

Расход считается в AI Credits по тарифам из `token_details_json` каждой записи, то есть привязан к модели, которая реально обслуживала вызов, а не к зашитым ценам. Ход помечается `REBUILT`, если входной вызов не прочитал кэшированный префикс, но записал заметный новый.

Нужен Copilot-клиент с поддержкой canvas-расширений, Node.js с модулем `node:sqlite` и локальное хранилище сессий с таблицей `assistant_usage_events`. Модель не вызывается и телеметрия не отправляется: холст отдаётся с временного порта `127.0.0.1`. Без этих трёх условий статистика просто не появится.

## Установка

### GitHub Copilot (родная платформа)

**Команда из источника**
```bash
copilot plugin install cache-stats@awesome-copilot
```

## Когда брать
- увидеть, сколько промпта переиспользуется из кэша в текущей сессии
- посчитать стоимость сессии в AI Credits без вызовов модели
- разложить токены по категориям: ввод, чтение и запись кэша, вывод, reasoning
- найти ходы, где кэш перестраивался заново
- отследить истечение срока кэш-записи по событию `session.usage_checkpoint`

## Примеры запросов агенту
- Открой канву статистики кэша
- Покажи историю ходов и где был REBUILT
- Сколько сейчас стоит эта сессия в AI Credits и что будет, если кэш протухнет

## Похожие
- [cache-tax](https://affpapa.org/nevibecode/plugins/cache-tax.md) — плагин · ★ 586 у репозитория
- [cleanup-cache](https://affpapa.org/nevibecode/commands/cleanup-cache.md) — команда · 416 установок
- [compare-cache-runs](https://affpapa.org/nevibecode/skills/compare-cache-runs.md) — скилл · 291 установка
- [magento-cache-analyst](https://affpapa.org/nevibecode/skills/magento-cache-analyst.md) — скилл · 160 установок
- [nx-cloud-cache-investigator](https://affpapa.org/nevibecode/skills/nx-cloud-cache-investigator.md) — скилл · 127 установок

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
