Introduction

dsh-zh is designed for the DSH Web interface. It addresses display layer issues: replacing residual English UI text in the interface with Chinese, while not altering values, attributes, events, or session content. Additionally, it detects whether the official version has already adapted to this, avoiding duplication between the plugin and official text.

What is this

dsh-zh is a DSH client plugin with the repository address at https://github.com/HarryLi-7/dsh-zh. It performs only display layer localization and official adaptation detection, without modifying DSH’s functional logic.

Core Features

Interface Localization (Display Layer)

The plugin only replaces the display content of entire text nodes. The verified scope includes:

  • Localization of command panel command descriptions.
  • Localization of permission preset display: Read Only, Workspace Write, Full access.
  • Localization of short common words in reasoning level menus: Off, High, Max, Default.
  • The text and icon for Full access use the orange-red accent color #ff5722.

The following content and values remain unchanged:

  • Command names are not translated.
  • Machine values for permission presets, reasoning level IDs, and command names remain unchanged.
  • Session content, user messages, assistant replies, tool results, code blocks, and input fields are not replaced.

Short common words are only replaced within menu-like surfaces involving role="menu", role="listbox", and aria-haspopup="menu". This helps avoid incorrectly targeting body text and session content.

Official Adaptation Detection

The plugin silently probes official host data using 3 read-only RPCs. When official adaptation is detected, a one-time toast message is displayed. Detection failures are not logged, and the probe retries on the next load.

Storage and Switches

Regarding storage, the plugin uses only two fixed keys in localStorage and does not use ctx.logger.

The feature switch is located at:

Settings → General Settings → "Interface Localization (Chinese)"

Turning it on starts localization; turning it off stops localization immediately and restores the original text.

Installation and Activation

First, install the plugin:

dsh plugin --profile web add ~/.dsh/profiles/packages/dsh-zh

New plugins require restarting the harness to be loaded; client-side changes only require refreshing the page. After installation and restart, enter the DSH Web settings panel and enable or disable localization via “Settings → General Settings → ‘Interface Localization (Chinese)’”.

Typical Usage

  1. Install:
dsh plugin --profile web add ~/.dsh/profiles/packages/dsh-zh

  1. Restart the harness and open DSH Web.

  2. Go to “Settings → General Settings → ‘Interface Localization (Chinese)’” and turn on the switch.

  3. To revert, turn off the same switch; localization stops immediately and the original text is restored.

  4. Uninstall:

dsh plugin --profile web remove dsh-zh

Applicable Scenarios and Notes

Suitable for scenarios where users want the DSH Web interface to display in Chinese but do not wish to change the original values of commands, permissions, reasoning levels, or session content. It is also suitable for maintainers who need to determine if the official version has already been localized.

Please note: The plugin runs with the current DSH process permissions; you should check the source code and license before installing. dsh-zh only handles the display layer and does not modify values, attributes, events, or session content; functional behavior is still subject to DSH’s own permissions and command semantics.

Related Resources

  • GitHub: https://github.com/HarryLi-7/dsh-zh
  • Community Directory Page: Link not currently provided