@goodandready/dsh-russian-lang 0.3.25 → 0.3.27

package/README.md

@@ -5,7 +5,7 @@
 <h3>Полная русская локализация, умная типографика и исправление раскладки клавиатуры для DeepSeek Harness</h3>
 
 <p align="center">
-  <a href="https://www.npmjs.com/package/@goodandready/dsh-russian-lang"><img src="https://img.shields.io/badge/npm-v0.3.25-6366f1.svg?style=for-the-badge&labelColor=1e1b4b" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/@goodandready/dsh-russian-lang"><img src="https://img.shields.io/badge/npm-v0.3.27-6366f1.svg?style=for-the-badge&labelColor=1e1b4b" alt="npm version"></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-10b981.svg?style=for-the-badge&color=10b981&labelColor=064e3b" alt="license"></a>
   <a href="https://github.com/topics/dsh-plugin"><img src="https://img.shields.io/badge/DSH-Plugin-8b5cf6.svg?style=for-the-badge&labelColor=2e1065" alt="DSH Plugin"></a>
   <a href="https://nodejs.org"><img src="https://img.shields.io/badge/Node-20%2B-f59e0b.svg?style=for-the-badge&labelColor=451a03" alt="Node version"></a>
@@ -14,7 +14,7 @@
 <p align="center">
   <img src="https://img.shields.io/badge/DSH-v0.2.0--rc.2%2B-blue.svg?style=for-the-badge&labelColor=1e1b4b" alt="DSH v0.1.7-rc.2+">
   <img src="https://img.shields.io/badge/Покрытие-100%25-10b981.svg?style=for-the-badge&labelColor=064e3b" alt="Покрытие 100%">
-  <img src="https://img.shields.io/badge/Ключей_UI-8576-6366f1.svg?style=for-the-badge&labelColor=1e1b4b" alt="8576 ключей">
+  <img src="https://img.shields.io/badge/Ключей_UI-8584-6366f1.svg?style=for-the-badge&labelColor=1e1b4b" alt="8584 ключей">
   <img src="https://img.shields.io/badge/Ручная_вычитка-100%25-0ea5e9.svg?style=for-the-badge&labelColor=082f49" alt="100% ручная вычитка">
 </p>
 
@@ -85,7 +85,7 @@ graph LR
 
 ## ✨ Полный обзор возможностей
 
-### 1. 🌐 100% покрытие ядра DSH (59 Пространств имён, 2415 ключей)
+### 1. 🌐 100% покрытие ядра DSH (58 пространств имён, 2 442 ключа)
 * **Диалоги и переписка (`conversation`)**: лента сообщений, ветки обсуждений, карточки вызова инструментов, статус генерации и рассуждений (thinking traces).
 * **Модели и провайдеры (`settings.models`)**: каталог моделей, параметры инференса, управление токенами и ключами API.
 * **Трейсы рассуждений (`trajectory`)**: детальные шаги, параметры вызовов инструментов, временные метки и визуализация размышлений модели.
@@ -94,9 +94,9 @@ graph LR
 * **Планировщик и инвентарь (`schedule.catalog`, `settings.pluginInventory`, `settings.plugins`)**: фоновые задания, периодичность, фильтры и каталог установленных плагинов.
 * **Права доступа и безопасность (`permission.access`, `plan`, `skill`)**: пресеты прав (полный доступ, только чтение, запись в рабочую область), выполнение планов и навыки.
 
-> **О качестве перевода.** Все **8110 ключей интерфейса (2146 ядра + 6589 плагинов) переведены на 100% и вычитаны вручную**. Черновой машинный перевод полностью замещён проверенными формулировками (`draft = 0`). Перевод регулярно валидируется автоматическими линтерами целостности плейсхолдеров, проверкой соблюдения глоссария (`glossary.json`) и детекторами переполнения верстки. Нашли неточность — кнопка «Сообщить о проблеме перевода» в карточке настроек создаёт готовый issue.
+> **О качестве перевода.** Все **8 584 ключа интерфейса (2 442 ядра + 6 142 плагинов) переведены на 100% и вычитаны вручную**. Черновой машинный перевод полностью замещён проверенными формулировками (`draft = 0`). Перевод регулярно валидируется автоматическими линтерами целостности плейсхолдеров, проверкой соблюдения глоссария (`glossary.json`) и детекторами переполнения верстки. Нашли неточность — кнопка «Сообщить о проблеме перевода» в карточке настроек создаёт готовый issue.
 
-### 2. 🧩 Встроенный перевод 65+ плагинов экосистемы DSH (5695 ключей)
+### 2. 🧩 Встроенный перевод 65+ плагинов экосистемы DSH (6 142 ключа)
 Локализация автоматически распространяется на все ключевые плагины экосистемы DeepSeek Harness:
 * **`dsh-session-control`** — расширенное управление сессиями: закрепление диалогов, архив по периодам, просмотр расшифровок и фильтрация шума;
 * **`dsh-kanban` и `task-board`** — канбан-доски задач, карточки, чек-листы, дедлайны, критерии готовности (DoD) и шлюз приёмки (Acceptance Gate);
@@ -149,7 +149,7 @@ graph LR
 
 ### 7. ⚡ Оптимизации производительности и архитектурная безопасность
 * **Пакетная обработка MutationObserver**: оптимизированный наблюдатель мутаций интерфейса с адаптивным debounce (16 мс) предотвращает лавинообразные перерисовки и перерасчёт макета (reflow) при интенсивном рендеринге списков и стриминге LLM-токенов.
-* **Защита HTTP-маршрутов словарей (405 Method Not Allowed)**: серверные эндпоинты `/dict/core`, `/dict/plugins`, `/dict/all`, `/dict/search` строго защищены и принимают только безопасные методы GET/HEAD.
+* **Защита HTTP-маршрутов словарей (405 Method Not Allowed)**: серверные эндпоинты `/api/dsh-russian-lang/dict/core`, `/api/dsh-russian-lang/dict/plugins`, `/api/dsh-russian-lang/dict/all` строго защищены и принимают только безопасные методы GET/HEAD.
 * **Клиентский бандл с запасом**: оптимизированная архитектура и компактный бутстрап обеспечивают размер клиентского скрипта 153.7 KiB (запас более 10 KiB до предельного лимита).
 
 ### 8. 🔤 Нативная интеграция в ядро
@@ -167,22 +167,31 @@ dsh plugin --profile web add @goodandready/dsh-russian-lang
 
 ---
 
-## ⚙️ Параметры конфигурации (`settings.yaml`)
+## ⚙️ Параметры конфигурации (`settings.yaml` / профиль Cordis)
 
-Пространство настроек — `russian-lang`. Схема объявлена в [`lib/index.js`](lib/index.js),
-все поля необязательные:
+В актуальных версиях DSH (v0.2.0-rc.2+, v0.1.7+) конфигурация плагина управляется штатно через managed-форму в веб-интерфейсе (**Настройки → Плагины → Русская локализация**) либо в профиле/конфиге под идентификатором плагина `dsh-russian-lang` (согласно `cordis.patch.yml`).
+
+Для полной обратной совместимости с ранними версиями ядра (DSH <= 0.1.6) плагин также автоматически поддерживает чтение из легаси-пространства `russian-lang`.
+
+Схема параметров объявлена в [`lib/index.js`](lib/index.js), все поля необязательные:
 
 ```yaml
-russian-lang:
+# Актуальный формат (DSH v0.2.0-rc.2+ / v0.1.7+):
+dsh-russian-lang:
   enabled: true          # Русский язык интерфейса
   typography:
     enabled: true        # Ёлочки, длинные тире, неразрывные пробелы
     yo: false            # Восстанавливать «ё» (по умолчанию выключено)
   agentPrompt: false     # Просить агента отвечать по-русски
   overrides: {}          # Свои значения для любых ключей перевода
+
+# Легаси-формат (DSH <= 0.1.6, поддерживается автоматически как fallback):
+# russian-lang:
+#   enabled: true
+#   ...
 ```
 
-Проще то же самое — в **Настройки → Плагины → Русская локализация**.
+Удобнее всего настраивать параметры визуально в интерфейсе: **Настройки → Плагины → Русская локализация**.
 
 Исправление раскладки (<kbd>Alt+L</kbd>) и браузерный спелчек включаются вместе с
 русским языком и отдельных ключей не имеют.

package/bin/dsh-i18n.mjs

@@ -6,6 +6,10 @@ import { fileURLToPath } from 'node:url'
 const __dirname = path.dirname(fileURLToPath(import.meta.url))
 const ROOT = path.resolve(__dirname, '..')
 
+function escapeRegExp(string) {
+  return string.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
+}
+
 function getPkgVersion() {
   try {
     const pkg = JSON.parse(fs.readFileSync(path.join(ROOT, 'package.json'), 'utf8'))
@@ -55,7 +59,7 @@ function extractKeys(targetDir, defaultNs = 'common') {
         walk(fullPath)
       } else if (entry.isFile() && extensions.has(path.extname(entry.name))) {
         const code = fs.readFileSync(fullPath, 'utf8')
-        const tMatches = code.matchAll(/\bt\(\s*['"`]([a-zA-Z0-9_.-]+)['"`]\s*\)/g)
+        const tMatches = code.matchAll(/\bt\(\s*['"`]([a-zA-Z0-9_.-]+)['"`]\s*[,)]/g)
         for (const m of tMatches) {
           result[defaultNs][m[1]] = result[defaultNs][m[1]] || ''
         }
@@ -88,6 +92,11 @@ function validateDict(filePath, glossaryPath) {
     return false
   }
 
+  if (!data || typeof data !== 'object' || Array.isArray(data)) {
+    console.error(`Ошибка структуры JSON в ${filePath}: корневой элемент должен быть объектом`)
+    return false
+  }
+
   let errors = []
   let warnings = []
   let totalKeys = 0
@@ -103,7 +112,7 @@ function validateDict(filePath, glossaryPath) {
   function checkString(ns, key, val) {
     totalKeys++
     if (typeof val !== 'string') {
-      errors.push(`[${ns}:${key}] Значение должно быть строкой, получено: ${typeof val}`)
+      errors.push(`[${ns}:${key}] Значение должно быть строкой, получено: ${val === null ? 'null' : Array.isArray(val) ? 'массив' : typeof val}`)
       return
     }
 
@@ -117,13 +126,12 @@ function validateDict(filePath, glossaryPath) {
     }
 
     if (glossary) {
-      const lower = val.toLowerCase()
       for (const [term, info] of Object.entries(glossary)) {
         if (Array.isArray(info.forbidden)) {
           for (const forbidden of info.forbidden) {
-            const fLow = forbidden.toLowerCase()
-            const re = new RegExp(`\\b${fLow}\\b`, 'i')
-            if (re.test(lower)) {
+            const esc = escapeRegExp(forbidden)
+            const re = new RegExp(`(?<=[^\\p{L}\\p{N}]|^)${esc}(?=[^\\p{L}\\p{N}]|$)`, 'iu')
+            if (re.test(val)) {
               warnings.push(`[${ns}:${key}] Запрещённый термин по глоссарию "${forbidden}" (рекомендуется: "${info.canonical}")`)
             }
           }
@@ -134,10 +142,12 @@ function validateDict(filePath, glossaryPath) {
 
   for (const ns of Object.keys(data)) {
     const section = data[ns]
-    if (typeof section === 'object' && section !== null) {
-      for (const [k, v] of Object.entries(section)) {
-        checkString(ns, k, v)
-      }
+    if (!section || typeof section !== 'object' || Array.isArray(section)) {
+      errors.push(`[${ns}] Пространство имён должно быть объектом, получено: ${section === null ? 'null' : Array.isArray(section) ? 'массив' : typeof section}`)
+      continue
+    }
+    for (const [k, v] of Object.entries(section)) {
+      checkString(ns, k, v)
     }
   }
 

package/glossary.json

@@ -0,0 +1,206 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "version": "1.0.0",
+  "description": "Канонический глоссарий терминов DeepSeek Harness (DSH) и AI-экосистемы",
+  "terms": {
+    "workspace": {
+      "canonical": "Рабочая область",
+      "allowed": [
+        "Рабочая область",
+        "Воркспейс"
+      ],
+      "forbidden": [
+        "Рабочее место",
+        "Рабочий стол",
+        "Пространство задач"
+      ],
+      "description": "Изолированная рабочая директория/проект агента"
+    },
+    "subagent": {
+      "canonical": "Субагент",
+      "allowed": [
+        "Субагент",
+        "Дочерний агент"
+      ],
+      "forbidden": [
+        "Подагент",
+        "Младший агент",
+        "Вспомогательный агент"
+      ],
+      "description": "Автономный дочерний агент"
+    },
+    "prompt": {
+      "canonical": "Промпт",
+      "allowed": [
+        "Промпт",
+        "Инструкция",
+        "Системный промпт"
+      ],
+      "forbidden": [
+        "Затравка",
+        "Побуждение",
+        "Внушение"
+      ],
+      "description": "Инструкция или текстовый ввод для модели"
+    },
+    "tool": {
+      "canonical": "Инструмент",
+      "allowed": [
+        "Инструмент",
+        "Вызов инструмента"
+      ],
+      "forbidden": [
+        "Орудие",
+        "Утилита"
+      ],
+      "description": "Функция или инструмент, вызываемый агентом (tool/tool call)"
+    },
+    "session": {
+      "canonical": "Сессия",
+      "allowed": [
+        "Сессия",
+        "Диалог",
+        "Чат"
+      ],
+      "forbidden": [
+        "Заседание",
+        "Сеанс связи"
+      ],
+      "description": "Отдельный поток диалога или сессия работы"
+    },
+    "skill": {
+      "canonical": "Навык",
+      "allowed": [
+        "Навык",
+        "Навыки",
+        "Skill"
+      ],
+      "forbidden": [
+        "Умение",
+        "Мастерство"
+      ],
+      "description": "Подключаемый модуль навыков агента"
+    },
+    "plugin": {
+      "canonical": "Плагин",
+      "allowed": [
+        "Плагин",
+        "Плагины"
+      ],
+      "forbidden": [
+        "Встраиваемый модуль"
+      ],
+      "description": "Плагин Cordis / DSH"
+    },
+    "provider": {
+      "canonical": "Провайдер",
+      "allowed": [
+        "Провайдер",
+        "Провайдеры"
+      ],
+      "forbidden": [
+        "Поставщик",
+        "Поставщики"
+      ],
+      "description": "Провайдер LLM API (OpenAI, DeepSeek, Ollama и др.)"
+    },
+    "token": {
+      "canonical": "Токен",
+      "allowed": [
+        "Токен",
+        "Токены"
+      ],
+      "forbidden": [
+        "Жетон",
+        "Жетоны"
+      ],
+      "description": "Единица расхода контекста LLM"
+    },
+    "thinking": {
+      "canonical": "Размышления",
+      "allowed": [
+        "Размышления",
+        "Рассуждения",
+        "Цепочка рассуждений"
+      ],
+      "forbidden": [
+        "Думание",
+        "Мышление модели"
+      ],
+      "description": "Трейс внутренних рассуждений (thinking traces) модели"
+    },
+    "effort": {
+      "canonical": "Уровень рассуждений",
+      "allowed": [
+        "Уровень рассуждений",
+        "Усилие рассуждений",
+        "Усилие"
+      ],
+      "forbidden": [
+        "Старание",
+        "Напряжение"
+      ],
+      "description": "Параметр reasoning effort модели"
+    },
+    "approval": {
+      "canonical": "Подтверждение",
+      "allowed": [
+        "Подтверждение",
+        "Одобрение"
+      ],
+      "forbidden": [
+        "Апробация",
+        "Санкционирование"
+      ],
+      "description": "Запрос подтверждения опасного действия пользователем"
+    },
+    "deliverables": {
+      "canonical": "Результаты работы",
+      "allowed": [
+        "Результаты работы",
+        "Файлы результатов",
+        "Результаты"
+      ],
+      "forbidden": [
+        "Поставки",
+        "Доставляемые элементы"
+      ],
+      "description": "Созданные агентом итоговые файлы"
+    },
+    "branch": {
+      "canonical": "Ветка",
+      "allowed": [
+        "Ветка",
+        "Ветвление"
+      ],
+      "forbidden": [
+        "Ответвление",
+        "Ветвь"
+      ],
+      "description": "Ветка диалога или Git-ветка"
+    },
+    "checkpoint": {
+      "canonical": "Контрольная точка",
+      "allowed": [
+        "Контрольная точка",
+        "Чекпоинт"
+      ],
+      "forbidden": [
+        "Точка проверки",
+        "Контрольный пункт"
+      ],
+      "description": "Точка сохранения состояния сессии или памяти"
+    },
+    "command_code": {
+      "canonical": "Command Code",
+      "allowed": [
+        "Command Code"
+      ],
+      "forbidden": [
+        "Код команды",
+        "Командный код"
+      ],
+      "description": "Название провайдера и расширения Command Code (commandcode.ai)"
+    }
+  }
+}