iia-arg/dsh-plugins--packages-dsh-pamyat-kompakt ↗★ 2

dsh-pamyat-kompakt

Компакт контекста агента: сводка своей моделью, атомарная перезапись журнала сессии (Claude SDK и Codex), возврат сводки в контекст · Agent context compaction: summary by its own model, atomic session-log rewrite (Claude SDK and Codex), summary returned to context

パッケージ
dsh-pamyat-kompakt
互換性
未検証
バージョン
3.1.2
ライセンス
MIT
最終更新
2026/10/22

インストール

検証済み bundle がないか、互換性チェックに失敗しています。先にリポジトリの説明を読んでください。 README 全文を読む ↗

ドキュメント

README 全文を読む ↗

Настройка · Configuration

Своего config в профиле у пакета нет. Код читает четыре источника: переменные окружения, файл D агента, необязательный JSON размещения и текстовые шаблоны рядом с кодом. Старшинство для полей, у которых есть и переменная, и поле D: окружение (непустое) > файл D > умолчание модуля. Источник каждого значения печатается при импорте и экспортируется объектом ISTOCHNIKI.

The package has no profile config. The code reads four sources: environment variables, the agent D file, an optional deployment JSON and text templates next to the code. For fields that have both a variable and a D field the precedence is environment (non-empty) > D file > module default. The source of every value is printed at import and exported as the ISTOCHNIKI object.

Файл D: /.json · D file: /.json

Каталог: KOMPAKT_NASTROJKI_KATALOG, иначе /etc/dsh-pamyat/agenty. Имя агента допускает только A-Z a-z 0-9 _ -. Если KOMPAKT_AGENT задан, а файла нет или JSON не разбирается, импорт модуля падает. Без KOMPAKT_AGENT модуль работает на умолчаниях, без порога. Файлы D собирает внешний сборщик настроек; модуль их только читает.

Directory: KOMPAKT_NASTROJKI_KATALOG, otherwise /etc/dsh-pamyat/agenty. The agent name allows only A-Z a-z 0-9 _ -. If KOMPAKT_AGENT is set and the file is missing or its JSON does not parse, the module import fails. Without KOMPAKT_AGENT the module runs on defaults, without a threshold. D files are produced by an external settings builder; the module only reads them.

ПолеПеребив окружениемУмолчаниеСмысл
porogiнет (см. ниже)нетГотовый порог: {schema:1, defaultRoute:{provider,model}, routes:[{provider,model,window,ratio,nominalThreshold}]}. Проверяется строго (porogi.mjs); ошибка даёт {prichina}, а не число
modelKOMPAKT_MODELdeepseek-flashМодель сводки
adresKOMPAKT_ADREShttps://api.deepseek.com/v1/chat/completionsАдрес API сводки
imenaKlyuchaнетKOMPAKT_API_KEY, DEEPSEEK_API_KEY, GATEWAY_API_KEYИмена переменных окружения, где искать ключ (берётся первое непустое). Сам ключ в файлах не хранится
hvostStrokKOMPAKT_HVOST30Сколько последних строк журнала остаются дословно; целое ≥ 1, иное — отказ сжатия без перезаписи
oknoSvodki (устар. oknoModeli)KOMPAKT_OKNO_MODELI1 000 000Окно модели сводки, токены; к порогу компакта не относится
razmyshleniyaKOMPAKT_RAZMYSHLENIYAfalseПри false в запрос идёт thinking: {type: "disabled"}
kompaktShlyuzovojKOMPAKT_SHLYUZOVOJне объявленВыключатель шлюзового компакта. Выключает только false; не объявлен — сжимать
minProzaZnakovKOMPAKT_MIN_PROZA0 (выкл.)Если прозы меньше, модель не зовётся, отдаётся проза
cenyнетнет{vhod, vyhod, istochnik, data}, $ за миллион токенов; без него расход печатается только в токенах
imyaнетнетИмя агента для промта (одно слово с заглавной, до 31 буквы); иначе «от лица агента»
FieldEnv overrideDefaultMeaning
poroginone (see below)noneReady threshold: {schema:1, defaultRoute:{provider,model}, routes:[{provider,model,window,ratio,nominalThreshold}]}. Strictly validated (porogi.mjs); a fault yields {prichina}, not a number
modelKOMPAKT_MODELdeepseek-flashSummary model
adresKOMPAKT_ADREShttps://api.deepseek.com/v1/chat/completionsSummary API endpoint
imenaKlyuchanoneKOMPAKT_API_KEY, DEEPSEEK_API_KEY, GATEWAY_API_KEYNames of environment variables to search for the key (the first non-empty wins). The key itself is never stored in files
hvostStrokKOMPAKT_HVOST30Last log lines kept verbatim; an integer ≥ 1, anything else refuses compaction without rewriting
oknoSvodki (obsolete oknoModeli)KOMPAKT_OKNO_MODELI1,000,000Summary model window, tokens; unrelated to the compaction threshold
razmyshleniyaKOMPAKT_RAZMYSHLENIYAfalseWhen false, the request carries thinking: {type: "disabled"}
kompaktShlyuzovojKOMPAKT_SHLYUZOVOJundeclaredGateway compaction switch. Only false turns it off; undeclared means compress
minProzaZnakovKOMPAKT_MIN_PROZA0 (off)If the prose is shorter, the model is not called and the prose is returned
cenynonenone{vhod, vyhod, istochnik, data}, $ per million tokens; without it cost is printed in tokens only
imyanonenoneAgent name for the prompt (one capitalised word, up to 31 letters); otherwise "on behalf of the agent"

Поля dolyaPoroga, kompaktPlatformennyj, dolyaPorogaPlatformy устарели: при наличии печатается предупреждение, значения игнорируются. Порог (porogIzPreseta, stupenZanjatosti) читается из D заново при каждом вызове. Остальные поля читаются один раз при импорте. svodkaNashejModelyu перечитывает D перед вызовом модели только для проверки его годности.

The fields dolyaPoroga, kompaktPlatformennyj, dolyaPorogaPlatformy are obsolete: if present, a warning is printed and the values are ignored. The threshold (porogIzPreseta, stupenZanjatosti) is re-read from D on every call. Other fields are read once at import. svodkaNashejModelyu re-reads D before the model call only to check its validity.

JSON размещения (текстовые подстановки) · Deployment JSON (text substitutions)

Файл: KOMPAKT_RAZMESCHENIE, иначе /etc/memory-compaction/deployment.json. Заданная переменная (в том числе пустая) обязана быть непустым абсолютным путём без сегмента .. и без NUL и перевода строки; иначе сводка отказывает (tekstovye-nastrojki.mjs, проверка absolute). Читается лениво, при первой сводке; удачный снимок держится до нового импорта, ошибка не кешируется. Если файла по умолчанию нет, берутся умолчания. Если файл задан переменной явно и его нет, сводка отказывает. Допустим единственный ключ promptSubstitutions с полями ownerInstrumental, ownerNominative, ownerGenitive, ownerDative, coordinatorExample, evidenceRuleLabel, exampleHost, roleClarification. Они заменяют метки {{KOMPAKT_OWNER_INSTRUMENTAL}}, {{KOMPAKT_OWNER_NOMINATIVE}} и остальные в промте и рамках. Неизвестный ключ, повтор ключа, пустое значение или значение с {{/}} приводят к отказу сводки до вызова модели. Так же отказывает метка вида {{KOMPAKT_}} с неизвестным именем в промте или рамке, в том числе в файле, заданном KOMPAKT_PROMT, KOMPAKT_RAMKA или KOMPAKT_RAMKA_HVOST: подстановка (podstavitTeksty) идёт до запроса к модели.

File: KOMPAKT_RAZMESCHENIE, otherwise /etc/memory-compaction/deployment.json. A set variable (including an empty one) must be a non-empty absolute path with no .. segment and no NUL or line feed; otherwise the summary refuses (tekstovye-nastrojki.mjs, the absolute check). It is read lazily, at the first summary; a successful snapshot is kept until a fresh import, and failures are not cached. If the default file is missing, defaults are used. If the file is set explicitly via the variable and is missing, the summary refuses. The only allowed key is promptSubstitutions with the fields ownerInstrumental, ownerNominative, ownerGenitive, ownerDative, coordinatorExample, evidenceRuleLabel, exampleHost, roleClarification. They replace the {{KOMPAKT_OWNER_INSTRUMENTAL}}, {{KOMPAKT_OWNER_NOMINATIVE}} and the other labels in the prompt and frames. An unknown key, a duplicate key, an empty value or a value containing {{/}} makes the summary refuse before the model is called. A {{KOMPAKT_}} label with an unknown name in the prompt or a frame causes the same refusal, including in a file set by KOMPAKT_PROMT, KOMPAKT_RAMKA or KOMPAKT_RAMKA_HVOST: substitution (podstavitTeksty) happens before the model request.

Шаблоны · Templates

ФайлПеребивТребование
promt-svodki.txtKOMPAKT_PROMTНе пустой; {{OT_LICA}} не более одного. Если в промте есть и [MODE=ACTIVE], и [MODE=DIALOG], ответ обязан начинаться такой меткой
ramka-stenogrammy.txtKOMPAKT_RAMKAРовно один {{STENOGRAMMA}}
ramka-s-hvostom.txtKOMPAKT_RAMKA_HVOSTОдин {{STENOGRAMMA}} и один {{HVOST}} после него (используется, когда зовущий передаёт хвост)
FileOverrideRequirement
promt-svodki.txtKOMPAKT_PROMTNot empty; at most one {{OT_LICA}}. If the prompt contains both [MODE=ACTIVE] and [MODE=DIALOG], the answer must start with such a tag
ramka-stenogrammy.txtKOMPAKT_RAMKAExactly one {{STENOGRAMMA}}
ramka-s-hvostom.txtKOMPAKT_RAMKA_HVOSTOne {{STENOGRAMMA}} and one {{HVOST}} after it (used when the caller passes a tail)

Прочие переменные окружения · Other environment variables

ПеременнаяУмолчаниеСмысл
KOMPAKT_AGENTпустоИмя агента = имя файла D
KOMPAKT_VHOD0Предел входа сводки, знаков; 0 — без предела
KOMPAKT_POTOLOK393 216Потолок max_tokens провайдера
KOMPAKT_ZN_NA_TOK2.0Знаков на токен для оценки входа; увеличивать без нового замера нельзя
KOMPAKT_ZAPAS8192Запас окна на обрамление запроса, токены
KOMPAKT_MIN_VYHOD8192Если места под сводку меньше, отказ
KOMPAKT_PLATFORMENNYJtrue, если порог прочитанПризнак платформенного компакта (экспортируется)
KOMPAKT_OTKAZY, KOMPAKT_UDACHI$HOME/pamyat/otkazy-kompakta, $HOME/pamyat/udachi-kompaktaКаталоги следа сводок
KOMPAKT_VYHOD100000Объявлена, кодом не используется
KOMPAKT_DOLYA, KOMPAKT_OKNO, KOMPAKT_POROG—Запрещены: если заданы, импорт падает (порог задаётся только через porogi в D)
KOMPAKT_SAMOPROVERKA—Самопроверка. Включает её любое непустое значение, и не только при node index.mjs: проверка стоит в теле модуля и срабатывает при любом импорте, в том числе в процессе-потребителе. В конце она вызывает process.exit (0/1/2) и тем завершает этот процесс. В окружении шлюзов и агентов не задавать
HOME, CODEX_HOME—Поиск журнала сессии: $HOME/.claude/projects/..., затем $CODEX_HOME/sessions/...
VariableDefaultMeaning
KOMPAKT_AGENTemptyAgent name = D file name
KOMPAKT_VHOD0Summary input limit, characters; 0 means unlimited
KOMPAKT_POTOLOK393,216Provider max_tokens ceiling
KOMPAKT_ZN_NA_TOK2.0Characters per token for input estimation; do not raise without a new measurement
KOMPAKT_ZAPAS8192Window margin for request framing, tokens
KOMPAKT_MIN_VYHOD8192If less room is left for the summary, refuse
KOMPAKT_PLATFORMENNYJtrue if the threshold was readPlatform compaction flag (exported)
KOMPAKT_OTKAZY, KOMPAKT_UDACHI$HOME/pamyat/otkazy-kompakta, $HOME/pamyat/udachi-kompaktaSummary trace directories
KOMPAKT_VYHOD100000Declared, not used by the code
KOMPAKT_DOLYA, KOMPAKT_OKNO, KOMPAKT_POROG—Forbidden: if set, the import fails (the threshold comes only from porogi in D)
KOMPAKT_SAMOPROVERKA—Self-check. Any non-empty value enables it, and not only under node index.mjs: the check sits in the module body and fires on any import, including in a consumer process. At the end it calls process.exit (0/1/2) and so terminates that process. Do not set it in the environment of gateways and agents
HOME, CODEX_HOME—Session log lookup: $HOME/.claude/projects/..., then $CODEX_HOME/sessions/...

Флаги KOMPAKT_SHLYUZOVOJ, KOMPAKT_PLATFORMENNYJ, KOMPAKT_RAZMYSHLENIYA: истина только для строки true. Заданная пустая KOMPAKT_SHLYUZOVOJ означает false, то есть шлюзовой компакт выключен.

The flags KOMPAKT_SHLYUZOVOJ, KOMPAKT_PLATFORMENNYJ, KOMPAKT_RAZMYSHLENIYA are true only for the string true. A set but empty KOMPAKT_SHLYUZOVOJ means false, i.e. gateway compaction is off.

Ступени занятости KOMPAKT_STUPENI = 0.60 / 0.80 / 0.95 от порога зашиты в код. Подробный справочник — docs/SETTINGS.md.

The occupancy steps KOMPAKT_STUPENI = 0.60 / 0.80 / 0.95 of the threshold are hard-coded. Detailed reference: docs/SETTINGS.md.