Proposal: add Russian (ru) locale to the Web UI (zh/en/ru)

[Ragnoryok1]

Proposal: add Russian (ru) locale to the Web UI (zh/en/ru)

Hi everyone,

I've been using dsh with the Web UI and wanted to contribute a Russian translation. Since the repo currently doesn't accept external PRs, I'm posting this here as a proposal and would love feedback from the maintainers and the community.

What it does

Ships Russian as a full third GUI locale alongside zh and en. The Language switcher in Settings → General now offers 中文 / English / Русский, and the whole Web UI is translated.

What's included

• Core LOCALE_IDS / LOCALES change to add ru.
• Russian dictionaries for every client namespace — roughly 1,000 strings across ~28 client packages (ui-conversation, ui-trajectory, ui-settings-models, ui-agent-preset, ui-permission-presets, etc.).
• Correct Russian plural categories (one / few / other) in all the selection sites that count items.
• Localized trajectory / session-export / permission-preset strings.
• Layout (CSS) fixes where Russian text renders wider than zh/en, e.g. the trajectory table and subagent lineage headers.
• html lang is set to the active locale (ru) so assistive tech and browser features behave correctly.

How it's kept correct

zh stays the key-set source of truth (per the repo's zh-first convention). The typed registration contract is now register(ns, { zh, en, ru }), so a missing or extra ru key is a compile error — complete Russian coverage is enforced by the type system, not by review.

Verification

• typecheck: green
• locale tests: 35/35 passed
• affected GUI packages: 752/752 (trajectory 107/107, permission presets 14/14)

Where it lives

• Branch: feat/ru-locale
• Commit: a449619 — "feat(web): add Russian (ru) locale to the Web UI"
• Fork: github.com/Ragnoryok1/deepseek-harness_ru

Happy to rebase onto master whenever the upstream moves, and to open a PR as soon as you're able to accept them. Feedback, corrections, and style nits are very welcome — especially from native Russian speakers.

[Ragnoryok1]

🇷🇺 For Russian-speaking users: a step-by-step install & first-run guide in Russian is now available — it covers
px @deepseek-ai/dsh web, API key setup, workspace selection, and how to enable the ru locale from this proposal's fork.

Русскоязычный гайд по установке и первому запуску (включая включение русской локали из этого предложения): https://github.com/Ragnoryok1/deepseek-harness-guide-ru

[Ragnoryok1]

Update — the Russian pack is now a language-pack plugin, no fork patch needed.

I rebuilt the Russian localization as a standalone plugin on top of dsh v0.1.2-alpha.4, so it no longer requires patching in-tree locale files.

What it is

@deepseek-ai/dsh-client-locale-ru — a client plugin that calls ctx.locale.addLanguage({ id: 'ru', label: 'Русский', fallback: 'en' }) and registers a ru dictionary for every client locale namespace (34 namespaces, ~1,400 strings). No core files are patched: the language-pack contract in dsh-client-locale does all the work, and missing keys fall back to en at lookup time.

Settings -> General gets a third option: Chinese / English / Russian. Switching to Russian localizes the entire GUI, including the trajectory view, session export, permission presets, plugin inventory, and schedule catalog.

Why a plugin

The earlier in-tree approach patched locale files and broke on every upstream move (rc.2 -> alpha.4 alone renamed a large part of the key sets). As a plugin, surviving an update is: merge upstream, run the audit script, translate the printed gaps. I keep two maintenance scripts in the repo: locale-ru-audit.mjs (reports every en key without a ru value) and locale-ru-sync.mjs (relocates translations across renamed keys by matching the unchanged English text).

On Russian plural forms — correction: the language-pack contract (addLanguage/register) takes no plural-rule field and the app has no Intl.PluralRules/ICU {count, plural, ...} pipeline, so count-sensitive strings ship in a neutral or fixed form (e.g. "... обрезано на {total} символах"). Proper Russian pluralization (1 результат / 2 результата / 5 результатов) needs per-component Intl.PluralRules('ru') UI code, which is product code, not something a language pack can contribute.

Try it

• Fork: github.com/Ragnoryok1/deepseek-harness_ru
• Branch: feat/ru-locale-pack (base: dsh v0.1.2-alpha.4), merged into the fork's master
• git clone, pnpm install, pnpm run build, pnpm dsh web — pick Русский in Settings.

Feedback and corrections welcome, especially from native Russian speakers — if you spot a clumsy rendering, tell me the screen and I'll fix the wording. And if the project ever opens to external contributions, I'd be glad to upstream the dictionaries.

[Ragnoryok1]

Update — Russian is available today as an installable plugin.

Rather than waiting on the upstream decision, ru now ships as a standalone plugin: @ragnoryok1/dsh-client-locale-ru

dsh plugin --profile web add @ragnoryok1/dsh-client-locale-ru

• npm: https://www.npmjs.com/package/@ragnoryok1/dsh-client-locale-ru
• source: https://github.com/Ragnoryok1/dsh-client-locale-ru
• announcement: DSH | dsh-client-locale-ru | Russian (ru) language pack for the dsh web GUI #5582

This proposal (shipping ru upstream as a first-class locale) stays open as a maintainer decision — meanwhile users get Russian right away through the plugin.

Кратко (RU): русский интерфейс уже доступен как плагин @ragnoryok1/dsh-client-locale-ru (dsh plugin --profile web add …); предложение включить ru в апстрим остаётся открытым.