🇷🇺 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'
Что переводится
| Раздел | Примеры |
|---|
| Общий интерфейс | Кнопки, ошибки, загрузка, подтверждения |
| Чат | Сообщения, статистика, использование токенов, история |
| Настройки | Язык, тема, модели, плагины, архив сессий |
| Рабочие области | Сессии, файлы, ветвление, выбор папки |
| Инструменты | Команды, планы, цели, навыки, задания |
| Агенты | Субагенты, команда агентов, пресеты |
| Боковые панели | Браузер, терминал, файлы, документы |
| Документы | Markdown, HTML, PDF, изображения, Office |
Сторонний плагин со своим пространством перевода продолжит работать: неизвестные русскому пакету ключи отображаются на английском через штатную цепочку fallback.
Русские числительные
В словарях предусмотрены категории CLDR one, few, many и other. Версии Harness с расширенной поддержкой числительных автоматически выбирают правильную форму по параметру count или n.
| Число | Результат |
|---|
| 1 | 1 вызов инструмента |
| 2 | 2 вызова инструмента |
| 5 | 5 вызовов инструментов |
| 21 | 21 вызов инструмента |
Совместимость
Первая версия подготовлена для 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 изучались для сравнения подходов. Их исходники и словари в этот пакет не переносились.
