Plugin directory / UI & Skins / dsh-plugin-better-locale
dsh-plugin-better-locale
Verified · install-tested on dsh HuanLinOTO
What it does
DSH web 插件：通过运行时 monkey-patch LocaleRuntime.lookup 注入第三语言（ja/ko/...）覆盖，保持 dsh active locale 不变；通过 DSH 设置页通用分区暴露切换 UI。 | DSH web plugin: injects third-language (ja/ko/...) overrides via a runtime monkey-patch of LocaleRuntime.lookup, leaving the dsh active locale unchanged; exposes a switcher UI through the DSH settings page (General section).
Works — verified, early-stage project
DSH web 插件：通过运行时 monkey-patch LocaleRuntime.lookup 注入第三语言（ja/ko/...）覆盖，保持 dsh active locale 不变；通过 DSH 设置页通用分区暴露切换 UI。 | DSH web plugin: injects third-language (ja/ko/...) overrides via a runtime monkey-patch of LocaleRuntime.lookup, leaving the dsh active locale unchanged; exposes a switcher UI through the DSH settings page (General section). It installs cleanly and boots without issues in our testing. It's early-stage but functional.
“Verified” means our automated CI actually ran dsh plugin add in a clean profile and it booted — nothing more. Feature descriptions and version compatibility are the author’s claims. This is not a security audit and not an endorsement of third-party code.
README
dsh-plugin-better-locale
中文 | English
A DSH web plugin that adds 19 third-language overrides (Japanese / Korean / French / German / ...) on top of DSH's native Chinese / English. Coverage spans DSH's own UI copy and all third-party plugins that have opted in.
| Package | @huanlin/dsh-plugin-better-locale |
| Repo | huanlinoto/dsh-plugin-better-locale |
| License | AGPL-3.0 |
Supported languages
The override borrows DSH's English slot to render a third language — after switching, the UI shows the selected override language; uncovered parts fall back to English.
| Language | id | Label |
|---|---|---|
| Japanese | ja |
日本語 |
| Korean | ko |
한국어 |
| French | fr |
Français |
| German | de |
Deutsch |
| Portuguese | pt |
Português |
| Arabic | ar |
العربية |
| Hindi | hi |
हिन्दी |
| Indonesian | id |
Bahasa Indonesia |
| Turkish | tr |
Türkçe |
| Vietnamese | vi |
Tiếng Việt |
| Thai | th |
ไทย |
| Russian | ru |
Русский |
| Italian | it |
Italiano |
| Dutch | nl |
Nederlands |
| Swedish | sv |
Svenska |
| Polish | pl |
Polski |
| Traditional Chinese (HK) | zh-HK |
繁體中文（香港） |
| Traditional Chinese (TW) | zh-TW |
繁體中文（台灣） |
| Traditional Chinese (MO) | zh-MO |
繁體中文（澳門） |
Install
# npm registry
dsh plugin --profile web add "@huanlin/dsh-plugin-better-locale"
# or github ref
dsh plugin --profile web add "github:huanlinoto/dsh-plugin-better-locale"
After install, restart dsh web and hard-refresh the browser (Ctrl+Shift+R).
Usage
Switch DSH to English first (Settings → Language → English).
The override borrows DSH's English slot — it is inert while DSH is on Chinese. The switcher shows a "switch DSH to English to view [language]" hint in that case.
Pick an override language in Settings → General section.
better-locale registers a language picker row in DSH's settings General section (right after the native Language row). Open the dropdown and pick a target language — the UI switches immediately.
Switch back to native: pick "Use DSH native (zh/en)" in the same row.
The selection persists to browser localStorage and survives page refresh.
Coverage
- DSH itself: built-in namespaces (
common/settings.locale/command/ ...) — seesrc/client/dictionaries/<lang>.ts. - Third-party plugins: plugins that have opted into better-locale (e.g. dsh-better-sidebar, yet-another-subagent, dsh-aigc-canvas, and the rest of the huanlinoto series) follow the override; non-opted-in plugins fall back to English.
Want your plugin to follow the override too? See the Developer Guide.
Known limitations
- Must switch to English: the override only takes effect when DSH's active locale is
en. While DSH is on Chinese the override is fully inert (native Chinese preserved, no mixed languages). - Coverage is partial: uncovered namespaces / keys fall back to English. See
TRANSLATION.mdfor the coverage table (regenerate withpnpm run gen:translations). - Persistence uses localStorage: the selected override id is stored in browser localStorage, not in DSH's
locale.preference(we bypass the native schema enum). Not shared across browsers / profiles. - Web only: the client bundle targets the browser; it does not run in Node.
License
AGPL-3.0
Install
Install the catalog once, then DeepSeek Harness can find and install any plugin from this site automatically:
dsh plugin add dshbase-catalogThen say "install dsh-plugin-better-locale for me" — your agent finds it in the directory and installs it. Docs: dshbase-catalog · verified packs.
This plugin is GitHub source (not published to npm) — install it straight from the repo:
Web profile:
dsh plugin --profile web add github:HuanLinOTO/dsh-plugin-better-localeHeadless (CLI) profile:
dsh plugin --profile headless add github:HuanLinOTO/dsh-plugin-better-localeTest report
Verified: L1 install + L2 load + L3 runtime from GitHub source on dsh 0.1.0-rc.6.
Share this badge
Drop this badge into your README — it links back here and updates automatically when our test status changes:
[](https://dshbase.com/plugins/dsh-plugin-better-locale/)<a href="https://dshbase.com/plugins/dsh-plugin-better-locale/"><img src="https://dshbase.com/badges/dsh-plugin-better-locale.svg" alt="dshbase install-tested"></a>