🇷🇺 dsh-locale-ru

Нативная русская локализация веб-интерфейса DeepSeek Harness

English

dsh-locale-ru добавляет язык Русский в штатный переключатель DeepSeek Harness и переводит основные поверхности веб-интерфейса. Пакет использует публичный API языковых пакетов, не подменяет внутренние методы приложения и не изменяет DOM после отрисовки.

Автор и сопровождающий: AbsoluteMikhail

Возможности

• 48 пространств перевода и более 1600 строк интерфейса.
• Чат, настройки, рабочие области, плагины, разрешения, терминал, файлы, планы, задания, субагенты и служебные панели.
• Мгновенное переключение языка через Настройки → Общие настройки → Язык.
• Сохранение выбранного языка в штатных настройках профиля.
• Русские формы числительных: 1 вызов, 2 вызова, 5 вызовов, 21 вызов.
• Английский fallback для ключей сторонних плагинов, которых ещё нет в русском словаре.
• Локализованные названия встроенных режимов доступа.
• Автоматическая сверка ключей и плейсхолдеров с совместимой версией Harness.
• Установочный smoke-тест на изолированном реальном профиле web.

flowchart LR
    A[Профиль DSH] --> B[Bundle dsh-locale-ru]
    B --> C[Язык ru]
    B --> D[48 словарей]
    C --> E[Штатный LocaleRuntime]
    D --> E
    E --> F[Русский Web UI]

Установка

Из GitHub

dsh plugin --profile web add github:AbsoluteMikhail/dsh-locale-ru

Собранные файлы lib/ хранятся в репозитории. Установка из GitHub не запускает сборочный код на компьютере пользователя и не требует разрешать install-скрипты.

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

Из npm

Команда станет доступна после публикации пакета @absolutemikhail/dsh-locale-ru:

dsh plugin --profile web add @absolutemikhail/dsh-locale-ru

Через интерфейс

Откройте Плагины → Добавить плагин и вставьте:

github:AbsoluteMikhail/dsh-locale-ru

Проверка установки

dsh --profile web --dump-config

В собранной конфигурации должен появиться ряд:

- id: locale-ru
  name: '@absolutemikhail/dsh-locale-ru'

Что переводится

Сторонний плагин со своим пространством перевода продолжит работать: неизвестные русскому пакету ключи отображаются на английском через штатную цепочку fallback.

Русские числительные

В словарях предусмотрены категории CLDR one, few, many и other. Версии Harness с расширенной поддержкой числительных автоматически выбирают правильную форму по параметру count или n.

Совместимость

Первая версия подготовлена для DeepSeek Harness 0.1.6-alpha.2 и использует публичные методы addLanguage и register. Словари соответствуют интерфейсным ключам этой версии Harness.

Расширенные категории .few и .many требуют версии LocaleRuntime с поддержкой CLDR. На более ранних версиях остальные переводы работают через стандартные ключи .one и .other.

При обновлении Harness состав ключей может измениться. Выпуск новой совместимой версии русификатора должен сопровождать такие изменения.

Обновление и удаление

dsh plugin --profile web update @absolutemikhail/dsh-locale-ru
dsh plugin --profile web remove @absolutemikhail/dsh-locale-ru

Для GitHub-установки можно закрепить конкретный тег:

dsh plugin --profile web add github:AbsoluteMikhail/dsh-locale-ru#v0.1.0

Разработка

Словари находятся в src/client/dictionaries, регистрация языка — в src/client/index.ts, установочный слой — в cordis.patch.yml.

pnpm install
pnpm run check

pnpm run check выполняет сборку, проверяет регистрацию всех 48 словарей и содержимое npm-архива. После изменения исходников добавьте обновлённые lib/index.js и lib/client.js в тот же коммит: благодаря этому установка из GitHub остаётся безопасной и не запускает локальную сборку.

Полная проверка совместимости требует checkout DeepSeek Harness 0.1.6-alpha.2:

DSH_HARNESS_ROOT=/path/to/deepseek-harness pnpm run check:harness

Команда сверяет ключи, порядок и плейсхолдеры всех словарей с владельцами пространств перевода в Harness. Затем она собирает npm-архив, устанавливает его через dsh plugin --profile web add во временный DSH_HOME и проверяет появление locale-ru в собранной конфигурации. Закреплённые репозиторий, версия и commit находятся в harness-compatibility.json; GitHub Actions выполняет обе проверки автоматически.

Обратная связь

Нашли неточный перевод или непререведённую строку — создайте issue. Укажите экран, исходный текст и желаемый вариант перевода.

Авторство и лицензия

Русская локализация и код этого пакета созданы и сопровождаются AbsoluteMikhail и распространяются по лицензии MIT.

DeepSeek Harness — отдельный проект компании DeepSeek. Исходное уведомление об авторских правах и лицензии сохранено в THIRD_PARTY_NOTICES.md. Этот репозиторий является независимым проектом сообщества и не заявляет об официальной поддержке со стороны DeepSeek.

Проекты GooDAnDReaDY/dsh-russian-lang и warment/deepseek-harness-locale-ru изучались для сравнения подходов. Их исходники и словари в этот пакет не переносились.