iia-arg/dsh-plugins--packages-dsh-pamyat-storozha ↗★ 2
dsh-pamyat-storozha
Сторожа обслуживания памяти агента DSH: оповещение о каждом сжатии, ступени заполнения от порога сжатия, сводка с охватом; приборы и сторожа памяти в bin/ · Memory maintenance guards for a DSH agent: a notice on every compaction, fill stages of the compaction threshold, a summary with coverage; memory tools and watchers in bin/
安裝
此插件尚未提供可驗證的 bundle,或相容性檢查未通過。請先閱讀倉庫說明。 閱讀完整 README ↗
說明文件
閱讀完整 README ↗Настройка · Configuration
Ключи config плагина (схема Config в src/index.js) · Plugin config keys (Config schema in src/index.js)
| Ключ | Тип | Умолчание | Что значит |
|---|---|---|---|
ispolnenieInstrumentov | 'sdk' | 'dsh' | 'unknown' | 'unknown' | кто исполняет инструменты; от этого зависит строка про обрезку в сводке: sdk — «неприменимо», dsh — счёт обрезок, unknown — «не установлено» |
komandaStoka | string | нет | команда внешнего стока (/bin/sh -c, текст на stdin, 5 с). '' — только журнал; ключа нет — строка подъёма называет это упущением. Исполняется с правами процесса агента |
stupeni | number[] | [0.85, 0.9] | ступени тревоги — доли порога сжатия |
trevogaSzhatiya | boolean | true | отдавать ли в сток короткую строку о завершённом сжатии; провал уходит в сток всегда |
predel | number | 0 | запасное окно в токенах, если платформа окна не объявила; 0 — запасного нет |
agent | string | '' | имя агента в строках и ключ стража одиночного монтажа. Пусто — в журнале «агент НЕ НАЗВАН (настройка agent пуста)». В короткой строке владельцу (сток) имя берётся из вшитой таблицы IMENA в src/index.js (имя учётки → имя по-русски), для учётки вне таблицы — само значение agent; при пустом agent имя в этой строке пустое, «НЕ НАЗВАН» там не пишется |
| Key | Type | Default | Meaning |
|---|---|---|---|
ispolnenieInstrumentov | 'sdk' | 'dsh' | 'unknown' | 'unknown' | who executes tools; determines the prune line in the summary: sdk — "not applicable", dsh — prune count, unknown — "not established" |
komandaStoka | string | none | external sink command (/bin/sh -c, text on stdin, 5 s). '' — log only; key absent — the start-up line calls it an omission. Runs with the agent process privileges |
stupeni | number[] | [0.85, 0.9] | alarm stages — shares of the compaction threshold |
trevogaSzhatiya | boolean | true | whether to send the short line about a finished compaction to the sink; a failure always goes to the sink |
predel | number | 0 | fallback window in tokens if the platform announced none; 0 — no fallback |
agent | string | '' | agent name in lines and the single-mount guard key. Empty — the log says "агент НЕ НАЗВАН (настройка agent пуста)" (agent NOT NAMED (the agent setting is empty)). In the short line to the owner (sink) the name is taken from the built-in IMENA table in src/index.js (account name → name in Russian); for an account outside the table it is the agent value itself; with an empty agent the name in that line is empty, and "НЕ НАЗВАН" is not written there |
Окружение и файлы плагина · Plugin environment and files
| Переменная | Где читается | Что делает |
|---|---|---|
DSH_HOME | src/index.js:311 | каталог для storages/storozha-stupeni.json; нет его и STOROZHA_STUPENI_FAJL — ступени только в памяти процесса |
STOROZHA_STUPENI_FAJL | src/index.js:311 | путь файла ступеней вместо $DSH_HOME/… (для стендов); пустая строка не отменяет DSH_HOME |
STOROZHA_ZHDAT_POSLE_MS | src/index.js:1021 | сколько ждать замера «после» для строки о сжатии; по умолчанию 600 000 мс |
KOMPAKT_AGENT | src/index.js:268 | имя агента для файла порогов dsh-pamyat-kompakt |
KOMPAKT_NASTROJKI_KATALOG | dsh-pamyat-kompakt/porogi.mjs | каталог файлов порогов (читает сосед, не этот пакет) |
| Variable | Read at | Effect |
|---|---|---|
DSH_HOME | src/index.js:311 | directory for storages/storozha-stupeni.json; without it and without STOROZHA_STUPENI_FAJL stages live only in process memory |
STOROZHA_STUPENI_FAJL | src/index.js:311 | stage file path instead of $DSH_HOME/… (for stands); an empty string does not override DSH_HOME |
STOROZHA_ZHDAT_POSLE_MS | src/index.js:1021 | how long to wait for the "after" measurement for the compaction line; default 600 000 ms |
KOMPAKT_AGENT | src/index.js:268 | agent name for the dsh-pamyat-kompakt threshold file |
KOMPAKT_NASTROJKI_KATALOG | dsh-pamyat-kompakt/porogi.mjs | threshold files directory (read by the sibling, not this package) |
Формат файла ступеней: { v: 1, sessii: { : { otdany: [доли], rubezh, kogda } } }.
Stage file format: { v: 1, sessii: { : { otdany: [ratios], rubezh, kogda } } }.
Файл настройки программ bin/ · Settings file of the bin/ programs
Путь — /etc/dsh-pamyat-storozha/dsh-pamyat-storozha.conf, меняется переменной DSH_PAMYAT_STOROZHA_CONF. Строки КЛЮЧ=значение; # в начале строки — комментарий; при повторе ключа действует последнее вхождение; значение с « #» (пробел или таб перед #) — отказ с названием ключа: Node и bash — код 2, Python — код 3. Не задан нужный ключ — СЛЕПОТА с именем ключа, код 2 (исключения — в таблице ниже).
Path — /etc/dsh-pamyat-storozha/dsh-pamyat-storozha.conf, changed by the DSH_PAMYAT_STOROZHA_CONF variable. KEY=value lines; # at the start of a line is a comment; if a key repeats the last occurrence wins; a value containing " #" (space or tab before #) is a refusal naming the key: Node and bash — code 2, Python — code 3. A required key unset — СЛЕПОТА (blindness) with the key name, code 2 (exceptions are in the table below).
| Ключ | Кто читает |
|---|---|
PAMYAT_CORE | pamyat-vernut-povtor, proba-sleda-podyoma.mjs, proverka-opory.mjs (для --zapisat), omega-kopiya-watch (счёт доверия), test/stend-proverki-opory.mjs |
PAMYAT_BAZA | proverka-cepi-boem.mjs, proverka-opory.mjs, sverka-s-istochnikom.mjs, rubezh-otnoshenij-watch |
DSH_SESSII | proverka-opory.mjs, sverka-s-istochnikom.mjs |
CEP_UNIT | proverka-cepi-boem.mjs |
SLED_PROFIL | proba-sleda-podyoma.mjs |
OTKLONENNYE_KATALOG, CHITATEL_RUKA | chitatel-otklonennyh.mjs |
DSH_PLUGINS_KLON | sostav-nabora.mjs, stendy-vseh-paketov.sh |
STENDY_SPISOK_SLEPOTY | stendy-vseh-paketov.sh (умолчание — prinyataya-slepota.txt рядом со скриптом) |
AGENT_REGISTRY | session-agent-preset-watch, session-writer-watch.py |
SWW_PAUZA_DIR, SWW_VERSIYA, SWW_CHITATEL | session-writer-watch.py |
KP_ISHODY, KP_SHLYUZ | kompakt-priemka (только семейство codex; KP_SHLYUZ — шаблон с {agent}) |
OKW_PAMYAT, OKW_STATE, OKW_PRAVKI, OKW_ISKLYUCHENIYA, OKW_IMYA | omega-kopiya-watch |
| Key | Read by |
|---|---|
PAMYAT_CORE | pamyat-vernut-povtor, proba-sleda-podyoma.mjs, proverka-opory.mjs (for --zapisat), omega-kopiya-watch (trust count), test/stend-proverki-opory.mjs |
PAMYAT_BAZA | proverka-cepi-boem.mjs, proverka-opory.mjs, sverka-s-istochnikom.mjs, rubezh-otnoshenij-watch |
DSH_SESSII | proverka-opory.mjs, sverka-s-istochnikom.mjs |
CEP_UNIT | proverka-cepi-boem.mjs |
SLED_PROFIL | proba-sleda-podyoma.mjs |
OTKLONENNYE_KATALOG, CHITATEL_RUKA | chitatel-otklonennyh.mjs |
DSH_PLUGINS_KLON | sostav-nabora.mjs, stendy-vseh-paketov.sh |
STENDY_SPISOK_SLEPOTY | stendy-vseh-paketov.sh (default — prinyataya-slepota.txt next to the script) |
AGENT_REGISTRY | session-agent-preset-watch, session-writer-watch.py |
SWW_PAUZA_DIR, SWW_VERSIYA, SWW_CHITATEL | session-writer-watch.py |
KP_ISHODY, KP_SHLYUZ | kompakt-priemka (codex family only; KP_SHLYUZ is a template with {agent}) |
OKW_PAMYAT, OKW_STATE, OKW_PRAVKI, OKW_ISKLYUCHENIYA, OKW_IMYA | omega-kopiya-watch |
Аргументы, переменные и коды программ bin/ · Arguments, variables and exit codes of the bin/ programs
| Программа | Аргументы | Переменные окружения (умолчание) | Что пишет | Коды |
|---|---|---|---|---|
chitatel-otklonennyh.mjs | [каталог] [--suho] | — | .reshenie.txt рядом (кроме --suho) | 0, 2 |
kompakt-priemka | [--since ISO8601] [--json] | — | ничего; зовёт /usr/local/bin/agent-registry, journalctl, zstd | 0, 1, 2 |
omega-kopiya-watch | — | OKW_N_MIN (10), OKW_OKNO_MIN (60), OKW_OMEGA_DB (/var/lib/omega/.omega/omega.db), OKW_PAMYAT, OKW_STATE, OKW_PRAVKI, OKW_CORE, OKW_ALERT (/usr/local/bin/agent-alert), OKW_NODE (/usr/local/bin/node), OKW_OMEGA_SP (/opt/omega/venv/lib/python3.12/site-packages), OKW_OMEGA_UNIT (omega-memory), OKW_OMEGA_MODEL_DIR (/var/lib/omega/.cache/omega/models/bge-m3-onnx), OKW_SYSTEMCTL, OKW_JOURNALCTL | файл OKW_STATE; тревоги в канал | 0, 1, 2; 3 — не задан OKW_STATE |
pamyat-vernut-povtor | ` |
|PAMYAT_VERNUT_CORE(только стенд) | запись в базу, переименование файла | 0, 2 | |proba-sleda-podyoma.mjs(без шебанга,node …) | [корень пакетов]|PROBA_PROFIL| временный каталог | 0, 1, 2 | |proverka-cepi-boem.mjs|[--kontrol]|CEP_BAZA, CEP_OKNO (-7 days), CEP_ZHURNAL, CEP_START| ничего;--kontrol— временный каталог в$HOME/workspace/vremennoe/| 0, 1, 2 | |proverka-opory.mjs|[.db] [--kontrol] [--zapisat]| — | только с--zapisat: отметки проверки в базу | 0, 1, 2 | | rasshcheplenie-otmeny-watch| — |RASSHCH_BAZA (/var/lib/omega/.omega/omega.db), RASSHCH_SOST (/var/lib/rasshcheplenie-otmeny-watch/proshloe.json), RASSHCH_ITOG (…/last.json), RASSHCH_ALERT (/usr/local/bin/agent-alert) | SOST, ITOG; тревоги | 0, 2, 3 (рост) | | rubezh-otnoshenij-watch| — |RUBEZH_BAZA, RUBEZH_SOST (/var/lib/rubezh-otnoshenij-watch/skazano), RUBEZH_ALERT (agent-alertизPATH), RUBEZH_MONTAZH_MAXID(2912),RUBEZH_MONTAZH_TS(1790004368),RUBEZH_PREDEL_SUTOK(7) |SOST; тревоги | 0, 1, 2 | | session-agent-preset-watch|[--json | --watch]|PRESET_WATCH_REGISTRY, PRESET_WATCH_STATE, PRESET_WATCH_ALERT— только вместе сPRESET_WATCH_PROBA=1|--watch: /var/lib/session-agent-preset-watch/last.json, тревога agent-alert --plain| 0, 1, 2, 3 | |session-writer-watch.py|[--check] [--version]|SESSION_WRITER_PAUZA_DIR(стенд) | без--check: /var/lib/session-writer-watch/state.json, тревога /usr/local/bin/agent-alert| 0, 1, 2 | |sostav-nabora.mjs| — |KLON_TEGOV|git fetch originв клоне; запрос кregistry.npmjs.org| 0, 1, 2 | |stendy-vseh-paketov.sh| — |STENDY_PKG_DIR, STENDY_OBRAZEC (dsh-pamyat-*), STENDY_PREDEL(120 с),STENDY_SPISOK_SLEPOTY| ничего, но запускает чужие стенды | 0, 1, 2 | |sverka-s-istochnikom.mjs|[pamyat.db]` | — | ничего | 0, 1, 2 |
| Program | Arguments | Environment variables (default) | Writes | Codes |
|---|---|---|---|---|
chitatel-otklonennyh.mjs | [directory] [--suho] | — | .reshenie.txt alongside (except --suho) | 0, 2 |
kompakt-priemka | [--since ISO8601] [--json] | — | nothing; calls /usr/local/bin/agent-registry, journalctl, zstd | 0, 1, 2 |
omega-kopiya-watch | — | OKW_N_MIN (10), OKW_OKNO_MIN (60), OKW_OMEGA_DB (/var/lib/omega/.omega/omega.db), OKW_PAMYAT, OKW_STATE, OKW_PRAVKI, OKW_CORE, OKW_ALERT (/usr/local/bin/agent-alert), OKW_NODE (/usr/local/bin/node), OKW_OMEGA_SP (/opt/omega/venv/lib/python3.12/site-packages), OKW_OMEGA_UNIT (omega-memory), OKW_OMEGA_MODEL_DIR (/var/lib/omega/.cache/omega/models/bge-m3-onnx), OKW_SYSTEMCTL, OKW_JOURNALCTL | the OKW_STATE file; alarms to the channel | 0, 1, 2; 3 — OKW_STATE unset |
pamyat-vernut-povtor | ` |
|PAMYAT_VERNUT_CORE(stand only) | a record in the base, file rename | 0, 2 | |proba-sleda-podyoma.mjs(no shebang,node …) | [packages root]|PROBA_PROFIL| a temporary directory | 0, 1, 2 | |proverka-cepi-boem.mjs|[--kontrol]|CEP_BAZA, CEP_OKNO (-7 days), CEP_ZHURNAL, CEP_START| nothing;--kontrol— a temporary directory in$HOME/workspace/vremennoe/| 0, 1, 2 | |proverka-opory.mjs|[.db] [--kontrol] [--zapisat]| — | only with--zapisat: check marks in the base | 0, 1, 2 | | rasshcheplenie-otmeny-watch| — |RASSHCH_BAZA (/var/lib/omega/.omega/omega.db), RASSHCH_SOST (/var/lib/rasshcheplenie-otmeny-watch/proshloe.json), RASSHCH_ITOG (…/last.json), RASSHCH_ALERT (/usr/local/bin/agent-alert) | SOST, ITOG; alarms | 0, 2, 3 (growth) | | rubezh-otnoshenij-watch| — |RUBEZH_BAZA, RUBEZH_SOST (/var/lib/rubezh-otnoshenij-watch/skazano), RUBEZH_ALERT (agent-alertfromPATH), RUBEZH_MONTAZH_MAXID(2912),RUBEZH_MONTAZH_TS(1790004368),RUBEZH_PREDEL_SUTOK(7) |SOST; alarms | 0, 1, 2 | | session-agent-preset-watch|[--json | --watch]|PRESET_WATCH_REGISTRY, PRESET_WATCH_STATE, PRESET_WATCH_ALERT— only together withPRESET_WATCH_PROBA=1|--watch: /var/lib/session-agent-preset-watch/last.json, alarm via agent-alert --plain| 0, 1, 2, 3 | |session-writer-watch.py|[--check] [--version]|SESSION_WRITER_PAUZA_DIR(stand) | without--check: /var/lib/session-writer-watch/state.json, alarm via /usr/local/bin/agent-alert| 0, 1, 2 | |sostav-nabora.mjs| — |KLON_TEGOV|git fetch originin the clone; request toregistry.npmjs.org| 0, 1, 2 | |stendy-vseh-paketov.sh| — |STENDY_PKG_DIR, STENDY_OBRAZEC (dsh-pamyat-*), STENDY_PREDEL(120 s),STENDY_SPISOK_SLEPOTY| nothing, but runs other packages' stands | 0, 1, 2 | |sverka-s-istochnikom.mjs|[pamyat.db]` | — | nothing | 0, 1, 2 |
Внешние зависимости программ: Node с node:sqlite (proverka-*, sverka-s-istochnikom.mjs), zstd, sqlite3 (rubezh-otnoshenij-watch), Python 3 с PyYAML (session-*), Python службы OMEGA /opt/omega/venv/bin/python3 (шебанг rasshcheplenie-otmeny-watch), git и сеть (sostav-nabora.mjs).
External dependencies of the programs: Node with node:sqlite (proverka-*, sverka-s-istochnikom.mjs), zstd, sqlite3 (rubezh-otnoshenij-watch), Python 3 with PyYAML (session-*), the OMEGA service Python /opt/omega/venv/bin/python3 (shebang of rasshcheplenie-otmeny-watch), git and network (sostav-nabora.mjs).