📦 @goodandready/dsh-russian-lang

Полная русская локализация, умная типографика и исправление раскладки клавиатуры для DeepSeek Harness

  ⭐ Если вам нравится этот плагин, поставьте ему звезду на GitHub — это покажет мне, что плагин вам полезен, и будет мотивировать меня развивать его дальше.
  

  🐛 Если вы нашли баг или хотите предложить новый функционал, создайте issue на GitHub на любом языке — я рассмотрю ваше предложение и реализую полезные идеи в одной из следующих версий плагина.

[!NOTE] Языковая политика проекта: dsh-russian-lang — специализированный плагин русской локализации интерфейса DSH. Каноническая документация ведётся исключительно на русском языке (README.md, README.ru.md). Общее требование трёхъязычной документации к нему не применяется.

⚡ Обзор

dsh-russian-lang — официальный, всеобъемлющий пакет русской локализации для веб-интерфейса DeepSeek Harness (dsh).

Пакет не просто переводит интерфейс ядра и всех популярных плагинов экосистемы, но и добавляет интеллектуальные функции для комфортной русскоязычной работы: 100% ручная вычитка терминов, грамматические формы множественного числа (plural), автоматическую расстановку экранной типографики («ёлочки», длинные тире, неразрывные пробелы) и исправление ошибочно набранного текста на неверной раскладке по горячей клавише Alt+L.

graph LR
    subgraph DSHCore [Ядро DeepSeek Harness]
        DSH[Web UI Интерфейс] --> Loader[Загрузчик локализации dsh-russian-lang]
    end

    subgraph TranslationLayer [Слой перевода и адаптации — 8735 ключей / 100% вычитано]
        Loader --> CoreDict[49 Пространств имён ядра DSH / 2146 ключей]
        Loader --> PluginDict[60+ Плагинов экосистемы DSH / 6589 ключей]
        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 (49 Пространств имён, 2146 ключей)

Диалоги и переписка (conversation): лента сообщений, ветки обсуждений, карточки вызова инструментов, статус генерации и рассуждений (thinking traces).
Модели и провайдеры (settings.models): каталог моделей, параметры инференса, управление токенами и ключами API.
Трейсы рассуждений (trajectory): детальные шаги, параметры вызовов инструментов, временные метки и визуализация размышлений модели.
Настройки ядра (settings, common, settings.theme): параметры подключения, горячие клавиши, системные уведомления, масштабирование шрифтов, модальные окна и подтверждения.
Рабочие области (workspace, subagent): дерево файлов, управление контекстом, запуск и координация субагентов.
Планировщик и инвентарь (schedule.catalog, settings.pluginInventory, settings.plugins): фоновые задания, периодичность, фильтры и каталог установленных плагинов.
Права доступа и безопасность (permission.access, plan, skill): пресеты прав (полный доступ, только чтение, запись в рабочую область), выполнение планов и навыки.

О качестве перевода. Все 8735 ключей интерфейса (2146 ядра + 6589 плагинов) переведены на 100% и вычитаны вручную. Черновой машинный перевод полностью замещён проверенными формулировками (draft = 0). Перевод регулярно валидируется автоматическими линтерами целостности плейсхолдеров, проверкой соблюдения глоссария (glossary.json) и детекторами переполнения верстки. Нашли неточность — кнопка «Сообщить о проблеме перевода» в карточке настроек создаёт готовый issue.

2. 🧩 Встроенный перевод 60+ плагинов экосистемы DSH (6589 ключей)

Локализация автоматически распространяется на все ключевые плагины экосистемы 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. ⌨️ Исправление ошибочной раскладки клавиатуры (Alt+L)

Если вы забыли переключить раскладку и набрали текст латиницей (например, ghjtrn d gzkmt вместо проект в пальто), плагин мгновенно:

Определяет ошибочный ввод в реальном времени;
Показывает ненавязчивую плавающую подсказку над полем ввода;
При нажатии горячей клавиши Alt+L мгновенно конвертирует набранный текст в правильную кириллицу.

6. 🔍 Интерактивный Инспектор перевода и живые оверрайды (Alt+Click / Alt+I)

Мощный встроенный инструмент для инспекции строк интерфейса и мгновенного редактирования переводов на лету:

Точечная инспекция (Alt+Click): зажмите клавишу Alt и кликните по любому элементу интерфейса (кнопке, пункту меню, лейблу), чтобы открыть модальное окно инспектора.
Постоянный режим (Alt+I): переключает интерфейс в интерактивный режим исследования — наведение курсора подсвечивает элементы аккуратной рамкой с бейджем источника (Core, Plugin, DOM, Untranslated), а в правом нижнем углу экрана отображается плавающий статус-виджет с кнопкой быстрого выхода.
Модальное окно инспектора:
- Точное определение системного ключа, пространства имён и типа источника.
- Быстрое копирование ключа или готового стандартизированного Markdown-сниппета для баг-репорта в 1 клик.
- Поле ввода собственного перевода (оверрайда) с кнопкой «Применить»: мгновенно изменяет текст в DOM и сохраняет оверрайд в настройки (russian-lang.overrides) без перезагрузки страницы. Все аналогичные элементы интерфейса обновляются автоматически.
- Кнопка «Сбросить» для мгновенного отката к стандартному словарному переводу.
Управление в карточке настроек (Раздел 4.5):
- Кнопка быстрого включения/выключения инспектора (Alt+I).
- Кнопки «Экспорт JSON» и «Импорт JSON» для резервного копирования, переноса и синхронизации списка ваших оверрайдов между браузерами и рабочими профилями.

7. ⚡ Оптимизации производительности и архитектурная безопасность

Пакетная обработка MutationObserver: оптимизированный наблюдатель мутаций интерфейса с адаптивным debounce (16 мс) предотвращает лавинообразные перерисовки и перерасчёт макета (reflow) при интенсивном рендеринге списков и стриминге LLM-токенов.
Защита HTTP-маршрутов словарей (405 Method Not Allowed): серверные эндпоинты /dict/core, /dict/plugins, /dict/all, /dict/search строго защищены и принимают только безопасные методы GET/HEAD.
Клиентский бандл с запасом: оптимизированная архитектура и компактный бутстрап обеспечивают размер клиентского скрипта 153.7 KiB (запас более 10 KiB до предельного лимита).

8. 🔤 Нативная интеграция в ядро

Плагин нативно регистрирует пункт «Русский» в меню Настройки → Общие → Язык, переключает атрибут `` и активирует встроенный браузерный словарь проверки орфографии (spellcheck).

📦 Установка

dsh plugin --profile web add @goodandready/dsh-russian-lang

После установки откройте веб-интерфейс, перейдите в Настройки → Общие → Язык, выберите «Русский» и обновите страницу.

⚙️ Параметры конфигурации (`settings.yaml`)

Пространство настроек — russian-lang. Схема объявлена в lib/index.js, все поля необязательные:

russian-lang:
  enabled: true          # Русский язык интерфейса
  typography:
    enabled: true        # Ёлочки, длинные тире, неразрывные пробелы
    yo: false            # Восстанавливать «ё» (по умолчанию выключено)
  agentPrompt: false     # Просить агента отвечать по-русски
  overrides: {}          # Свои значения для любых ключей перевода

Проще то же самое — в Настройки → Плагины → Русская локализация.

Исправление раскладки (Alt+L) и браузерный спелчек включаются вместе с русским языком и отдельных ключей не имеют.

📄 Лицензия

⚡ Новые возможности v0.2.9 — Smart Russian UX

Версия v0.2.9 расширяет функционал плагина от чистой локализации до полноценной адаптации пользовательского опыта работы с моделями на русском языке:

Живая экранная типографика в поле ввода (Live Input Typography):
- Автоматическая подстановка кавычек-ёлочек («...») вместо машинных программистских кавычек ("").
- Автоматическая замена двойного дефиса (--) на длинное тире (—).
- Автоматическая замена троеточия (...) на знак многоточия (…).
- Неразрывные пробелы ( ) после однобуквенных и коротких русских предлогов (в, на, с, к, о, у, за, по и др.).
- Строгая изоляция кода: текст внутри инлайн-кода (бэктики `code`) и многострочных блоков ( ```) сохраняется в неизменном виде без искажения синтаксиса.
- (Changed in v0.2.19: устранена деструктивная перезапись поля ввода на input; замена двойного дефиса на тире, кавычек на ёлочки и неразрывных пробелов после предлогов переведена в обработчик keydown с нативным insertText, сохранением фокуса, нативной отмены Ctrl+Z и отсутствием прыжков каретки. Наблюдатель typoObserver переведён только на childList: true, исключая сброс пользовательского выделения текста во время стриминга токенов).
Быстрый переключатель языка (Quick Language Switcher):
- Компактный чип RU ⇄ EN встроен прямо в шапку диалоговой сессии (conversation.session.header.utilities).
- Позволяет мгновенно переключать язык всего интерфейса в один клик без перехода в Настройки.
Русские алиасы слэш-команд (Slash-Command Aliases):
- Мгновенное авто-разворачивание команд при вводе:
  - /цель ➔ /goal
  - /сжать ➔ /compact
  - /план ➔ /plan
  - /экспорт ➔ /export
  - /память ➔ /memory
  - /отзыв ➔ /feedback
  - /разрешения ➔ /permission
Пресеты системных директив агента (Agent Style Presets):
- В карточке настроек плагина доступен выбор канонического стиля ответов для моделей:
  - 💼 Технический эксперт: строгая русская инженерная терминология, аккуратный код, русскоязычные комментарии к архитектуре.
  - 📝 Технический писатель: книжная типографика, Markdown, ГОСТ/RFC-структура документации.
  - ⚡ Лаконичный режим: предельно сжатые и точные ответы без вступительных любезностей.
Локализованный экспорт сессии (Localized Markdown Export):
- Генерация красивого Markdown-файла всей истории диалога с русскими датами, именами ролей («👤 Пользователь», «🤖 Ассистент»), метриками токенов и индикацией вызовов инструментов.
Хоткей транслитерации (Alt+T):
- Мгновенная конвертация набранного транслита в кириллицу и обратно прямо в поле ввода (privet ⇄ привет).
- (Deprecated since v0.2.15: экспериментальный UI-перехватчик удалён для обеспечения беспрепятственного нативного ввода Lexical; программная функция phoneticTranslit сохранена в lib/pure.js).
**Инлайн-

Install

README