Эта страница — канонический справочник по полям для конечного пользователя: он охватывает каждое поле ввода и элемент управления Entry Web UI.
Как читать этот справочник
Для каждого поля указано:
- Config key — ключ, который используется в файлах конфигурации и в CLI
- Control — тип элемента ввода
- Default — безопасное значение по умолчанию
- Risk —
normal, caution или risky
- Notes — что делает поле и когда его стоит менять
Core
| Config key | Control | Default | Risk | Notes |
|---|
enabled | toggle | true | risky | Главный переключатель. Отключение останавливает работу Engram. |
scope | select | both | risky | Цель сохранения: workspace, global, both. |
update | select | auto | normal | Тихая проверка обновления пакета: auto, manual, off. |
read | select | auto | normal | Когда хуки внедряют память: auto, startup, always, manual, off. |
proof | select | off | normal | Строка подтверждения хука: off, compact. |
global_path | text | пусто | risky | Путь в файловой системе для глобальной памяти. |
default_profile | select | пусто | risky | Профиль, который используется, когда ничего не задано явно. |
roles | roles | пусто | normal | Имена ролей для маршрутизации через запятую. |
Ignore Rules
| Config key | Control | Default | Risk | Notes |
|---|
ignore.source | select | engramignore | normal | Источники правил сканирования: engramignore, gitignore, both, off. |
ignore.gitignore_path | text | .gitignore | normal | Путь к файлу игнорирования Git. |
ignore.engramignore_path | text | .engramignore | normal | Путь к файлу игнорирования Engram. |
ignore.global_engramignore | toggle | true | normal | Применяет глобальные правила игнорирования, если они настроены. |
ignore.also_ignore | list | *.secret, private/** | normal | Дополнительные glob-шаблоны через запятую. |
ignore.global_patterns | textarea | пусто | normal | Один глобальный glob на строку; inject синхронизирует управляемый блок рабочего пространства. |
Load Routing
| Config key | Control | Default | Risk | Notes |
|---|
load.limit | number 1–32 | 8 | normal | Максимум воспоминаний, возвращаемых обычной загрузкой. |
load.working_ttl_days | number 1–365 | 14 | normal | Сколько дней воспоминание с целью-задачей остаётся в рабочем уровне. |
Memory Limits
| Config key | Control | Default | Risk | Notes |
|---|
memory.rule_line_target | number 50–200, step 10 | 70 | normal | Рекомендуемое число строк для правил. |
memory.rule_line_hard_limit | number 50–200, step 10 | 100 | risky | Жёсткий максимум строк для правил. |
memory.include_author_email | toggle | false | risky | Записывать author_email во frontmatter новых воспоминаний (author_name записывается всегда). |
Hooks
| Config key | Control | Default | Risk | Notes |
|---|
hooks.path_rules | select | native | normal | native: Claude и Cursor загружают воспоминания с applies_to из сгенерированных файлов правил, а Claude регистрирует InstructionsLoaded. hook: сохранить хук Claude PreToolUse и удалить файлы правил Claude. |
Graph
| Config key | Control | Default | Risk | Notes |
|---|
graph.enabled | toggle | true | normal | Включает маршрутизацию по зависимостям/связям. |
graph.max_related | number 1–20 | 4 | normal | Ограничивает связанные воспоминания из рёбер графа. |
graph.min_related_score | number 0–1, step 0.01 | 0.22 | normal | Минимальная оценка сходства для связанных рёбер. |
Vector Search
| Config key | Control | Default | Risk | Notes |
|---|
vector.enabled | toggle | false | normal | Экспериментально: включает необязательную локальную маршрутизацию на хешированных векторах (не семантические эмбеддинги). По умолчанию выключено. |
vector.provider | select | sqlite-vec | normal | Единственный поддерживаемый локальный векторный провайдер. |
vector.auto_threshold | number 10–1000 | 100 | normal | Количество воспоминаний, при котором активируется векторный поиск. |
vector.candidate_pool | number 8–100 | 24 | normal | Кандидаты, рассматриваемые перед переранжированием. |
vector.dimensions | number 16–512 | 64 | normal | Размерность эмбеддингов; после изменения нужна пересборка. |
Rule Variants
| Config key | Control | Default | Risk | Notes |
|---|
rule_variants.enabled | toggle | false | normal | Рендерит формулировки light и strict, выведенные из Content каждого правила (при off рендерится balanced). |
rule_variants.active | select | balanced | normal | Активный вариант: light, balanced, strict. |
Live Sync
| Config key | Control | Default | Risk | Notes |
|---|
live_sync.enabled | toggle | false | normal | Синхронизировать сгенерированные файлы контекста агента при сохранении. |
live_sync.targets | list | agents-md, claude-md, cursor-rules | normal | Цели сгенерированного контекста, которые обновляет live sync. |
Global Git
| Config key | Control | Default | Risk | Notes |
|---|
global_git.enabled | toggle | true | risky | Включает поведение Git для глобальной памяти. |
global_git.remote | text | origin | risky | Имя удалённого репозитория Git; без пробелов. |
global_git.remote_url | text | пусто | risky | URL общего удалённого репозитория глобальной памяти. |
global_git.branch | text | main | risky | Целевая ветка для синхронизации. |
global_git.auto_sync | toggle | true | risky | Автоматический pull/push. |
global_git.auto_resolve | toggle | true | risky | Автоматическое разрешение конфликтов; проверяйте диффы. |
Pattern Mining
| Config key | Control | Default | Risk | Notes |
|---|
pattern_mining.enabled | toggle | false | normal | Экспериментальное извлечение повторяющихся шаблонов. |
pattern_mining.threshold | number 1–20 | 3 | normal | Сколько повторений нужно, чтобы шаблон стал значимым. |
pattern_mining.lookback_sessions | number 1–100 | 20 | normal | Сколько недавних сессий проверять. |
PR Workflow
| Config key | Control | Default | Risk | Notes |
|---|
pr_workflow.enabled | toggle | false | risky | Экспериментальный командный PR-процесс. |
pr_workflow.provider | text | пусто | risky | Идентификатор провайдера для настроенного командного процесса. |
pr_workflow.repo | text | пусто | risky | Идентификатор репозитория для настроенного командного процесса. |
pr_workflow.target_branch | text | main | risky | Ветка, принимающая PR с памятью. |
Encryption
| Config key | Control | Default | Risk | Notes |
|---|
encryption.enabled | toggle | false | risky | Будущий/продвинутый режим шифрования. |
encryption.scope | select | global | risky | Область: workspace, global. |
encryption.key_source | select | portable-file | risky | Стратегия источника ключа; риск потери резервной копии. |
Память, подкреплённая доказательствами
| Поле | Значение |
|---|
schema_version | 3 для новых или обновлённых воспоминаний; устаревшие v1/v2 остаются читаемыми. |
authority | instruction для правил/навыков, reference для знаний. Записи следов используют authority: evidence. |
evidence_refs | Неизменяемые идентификаторы следов tr_..., подтверждающие воспоминание. |
derived_from | Идентификаторы сессий или источников, из которых было извлечено воспоминание. |
revision | Положительное целое число, которое увеличивается при обновлении существующего воспоминания. |
supersedes / superseded_by | Явные отношения замещения. |
valid_from / valid_until | Диапазон времени, в котором воспоминание действительно; valid_until может быть открытым. |
last_confirmed | Дата, когда воспоминание было подтверждено в последний раз. |
Элементы управления без ключей конфигурации
Элементы управления, не связанные с ключами конфигурации, см. на страницах отдельных вкладок:
Управление профилями и рабочими пространствами доступно на вкладке Construct и через engram profile и engram workspace. См. Профили и разрешение области.
Дальнейшие шаги
Личность автора Git
Engram может хранить глобального автора и необязательное переопределение для рабочего пространства. Порядок разрешения: рабочее пространство, глобальный, затем резервный Git только для чтения. Настройки влияют только на будущие воспоминания; переопределение рабочего пространства никогда не меняет глобальную конфигурацию Git. Для синхронизации с глобальным Git или миграции устаревших воспоминаний используйте явный план и подтверждение.
engram author show
engram author set --name "Jane Doe" --email "jane@example.com"
engram author unset --scope workspace
engram author sync-git-global --plan
engram author sync-git-global --confirm
engram author migrate-memories --plan
engram author migrate-memories --confirm
Прочитайте полное руководство по настройкам автора Git.
Инвентаризация обновлений конфигурации
После обновления пакета выполните engram upgrade --latest --plan перед engram upgrade --latest. Общий инвентарь сканирует воспоминания, инструкции, skillset, конфигурации, хуки и плагины рабочего пространства и глобальной области, управляемые Engram. Байты, написанные пользователем, сохраняются; неоднозначные смешанные файлы сообщаются как конфликты. См. Обновления конфигурации.