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
インストール
検証済み 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}, а не число |
model | KOMPAKT_MODEL | deepseek-flash | Модель сводки |
adres | KOMPAKT_ADRES | https://api.deepseek.com/v1/chat/completions | Адрес API сводки |
imenaKlyucha | нет | KOMPAKT_API_KEY, DEEPSEEK_API_KEY, GATEWAY_API_KEY | Имена переменных окружения, где искать ключ (берётся первое непустое). Сам ключ в файлах не хранится |
hvostStrok | KOMPAKT_HVOST | 30 | Сколько последних строк журнала остаются дословно; целое ≥ 1, иное — отказ сжатия без перезаписи |
oknoSvodki (устар. oknoModeli) | KOMPAKT_OKNO_MODELI | 1 000 000 | Окно модели сводки, токены; к порогу компакта не относится |
razmyshleniya | KOMPAKT_RAZMYSHLENIYA | false | При false в запрос идёт thinking: {type: "disabled"} |
kompaktShlyuzovoj | KOMPAKT_SHLYUZOVOJ | не объявлен | Выключатель шлюзового компакта. Выключает только false; не объявлен — сжимать |
minProzaZnakov | KOMPAKT_MIN_PROZA | 0 (выкл.) | Если прозы меньше, модель не зовётся, отдаётся проза |
ceny | нет | нет | {vhod, vyhod, istochnik, data}, $ за миллион токенов; без него расход печатается только в токенах |
imya | нет | нет | Имя агента для промта (одно слово с заглавной, до 31 буквы); иначе «от лица агента» |
| Field | Env override | Default | Meaning |
|---|---|---|---|
porogi | none (see below) | none | Ready threshold: {schema:1, defaultRoute:{provider,model}, routes:[{provider,model,window,ratio,nominalThreshold}]}. Strictly validated (porogi.mjs); a fault yields {prichina}, not a number |
model | KOMPAKT_MODEL | deepseek-flash | Summary model |
adres | KOMPAKT_ADRES | https://api.deepseek.com/v1/chat/completions | Summary API endpoint |
imenaKlyucha | none | KOMPAKT_API_KEY, DEEPSEEK_API_KEY, GATEWAY_API_KEY | Names of environment variables to search for the key (the first non-empty wins). The key itself is never stored in files |
hvostStrok | KOMPAKT_HVOST | 30 | Last log lines kept verbatim; an integer ≥ 1, anything else refuses compaction without rewriting |
oknoSvodki (obsolete oknoModeli) | KOMPAKT_OKNO_MODELI | 1,000,000 | Summary model window, tokens; unrelated to the compaction threshold |
razmyshleniya | KOMPAKT_RAZMYSHLENIYA | false | When false, the request carries thinking: {type: "disabled"} |
kompaktShlyuzovoj | KOMPAKT_SHLYUZOVOJ | undeclared | Gateway compaction switch. Only false turns it off; undeclared means compress |
minProzaZnakov | KOMPAKT_MIN_PROZA | 0 (off) | If the prose is shorter, the model is not called and the prose is returned |
ceny | none | none | {vhod, vyhod, istochnik, data}, $ per million tokens; without it cost is printed in tokens only |
imya | none | none | Agent 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.txt | KOMPAKT_PROMT | Не пустой; {{OT_LICA}} не более одного. Если в промте есть и [MODE=ACTIVE], и [MODE=DIALOG], ответ обязан начинаться такой меткой |
ramka-stenogrammy.txt | KOMPAKT_RAMKA | Ровно один {{STENOGRAMMA}} |
ramka-s-hvostom.txt | KOMPAKT_RAMKA_HVOST | Один {{STENOGRAMMA}} и один {{HVOST}} после него (используется, когда зовущий передаёт хвост) |
| File | Override | Requirement |
|---|---|---|
promt-svodki.txt | KOMPAKT_PROMT | Not 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.txt | KOMPAKT_RAMKA | Exactly one {{STENOGRAMMA}} |
ramka-s-hvostom.txt | KOMPAKT_RAMKA_HVOST | One {{STENOGRAMMA}} and one {{HVOST}} after it (used when the caller passes a tail) |
Прочие переменные окружения · Other environment variables
| Переменная | Умолчание | Смысл |
|---|---|---|
KOMPAKT_AGENT | пусто | Имя агента = имя файла D |
KOMPAKT_VHOD | 0 | Предел входа сводки, знаков; 0 — без предела |
KOMPAKT_POTOLOK | 393 216 | Потолок max_tokens провайдера |
KOMPAKT_ZN_NA_TOK | 2.0 | Знаков на токен для оценки входа; увеличивать без нового замера нельзя |
KOMPAKT_ZAPAS | 8192 | Запас окна на обрамление запроса, токены |
KOMPAKT_MIN_VYHOD | 8192 | Если места под сводку меньше, отказ |
KOMPAKT_PLATFORMENNYJ | true, если порог прочитан | Признак платформенного компакта (экспортируется) |
KOMPAKT_OTKAZY, KOMPAKT_UDACHI | $HOME/pamyat/otkazy-kompakta, $HOME/pamyat/udachi-kompakta | Каталоги следа сводок |
KOMPAKT_VYHOD | 100000 | Объявлена, кодом не используется |
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/... |
| Variable | Default | Meaning |
|---|---|---|
KOMPAKT_AGENT | empty | Agent name = D file name |
KOMPAKT_VHOD | 0 | Summary input limit, characters; 0 means unlimited |
KOMPAKT_POTOLOK | 393,216 | Provider max_tokens ceiling |
KOMPAKT_ZN_NA_TOK | 2.0 | Characters per token for input estimation; do not raise without a new measurement |
KOMPAKT_ZAPAS | 8192 | Window margin for request framing, tokens |
KOMPAKT_MIN_VYHOD | 8192 | If less room is left for the summary, refuse |
KOMPAKT_PLATFORMENNYJ | true if the threshold was read | Platform compaction flag (exported) |
KOMPAKT_OTKAZY, KOMPAKT_UDACHI | $HOME/pamyat/otkazy-kompakta, $HOME/pamyat/udachi-kompakta | Summary trace directories |
KOMPAKT_VYHOD | 100000 | Declared, 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.