Перейти к основному содержимому

load / search / graph

Команды чтения загружают маршрутизированные воспоминания, выполняют поиск в хранилище и проверяют маршрутизацию графа.

load​

engram load "<task>"
engram load --full "<task>"
engram load --dry-run "<task>"
engram load --all "<task>"
engram load --budget-tokens 800 "<task>"
engram load --disclosure full "<task>"
engram load --id <id>,<id>
engram load --exclude-keys workspace:rules/use-pnpm.md "<task>"

load сначала привязывает маршрутизацию к значимым поисковым терминам, игнорируя общие слова памяти, такие как rule, knowledge, и распространенные стоп-слова. Затем он уточняет широкий пул кандидатов в компактный пакет контекста. Обычная загрузка сообщает о выбранном и общем количестве связанных воспоминаний, например loaded 8 memory files / 14 total related memories.

  • load по умолчанию — многоуровневый маршрут для агента: топовые совпадения согласно load.expand_top (по умолчанию 3) раскрываются в виде тел (bodies), все остальные выбранные совпадения выводятся в виде однострочных карточек (cards) с завершающей подсказкой fetch: engram load --id <ids>; каждый заголовок тела несет authority воспоминания, фронтметтер, такой как evidence_refs, ## Context, ## Example и ## Origin, не отображается (используйте --full для их просмотра), а правила показывают один выбранный вариант.
  • --id <id,...> — выборка полных тел для карточек; идентификаторы разделяются запятыми, и явная выборка учитывается в stats --usage.
  • --budget-tokens <200-16000> — жесткий лимит на весь многоуровневый вывод; тела сначала превращаются в карточки, и только затем исключаются карточки с наименьшим рангом.
  • --disclosure auto|full — full печатает каждое упакованное тело вместо многоуровневого пакета (также настраивается как load.disclosure: full в конфиге).
  • --exclude-keys <scope:file,...> — пропуск воспоминаний, которые у вызывающей стороны уже есть; тела и карточки не выводятся, а --json указывает их в already_loaded.
  • --full — более широкий устаревший вывод с полным фронтметтером и всеми вариантами правил.
  • --dry-run — показ количества кандидатов, сужающих тегов и причин совпадения без вывода содержимого.
  • --all — возврат всех видимых совпадений маршрута вместо компактного ограничения.

workflow и workflows по-прежнему маршрутизируются к воспоминаниям навыков (skills), но общие слова типов сами по себе не создают широкого совпадения.

В режиме раскрытия auto списки JSON selected и entries описывают только развернутые тела; карточки выводятся отдельно. Настройте load.expand_top и load.disclosure в блоке load файла engram.config.json (см. профили / workspaces / конфигурация).

engram search "<topic>"
engram search --semantic "<topic>"

Поиск по умолчанию — детерминированный лексический поиск. search --semantic добавляет детерминированное локальное сходство, а не семантический поиск на основе эмбеддингов. Результаты search --json содержат поле score.

graph​

engram graph "<topic>"
engram graph --rebuild

Проверка маршрутизации графа. Запустите engram graph --rebuild после ручных правок. Граф сообщает об уровнях зависимостей, а engram load подтягивает маршрутизированные предварительные условия в тот же компактный пакет перед более глубокими воспоминаниями.

Связанные ребра графа и векторные совпадения не загружают несвязанные воспоминания автоматически; они лишь помогают переранжировать или расширить воспоминания, уже совпавшие со значимыми терминами запроса. Явные предварительные условия depends_on по-прежнему могут загружаться без совпадения собственных терминов.

Уровни зависимостей​

depends_on: [release-foundation]
level: advanced

Используйте фронтметтер depends_on, когда воспоминание должно основываться на другом, а не повторять его.

Следующие шаги​