dsh-shutdown-guard 1.5.0 → 1.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.ru.md ADDED
@@ -0,0 +1,314 @@
1
+ # Shutdown Guard · Выключение после завершения задач
2
+ [中文](README.md) · [English](README.en.md) · **Русский**
3
+
4
+ <p align="center"><img src="https://cdn.jsdelivr.net/gh/ltayshark0637/dsh-Shutdown-Guard@main/docs/screenshots/banner.png" width="880" alt="Shutdown Guard — автоматическое выключение после завершения задач, ночная карточка на боковой панели"></p>
5
+
6
+ [![version](https://img.shields.io/badge/version-1.6.0-2ea44f)](CHANGELOG.md)
7
+ [![demo](https://img.shields.io/badge/%E2%96%B6-%D0%94%D0%95%D0%9C%D0%9E-d97757)](https://ltayshark0637.github.io/dsh-Shutdown-Guard/demo.html)
8
+ [![DSH](https://img.shields.io/badge/DSH-%E2%89%A50.1.5--rc.1-4a90d9)](https://github.com/deepseek-ai)
9
+ [![platform](https://img.shields.io/badge/platform-Windows-0078d4)](#ограничения)
10
+ [![license](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
11
+ [![dshbase: проверено установкой](https://dshbase.com/badges/dsh-shutdown-guard.svg)](https://dshbase.com/plugins/dsh-shutdown-guard/) [![awesome-dsh-plugin: в каталоге](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com/p/ltayshark0637/dsh-Shutdown-Guard/)
12
+
13
+ Добавляет в боковую панель DeepSeek Harness карточку «выключить компьютер после завершения всех задач» — с более разнообразным и качественным оформлением, логикой принятия решения и настройкой под себя. Карточка расположена под «Центром навыков» и над списком сессий и обновляется в реальном времени вместе с состоянием задач.
14
+
15
+ **▶ [Интерактивная демонстрация](https://ltayshark0637.github.io/dsh-Shutdown-Guard/demo.html)** — подключать плагин не нужно: сначала посмотрите, как он выглядит и как принимает решения. Две страницы: **«Понять»** (правила, внешний вид, состояния) и **«Попробовать»** (случайный сценарий: вручную включите охрану, отмените её, снимите — и проследите до самого выключения или блокировки). Все данные генерируются локально случайным образом, сеть не используется.
16
+
17
+ ## Зачем это нужно
18
+
19
+ У тех, кто запускает долгие задачи, сценарий обычно такой: вечером вы поручаете агенту пачку работы и хотите, чтобы по её завершении компьютер выключился, — а вас рядом нет.
20
+
21
+ Но «задачи завершены» не означает «можно выключать»: фоновые задачи ещё выполняются, в сессии произошла ошибка, агент ждёт вашего ответа, вы сами прервали его на полпути. Выключение в любом из этих случаев — авария. Плагин отсекает каждую такую ситуацию и выключает компьютер, только когда это действительно безопасно.
22
+
23
+ ## Правила: когда происходит выключение
24
+
25
+ В заблокированном состоянии (см. ниже) команда не отправляется вовсе; в остальных случаях должны одновременно выполниться пять условий, и только тогда отправляется `shutdown /s`:
26
+
27
+ 1. **Охрана включена** — вы включили её вручную
28
+ 2. **Обратный отсчёт уже не идёт** — чтобы не отправить команду повторно
29
+ 3. **Все корневые сессии простаивают** — ни один агент ещё не работает
30
+ 4. **Нет выполняющихся или останавливающихся фоновых задач** — `blockOnJobs`, включено по умолчанию
31
+ 5. **В этой партии нет ошибок сессий** — `onlyOnSuccess`, включено по умолчанию
32
+
33
+ Если не выполнено хотя бы одно условие, выключения не будет, а причина будет указана на карточке и на странице настроек.
34
+
35
+ ## Три варианта оформления
36
+
37
+ Один и тот же вариант в светлой и тёмной теме; снимки на трёх языках лежат в `docs/screenshots/` под именами `<nn>-armed-<вариант>-<язык>-<тема>.png`.
38
+
39
+ | Минимальный (светлая) | Радар (светлая) | Терминал (светлая) |
40
+ |:------------------------------------------------------------------------------:|:-----------------------------------------------------------------------:|:--------------------------------------------------------------------------------------------:|
41
+ | <img src="https://cdn.jsdelivr.net/gh/ltayshark0637/dsh-Shutdown-Guard@main/docs/screenshots/05-armed-a-ru-light.png" width="250"> | <img src="https://cdn.jsdelivr.net/gh/ltayshark0637/dsh-Shutdown-Guard@main/docs/screenshots/11-armed-b-ru-light.png" width="250"> | <img src="https://cdn.jsdelivr.net/gh/ltayshark0637/dsh-Shutdown-Guard@main/docs/screenshots/17-armed-c-ru-light.png" width="250"> |
42
+
43
+ | Минимальный (тёмная) | Радар (тёмная) | Терминал (тёмная) |
44
+ |:------------------------------------------------------------------------------:|:-----------------------------------------------------------------------:|:--------------------------------------------------------------------------------------------:|
45
+ | <img src="https://cdn.jsdelivr.net/gh/ltayshark0637/dsh-Shutdown-Guard@main/docs/screenshots/06-armed-a-ru-dark.png" width="250"> | <img src="https://cdn.jsdelivr.net/gh/ltayshark0637/dsh-Shutdown-Guard@main/docs/screenshots/12-armed-b-ru-dark.png" width="250"> | <img src="https://cdn.jsdelivr.net/gh/ltayshark0637/dsh-Shutdown-Guard@main/docs/screenshots/18-armed-c-ru-dark.png" width="250"> |
46
+ | Крупный заголовок + одна строка пояснения, внизу бегущая лента (красно-жёлтая, пока карточка на посту) | Радар + строка состояния, сессии и фоновые задачи показаны точками | Три строки терминала (команда, счётчики, ожидание) над шестью индикаторами условий |
47
+
48
+ Точки на радаре только добавляются и удаляются, но не переставляются: при изменении количества те точки, на которые вы смотрите, не прыгают на другие места.
49
+
50
+ Лента по нижнему краю карточки и плавающего окна меняется вместе с состоянием: в штатных палитрах, пока карточка выключена или заблокирована, она держится в двух спокойных оттенках цвета темы; с момента включения режима и до самого выключения возвращаются привычные красно-жёлтые полосы. Смена идёт плавно, за 280 мс, без вспышек. В палитрах Claude Style и DeepSeek Blue лента на красно-жёлтое не переключается и всё время следует за цветом темы — там полосы просто спорят с остальным.
51
+
52
+ <p align="center"><img src="https://cdn.jsdelivr.net/gh/ltayshark0637/dsh-Shutdown-Guard@main/docs/screenshots/anim-radar.gif" width="330" alt="Сканирование радара"></p>
53
+
54
+ Переключается на вкладке «Оформление»: три карточки с миниатюрами, щелчок применяется сразу, перезапуск не нужен; миниатюра меняется вместе с языком интерфейса и светлотой фона.
55
+
56
+ ## Шесть состояний работы
57
+
58
+ | Выключено | Ожидание | Ожидание фоновых задач |
59
+ |:---------------------------------------------------:|:-----------------------------------------------------:|:----------------------------------------------------------------------:|
60
+ | <img src="https://cdn.jsdelivr.net/gh/ltayshark0637/dsh-Shutdown-Guard@main/docs/screenshots/01-off.png" width="250"> | <img src="https://cdn.jsdelivr.net/gh/ltayshark0637/dsh-Shutdown-Guard@main/docs/screenshots/02-armed.png" width="250"> | <img src="https://cdn.jsdelivr.net/gh/ltayshark0637/dsh-Shutdown-Guard@main/docs/screenshots/03-hold.png" width="250"> |
61
+
62
+ | Обратный отсчёт | Команда отправлена | Блокировка |
63
+ |:----------------------------------------------------:|:-----------------------------------------------------------------------:|:------------------------------------------------------------------------:|
64
+ | <img src="https://cdn.jsdelivr.net/gh/ltayshark0637/dsh-Shutdown-Guard@main/docs/screenshots/04-fire.png" width="250"> | <img src="https://cdn.jsdelivr.net/gh/ltayshark0637/dsh-Shutdown-Guard@main/docs/screenshots/05-fired.png" width="250"> | <img src="https://cdn.jsdelivr.net/gh/ltayshark0637/dsh-Shutdown-Guard@main/docs/screenshots/08-blocked-halted.png" width="250"> |
65
+
66
+ `Выключено` → `Ожидание` → `Ожидание фоновых задач` → `Обратный отсчёт` → `Команда отправлена`; на любом этапе блокирующая ошибка переводит карточку в `Блокировка`. Во время обратного отсчёта можно отменить в любой момент; **после отмены охрана остаётся включённой** — следующая партия задач всё равно приведёт к выключению.
67
+
68
+ Хотите пересмотреть все шесть состояний? В демонстрации, в разделе 04 страницы «Понять», в правом верхнем углу есть три «капсулы» `A` `B` `C` — они переключают оформление предпросмотра.
69
+
70
+ ## Заблокированные состояния
71
+
72
+ | halted · нужно вмешательство человека | waiting · автоматические повторы |
73
+ |:--------------------------------------------------------------:|:---------------------------------------------------------------------------------:|
74
+ | <img src="https://cdn.jsdelivr.net/gh/ltayshark0637/dsh-Shutdown-Guard@main/docs/screenshots/08-blocked-halted.png" width="250"> | <img src="https://cdn.jsdelivr.net/gh/ltayshark0637/dsh-Shutdown-Guard@main/docs/screenshots/09-blocked-waiting.png" width="250"> |
75
+
76
+ При ошибках, которые нельзя обработать как обычный сбой, плагин **не снимает охрану**, меняет цвет карточки и пишет причину:
77
+
78
+ - **`halted`** (серо-синий) — нехватка квоты, недействительные учётные данные, превышение контекста, неподдерживаемая возможность, переполнен диск. Справиться может только человек: нажмите «Снять и повторить».
79
+ - **`waiting`** (серо-зелёный, точка «дышит») — ограничение частоты, 5xx, обрыв сети, пустой ответ, тайм-аут, выгрузка изображений. Повторяется автоматически по политике; в нужный момент внедряется инструкция «продолжить по исходному плану».
80
+
81
+ <p align="center"><img src="https://cdn.jsdelivr.net/gh/ltayshark0637/dsh-Shutdown-Guard@main/docs/screenshots/anim-blocked.gif" width="380" alt="Ожидание восстановления, точка состояния «дышит»"></p>
82
+
83
+ Ритм повторов настраивается отдельно для каждого типа сбоя, см. [Политики повторов](#политики-повторов).
84
+
85
+ ## Автопилот AFK
86
+
87
+ Когда вас нет рядом, плагин берёт на себя три вещи:
88
+
89
+ - **Автоматические ответы на вопросы** (включено по умолчанию): когда агент что-то спрашивает, плагин отвечает: «Пользователь в AFK. Сначала выполните уже поставленные задачи, сведите отчёт и сохраните его на диск, не трогайте ветки, которые не были поручены». Возвращается `selected: []` плюс пользовательский текст, поэтому **ни один вариант за вас не выбирается**; если выключить, вопросы снова будут приходить вам.
90
+ - **Восстановление после ошибок**: при ошибке сессии агенту сначала предлагается разобраться и продолжить по исходному плану; при повторной ошибке в той же сессии — «прекратить повторы и завершить отчётом».
91
+ - **Защита от прерывания**: если вы сами остановили задачу на полпути, выключение не сработает.
92
+
93
+ ## Где он находится
94
+
95
+ | Охрана включена: под «Центром навыков», над списком сессий | Обратный отсчёт: там же, вся полоса краснеет |
96
+ |:-------------------------------------------------------------------------------------------:|:---------------------------------------------------------------------------------------:|
97
+ | <img src="https://cdn.jsdelivr.net/gh/ltayshark0637/dsh-Shutdown-Guard@main/docs/screenshots/10-sidebar-hold.png" width="250"> | <img src="https://cdn.jsdelivr.net/gh/ltayshark0637/dsh-Shutdown-Guard@main/docs/screenshots/11-sidebar-fire.png" width="250"> |
98
+
99
+ По умолчанию карточка закреплена именно в этом месте боковой панели; кнопка в её заголовке открывает карточку как отдельное плавающее окно, которое остаётся на виду при переключении сессий (см. «Прочее» ниже).
100
+
101
+ ## Прочее
102
+
103
+ - **Плавающее окно**: кнопка в правом верхнем углу карточки открывает панель состояния в отдельном окне — она остаётся на виду, даже когда вы переключились на другую сессию. Переключатель «компактное плавающее окно» в настройках включён по умолчанию и оставляет только статус и обратный отсчёт; выключите его, чтобы видеть полную панель.
104
+
105
+ - **Вертикальное сворачивание**: в свёрнутом виде остаются только заголовок и статус; нажмите на заголовок, чтобы развернуть.
106
+
107
+ <img src="https://cdn.jsdelivr.net/gh/ltayshark0637/dsh-Shutdown-Guard@main/docs/screenshots/16-folded.png" width="250" align="right" alt="Свёрнутое состояние">
108
+
109
+ - **Адаптация к теме**: у карточки собственная палитра `--dsp-*`, светлые и тёмные цвета выбираются автоматически по яркости поверхности хоста; можно также принудительно задать тёмную / светлую / Claude Style. Страница настроек всегда следует теме хоста.
110
+
111
+ - **Язык**: по умолчанию «как в системе» — `LC_ALL` / `LC_MESSAGES` / `LANG`, затем региональные настройки `Intl`, в последнюю очередь `en`; можно закрепить китайский / английский / русский. Состояние «следовать» для языка и темы хранит хост, поэтому оно не дублируется на каждом устройстве.
112
+
113
+ - **Журнал событий**: на странице настроек видны последние события и «почему в прошлый раз не выключилось»; полный поток — в `data/events.log`.
114
+
115
+ <br clear="all">
116
+
117
+ ## Страница настроек
118
+
119
+ | Тёмная | Светлая |
120
+ |:---------------------------------------------------------------------------------------------:|:----------------------------------------------------------------------------------------------:|
121
+ | <img src="https://cdn.jsdelivr.net/gh/ltayshark0637/dsh-Shutdown-Guard@main/docs/screenshots/12-settings-dark.png" width="380"> | <img src="https://cdn.jsdelivr.net/gh/ltayshark0637/dsh-Shutdown-Guard@main/docs/screenshots/13-settings-light.png" width="380"> |
122
+
123
+ Четыре вкладки: **Оформление** / **Охрана** / **Уведомления** / **Состояние**. Открывается на «Оформлении», все переключатели действуют сразу.
124
+
125
+ - **Оформление**: пять строк без заголовка группы — три карточки с миниатюрами («Минимальный» / «Радар» / «Терминал», миниатюра подбирается по языку интерфейса и светлоте фона), тема (как в системе / тёмная / светлая / Claude Style), сворачивание по умолчанию, компактное плавающее окно, язык интерфейса.
126
+ - **Охрана**: сверху отдельной строкой, вне групп, стоит переключатель «пользовательские профили»; когда он включён, появляется группа **Профили** — список профиля по умолчанию и всех пользовательских с переключением, назначением по умолчанию, переименованием и удалением, в конце **+ Создать**. Ниже группа **Поведение охраны** ставит четыре строки условий перед AFK: «Все сессии остановились» — базовое условие, включено всегда и не отключается; «Фоновые задачи завершены» блокирует фоновые задачи; «пропустить этот раунд при ошибке в сессии» блокирует партии с ошибками; длительность обратного отсчёта меняется только в пользовательском профиле. Последним идёт «Автоответ в AFK»: «ответы не выбирают за вас ни один вариант; после отключения вопросы снова приходят вам».
127
+ - **Уведомления**: одна группа — общий переключатель и четыре отдельных (начался отсчёт / выключение сейчас / первая блокировка / блокировка снята). Ручное включение охраны, снятие и отмена отсчёта не уведомляют.
128
+ - **Состояние**: одна группа — текущая блокировка, почему в прошлый раз не выключилось, последние события.
129
+
130
+ ## Светлая тема и сторонние темы
131
+
132
+ | Светлая карточка | Claude Style |
133
+ |:-----------------------------------------------------:|:------------------------------------------------------:|
134
+ | <img src="https://cdn.jsdelivr.net/gh/ltayshark0637/dsh-Shutdown-Guard@main/docs/screenshots/14-light.png" width="250"> | <img src="https://cdn.jsdelivr.net/gh/ltayshark0637/dsh-Shutdown-Guard@main/docs/screenshots/15-claude.png" width="250"> |
135
+
136
+ Карточка не наследует палитру хоста, у неё своя; страница настроек следует теме хоста. Для Claude Style в этой строке плагин заранее не нужен: без dsh-claude-style карточка берёт встроенную похожую палитру (терракота), а под строкой темы появляется серая пояснительная строка; после установки плагина цвета подхватываются у него, и пояснение исчезает. Если плагин стоит, но у него выставлено `palette: host`, берётся наша янтарная палитра — не терракота.
137
+
138
+ ## Установка
139
+
140
+ Опубликовано в npm, рекомендуется:
141
+
142
+ ```bash
143
+ dsh plugin --profile web add dsh-shutdown-guard
144
+ ```
145
+
146
+ Или установить напрямую с GitHub:
147
+
148
+ ```bash
149
+ dsh plugin --profile web add github:ltayshark0637/dsh-Shutdown-Guard
150
+ ```
151
+
152
+ После установки **перезапустите DSH**.
153
+
154
+ > ⚠️ **Клиентский бандл попадает в граф модулей только при запуске DSH**: после изменения `lib/client.js` обязателен перезапуск, обновление страницы не поможет. С серверной частью то же самое.
155
+
156
+ **При ограниченной сети**: команда с GitHub по сути представляет собой `pnpm add github:...` и требует клонирования. Если клонировать не получается, используйте в первую очередь команду из npm (она идёт через registry); если не работает и она, установите по локальному пути — DSH Настройки → Плагины → Добавить, укажите **абсолютный путь** к этому каталогу → Установить → перезапустить.
157
+
158
+ **Ручной резервный вариант**: создайте в `profiles\web` символическую ссылку `node_modules\dsh-shutdown-guard` на этот каталог, затем:
159
+
160
+ - в `profiles\web\package.json` добавьте `link:<абсолютный путь к этому каталогу>` в `dependencies` и `pnpm.overrides`
161
+ - в `dsh.profile.bundles` добавьте `dsh-shutdown-guard`
162
+
163
+ ## Права и влияние
164
+
165
+ После установки плагин делает следующее:
166
+
167
+ | Область | Конкретное поведение |
168
+ | --- | --- |
169
+ | **Выполнение команд** | Через `subprocess` вызывает Windows `shutdown.exe`: `/s /t <секунды>` планирует выключение, `/a` отменяет. **Вызывается только при включённой охране и выполнении всех пяти условий** |
170
+ | **Файлы** | Только `data/` в каталоге плагина: `config.json` (настройки) и `events.log` (журнал событий) |
171
+ | **События** | `agent/status`, `agent/error`, `session/event`, `user-questions/request` |
172
+ | **HTTP-маршруты** | В локальном веб-сервере DSH: `/api/dsh-shutdown-guard/` — `GET /state`, `GET /events`, `POST /arm`, `POST /disarm`, `POST /cancel`, `POST /config`; для POST проверяется, что Origin равен `127.0.0.1` или `localhost` |
173
+ | **Сеть** | **Никаких внешних запросов**, данные не собираются |
174
+ | **Платформа** | **Только Windows**. На платформах, отличных от `win32`, плагин молча не загружается |
175
+
176
+ Когда автопилот AFK включён, плагин во время охраны отвечает на вопросы агента и внедряет инструкции восстановления в сессии с ошибками; этот переключатель можно в любой момент отключить в настройках.
177
+
178
+ ## Настройка
179
+
180
+ Настройка делится на два уровня: один **профиль по умолчанию** и любое число **пользовательских профилей**. У каждого профиля свои длительность отсчёта, оба условия-«ворота», AFK и четыре переключателя уведомлений.
181
+
182
+ Три источника, от низкого приоритета к высокому:
183
+
184
+ 1. `cordis.patch.yml` (заводской патч внутри пакета плагина)
185
+ 2. `data/config.json` (сохраняется во время работы; сюда попадает всё, что меняется на странице настроек)
186
+ 3. `POST /config` (изменение во время работы, тоже сохраняется)
187
+
188
+ ### Почему профиль по умолчанию зафиксирован
189
+
190
+ Профиль по умолчанию — **безопасная нижняя граница для всех**: 60 секунд, ждать фоновые задачи, пропускать партии с ошибками — всё зашито, менять нельзя. Причины практические:
191
+
192
+ - 60 секунд — самое короткое окно, в котором вы ещё успеваете увидеть карточку и нажать отмену; при 10 секундах цена случайного выключения намного больше сэкономленной минуты.
193
+ - Раз профиль по умолчанию не дрейфует, к нему всегда можно вернуться, не гадая, действует ли ещё прошлая правка.
194
+ - Нужно иначе? Можно, но придётся явно создать пользовательский профиль — правка уйдёт в него, а не в нижнюю границу.
195
+
196
+ ### Как создать пользовательский профиль
197
+
198
+ Настройки → **Оформление** → **Профили** → `+ Создать`: профиль копируется из текущего, вы задаёте имя (до 24 символов) и сохраняете — он становится активным.
199
+
200
+ - При чистой установке есть ровно один профиль — по умолчанию. Второй создаётся через `+ Создать`; пустые слоты заранее больше не заводятся.
201
+ - Если выключить переключатель «пользовательские профили» и снова включить, вы вернётесь к тому профилю, которым пользовались; если его успели удалить — останетесь на профиле по умолчанию.
202
+ - При обновлении слоты, которых вы ни разу не касались, вычищаются. Профиль, который вы переименовали или в котором меняли хотя бы один переключатель, сохраняется.
203
+ - Любой пользовательский профиль можно сделать профилем по умолчанию, переименовать или удалить.
204
+ - Удаление используемого профиля возвращает профиль по умолчанию; перед удалением запрашивается подтверждение.
205
+ - Когда общий переключатель «пользовательские профили» выключен, ни один пользовательский профиль не применяется и используется профиль по умолчанию.
206
+
207
+ ### Ключи
208
+
209
+ Эти ключи хранятся в каждом профиле отдельно:
210
+
211
+ | Ключ | Диапазон | По умолчанию | Описание |
212
+ | --------------- | ------ | ------ | ----------------------------------------- |
213
+ | `countdownSec` | 10–600 | 60 | Секунды обратного отсчёта перед выключением (в профиле по умолчанию фиксировано 60, не меняется) |
214
+ | `onlyOnSuccess` | bool | `true` | Пропускать выключение при ошибке в любой сессии этой партии |
215
+ | `blockOnJobs` | bool | `true` | Пропускать выключение, пока выполняются фоновые задачи |
216
+ | `afkAutoAnswer` | bool | `true` | Отвечать на вопросы за пользователя и выполнять восстановление после ошибок во время охраны |
217
+ | `notify` | объект | все `true` | Четыре переключателя уведомлений: `countdown` / `fired` / `blocked` / `recovered` |
218
+
219
+ Глобальные (не привязаны к профилю):
220
+
221
+ | Ключ | Диапазон | По умолчанию | Описание |
222
+ | ---------- | ------ | ------ | ---- |
223
+ | `language` | список | `auto` | Язык интерфейса; `auto` следует языку системы (`LC_ALL` / `LC_MESSAGES` / `LANG` → `Intl` → `en`), можно закрепить `zh` / `en` / `ru` |
224
+ | `customEnabled` | bool | `false` | Разрешено ли использовать пользовательские профили |
225
+ | `activeProfileId` | string | `default` | Профиль, который действует сейчас |
226
+
227
+ Кроме того, `marginSec` (0–60, по умолчанию 5) добавляет запас к `shutdown /t`.
228
+
229
+ ### Политики повторов
230
+
231
+ Каждому коду ошибки назначается имя политики; сами политики настраиваются:
232
+
233
+ | Политика | Ритм по умолчанию | Назначена |
234
+ | ------------ | -------------------------------------- | ---------------------------------- |
235
+ | `rate-limit` | backoff 30 → 60 → 120 → 240 → 300, с потолком | `RATE_LIMIT` |
236
+ | `transient` | фиксировано 20 секунд | `SERVER` / `TRANSPORT` / `TIMEOUT` |
237
+ | `empty` | фиксировано 30 секунд | `EMPTY_RESPONSE` |
238
+ | `offload` | фиксировано 5 секунд | `IMAGE_OFFLOAD_REQUIRED` |
239
+
240
+ Для ограничения частоты используется backoff, а не фиксированный интервал: частые повторы к сервису, ограничивающему частоту, **продлевают** период ограничения, а не просто тратят запросы. Сбои 5xx и сетевые ошибки восстанавливаются за предсказуемое время, поэтому фиксированный интервал оказывается быстрее. Выгрузка изображений — локальная операция с диском, повтор возможен почти сразу, отсюда 5 секунд.
241
+
242
+ Переопределение отдельного кода ошибки:
243
+
244
+ ```yaml
245
+ retryAssign:
246
+ RATE_LIMIT: slow-limit
247
+ retryPolicies:
248
+ slow-limit: { mode: backoff, base: 60, max: 900 }
249
+ ```
250
+
251
+ Неизвестный `code` откатывается к `transient`; политики с неверной структурой отбрасываются, а значения по умолчанию сохраняются. Действующие назначения можно прочитать из `retryAssign` и `retryPolicies` в `/state`.
252
+
253
+ **Где хранятся предпочтения**: оформление карточки, тема и сворачивание — чисто интерфейсные настройки, они лежат в браузерном `localStorage` (`dsh-shutdown-guard.variant` / `.theme` / `.folded`); компактное плавающее окно и четыре переключателя уведомлений принадлежат хосту (`data/ui.json`); язык и ключи профилей попадают в `data/config.json`.
254
+
255
+ ## HTTP-интерфейс
256
+
257
+ Префикс `/api/dsh-shutdown-guard`, используется для опроса самой карточкой с того же источника:
258
+
259
+ | Метод | Путь | Описание |
260
+ | ---- | -------------------------- | -------------------------------------------------------------------------------- |
261
+ | GET | `/state?since=<ms>` | Полное состояние + инкрементальные события |
262
+ | POST | `/arm` `/disarm` `/cancel` | Включить охрану / снять / отменить текущий обратный отсчёт |
263
+ | POST | `/config` | Изменить настройки: `customEnabled`, `activeProfileId`, `profileId`+`patch`, `afkAutoAnswer`, `language` |
264
+ | GET | `/events?since=&limit=` | Поток событий |
265
+
266
+ POST с Origin не с этого компьютера возвращает 403; запрос не методом POST — 405.
267
+
268
+ ## Журналы
269
+
270
+ - `<каталог плагина>\data\events.log` — читаемый человеком поток событий (категории `config` / `afk` / `skip`), его же читает «Журнал событий» на странице настроек
271
+ - `<DSH_HOME>\dsh-shutdown-guard.log` — журнал уровня процесса (дописывается)
272
+
273
+ ## Разработка
274
+
275
+ ```bash
276
+ node test/host.test.mjs # сервер: 26 проверок, mock ctx, реального выключения нет
277
+ node test/client.test.cjs # smoke-тест клиентского бандла
278
+ node scripts/gen-gallery.cjs # генерация страницы скриншотов из настоящего CSS в lib/client.js
279
+ powershell -NoProfile -ExecutionPolicy Bypass -File scripts/screenshot.ps1 # headless Edge рендерит PNG (прозрачный фон + автообрезка)
280
+ node scripts/gen-gif.cjs # генерация трёх анимированных GIF для README
281
+ node scripts/gen-banner.cjs # генерация социального превью 1280x640
282
+ node scripts/gen-demo.cjs # генерация docs/demo.html (интерактивная демонстрация)
283
+ ```
284
+
285
+ Все скриншоты генерируются из настоящего CSS в `lib/client.js`, поэтому не расходятся с продуктом. С анимациями так же: CSS-анимации замораживаются через `animation-delay` в нескольких моментах времени, снимаются покадрово и собираются встроенным кодировщиком GIF89a — ffmpeg или ImageMagick на машине не нужны.
286
+
287
+ Раздел «Понять» на странице демонстрации тоже рендерится в реальном времени: шесть состояний создаются на месте той же разметкой `card()`, что и в продукте, а не берутся со скриншотов.
288
+
289
+ ## Частые вопросы
290
+
291
+ **В: Почему изменение настройки ни на что не влияет?**
292
+ О: И сервер, и клиент загружают новый код только после перезапуска DSH. Локальный HMR для локально подключённых плагинов не работает.
293
+
294
+ **В: Почему после включения охраны компьютер не выключился?**
295
+ О: Посмотрите на странице настроек «почему в прошлый раз не выключилось» — там указана конкретная причина (фоновые задачи, ошибка, охрана не включена и т. п.).
296
+
297
+ **В: Можно ли передумать во время обратного отсчёта?**
298
+ О: Да. «Отменить выключение» на карточке или просто `shutdown /a`; после отмены охрана остаётся включённой и действует для следующей партии.
299
+
300
+ **В: Бывает ли ошибочное выключение?**
301
+ О: При настройках по умолчанию плагин действует, только когда одновременно выполнены четыре условия: все сессии простаивают, фоновых задач нет, ошибок нет, охрана включена вручную. Нарушение любого из них отменяет или пропускает выключение. Ручное прерывание задачи также распознаётся и исключается.
302
+
303
+ **В: Работает ли не на Windows?**
304
+ О: Пока нет, это запланировано на будущее.
305
+
306
+ ## Ограничения
307
+
308
+ - Только Windows: на платформах, отличных от `win32`, происходит ранний выход, ничего не монтируется.
309
+ - Нулевые зависимости времени выполнения: сервер использует только `node:fs` / `node:path` / `node:crypto`, браузер — только `require('react')`.
310
+ - Не изменяет `app.asar` и исходный код DSH.
311
+
312
+ ## Лицензия
313
+
314
+ [MIT](LICENSE)
Binary file
package/cordis.patch.yml CHANGED
@@ -1,21 +1,23 @@
1
- # dsh-shutdown-guard:任务完成后自动关机
2
- - insert:
3
- - id: dsh-shutdown-guard
4
- name: 'dsh-shutdown-guard'
5
- config:
6
- countdownSec: 60
7
- marginSec: 5
8
- onlyOnSuccess: true
1
+ # dsh-shutdown-guard:任务完成后自动关机
2
+ - insert:
3
+ - id: dsh-shutdown-guard
4
+ name: 'dsh-shutdown-guard'
5
+ config:
6
+ countdownSec: 60
7
+ marginSec: 5
8
+ onlyOnSuccess: true
9
9
  blockOnJobs: true
10
- retryPolicies:
11
- rate-limit: { mode: backoff, base: 30, max: 300 }
12
- transient: { mode: fixed, every: 20 }
13
- empty: { mode: fixed, every: 30 }
14
- offload: { mode: fixed, every: 5 }
15
- retryAssign:
16
- RATE_LIMIT: rate-limit
17
- SERVER: transient
18
- TRANSPORT: transient
19
- TIMEOUT: transient
20
- EMPTY_RESPONSE: empty
10
+ # auto | zh | en | ru — 'auto' follows the OS locale
11
+ language: auto
12
+ retryPolicies:
13
+ rate-limit: { mode: backoff, base: 30, max: 300 }
14
+ transient: { mode: fixed, every: 20 }
15
+ empty: { mode: fixed, every: 30 }
16
+ offload: { mode: fixed, every: 5 }
17
+ retryAssign:
18
+ RATE_LIMIT: rate-limit
19
+ SERVER: transient
20
+ TRANSPORT: transient
21
+ TIMEOUT: transient
22
+ EMPTY_RESPONSE: empty
21
23
  IMAGE_OFFLOAD_REQUIRED: offload