dsh-russian-lang

📦 @goodandready/dsh-russian-lang

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

🇷🇺 Русский • 🇨🇳 中文说明 • 📐 Design Contract

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

⚡ Обзор

`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 [Слой перевода и адаптации — 10 432 ключей / 100% вычитано]
        Loader --> CoreDict[58 Пространств имён ядра DSH / 2 442 ключа]
        Loader --> PluginDict[43 Пространства имён плагинов DSH / 7 781 ключа]
        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 (58 пространств имён, 2 442 ключа)

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

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

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

Локализация автоматически распространяется на все ключевые плагины экосистемы 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): серверные эндпоинты /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. 🔤 Нативная интеграция в ядро

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

📦 Установка

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

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

⚙️ Параметры конфигурации (settings.yaml / профиль Cordis)

В актуальных версиях 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, все поля необязательные:

# Актуальный формат (DSH v0.2.0-rc.2+ / v0.1.7+):
dsh-russian-lang:
  enabled: true                    # Русский язык интерфейса (по умолчанию: true)
  overrides: {}                    # Пользовательские оверрайды ключей (по умолчанию: {})
  typography:                      # Интеллектуальная типографика (по умолчанию: все opt-in false)
    enabled: false                 # Ёлочки, длинные тире, неразрывные пробелы
    yo: false                      # Восстановление безопасной буквы «ё»
    liveInput: false               # Живая типографика при вводе в текстовых полях
  agentPrompt: false               # Системная инструкция агенту отвечать по-русски (по умолчанию: false)
  agentPromptPreset: technical_expert # Пресет системного промпта (по умолчанию: technical_expert)
  slashAliases: true               # Русские алиасы слэш-команд (/помощь, /очистить) (по умолчанию: true)
  layoutConversion: true           # Детектор неверной раскладки и подсказка Alt+L (по умолчанию: true)
  quickSwitch: true                # Быстрый переключатель RU/EN в статусной строке (по умолчанию: true)
  translateEngine: off             # Движок перевода реплик: off, local (LibreTranslate) или google (Google) (по умолчанию: off)
  localApiUrl: http://localhost:5000 # URL локального инстанса LibreTranslate (по умолчанию: http://localhost:5000)

# Легаси-формат (DSH <= 0.1.6, поддерживается автоматически как fallback):
# russian-lang:
#   enabled: true
#   ...

Удобнее всего настраивать параметры визуально в интерфейсе: Настройки → Плагины → Русская локализация.

Исправление раскладки (Alt+L) и русские алиасы слэш-команд включены по умолчанию (true) и могут быть индивидуально отключены в настройках (layoutConversion: false, slashAliases: false). Браузерный спелчек (lang="ru-RU") активируется автоматически при выборе русской локали.

🛠 Разработка и зеркало репозитория

Публичный репозиторий на GitHub является дистрибутивным зеркалом релизов @goodandready/dsh-russian-lang. Основная разработка, сборочный пайплайн и полный тестовый контур ведутся в основном Gitea-репозитории проекта.

Pull Requests и Issues на GitHub приветствуются и обрабатываются в обычном порядке! Для внесения правок в логику клиента используйте lib/client.template.js. Запуск npm test в репозитории выполняет полную проверку (270+ модульных тестов Node.js, тесты сборщика, линтеры переводов и глоссария).

📄 Лицензия

MIT © GooDAnDReaDY

Движок перевода реплик

Плагин позволяет переводить ответы модели на русский язык. Для этого используется один из двух движков — по выбору пользователя в настройках. По умолчанию оба движка выключены (translateEngine: off).

Google Translate (неофициальный)

Текст ответов модели отправляется на translate.googleapis.com/translate_a/single?client=gtx — это неофициальный публичный эндпоинт Google без SLA и без гарантий доступности. В ответах модели могут содержаться фрагменты кода, пути, содержимое файлов — всё это уходит третьей стороне. При включении в карточке настроек отображается жёлтый бейдж.

LibreTranslate (локальный)

Плагин запускает Docker-контейнер libretranslate/libretranslate:v1.5.3 на 127.0.0.1:5000. Перевод выполняется полностью локально — текст не покидает машину. Для работы необходим установленный Docker.

Движок · Куда уходит текст · Приватность · Интернет off (по умолчанию) · никуда · ✅ полная · не нужен google · Google (googleapis.com) · ⚠️ текст отправляется третьей стороне · нужен libretranslate · localhost:5000 (Docker) · ✅ локально · нужен только для загрузки образа

[!NOTE]

Ограничение системного меню Electron:

Пункты системного меню десктопной оболочки Electron (Application, Edit, File, Quit, Undo/Redo/Cut/Copy/Paste и др.) принадлежат главному процессу Electron (app.asar) на уровне операционной системы и не подлежат переводу веб-плагинами DSH.