Известные
Ограничения
Мы верим в честную документацию. Вот в чём lean-ctx силён - и где проходят его границы.
Пределы Сжатия
Экономия токенов варьируется в зависимости от типа файла, сложности содержимого и режима чтения. Вот чего ожидать на практике.
Ожидаемая экономия по сценариям
| Сценарий | Экономия |
|---|---|
| Первое чтение (файлы кода) | 60–95% |
| Повторное чтение из кэша | До 99% |
| Маленькие файлы (<10 строк) | Минимально |
| Бинарные файлы | Пропущены |
| Незнакомый вывод Shell | Без сжатия |
Экономия зависит от содержимого
Фактическая экономия зависит от плотности кода, доли комментариев и повторений. Хорошо структурированный код с чёткими сигнатурами сжимается лучше, чем плотные однострочники без комментариев.
Повторное чтение из кэша
Когда lean-ctx уже видел файл и он не изменился, повторное чтение стоит примерно 13 токенов независимо от размера файла. Это источник показателя 99%.
Языковая Поддержка
lean-ctx использует tree-sitter для AST-осведомлённого сжатия. Покрытие варьируется по языкам - вот полная картина.
Уровни языковой поддержки
| Уровень | Языки | Сжатие |
|---|---|---|
| Полный AST | Rust, TypeScript, Python, Go, Java, C, C++, C#, Ruby, PHP, Swift, Kotlin, Scala, Lua, Zig, Elixir, Haskell, OCaml | Обрезка с учётом сигнатур |
| Базовый | Все остальные языки | Построчное сжатие |
Базовый уровень всё ещё обеспечивает значимое сжатие - просто не может извлекать сигнатуры функций или обрезать узлы AST. Большинство файлов по-прежнему экономят 40–70% благодаря дедупликации и фильтрации энтропии.
Архитектурные Ограничения
lean-ctx спроектирован с определёнными архитектурными компромиссами. Их понимание помогает установить правильные ожидания.
Требование MCP
lean-ctx работает как MCP-сервер. Ваш ИИ-агент должен поддерживать Model Context Protocol.
Совместим с: Claude Code, Cursor, Codex, Gemini CLI и другими.
Область одного проекта
Каждый экземпляр lean-ctx ограничен одним корнем проекта. Мульти-репозиторные рабочие процессы требуют отдельных экземпляров.
Решение: запускайте один экземпляр на репозиторий в рабочем пространстве.
Масштабирование памяти
Кэш в оперативной памяти растёт вместе с проектом. Очень крупные монорепозитории (100 000+ файлов) могут выиграть от настройки лимитов кэша.
Настраивается через параметры lean-ctx.
Не Замена
lean-ctx оптимизирует способ доставки контекста LLM. Он не заменяет основы хорошей инженерии.
- Хорошие практики промптинга - чёткие, конкретные инструкции по-прежнему важны
- Правильную организацию кода - хорошо структурированный код сжимается лучше
- Контроль версий - lean-ctx не управляет изменениями кода и историей
lean-ctx оптимизирует доставку, а не заменяет основы.
Узнайте, что lean-ctx может
Теперь, когда вы знаете границы, изучите, что lean-ctx предлагает в их рамках - гарантии безопасности, бенчмарки производительности и сравнения.