@goodandready/dsh-russian-lang 0.2.13 → 0.2.15

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.2.13-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.2.15-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.1.5--rc.1%2B-blue.svg?style=for-the-badge&labelColor=1e1b4b" alt="DSH v0.1.5-rc.1+">
   <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-5765-6366f1.svg?style=for-the-badge&labelColor=1e1b4b" alt="5765 ключей">
+  <img src="https://img.shields.io/badge/Ключей_UI-6629-6366f1.svg?style=for-the-badge&labelColor=1e1b4b" alt="6629 ключей">
   <img src="https://img.shields.io/badge/Ручная_вычитка-100%25-0ea5e9.svg?style=for-the-badge&labelColor=082f49" alt="100% ручная вычитка">
 </p>
 
@@ -26,6 +26,16 @@
   <img src="docs/media/banner.jpg" alt="dsh-russian-lang hero banner" width="100%">
 </p>
 
+<table align="center">
+  <tr>
+    <td align="center">
+      ⭐ <strong>Если вам нравится этот плагин, поставьте ему звезду на GitHub</strong> — это покажет мне, что плагин вам полезен, и будет мотивировать меня развивать его дальше.
+      <br><br>
+      🐛 <strong>Если вы нашли баг или хотите предложить новый функционал</strong>, создайте issue на GitHub на любом языке — я рассмотрю ваше предложение и реализую полезные идеи в одной из следующих версий плагина.
+    </td>
+  </tr>
+</table>
+
 </div>
 
 ---
@@ -42,9 +52,9 @@ graph LR
         DSH[Web UI Интерфейс] --> Loader[Загрузчик локализации dsh-russian-lang]
     end
 
-    subgraph TranslationLayer [Слой перевода и адаптации — 5765 ключей / 100% вычитано]
+    subgraph TranslationLayer [Слой перевода и адаптации — 6629 ключей / 100% вычитано]
         Loader --> CoreDict[30+ Пространств имён ядра DSH / 1225 ключа]
-        Loader --> PluginDict[30+ Плагинов экосистемы DSH / 4540 ключ]
+        Loader --> PluginDict[30+ Плагинов экосистемы DSH / 5404 ключ]
         Loader --> PluralEngine[Движок грамматических Plural-форм: 1/2/5]
     end
 
@@ -84,9 +94,9 @@ graph LR
 * **Планировщик и инвентарь (`schedule.catalog`, `settings.pluginInventory`, `settings.plugins`)**: фоновые задания, периодичность, фильтры и каталог установленных плагинов.
 * **Права доступа и безопасность (`permission.access`, `plan`, `skill`)**: пресеты прав (полный доступ, только чтение, запись в рабочую область), выполнение планов и навыки.
 
-> **О качестве перевода.** Все **5765 ключей интерфейса (722 ядра + 3989 плагинов) переведены на 100% и вычитаны вручную**. Черновой машинный перевод полностью замещён проверенными формулировками (`draft = 0`). Перевод регулярно валидируется автоматическими линтерами целостности плейсхолдеров, проверкой соблюдения глоссария (`glossary.json`) и детекторами переполнения верстки. Нашли неточность — кнопка «Сообщить о проблеме перевода» в карточке настроек создаёт готовый issue.
+> **О качестве перевода.** Все **6629 ключей интерфейса (722 ядра + 3989 плагинов) переведены на 100% и вычитаны вручную**. Черновой машинный перевод полностью замещён проверенными формулировками (`draft = 0`). Перевод регулярно валидируется автоматическими линтерами целостности плейсхолдеров, проверкой соблюдения глоссария (`glossary.json`) и детекторами переполнения верстки. Нашли неточность — кнопка «Сообщить о проблеме перевода» в карточке настроек создаёт готовый issue.
 
-### 2. 🧩 Встроенный перевод 30+ плагинов экосистемы DSH (4540 ключ)
+### 2. 🧩 Встроенный перевод 30+ плагинов экосистемы DSH (5404 ключ)
 Локализация автоматически распространяется на все ключевые плагины экосистемы DeepSeek Harness:
 * **`dsh-session-control`** — расширенное управление сессиями: закрепление диалогов, архив по периодам, просмотр расшифровок и фильтрация шума;
 * **`dsh-kanban` и `task-board`** — канбан-доски задач, карточки, чек-листы, дедлайны, критерии готовности (DoD) и шлюз приёмки (Acceptance Gate);
@@ -168,7 +178,6 @@ russian-lang:
 
 MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)
 
-
 ## ⚡ Новые возможности v0.2.9 — Smart Russian UX
 
 Версия **v0.2.9** расширяет функционал плагина от чистой локализации до полноценной адаптации пользовательского опыта работы с моделями на русском языке:
@@ -205,7 +214,7 @@ MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)
 
 6. **Хоткей транслитерации (<kbd>Alt+T</kbd>)**:
    - Мгновенная конвертация набранного транслита в кириллицу и обратно прямо в поле ввода (`privet` ⇄ `привет`).
-   - *(Deprecated since v0.2.13: экспериментальный UI-перехватчик удалён для обеспечения беспрепятственного нативного ввода Lexical; программная функция `phoneticTranslit` сохранена в `lib/pure.js`).*
+   - *(Deprecated since v0.2.15: экспериментальный UI-перехватчик удалён для обеспечения беспрепятственного нативного ввода Lexical; программная функция `phoneticTranslit` сохранена в `lib/pure.js`).*
 
 7. **Инлайн-перевод реплик ассистента (`RU ↗`)**:
    - Кнопка `RU ↗` в панели действий ответа ассистента переводит текст ответа на русский язык с сохранением блоков кода и выводит карточку перевода прямо под сообщением с кнопкой быстрого копирования (`📋 Копировать`).

package/README.ru.md

@@ -0,0 +1,220 @@
+# 📦 @goodandready/dsh-russian-lang
+
+<div align="center">
+
+<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.2.14-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>
+</p>
+
+<p align="center">
+  <img src="https://img.shields.io/badge/DSH-v0.1.5--rc.1%2B-blue.svg?style=for-the-badge&labelColor=1e1b4b" alt="DSH v0.1.5-rc.1+">
+  <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-6002-6366f1.svg?style=for-the-badge&labelColor=1e1b4b" alt="6002 ключей">
+  <img src="https://img.shields.io/badge/Ручная_вычитка-100%25-0ea5e9.svg?style=for-the-badge&labelColor=082f49" alt="100% ручная вычитка">
+</p>
+
+<p align="center">
+  <a href="https://goodandready.app/"><img src="https://img.shields.io/badge/Все_проекты_автора-goodandready.app-ff4500.svg?style=for-the-badge&logo=rocket&logoColor=white&labelColor=1a1a2e" alt="Все проекты автора"></a>
+</p>
+
+<p align="center">
+  <img src="docs/media/banner.jpg" alt="dsh-russian-lang hero banner" width="100%">
+</p>
+
+<table align="center">
+  <tr>
+    <td align="center">
+      ⭐ <strong>Если вам нравится этот плагин, поставьте ему звезду на GitHub</strong> — это покажет мне, что плагин вам полезен, и будет мотивировать меня развивать его дальше.
+      <br><br>
+      🐛 <strong>Если вы нашли баг или хотите предложить новый функционал</strong>, создайте issue на GitHub на любом языке — я рассмотрю ваше предложение и реализую полезные идеи в одной из следующих версий плагина.
+    </td>
+  </tr>
+</table>
+
+</div>
+
+---
+
+## ⚡ Обзор
+
+**`dsh-russian-lang`** — официальный, всеобъемлющий пакет русской локализации для веб-интерфейса [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (dsh).
+
+Пакет не просто переводит интерфейс ядра и всех популярных плагинов экосистемы, но и добавляет интеллектуальные функции для комфортной русскоязычной работы: **100% ручная вычитка терминов**, **грамматические формы множественного числа (plural)**, автоматическую **расстановку экранной типографики** («ёлочки», длинные тире, неразрывные пробелы) и **исправление ошибочно набранного текста** на неверной раскладке по горячей клавише <kbd>Alt+L</kbd>.
+
+```mermaid
+graph LR
+    subgraph DSHCore [Ядро DeepSeek Harness]
+        DSH[Web UI Интерфейс] --> Loader[Загрузчик локализации dsh-russian-lang]
+    end
+
+    subgraph TranslationLayer [Слой перевода и адаптации — 6002 ключей / 100% вычитано]
+        Loader --> CoreDict[30+ Пространств имён ядра DSH / 1225 ключа]
+        Loader --> PluginDict[30+ Плагинов экосистемы DSH / 4777 ключ]
+        Loader --> PluralEngine[Движок грамматических Plural-форм: 1/2/5]
+    end
+
+    subgraph SmartFeatures [Интеллектуальные модули]
+        Loader --> Typo[Модуль типографики: кавычки-«ёлочки» и длинные тире]
+        Loader --> LayoutFix[Детектор неверной раскладки + Hotkey Alt+L]
+        Loader --> Spell[Активация русской проверки орфографии]
+        Loader --> Overrides[Пользовательские переопределения ключей]
+    end
+
+    subgraph Result [Результат]
+        CoreDict --> NativeUI[Нативный русский интерфейс]
+        PluginDict --> NativeUI
+        PluralEngine --> NativeUI
+        Typo --> NativeUI
+        LayoutFix --> NativeUI
+        Spell --> NativeUI
+        Overrides --> NativeUI
+    end
+
+    style DSHCore fill:#1e1e2e,stroke:#89b4fa,stroke-width:2px,color:#cdd6f4
+    style TranslationLayer fill:#181825,stroke:#cba6f7,stroke-width:2px,color:#cdd6f4
+    style SmartFeatures fill:#11111b,stroke:#a6e3a1,stroke-width:2px,color:#cdd6f4
+    style Result fill:#181825,stroke:#f38ba8,stroke-width:2px,color:#cdd6f4
+```
+
+---
+
+## ✨ Полный обзор возможностей
+
+### 1. 🌐 100% покрытие ядра DSH (30+ Пространств имён, 1225 ключа)
+* **Диалоги и переписка (`conversation`)**: лента сообщений, ветки обсуждений, карточки вызова инструментов, статус генерации и рассуждений (thinking traces).
+* **Модели и провайдеры (`settings.models`)**: каталог моделей, параметры инференса, управление токенами и ключами API.
+* **Трейсы рассуждений (`trajectory`)**: детальные шаги, параметры вызовов инструментов, временные метки и визуализация размышлений модели.
+* **Настройки ядра (`settings`, `common`, `settings.theme`)**: параметры подключения, горячие клавиши, системные уведомления, масштабирование шрифтов, модальные окна и подтверждения.
+* **Рабочие области (`workspace`, `subagent`)**: дерево файлов, управление контекстом, запуск и координация субагентов.
+* **Планировщик и инвентарь (`schedule.catalog`, `settings.pluginInventory`, `settings.plugins`)**: фоновые задания, периодичность, фильтры и каталог установленных плагинов.
+* **Права доступа и безопасность (`permission.access`, `plan`, `skill`)**: пресеты прав (полный доступ, только чтение, запись в рабочую область), выполнение планов и навыки.
+
+> **О качестве перевода.** Все **6002 ключей интерфейса (722 ядра + 3989 плагинов) переведены на 100% и вычитаны вручную**. Черновой машинный перевод полностью замещён проверенными формулировками (`draft = 0`). Перевод регулярно валидируется автоматическими линтерами целостности плейсхолдеров, проверкой соблюдения глоссария (`glossary.json`) и детекторами переполнения верстки. Нашли неточность — кнопка «Сообщить о проблеме перевода» в карточке настроек создаёт готовый issue.
+
+### 2. 🧩 Встроенный перевод 30+ плагинов экосистемы DSH (4777 ключ)
+Локализация автоматически распространяется на все ключевые плагины экосистемы DeepSeek Harness:
+* **`dsh-session-control`** — расширенное управление сессиями: закрепление диалогов, архив по периодам, просмотр расшифровок и фильтрация шума;
+* **`dsh-kanban` и `task-board`** — канбан-доски задач, карточки, чек-листы, дедлайны, критерии готовности (DoD) и шлюз приёмки (Acceptance Gate);
+* **`dsh-cost-meter`** — учёт стоимости токенов, калькуляция расходов и тарифные сетки моделей в реальном времени;
+* **`dsh-goal`** — автономный целеполагающий агент с безопасным циклом и рефлексией;
+* **`dsh-moa`** — многоагентная архитектура Mixture-of-Agents;
+* **`dsh-context-lens` и `dsh-context`** — визуализатор и оптимизатор контекста, аналитика токенов и сжатие;
+* **`dsh-time-machine`** — снимки рабочей области и откат состояний файлов;
+* **`dsh-shadow-auditor`** — теневой аудит изменений и безопасность;
+* **`dsh-cron` и `schedule.catalog`** — планировщик периодических cron-задач;
+* **`dsh-clinebot` и `im-hub`** — интеграции и шлюзы для Telegram, Discord, Slack;
+* **`dsh-subscriptions`** — управление персональными подписками на модели;
+* **`dsh-voice` и `dsh-tts`** — распознавание речи и голосовое озвучивание;
+* **`dsh-image-gen`** — генерация изображений;
+* **`dsh-lanmode`** — сетевой доступ по локальной сети и генерация TLS-сертификатов;
+* **`dsh-model-sync`** — синхронизация моделей и эндпоинтов;
+* **`dsh-usage-guard` и `token-dashboard`** — контроль лимитов и аналитика расходов токенов;
+* **`skills-manager` и `dsh-skill-hub`** — менеджер навыков агента и витрина способностей;
+* **`commandcode` и `settings.commandcode`** — провайдеры команд и аккаунты;
+* **`better-sidebar`, `better-input`, `opencode-palette`, `context-doctor`, `plugin-store`, `autoReview`** и др.
+
+### 3. 🔢 Русские грамматические формы числительных (Plural)
+Английский язык различает только `1` и `other`. Русский язык требует 3 грамматические формы числительных (`1 файл`, `2 файла`, `5 файлов` / `1 секунда`, `3 секунды`, `10 секунд`). Движок локализации автоматически подставляет правильные окончания в зависимости от числового значения.
+
+### 4. ✍️ Интеллектуальный модуль типографики (`russian-lang.typography`)
+Автоматически приводит тексты сообщений и описаний к правилам русской экранной типографики:
+* Заменяет прямые "лапки" на правильные кавычки-«ёлочки» (а вложенные — на „лапки“);
+* Заменяет дефисы между словами на длинные тире (—);
+* Добавляет неразрывные пробелы после коротких союзов и предлогов, предотвращая висячие строки;
+* **Безопасность кода**: типографика строго изолирована и никогда не затрагивает блоки исходного кода, формулы LaTeX и моноширинные поля ввода.
+
+### 5. ⌨️ Исправление ошибочной раскладки клавиатуры (<kbd>Alt+L</kbd>)
+Если вы забыли переключить раскладку и набрали текст латиницей (например, `ghjtrn d gzkmt` вместо `проект в пальто`), плагин мгновенно:
+* Определяет ошибочный ввод в реальном времени;
+* Показывает ненавязчивую плавающую подсказку над полем ввода;
+* При нажатии горячей клавиши <kbd>Alt+L</kbd> мгновенно конвертирует набранный текст в правильную кириллицу.
+
+### 6. ⚙️ Пользовательские переопределения (`russian-lang.overrides`)
+Вы можете переопределить абсолютно любой системный ключ перевода под терминологию вашей команды в **Настройки → Плагины → Russian Lang → Переопределения** без редактирования исходного кода.
+
+### 7. 🔤 Нативная интеграция в ядро
+Плагин нативно регистрирует пункт **«Русский»** в меню **Настройки → Общие → Язык**, переключает атрибут `<html lang="ru-RU">` и активирует встроенный браузерный словарь проверки орфографии (`spellcheck`).
+
+---
+
+## 📦 Установка
+
+```bash
+dsh plugin --profile web add @goodandready/dsh-russian-lang
+```
+
+После установки откройте веб-интерфейс, перейдите в **Настройки → Общие → Язык**, выберите **«Русский»** и обновите страницу.
+
+---
+
+## ⚙️ Параметры конфигурации (`settings.yaml`)
+
+Пространство настроек — `russian-lang`. Схема объявлена в [`lib/index.js`](lib/index.js),
+все поля необязательные:
+
+```yaml
+russian-lang:
+  enabled: true          # Русский язык интерфейса
+  typography:
+    enabled: true        # Ёлочки, длинные тире, неразрывные пробелы
+    yo: false            # Восстанавливать «ё» (по умолчанию выключено)
+  agentPrompt: false     # Просить агента отвечать по-русски
+  overrides: {}          # Свои значения для любых ключей перевода
+```
+
+Проще то же самое — в **Настройки → Плагины → Русская локализация**.
+
+Исправление раскладки (<kbd>Alt+L</kbd>) и браузерный спелчек включаются вместе с
+русским языком и отдельных ключей не имеют.
+
+---
+
+## 📄 Лицензия
+
+MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)
+
+## ⚡ Новые возможности v0.2.9 — Smart Russian UX
+
+Версия **v0.2.9** расширяет функционал плагина от чистой локализации до полноценной адаптации пользовательского опыта работы с моделями на русском языке:
+
+1. **Живая экранная типографика в поле ввода (Live Input Typography)**:
+   - Автоматическая подстановка кавычек-ёлочек («...») вместо машинных программистских кавычек (`""`).
+   - Автоматическая замена двойного дефиса (`--`) на длинное тире (`—`).
+   - Автоматическая замена троеточия (`...`) на знак многоточия (`…`).
+   - Неразрывные пробелы (` `) после однобуквенных и коротких русских предлогов (`в`, `на`, `с`, `к`, `о`, `у`, `за`, `по` и др.).
+   - **Строгая изоляция кода**: текст внутри инлайн-кода (бэктики `` `code` ``) и многострочных блоков (``` ``` ```) сохраняется в неизменном виде без искажения синтаксиса.
+
+2. **Быстрый переключатель языка (Quick Language Switcher)**:
+   - Компактный чип `RU ⇄ EN` встроен прямо в шапку диалоговой сессии (`conversation.session.header.utilities`).
+   - Позволяет мгновенно переключать язык всего интерфейса в один клик без перехода в Настройки.
+
+3. **Русские алиасы слэш-команд (Slash-Command Aliases)**:
+   - Мгновенное авто-разворачивание команд при вводе:
+     - `/цель` ➔ `/goal`
+     - `/сжать` ➔ `/compact`
+     - `/план` ➔ `/plan`
+     - `/экспорт` ➔ `/export`
+     - `/память` ➔ `/memory`
+     - `/отзыв` ➔ `/feedback`
+     - `/разрешения` ➔ `/permission`
+
+4. **Пресеты системных директив агента (Agent Style Presets)**:
+   - В карточке настроек плагина доступен выбор канонического стиля ответов для моделей:
+     - 💼 **Технический эксперт**: строгая русская инженерная терминология, аккуратный код, русскоязычные комментарии к архитектуре.
+     - 📝 **Технический писатель**: книжная типографика, Markdown, ГОСТ/RFC-структура документации.
+     - ⚡ **Лаконичный режим**: предельно сжатые и точные ответы без вступительных любезностей.
+
+5. **Локализованный экспорт сессии (Localized Markdown Export)**:
+   - Генерация красивого Markdown-файла всей истории диалога с русскими датами, именами ролей («👤 Пользователь», «🤖 Ассистент»), метриками токенов и индикацией вызовов инструментов.
+
+6. **Хоткей транслитерации (<kbd>Alt+T</kbd>)**:
+   - Мгновенная конвертация набранного транслита в кириллицу и обратно прямо в поле ввода (`privet` ⇄ `привет`).
+   - *(Deprecated since v0.2.14: экспериментальный UI-перехватчик удалён для обеспечения беспрепятственного нативного ввода Lexical; программная функция `phoneticTranslit` сохранена в `lib/pure.js`).*
+
+7. **Инлайн-перевод реплик ассистента (`RU ↗`)**:
+   - Кнопка `RU ↗` в панели действий ответа ассистента переводит текст ответа на русский язык с сохранением блоков кода и выводит карточку перевода прямо под сообщением с кнопкой быстрого копирования (`📋 Копировать`).