opencode-windows-scheduler 1.5.4 → 1.5.5

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.
Files changed (218) hide show
  1. package/CHANGELOG.md +65 -5
  2. package/CROSS_PLATFORM.md +107 -71
  3. package/README.md +72 -25
  4. package/ROADMAP-STRATEGY.md +6 -0
  5. package/ROADMAP.md +116 -85
  6. package/dist/core/analytics.d.ts +3 -0
  7. package/dist/core/analytics.d.ts.map +1 -1
  8. package/dist/core/analytics.js +4 -0
  9. package/dist/core/audit.d.ts +2 -1
  10. package/dist/core/audit.d.ts.map +1 -1
  11. package/dist/core/audit.js +32 -1
  12. package/dist/core/cron-to-schtasks.d.ts.map +1 -1
  13. package/dist/core/cron-to-schtasks.js +21 -4
  14. package/dist/core/file-watcher.d.ts.map +1 -1
  15. package/dist/core/file-watcher.js +16 -1
  16. package/dist/core/git-trigger.d.ts +4 -2
  17. package/dist/core/git-trigger.d.ts.map +1 -1
  18. package/dist/core/git-trigger.js +34 -16
  19. package/dist/core/lock.d.ts +14 -0
  20. package/dist/core/lock.d.ts.map +1 -1
  21. package/dist/core/lock.js +81 -4
  22. package/dist/core/matrix.d.ts.map +1 -1
  23. package/dist/core/matrix.js +3 -2
  24. package/dist/core/native-notify.d.ts.map +1 -1
  25. package/dist/core/native-notify.js +3 -0
  26. package/dist/core/one-shot.d.ts +7 -1
  27. package/dist/core/one-shot.d.ts.map +1 -1
  28. package/dist/core/one-shot.js +15 -2
  29. package/dist/core/permissions.d.ts +69 -0
  30. package/dist/core/permissions.d.ts.map +1 -0
  31. package/dist/core/permissions.js +143 -0
  32. package/dist/core/ps-wrapper.d.ts +9 -2
  33. package/dist/core/ps-wrapper.d.ts.map +1 -1
  34. package/dist/core/ps-wrapper.js +293 -96
  35. package/dist/core/record-history.d.ts +11 -0
  36. package/dist/core/record-history.d.ts.map +1 -1
  37. package/dist/core/record-history.js +106 -4
  38. package/dist/core/savings.d.ts +70 -0
  39. package/dist/core/savings.d.ts.map +1 -0
  40. package/dist/core/savings.js +87 -0
  41. package/dist/core/schedule-gate.js +7 -3
  42. package/dist/core/schedule-v2.js +1 -1
  43. package/dist/core/scheduler/index.d.ts +13 -1
  44. package/dist/core/scheduler/index.d.ts.map +1 -1
  45. package/dist/core/scheduler/index.js +35 -4
  46. package/dist/core/scheduler/linux.d.ts +4 -1
  47. package/dist/core/scheduler/linux.d.ts.map +1 -1
  48. package/dist/core/scheduler/linux.js +53 -20
  49. package/dist/core/scheduler/mac.d.ts +2 -1
  50. package/dist/core/scheduler/mac.d.ts.map +1 -1
  51. package/dist/core/scheduler/mac.js +24 -6
  52. package/dist/core/scheduler/posix.d.ts +1 -1
  53. package/dist/core/scheduler/posix.d.ts.map +1 -1
  54. package/dist/core/scheduler/posix.js +2 -2
  55. package/dist/core/scheduler/registry.d.ts +3 -2
  56. package/dist/core/scheduler/registry.d.ts.map +1 -1
  57. package/dist/core/scheduler/registry.js +6 -5
  58. package/dist/core/scheduler/windows.d.ts +49 -1
  59. package/dist/core/scheduler/windows.d.ts.map +1 -1
  60. package/dist/core/scheduler/windows.js +219 -34
  61. package/dist/core/secrets.d.ts +5 -3
  62. package/dist/core/secrets.d.ts.map +1 -1
  63. package/dist/core/secrets.js +86 -8
  64. package/dist/core/self-analysis.d.ts +117 -0
  65. package/dist/core/self-analysis.d.ts.map +1 -0
  66. package/dist/core/self-analysis.js +539 -0
  67. package/dist/core/session.d.ts +11 -3
  68. package/dist/core/session.d.ts.map +1 -1
  69. package/dist/core/session.js +34 -5
  70. package/dist/core/shutdown.d.ts +26 -0
  71. package/dist/core/shutdown.d.ts.map +1 -0
  72. package/dist/core/shutdown.js +49 -0
  73. package/dist/core/summary.d.ts +69 -0
  74. package/dist/core/summary.d.ts.map +1 -0
  75. package/dist/core/summary.js +250 -0
  76. package/dist/core/telegram.d.ts +10 -0
  77. package/dist/core/telegram.d.ts.map +1 -1
  78. package/dist/core/telegram.js +228 -47
  79. package/dist/core/triage-chain.d.ts +9 -3
  80. package/dist/core/triage-chain.d.ts.map +1 -1
  81. package/dist/core/triage-chain.js +15 -5
  82. package/dist/core/triage-compare.d.ts +68 -0
  83. package/dist/core/triage-compare.d.ts.map +1 -0
  84. package/dist/core/triage-compare.js +184 -0
  85. package/dist/core/triage-rules.d.ts.map +1 -1
  86. package/dist/core/triage-rules.js +22 -0
  87. package/dist/core/triage-shadow.d.ts +54 -10
  88. package/dist/core/triage-shadow.d.ts.map +1 -1
  89. package/dist/core/triage-shadow.js +138 -26
  90. package/dist/core/triage-worker.d.ts +55 -0
  91. package/dist/core/triage-worker.d.ts.map +1 -0
  92. package/dist/core/triage-worker.js +314 -0
  93. package/dist/core/triage.js +1 -1
  94. package/dist/core/watch-paths.d.ts +6 -0
  95. package/dist/core/watch-paths.d.ts.map +1 -0
  96. package/dist/core/watch-paths.js +62 -0
  97. package/dist/core/wrappers/bash.d.ts +15 -3
  98. package/dist/core/wrappers/bash.d.ts.map +1 -1
  99. package/dist/core/wrappers/bash.js +153 -120
  100. package/dist/db/history-repo.d.ts +1 -1
  101. package/dist/db/history-repo.d.ts.map +1 -1
  102. package/dist/db/history-repo.js +29 -14
  103. package/dist/db/schema.d.ts +1 -1
  104. package/dist/db/schema.d.ts.map +1 -1
  105. package/dist/db/schema.js +31 -0
  106. package/dist/history.d.ts +2 -2
  107. package/dist/history.d.ts.map +1 -1
  108. package/dist/history.js +3 -3
  109. package/dist/i18n.d.ts +25 -2
  110. package/dist/i18n.d.ts.map +1 -1
  111. package/dist/i18n.js +41 -3
  112. package/dist/index.d.ts +40 -4
  113. package/dist/index.d.ts.map +1 -1
  114. package/dist/index.js +345 -71
  115. package/dist/integrations.d.ts +9 -1
  116. package/dist/integrations.d.ts.map +1 -1
  117. package/dist/integrations.js +34 -6
  118. package/dist/notifications.d.ts +30 -2
  119. package/dist/notifications.d.ts.map +1 -1
  120. package/dist/notifications.js +287 -16
  121. package/dist/profiles.d.ts +1 -1
  122. package/dist/profiles.d.ts.map +1 -1
  123. package/dist/profiles.js +21 -3
  124. package/dist/rpc.d.ts +145 -8
  125. package/dist/rpc.d.ts.map +1 -1
  126. package/dist/rpc.js +81 -6
  127. package/dist/server.d.ts +20 -0
  128. package/dist/server.d.ts.map +1 -1
  129. package/dist/server.js +136 -14
  130. package/dist/settings.d.ts +89 -5
  131. package/dist/settings.d.ts.map +1 -1
  132. package/dist/settings.js +143 -23
  133. package/dist/task-transfer.d.ts +8 -1
  134. package/dist/task-transfer.d.ts.map +1 -1
  135. package/dist/task-transfer.js +2 -2
  136. package/dist/types.d.ts +8 -1
  137. package/dist/types.d.ts.map +1 -1
  138. package/dist/types.js +23 -5
  139. package/dist/workspaces.d.ts +9 -0
  140. package/dist/workspaces.d.ts.map +1 -1
  141. package/dist/workspaces.js +25 -0
  142. package/docs/ARCHITECTURE.md +40 -22
  143. package/docs/CONCEPT.md +230 -0
  144. package/docs/CROSS_PLATFORM.ru.md +150 -0
  145. package/docs/CROSS_PLATFORM.zh.md +146 -0
  146. package/docs/FAQ.md +52 -0
  147. package/docs/FAQ.ru.md +53 -0
  148. package/docs/FAQ.zh.md +43 -0
  149. package/docs/FEATURES.md +125 -48
  150. package/docs/FEATURES.zh.md +655 -0
  151. package/docs/LOCAL-AI.md +114 -16
  152. package/docs/README.ru.md +18 -13
  153. package/docs/README.zh.md +286 -0
  154. package/docs/SAVINGS.md +61 -0
  155. package/docs/SAVINGS.ru.md +60 -0
  156. package/docs/SAVINGS.zh.md +52 -0
  157. package/docs/ZH-LOCALE-PLAN.md +324 -0
  158. package/gui-experimental.cjs +8 -8
  159. package/locales/en.json +54 -1
  160. package/locales/ru.json +54 -1
  161. package/locales/zh.json +780 -0
  162. package/package.json +24 -7
  163. package/scripts/check-zh-locale.mjs +218 -0
  164. package/scripts/run-tests.mjs +236 -0
  165. package/scripts/test-locale.mjs +4 -3
  166. package/skills/scheduled-job-best-practices/SKILL.md +6 -3
  167. package/skills/scheduled-job-best-practices/references/recipes.md +1 -1
  168. package/src/core/analytics.ts +10 -0
  169. package/src/core/audit.ts +39 -1
  170. package/src/core/cron-to-schtasks.ts +23 -4
  171. package/src/core/file-watcher.ts +20 -1
  172. package/src/core/git-trigger.ts +34 -16
  173. package/src/core/lock.ts +88 -3
  174. package/src/core/matrix.ts +5 -1
  175. package/src/core/native-notify.ts +3 -0
  176. package/src/core/one-shot.ts +18 -2
  177. package/src/core/permissions.ts +200 -0
  178. package/src/core/ps-wrapper.ts +300 -96
  179. package/src/core/record-history.ts +111 -4
  180. package/src/core/savings.ts +150 -0
  181. package/src/core/schedule-gate.ts +9 -3
  182. package/src/core/schedule-v2.ts +1 -1
  183. package/src/core/scheduler/index.ts +41 -3
  184. package/src/core/scheduler/linux.ts +67 -22
  185. package/src/core/scheduler/mac.ts +24 -7
  186. package/src/core/scheduler/posix.ts +2 -2
  187. package/src/core/scheduler/registry.ts +7 -5
  188. package/src/core/scheduler/windows.ts +237 -32
  189. package/src/core/secrets.ts +101 -7
  190. package/src/core/self-analysis.ts +744 -0
  191. package/src/core/session.ts +40 -5
  192. package/src/core/shutdown.ts +69 -0
  193. package/src/core/summary.ts +318 -0
  194. package/src/core/telegram.ts +266 -55
  195. package/src/core/triage-chain.ts +15 -6
  196. package/src/core/triage-compare.ts +277 -0
  197. package/src/core/triage-rules.ts +23 -0
  198. package/src/core/triage-shadow.ts +176 -32
  199. package/src/core/triage-worker.ts +344 -0
  200. package/src/core/triage.ts +1 -1
  201. package/src/core/watch-paths.ts +70 -0
  202. package/src/core/wrappers/bash.ts +181 -138
  203. package/src/db/history-repo.ts +31 -18
  204. package/src/db/schema.ts +31 -0
  205. package/src/gui.tsx +5070 -4761
  206. package/src/history.ts +7 -3
  207. package/src/i18n.ts +55 -4
  208. package/src/index.ts +432 -74
  209. package/src/integrations.ts +50 -6
  210. package/src/notifications.ts +465 -18
  211. package/src/profiles.ts +21 -3
  212. package/src/rpc.ts +86 -6
  213. package/src/server.ts +135 -16
  214. package/src/settings.ts +305 -46
  215. package/src/task-transfer.ts +10 -3
  216. package/src/types.ts +24 -5
  217. package/src/workspaces.ts +22 -0
  218. package/dist/gui-experimental.cjs +0 -1
@@ -0,0 +1,60 @@
1
+ # Счётчик «сэкономлено $»
2
+
3
+ Дашборд и `get_analytics` показывают KPI **«Сэкономлено»**. Это **оценка**, а не
4
+ бухгалтерский факт: рядом с суммой стоит пометка «оценка» и ссылка на эту
5
+ страницу.
6
+
7
+ Translations: [English](SAVINGS.md) · [中文](SAVINGS.zh.md)
8
+
9
+ ## Methodology
10
+
11
+ Контрфактика строится по истории запусков (`history` в SQLite).
12
+
13
+ 1. Берутся записи окна анализа, кроме незавершённых (`status = "running"`).
14
+ 2. В оценку попадает запуск, у которого **есть токены** (`tokens > 0`) и
15
+ **не записана стоимость** (`costUsd` пустой или `0`). Обычно это локальная
16
+ модель (Ollama) или уже оплаченная подписка: токены потрачены, но деньги за
17
+ них не списаны.
18
+ 3. Для каждого такого запуска считается гипотетическая облачная стоимость:
19
+
20
+ ```
21
+ saved = tokens / 1000 × referenceCostPer1kTokensUsd
22
+ ```
23
+
24
+ 4. Сумма складывается по всем запускам окна и разбивается по задачам
25
+ (топ-10 по экономии).
26
+
27
+ Эталонная цена по умолчанию — **$0.01 за 1k токенов** (смесь входа и выхода
28
+ облачного провайдера среднего класса), константа
29
+ `CLOUD_REFERENCE_COST_PER_1K_TOKENS_USD` в `src/core/savings.ts`. Запуски с
30
+ записанной стоимостью в экономию не попадают: за них деньги уже списаны, и
31
+ сравнивать нечего.
32
+
33
+ ## Что оценка не учитывает
34
+
35
+ - кеш промптов, скидки и пакетные тарифы;
36
+ - разницу цен входных и выходных токенов;
37
+ - запуски без токенов (например, чистый shell): экономии там может и не быть;
38
+ - запуски, где стоимость не записана по ошибке, а не потому что она нулевая —
39
+ такие записи завышают оценку.
40
+
41
+ Поэтому счётчик отвечает на вопрос «сколько бы это стоило в облаке по
42
+ эталонной цене», а не «сколько денег вернулось на счёт».
43
+
44
+ ## API
45
+
46
+ `get_analytics` возвращает `report.savings`:
47
+
48
+ | Поле | Значение |
49
+ | --- | --- |
50
+ | `kind` | всегда `estimate` |
51
+ | `savedUsd` | оценка экономии, USD |
52
+ | `runs` | запусков в контрфактике |
53
+ | `tokens` | токенов в этих запусках |
54
+ | `actualCostUsd` | записанная стоимость этих же запусков (обычно 0) |
55
+ | `totalCostUsd` | записанная стоимость всех запусков окна |
56
+ | `referenceCostPer1kTokensUsd` | эталонная цена |
57
+ | `methodologyUrl` | ссылка на эту страницу |
58
+ | `byTask` | разбивка `{ taskName, runs, tokens, savedUsd }` |
59
+
60
+ Методика проверяется на фиксированных данных: `test-savings.mjs`, 14 проверок.
@@ -0,0 +1,52 @@
1
+ # 「节省 $」计数器
2
+
3
+ 仪表盘和 `get_analytics` 会显示 **「节省」** KPI。它是**估算**,不是账务事实:
4
+ 金额会标注为估算并链接到本页。
5
+
6
+ Translations: [English](SAVINGS.md) · [Русский](SAVINGS.ru.md)
7
+
8
+ ## 方法
9
+
10
+ 反事实估算基于运行历史(SQLite 中的 `history`)。
11
+
12
+ 1. 取分析窗口内的记录,排除未完成的运行(`status = "running"`)。
13
+ 2. 当一次运行**有 token**(`tokens > 0`)且**没有记录成本**(`costUsd` 为空或 `0`)时,
14
+ 它进入估算。通常是本地模型(Ollama)或已付费订阅:消耗了 token 但未扣费。
15
+ 3. 对每次这样的运行计算假设的云端成本:
16
+
17
+ ```
18
+ saved = tokens / 1000 × referenceCostPer1kTokensUsd
19
+ ```
20
+
21
+ 4. 在窗口内对所有运行求和,并按任务拆分(按节省额取前 10)。
22
+
23
+ 默认参考价格为 **每 1k token $0.01**(中端云厂商输入/输出混合价),即
24
+ `src/core/savings.ts` 中的常量 `CLOUD_REFERENCE_COST_PER_1K_TOKENS_USD`。
25
+ 有记录成本的运行不计入节省:已经扣过费,没什么可对比的。
26
+
27
+ ## 估算未考虑的因素
28
+
29
+ - 提示词缓存、折扣和批量定价;
30
+ - 输入与输出 token 的价格差异;
31
+ - 没有 token 的运行(例如纯 shell 运行):可能根本没有节省;
32
+ - 成本因错误而未记录(而非因为为零)的运行——这类记录会虚增估算。
33
+
34
+ 因此该计数器回答的是「按参考价格在云端要花多少钱」,而不是「实际退回了多少钱」。
35
+
36
+ ## API
37
+
38
+ `get_analytics` 返回 `report.savings`:
39
+
40
+ | 字段 | 值 |
41
+ | --- | --- |
42
+ | `kind` | 始终为 `estimate` |
43
+ | `savedUsd` | 估算节省额,USD |
44
+ | `runs` | 反事实中的运行数 |
45
+ | `tokens` | 这些运行的 token 数 |
46
+ | `actualCostUsd` | 这些运行记录的成本(通常为 0) |
47
+ | `totalCostUsd` | 窗口内所有运行记录的成本 |
48
+ | `referenceCostPer1kTokensUsd` | 参考价格 |
49
+ | `methodologyUrl` | 指向本页的链接 |
50
+ | `byTask` | 拆分 `{ taskName, runs, tokens, savedUsd }` |
51
+
52
+ 该方法在固定数据上验证:`test-savings.mjs`,14 项检查。
@@ -0,0 +1,324 @@
1
+ # План: интерфейс локали `zh` (locales/zh.json)
2
+
3
+ **Цель:** полноценная китайская локаль интерфейса планировщика — `locales/zh.json`,
4
+ подключённая к `src/i18n.ts` и GUI-бандлу, с паритетом ключей и зелёными тестами.
5
+
6
+ **Текущее состояние:** `locales/ru.json` (70 286 Б) и `locales/en.json` (51 490 Б) —
7
+ по 772 ключа, паритет полный. `zh.json` отсутствует. `Locale = "ru" | "en"`,
8
+ `SUPPORTED_LOCALES = ["ru", "en"]`, `DEFAULT_LOCALE = "ru"`.
9
+
10
+ ---
11
+
12
+ ## 1. Детали (что именно предстоит закрыть)
13
+
14
+ Деталь = смысловой блок каталога. Размеры посчитаны по `en.json` (26 511 символов
15
+ английского текста всего).
16
+
17
+ | ID | Деталь | Ключи | Символы EN | Что внутри |
18
+ |---|---|---:|---:|---|
19
+ | Д01 | `app.*`, `common.*` | 2 | 62 | заголовок дашборда, плюральный счётчик запусков |
20
+ | Д02 | `dryRun.*` | 33 | 1 437 | предупреждения и трассировка dry-run |
21
+ | Д03 | `gitTrigger.*` | 7 | 401 | git-триггеры (baseline, changed, ignored…) |
22
+ | Д04 | `gui.core` | 230 | 7 187 | основная панель: формы, поля, кнопки, хинты, статусы |
23
+ | Д05 | `gui.job.*` | 50 | 1 489 | карточка задачи, её панели и подписи |
24
+ | Д06 | `gui.toast.*` | 66 | 1 328 | всплывающие уведомления GUI |
25
+ | Д07 | `gui.validation.*` | 15 | 596 | ошибки валидации формы |
26
+ | Д08 | `gui.history*` | 13 | 261 | история, очистка, лимиты |
27
+ | Д09 | `gui.logs.*`, `gui.jobStatus.*`, `gui.priority*`, `gui.weekday*`, `gui.templates*`, `gui.promptTemplates*` | 36 | ~ 510 | микрогруппы GUI |
28
+ | Д10 | `gui.matrix*`, `gui.workspace*` | 43 | 1 540 | матрица, клоны, workspace |
29
+ | Д11 | `localAi.*` | 64 | 2 665 | локальный ИИ + мастер настройки (3 экрана) |
30
+ | Д12 | `matrix.*` | 16 | 874 | результаты и ошибки матрицы |
31
+ | Д13 | `notify.*` | 46 | 1 677 | каналы, дайджесты, ошибки доставки |
32
+ | Д14 | `schedule.*` | 21 | 612 | разбор cron и окон запуска |
33
+ | Д15 | `server.*` | 5 | 128 | HTTP-ошибки сервера |
34
+ | Д16 | `shadow.*` | 9 | 186 | теневой режим локального ИИ |
35
+ | Д17 | `tool.*` | 116 | 5 351 | результаты/ошибки инструментов агента |
36
+
37
+ **Механика i18n (важно для перевода):**
38
+ - Ключи плоские, `"gui.job.runTitle"`; значения — только непустые строки.
39
+ - ICU-подмножество: `{name}` — подстановка; `{count, plural, one {…} other {…}}`.
40
+ - Плюральных ключей 4: `common.runsCount`, `gui.dryRunMatrixPreview`,
41
+ `gui.job.watchGlobsCount`, `gui.matrixWillCreate`. Для `zh` у `Intl.PluralRules`
42
+ есть единственная категория `other` → в китайском каталоге ветка должна быть
43
+ только `other` (ветки `one/few/many` не нужны и будут мёртвым кодом).
44
+ - Параметры подстановки — 245 ключей; набор `{…}` обязан совпадать с `en.json`
45
+ (иначе в UI останутся «сырые» плейсхолдеры).
46
+ - Fallback: отсутствующий ключ → `ru` → сам ключ. Частичный `zh.json` безопасен,
47
+ но до полного паритета интерфейс будет смешанным (zh + ru).
48
+
49
+ **Точки интеграции:**
50
+ - `src/i18n.ts`: тип `Locale`, `SUPPORTED_LOCALES`, комментарии контракта.
51
+ - `src/gui.tsx` (строки 8–12): JSON-импорт каталогов и `registerCatalog` —
52
+ в webview нет доступа к файлам пакета, без импорта `zh` не заработает в GUI.
53
+ - `test-i18n.mjs`: проверки контракта, `availableLocales()`, паритета, плюрализации.
54
+ - `test-docs.mjs`: проверяет каталоги `ru`/`en`; `zh` не ломает, но паритет
55
+ `zh` нужно добавить в финальный контроль.
56
+ - `scripts/test-locale.mjs`: сейчас пропускает только `ru`/`en`.
57
+ - `package.json` → `files` уже содержит `locales`, правок не требует.
58
+ - `gui-experimental.cjs` — артефакт сборки (`npm run build:gui`).
59
+
60
+ **Источники терминологии:** `docs/README.zh.md`, `docs/FEATURES.zh.md`,
61
+ `docs/FAQ.zh.md`, `docs/CROSS_PLATFORM.zh.md` (готовый китайский глоссарий продукта).
62
+
63
+ ---
64
+
65
+ ## 2. Глоссарий (обязателен для всех подзадач)
66
+
67
+ | RU / EN | ZH |
68
+ |---|---|
69
+ | задача / task | 任务 |
70
+ | запуск / run | 运行 |
71
+ | расписание / schedule | 调度 |
72
+ | cron | cron (не переводить) |
73
+ | триггер / trigger | 触发器 |
74
+ | матрица / matrix | 矩阵 |
75
+ | клон / clone | 克隆 |
76
+ | рабочая область / workspace | 工作区 |
77
+ | качественный гейт / quality gate | 质量门禁 |
78
+ | зависимость / depends on | 依赖 |
79
+ | агрегатор / aggregator | 聚合任务 |
80
+ | уведомление / notification | 通知 |
81
+ | дайджест / digest | 摘要 |
82
+ | шаблон / template | 模板 |
83
+ | профиль / profile | 配置文件 |
84
+ | секрет / secret | 密钥 |
85
+ | история / history | 历史记录 |
86
+ | метрики / metrics | 指标 |
87
+ | аудит / audit | 审计 |
88
+ | логи / logs | 日志 |
89
+ | пауза / pause | 暂停 |
90
+ | возобновить / resume | 恢复 |
91
+ | приоритет / priority | 优先级 |
92
+ | часовой пояс / timezone | 时区 |
93
+ | окно запуска / window | 时间窗 |
94
+ | пропустить / skip | 跳过 |
95
+ | отложить / postpone | 延后 |
96
+ | повтор / retry | 重试 |
97
+ | задержка / delay | 延迟 |
98
+ | таймаут / timeout | 超时 |
99
+ | параллельно / sequential | 并行 / 串行 |
100
+ | ветка / branch | 分支 |
101
+ | путь / path | 路径 |
102
+ | игнорировать / ignore | 忽略 |
103
+ | тихие часы / quiet hours | 免打扰时段 |
104
+ | сессия / session | 会话 |
105
+ | модель / model | 模型 |
106
+ | промпт / prompt | 提示词 |
107
+ | инструменты / tools | 工具 |
108
+ | рабочая директория / working directory | 工作目录 |
109
+ | дашборд / dashboard | 仪表盘 |
110
+ | панель / panel | 面板 |
111
+ | локальный ИИ / local AI | 本地 AI |
112
+ | триаж / triage | 分诊 |
113
+ | теневой режим / shadow | 影子模式 |
114
+ | хук / hook | 钩子 |
115
+
116
+ **Правила перевода**
117
+ 1. Источник истины — `en.json`; `ru.json` — смысловой эталон (в нём есть нюансы).
118
+ 2. Технические токены не переводятся: `cron`, `JSON`, `SQLite`, `MCP`, `DAG`,
119
+ `HMAC`, `URL`, `ID`, `GUI`, `OpenCode`, `Telegram`, `Ollama`, `glob`, имена
120
+ инструментов (`schedule_task` и т.п.), ключи конфигурации, `${secret:NAME}`.
121
+ 3. Плейсхолдеры `{…}` копируются дословно и в том же количестве.
122
+ 4. Пунктуация — полноширинные знаки для китайского предложения (`,` `。` `:`),
123
+ но `…` в конце обрезанных строк и типографские кавычки сохраняют смысл.
124
+ Кавычки вокруг имён — `“…”` или прямые, единообразно по всему файлу.
125
+ 5. Единый стиль: краткие подписи полей — без точки; предложения — с `。`;
126
+ ошибки и предупреждения — законченные предложения.
127
+
128
+ ---
129
+
130
+ ## 3. Задачи и подзадачи
131
+
132
+ Правило работы: **ровно одна подзадача за итерацию**, после каждой — отчёт
133
+ (раздел 5). Статус: `[ ]` не начато, `[~]` в работе, `[x]` готово.
134
+
135
+ ### Задача T1. Контракт локали и инфраструктура
136
+
137
+ - [x] **S01. Контракт `zh` + скелет каталога + контрактные тесты** — выполнено 16.11.2026:
138
+ `src/i18n.ts`, `locales/zh.json` (скелет), `test-i18n.mjs` (50/50), `scripts/test-locale.mjs`;
139
+ `npm run build`, `node test-docs.mjs` (45/45) — зелёные.
140
+ - `src/i18n.ts`: `Locale = "ru" | "en" | "zh"`, `SUPPORTED_LOCALES = ["ru","en","zh"]`,
141
+ `DEFAULT_LOCALE` остаётся `"ru"`, обновить комментарии.
142
+ - Создать `locales/zh.json` — валидный пустой объект `{}`.
143
+ - `test-i18n.mjs`: `SUPPORTED_LOCALES` = `ru,en,zh`, `isLocale("zh")`,
144
+ `normalizeLocale("zh")`, `catalogPath("zh")`, `availableLocales() = ru,en,zh`,
145
+ fallback `zh → ru` на пустом каталоге.
146
+ - `scripts/test-locale.mjs`: разрешить `zh`.
147
+ - Проверка: `npm run build`, `node test-i18n.mjs`, `node test-docs.mjs`.
148
+ - [x] **S02. GUI-бандл: импорт и регистрация `zh`** — выполнено 16.11.2026:
149
+ `src/gui.tsx` (`import zhCatalog`, `registerCatalog("zh", zhCatalog)`), в бандле
150
+ присутствует `registerCatalog("zh", {})`; заодно убрано рассинхронизированное
151
+ ограничение локали в контрактах: `src/rpc.ts` (3 enum `["ru","en"]` → `["ru","en","zh"]`),
152
+ `src/index.ts` (`manage_settings.locale` enum + описание).
153
+ - `src/gui.tsx`: `import zhCatalog from "../locales/zh.json"`,
154
+ `registerCatalog("zh", zhCatalog)`.
155
+ - Проверка: `npm run build && npm run build:gui`, `node test-gui-bundle.mjs`
156
+ (5/5), `test-i18n.mjs` (50/50), `test-settings.mjs` (12/12),
157
+ `test-agent-tools.mjs` (23/23), `test-docs.mjs` (45/45).
158
+
159
+ ### Задача T2. Базовый и служебный контур (Д01–Д03, Д15)
160
+
161
+ - [x] **S03. `app.*`, `common.*`, `server.*`, `gitTrigger.*`, `dryRun.*` — 47 ключей** — выполнено 16.11.2026:
162
+ 47/47 переведены, плейсхолдеры совпадают, `common.runsCount` — только ветка `other`
163
+ (рендер при 1/2/5/21 проверен). `test-i18n.mjs` блок 8b переведён на подмену
164
+ каталога (`registerCatalog("zh", {})`), чтобы проверка fallback не зависела
165
+ от прогресса перевода. Осталось 725 ключей.
166
+ - `app.dashboardTitle`, `common.runsCount`, все `server.*` (5), `gitTrigger.*` (7),
167
+ `dryRun.*` (33). `common.runsCount` — ветка только `other`.
168
+
169
+ ### Задача T3. Основной GUI-контур (Д04–Д10)
170
+
171
+ - [x] **S04. `gui.core` 1/4 — 58 ключей** (`gui.add` … `gui.dryRunLocalTitle`) — выполнено 16.11.2026:
172
+ 58/58, плейсхолдеры совпадают (`{redacted}`, `{when}`), каталог 105/772, осталось 667.
173
+ - [x] **S05. `gui.core` 2/4 — 58 ключей** (`gui.dryRunMatrixPreview` … `gui.oneShotDelayHint`) — выполнено 16.11.2026:
174
+ 58/58, плюральный `gui.dryRunMatrixPreview` только с веткой `other` (рендер 1/2/5/21),
175
+ каталог 163/772, осталось 609.
176
+ - [x] **S06. `gui.core` 3/4 — 58 ключей** (`gui.oneShotDelayPlaceholder` … `gui.sendTestNotification`) — выполнено 16.11.2026:
177
+ 58/58 (профили, pre/post-flight, Quality Gate, тихие часы, секреты, шаблоны),
178
+ каталог 221/772, осталось 551; плейсхолдеры и пустые значения — 0 проблем.
179
+ - [x] **S07. `gui.core` 4/4 — 56 ключей** (`gui.sending` … `gui.zeroUnlimited`) — выполнено 16.11.2026:
180
+ 56/56 (сессии, шаблоны, tool-limits, триггеры, время/окна, зимний режим, рабочий каталог),
181
+ каталог 277/772, осталось 495; деталь Д04 (`gui.core`, 230) закрыта полностью.
182
+ - [x] **S08. `gui.job.*` — 50 ключей** — выполнено 16.11.2026: каталог 327/772,
183
+ осталось 445; деталь Д05 закрыта. `gui.job.watchGlobsCount` — только `other`
184
+ («✳ {count, plural, other {# 个模式}}»). «планировщик ОС» → 操作系统计划程序,
185
+ задача планировщика → 任务计划程序. Единственная опечатка (дубль «矩阵» в
186
+ `gui.job.fanoutTitle`) поймана до мержа.
187
+ - [x] **S09. `gui.toast.*` — 66 ключей** (закрывает Д06) — выполнено 16.11.2026:
188
+ 66/66 переведено, каталог 393/772, осталось 379. Тосты — короткие подтверждения
189
+ без точки (кроме фраз, где точка есть в EN: `noFileForImport`, `promptRequired`).
190
+ Профили — 配置档 (не 配置文件). Рендер `exported`/`paused`/`profileSwitchFailed`
191
+ проверен, плейсхолдеры 0 расхождений.
192
+ - [ ] **S10. `gui.validation.*` + `gui.history*` — 28 ключей**
193
+ - [x] **S11. Микрогруппы GUI — 36 ключей** — выполнено 16.11.2026: `gui.logs.*` (4), `gui.jobStatus.*` (8), `gui.priority*` (6), `gui.weekday*` (8), `gui.templates*` (3), `gui.promptTemplates*` (7). Каталог 457/772, осталось 315. Плейсхолдеры 0 расхождений, пустых нет, плюральных ключей в срезе нет, test-i18n 50/50, test-docs 45/45.
194
+ - [x] **S12. `gui.matrix*` + `gui.workspace*` — 43 ключей** — выполнено 16.11.2026: `gui.matrix.*` (21) + `gui.workspace.*` (22). Каталог 500/772, осталось 272. Плюральный `gui.matrixWillCreate` — только ветка `other`, рендер 1/2/5 проверен. Плейсхолдеры 0 расхождений, пустых нет, test-i18n 50/50, test-docs 45/45.
195
+
196
+ > «`gui.core` 1/4…4/4» — срез алфавитно отсортированного списка ключей `gui.*`
197
+ > **без** `gui.job.*`, `gui.jobStatus.*`, `gui.toast.*`, `gui.validation.*`,
198
+ > `gui.history*`, `gui.workspace*`, `gui.matrix*`, `gui.promptTemplates*`,
199
+ > `gui.templates*`, `gui.priority*`, `gui.weekday*`, `gui.logs*` (230 ключей),
200
+ > границы указаны первой и последней клавишей среза включительно.
201
+ > `gui.dryRunMatrixPreview`, `gui.job.watchGlobsCount`, `gui.matrixWillCreate` —
202
+ > плюральные, только ветка `other`.
203
+
204
+ ### Задача T4. Локальный ИИ, матрица, уведомления, планировщик (Д11–Д14, Д16)
205
+
206
+ - [x] **S13/S14. `localAi.*` — 64 ключа (32/32 + 32/32)** — выполнено 16.11.2026: `localAi.*` (64). Каталог 564/772, осталось 208. Плейсхолдеры 0 расхождений, пустых нет, все 4 плюральных ключа только `other`, test-i18n 50/50, test-docs 45/45.
207
+ - [x] **S15. `matrix.*` + `shadow.*` + `schedule.*` — 46 ключей (16 + 9 + 21)** — выполнено 16.11.2026: `matrix.*` (21) + `shadow.*` (9) + `schedule.*` (16). Каталог 610/772, осталось 162. Плейсхолдеры 0 расхождений, пустых нет, все 4 плюральных ключа только `other`, test-i18n 50/50, test-docs 45/45.
208
+ - [x] **S16. `notify.*` — 46 ключей** — выполнено 16.11.2026: `notify.*` (46). Каталог 656/772, осталось 116. Плейсхолдеры 0 расхождений, пустых нет, все 4 плюральных ключа только `other`, test-i18n 50/50, test-docs 45/45.
209
+
210
+ ### Задача T5. Инструменты агента (Д17)
211
+
212
+ - [x] **S17. `tool.*` 1/2 — 58 ключей** (`tool.error.allowedToolsEmpty` … `tool.matrix.parentMissing`) — выполнено 16.11.2026.
213
+ - [x] **S18. `tool.*` 2/2 — 58 ключей** (`tool.matrix.recreateFailed` … `tool.workspace.notFound`) — выполнено 16.11.2026.
214
+ `tool.*` (116 ключей) полностью переведен. Каталог 772/772 — **все ключи переведены**.
215
+ Плейсхолдеры 0 расхождений, пустых нет, все 4 плюральных ключа только `other`, test-i18n 50/50, test-docs 45/45.
216
+
217
+ ### Задача T6. Контроль качества и документация
218
+
219
+ - [x] **S19. Скрипт валидации локали** `scripts/check-zh-locale.mjs` + `npm run test:zh` — выполнено 17.11.2026:
220
+ - JSON валиден; набор ключей = `en.json` (772/772, 0 пропусков, 0 пустых);
221
+ - набор `{placeholder}` по каждому ключу совпадает с `en.json` (0 расхождений);
222
+ - плюральные ключи содержат только `other` (4 ключа, все OK);
223
+ - эвристика CJK: 0 ошибок, 1 предупреждение на `notify.native.title` = `OpenCode Scheduler` (название продукта, как в RU);
224
+ - `npm run test:zh` → все 58 сюит зелёные под локалью `zh`.
225
+ - [x] **S20. Полный прогон** — выполнено 17.11.2026: `npm run build` (tsc) OK,
226
+ `npm run build:gui` OK (371.63 kB с встроенным zh каталогом), `npm test`
227
+ → exit 0 (все сюит зелёные, регрессий ru/en нет), `npm run test:zh` → все
228
+ 58 сюит зелёные под локалью `zh`.
229
+ - [ ] **S21. Документация**: `README.md`, `docs/README.ru.md`, `docs/README.zh.md`
230
+ `node test-i18n.mjs`, `node test-docs.mjs`, `node test-gui-bundle.mjs`,
231
+ `node scripts/test-locale.mjs zh`, `npm test`.
232
+ - [x] **S21. Документация** — выполнено 17.11.2026:
233
+ - `docs/README.zh.md` — раздел «Язык» обновлён: три локали (ru/en/zh), `locale: "zh"`, `locales/zh.json`;
234
+ - `README.md` — уже содержал ссылки `[Русский]` и `[中文]` (строка 239);
235
+ - `docs/README.ru.md` — уже содержал ссылки `[English]` и `[中文]` (строка 10);
236
+ - `CHANGELOG.md` — добавлен раздел `[Unreleased]` с описанием zh локали (772 ключей, manage_settings locale, GUI-бандл).
237
+ - [x] **S22. Приёмочный отчёт** — выполнено 17.11.2026 (см. отчёт ниже). План закрыт.
238
+
239
+ ### Задача T7. Привязка языка планировщика к языку OpenCode
240
+
241
+ Выполняется после S02 (обе подзадачи трогают `src/gui.tsx`).
242
+
243
+ - [x] **S23. Маппинг BCP 47 и режим `auto`** — выполнено 17.11.2026:
244
+ - `i18n.ts`: `LocaleMode = "auto" | Locale`, `LOCALE_AUTO`, `isLocaleMode`,
245
+ `mapAppLocale` (префиксный маппинг; регистр и `-`/`_` не важны),
246
+ `normalizeLocale` теперь через `mapAppLocale`, `normalizeLocaleMode`,
247
+ `resolveLocale` (серверный `auto` → `DEFAULT_LOCALE`);
248
+ - `settings.ts`: `locale: LocaleMode`; load/save через `normalizeLocaleMode`
249
+ (старые `ru`/`en` читаются как раньше, `zh-CN` → `zh`, неизвестное → `ru`);
250
+ - `gui.tsx`: сигнал `localeMode`, `appLocale()` из реактивного `ctx.locale.locale()`,
251
+ `createEffect` для следования за OpenCode при `auto`, `applyLocaleMode`,
252
+ селектор языка в шапке панели (Авто / Русский / English / 中文),
253
+ сохранение через `persistSettings({ locale })`;
254
+ - `rpc.ts` (3 схемы) и `index.ts` (`manage_settings`): enum += `auto`,
255
+ сервер применяет `setLocale(resolveLocale(...))`;
256
+ - ключи `gui.languageAuto/En/Ru/Title/Zh` в ru/en/zh (777 ключей, паритет);
257
+ - проверки: `test-i18n.mjs` 69/69 (`zh-CN`, `zh-Hans`, `en-GB`, `ru-RU`,
258
+ `de-DE`, режим `auto`), `test-settings.mjs` 18/18 (default `ru`, `auto`,
259
+ `zh-CN`→`zh`, `en-GB`→`en`, неизвестное→`ru`), `check-zh-locale.mjs` 0 ошибок,
260
+ `npm test` exit 0, `npm run test:zh` 58 сюит, `build`/`build:gui` OK (373.58 kB).
261
+ - [x] **S24. Синхронизация с серверным процессом и документация** — выполнено 17.11.2026:
262
+ - `ctx.locale` существует только в окне; уведомления, дайджест, Telegram,
263
+ tool-результаты и дашборд рендерятся на сервере. При `auto` GUI отправляет
264
+ разрешённую локаль в `save_settings` (только при изменении) в новом поле
265
+ `uiLocale`; сервер хранит её как «последнюю известную локаль интерфейса»
266
+ и применяет через `resolveLocale(mode, uiLocale)`;
267
+ - `direction()` (`ltr`/`rtl`) не используется — для `zh` всегда `ltr`;
268
+ зафиксировано как задел на будущее (RTL-локалей в плане нет);
269
+ - обновлены `test-i18n.mjs` (71/71: `resolveLocale("auto", ...)`),
270
+ `test-settings.mjs` (21/21: `uiLocale` по умолчанию `ru`, сохранение,
271
+ `auto` + `uiLocale: "en-GB"` → `en`), `README.md`, `docs/README.ru.md`,
272
+ `docs/README.zh.md`, `docs/ARCHITECTURE.md`, `CHANGELOG.md`, раздел рисков;
273
+ - `npm run build` OK, `npm run build:gui` OK, `npm test` exit 0,
274
+ `npm run test:zh` 58 сюит, `check-zh-locale.mjs` 0 ошибок (777 ключей).
275
+
276
+ Итого контента: 47 + 230 + 50 + 66 + 28 + 36 + 43 + 64 + 46 + 46 + 116 = **772 ключа**.
277
+
278
+ ---
279
+
280
+ ## 4. Критерии готовности (Definition of Done)
281
+
282
+ 1. `locales/zh.json` — валидный JSON, 772 ключа, набор идентичен `en.json`.
283
+ 2. Для каждого ключа набор плейсхолдеров совпадает с `en.json` (0 расхождений).
284
+ 3. 4 плюральных ключа используют `other` и корректно рендерятся при `count = 1`, `2`, `5`, `21`.
285
+ 4. `zh` доступна как локаль: `setLocale("zh")`, `manage_settings` c `locale: "zh"`,
286
+ переключение без перезапуска; GUI-бандл содержит каталог.
287
+ 5. Все проверки S19–S20 зелёные; `npm test` без регрессий (ru/en не затронуты).
288
+ 6. Документация перечисляет три локали; план отмечен выполненным.
289
+
290
+ ## 5. Формат отчёта после подзадачи
291
+
292
+ ```
293
+ ## Отчёт S<NN> — <название>
294
+ Объём: N ключей (<диапазон/группы>)
295
+ Изменено: <файлы>
296
+ Проверено: <команды> → <результат>
297
+ Замечания: <риски, отклонения, спорные термины>
298
+ Следующая подзадача: S<NN+1> — <название>
299
+ ```
300
+
301
+ ## 6. Риски и ограничения
302
+
303
+ - **Смешанный язык до S18.** Пока каталог неполон, недостающие ключи падают в `ru`
304
+ (fallback). Это ожидаемо и не является дефектом.
305
+ - **GUI-строки в `gui.tsx` не все через `t()`** (часть текста дашборда остаётся
306
+ русской по дизайну, см. `docs/README.zh.md`). Задача — каталог, а не рефакторинг
307
+ всех литералов.
308
+ - **Длина строк.** Китайский компактнее, но кнопки/бейджи с `white-space:nowrap`
309
+ могут требовать визуальной проверки — отметить в S22, не блокирует каталог.
310
+ - **Плюрализация.** `zh` не имеет `one/few/many`; если оставить русские ветки,
311
+ `Intl.PluralRules` их не выберет — это скрытая ошибка, поэтому ветка только `other`.
312
+ - **Порядок ключей.** `zh.json` держим в алфавитном порядке (детерминированные
313
+ срезы, стабильные диффы); функционально порядок не важен.
314
+ - **`auto` и серверный рендер (T7).** Серверный процесс не видит `ctx.locale`,
315
+ поэтому при `auto` он использует `uiLocale` — последнюю локаль, присланную
316
+ открытым окном. Если окно ещё не открывалось (например, после перезапуска
317
+ OpenCode без GUI), уведомления и дашборд остаются на `ru`; это осознанный
318
+ fail-open до появления серверного источника языка.
319
+ - **`direction()` не используется.** Для `ru`/`en`/`zh` всегда `ltr`; RTL-локали
320
+ в плане не заявлены. При добавлении арабского/иврита направление нужно будет
321
+ прокинуть в `dir` панели и дашборда.
322
+ - **Селектор языка.** Отдельного экрана «Settings → Language» в GUI-панели нет:
323
+ переключатель живёт в шапке панели планировщика; документация приведена
324
+ в соответствие (S24).