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

Контекстные профили

Декларативные, версионируемые контекстные стратегии для lean-ctx

Контекстные профили позволяют настроить, как lean-ctx обрабатывает контент для различных сценариев: исследование, отладка, хотфиксы, CI, ревью кода и многое другое. Думайте об этом как о "Context as Code" - версионируемые стратегии, которыми ваша команда может делиться.

Что такое профили?

Профиль - это TOML-файл, который управляет режимами чтения, настройками сжатия, бюджетами токенов, слоями конвейера и автономным поведением. Профили могут наследовать от других профилей и переопределять конкретные поля.

Встроенные профили

lean-ctx включает 5 встроенных профилей, оптимизированных для типичных рабочих процессов:

exploration

Широкий контекст для понимания кодовых баз. Режим карты, бюджет 200K токенов, предпочтение кэша.

bugfix

Фокусированная отладка в авто-режиме. Краткий вывод, бюджет 100K токенов, контрольные точки каждые 10 вызовов.

hotfix

Минимальный контекст для срочных исправлений. Режим сигнатур, ультра-компактный вывод, 30K токенов, лимит стоимости $1.

ci-debug

Отладка CI/CD с 200 вызовами shell. Краткий вывод, бюджет 150K токенов.

review

Ревью кода с широким контекстом только для чтения. Режим карты, компактный CRP, бюджет 150K токенов.

Активация профиля

Установите переменную окружения LEAN_CTX_PROFILE:

export LEAN_CTX_PROFILE=hotfix

Или через CLI:

lean-ctx profile set hotfix

Или переключитесь во время выполнения через MCP:

ctx_session action=profile value=hotfix

Создание пользовательских профилей

Создайте TOML-файл профиля в .lean-ctx/profiles/ (локально для проекта) или ~/.lean-ctx/profiles/ (глобально):

# .lean-ctx/profiles/my-team.toml
[profile]
name = "my-team"
inherits = "exploration"
description = "Team defaults with lower budget"

[read]
default_mode = "map"
max_tokens_per_file = 40000

[budget]
max_context_tokens = 120000
max_cost_usd = 2.0

Или создайте профиль через CLI:

lean-ctx profile create my-team --from exploration

Наследование профилей

Профили могут наследовать от любого другого профиля, используя поле inherits. Дочерние значения переопределяют родительские; неустановленные поля наследуются от родителя.

# .lean-ctx/profiles/strict-review.toml
[profile]
name = "strict-review"
inherits = "review"

[budget]
max_context_tokens = 80000
max_cost_usd = 1.0

Схема профиля

Полный профиль содержит следующие секции:

  • [profile] - name, inherits, description
  • [read] - default_mode, max_tokens_per_file, prefer_cache
  • [compression] - crp_mode, output_density, entropy_threshold
  • [budget] - max_context_tokens, max_shell_invocations, max_cost_usd
  • [pipeline] - intent, relevance, compression, translation (логические переключатели)
  • [autonomy] - auto_dedup, checkpoint_interval

Справочник CLI

  • lean-ctx profile list - Показать все доступные профили
  • lean-ctx profile show <name> - Показать детали профиля
  • lean-ctx profile diff <a> <b> - Сравнить два профиля
  • lean-ctx profile create <name> - Создать новый профиль
  • lean-ctx profile set <name> - Показать инструкции по активации

Порядок разрешения

Профили разрешаются в следующем порядке:

  1. Переменная окружения LEAN_CTX_PROFILE
  2. Локальный для проекта .lean-ctx/profiles/<name>.toml
  3. Глобальный ~/.lean-ctx/profiles/<name>.toml
  4. Встроенные значения по умолчанию