Skip to main content
S

dsh-i18n-ja

satukisuto-hpc/dsh-i18n-ja

DSH Web GUI 日本語ロケールパック: registers the 日本語 language into the shared locale catalog and carries the ja dictionaries for every dsh-web-all family plugin namespace (missing keys fall back to English through the SDK chain).

Install

dsh plugin --profile web add github:satukisuto-hpc/dsh-i18n-ja

README

dsh-i18n-ja — DeepSeek Harness Web GUI 日本語ロケールパック

Japanese (日本語) locale packs for the DSH (DeepSeek Harness) Web GUI. Two npm packages cover the core UI (57 namespaces, ~2,600 keys) and the dsh-web-all extension family (17 namespaces, ~1,700 keys), with zero overlap. Install by npm name from the DSH plugin manager, then pick 日本語 in Settings → General → Language.

DeepSeek Harness(DSH)の Web GUI を日本語表示にするロケールパック集です。 言語カタログに ja(日本語)を登録し、各名前空間の日本語辞書を供給します。 インストール後、設定 → 一般 → 言語 → 日本語 を選ぶと UI が日本語になります。

パッケージ

パッケージ対象規模
dsh-i18n-jadsh-web-all 拡張バンドルの 17 名前空間約 1,700 キー
dsh-i18n-ja-coreDSH コア UI(common / settings.* / chat / workspace / sidebar* など 57 名前空間)約 2,600 キー

両者は名前空間が重複しない設計で、同時に有効化できます(dsh-i18n-ja がコア側の ja 言語登録も兼ねますが、コア単体でも動作します)。

インストール(DSH での導入方法)

npm に公開済みです(dsh-i18n-ja / dsh-i18n-ja-core)。コア UI まで含めて完全日本語化するには両方の導入を推奨します(名前空間の重複はなく、独立に有効化できます)。

  1. DSH Web GUI のプラグイン管理で、パッケージ名 dsh-i18n-ja と dsh-i18n-ja-core を追加(インストール)
  2. プラグイン一覧で両方が**有効(enabled)/適用(applied)**になっていることを確認
  3. Web GUI をリロード(ブラウザなら F5 / デスクトップアプリなら再起動)
  4. 設定 → 一般 → 言語 → 日本語 を選択

ローカル Checkout から試す場合の spec は link:<clone 先>/packages/dsh-i18n-ja の形式(link: プレフィックス)です。

エージェントに導入を任せる場合のプロンプト

DSH のチャットに、次のプロンプトをそのまま貼り付けてください:

DSH Web GUI を日本語化したいです。次の npm パッケージをプラグインとして導入してください。
- dsh-i18n-ja
- dsh-i18n-ja-core

手順:
1. plugin_manager の install_bundle で上記 2 つをインストール(spec はパッケージ名そのまま)
2. list_plugins / set_plugin(または set_bundle)で有効化(enabled)と適用状態を確認
3. 完了後、Web GUI の再読み込みと「設定 → 一般 → 言語 → 日本語」の手順を案内してください

仕組み

  • ctx.locale.addLanguage({ id: "ja", label: "日本語", fallback: "en" }) で言語を登録
  • 各名前空間ごとに ctx.locale.register(ns, "ja", dict) で辞書を登録
  • 未翻訳キーは ns → common → en → キー名 のフォールバックチェーンで英語表示になるため、翻訳が一部でも安全

翻訳パイプライン(再ビルド手順)

各パッケージの tools/ に再現手順のスクリプトが入っています:

  1. tools/asar-extract.mjs — DSH の app.asar からロケール辞書を含むバンドルを抽出
  2. tools/extract-locale.mjs — 名前空間ごとの out/locales.json / out/src/<ns>.json を抽出
  3. out/src → out/ja を翻訳(用語集・文体ルールは out/GLOSSARY.md)
  4. node tools/build-client.mjs — lib/client.js(Client バンドル)を生成

翻訳の品質チェック: 全キーで en と ja のキー集合一致・{...} プレースホルダ一致を機械検証しています。

npm 公開(Trusted Publishing)

初回リリース(v0.1.0)は OTP 付きのローカル publish で行い、以後は npm の Trusted Publishing(GitHub OIDC)で公開する設計です。トークン不要で、公開はタグ push のみ:

# packages/*/package.json の version を上げ
git tag v<version> && git push origin v<version>

→ .github/workflows/publish.yml が両パッケージを npm publish --provenance で公開します。 (信頼設定は npm trust github <pkg> --repo SatukiSuto-HPC/dsh-i18n-ja --file publish.yml --allow-publish を 1 回実行して登録します。2FA 認証が対話的に必要です)

ライセンス

Apache-2.0(各パッケージに LICENSE を同梱)。 翻訳文は DSH 本体の英中ロケール文字列から導出した派生物です。DSH / DeepSeek は各権利者の商標です。

Related plugins