dsh-whale-widget-ja
DSH(DeepSeek Harness)Web 画面右下の 小鲸鱼ウィジェット dsh-whale-widget を
日本語 + 日本円表示にする非公式パッチです。
- 上流プラグインのファイルを書き換えるだけ(再配布物ではありません)
- 画像・GIF・効果音などの素材は一切同梱しません(上流のものをそのまま使います)
- 対象バージョン: 0.4.2(それ以外でも適用は可能。
checkで差分を確認できます)
できること
| 項目 | 変更内容 |
|---|---|
| 言語 | メニュー・設定パネル・通知・確認ダイアログ・エラー・既定のふきだし文言まで日本語(約 1,300 文言 / 1,600 箇所) |
| 金額 | すべて 日本円(¥) 表示。USD / CNY 建ての金額を換算 |
| 為替 | 6 時間ごとに自動取得(画面を開いた直後にも 1 回)。取得できなければ前回値 → 既定値(157 円/USD) |
| GLM ピーク | GLM Coding Plan のピーク帯(平日 15:00–19:00 JST、オフピークはクレジット消費 50%)を判定。クォータ/plan モジュールで {glm_status} {glm_countdown} {glm_until} が使える |
| 日時 | zh-CN → ja-JP |
| ロジック | 中国語を条件に使っていた 2 か所(セルフチェックの成否判定・更新確認のタイムアウト判定)を日本語に合わせて調整 |
必要なもの
- DSH に
dsh-whale-widgetが導入済みであること
dsh plugin --profile web add dsh-whale-widget
- Node.js 18 以上(DSH に同梱の node でも可)
使い方
npx dsh-whale-widget-ja apply
# 画面をハードリロード(Cmd / Ctrl + Shift + R)
これだけです(バックアップは自動で作成されます)。npm 未使用の環境や中身を確認したい場合は clone して実行もできます。
git clone https://github.com/qnosuke/dsh-whale-widget-ja.git
cd dsh-whale-widget-ja
npm install
node bin/cli.mjs apply
反映のタイミング
- 画面側(メニュー・設定・通知など大部分): ハードリロードで即反映
- サーバー側(プロバイダー名・説明文・
/dsh-whale/fx.jsonの為替配信): DSH の再起動後
再起動前でも、為替はブラウザから open.er-api.com を直接取得して動きます(だめなら既定値)。
戻す
node bin/cli.mjs restore # 直前のバックアップへ
node bin/cli.mjs restore --from 2026-10-27T06-47-29-349Z
バックアップは <プラグイン>/.ja-backup/<timestamp>/ に残ります。
プラグインを更新したとき
dsh plugin --profile web add dsh-whale-widget # 上流を更新
node bin/cli.mjs apply # 再適用
node bin/cli.mjs check # 新しく増えた文言を確認
check は「未翻訳の中国語」と「上流の変更で当たらなくなった手直し」を一覧します。
新規文言も日本語にしたい場合は、src/dict.json に追記して PR してください。
仕組み
bin/cli.mjs … apply / check / restore
src/extract.mjs … acorn で AST を解析し、文字列リテラル内の中国語を位置付きで抽出
src/dict.json … 中国語 → 日本語 の対応表(1,300 件)
src/postpatch.mjs … コード側の手直し(通貨換算・為替取得ルート・判定ロジックなど)
test/parse.mjs … 辞書とパッチ定義の健全性チェック(CI で実行)
適用の流れ:
- 対象ファイルを構文解析し、文字列リテラルの中身だけを辞書で置換(コメントやコードは触らない)
- 引用符・
{cost}などのプレースホルダ・HTML タグ・エスケープが一致するか検証 - コード側の手直し(
postpatch.mjs)を適用 - 置換後に再パース。どこかで失敗したら 1 バイトも書き込まずに中止
- 成功時のみ、タイムスタンプ付きバックアップを取ってからアトミックに差し替え
金額換算
USD→¥:amount × usdJpyCNY→¥:amount ÷ usdCny × usdJpy- 100 円未満は小数 2 桁、1,000 円以上は 3 桁区切り
- しきい値(残高アラート・今日の予算)の入力は USD のまま。ふきだし内の表示だけ円換算します
GLM Coding Plan のピーク表示
z.ai 公式: ピークは 月曜〜金曜 14:00–18:00 SGT (UTC+8) = 日本時間 15:00–19:00。 ピーク中はクレジット消費が標準レート、オフピークは 50%。 (出典: https://docs.z.ai/devpack/overview — "During off-peak hours, model usage is charged at 50% of the standard credit rate")
GLM モデルのクォータ(plan)モジュールのテンプレートに次のプレースホルダが使えます:
| 変数 | 表示例 |
|---|---|
{glm_status} |
ピーク / オフピーク |
{glm_countdown} |
2時間5分(次の切替まで) |
{glm_until} |
ピーク終了まで 2時間5分 |
テンプレート例: 【{glm_status}】{plan} · {plan_reset}
為替レート
- ホストの
/dsh-whale/fx.json(6 時間キャッシュ、$DSH_HOME/.dshw-fx.json) - 無ければブラウザから
https://open.er-api.com/v6/latest/USDを直接取得 - それも失敗したら既定値(157 円/USD・6.7 元/USD)
取得元は open.er-api.com → frankfurter.app の順に試します。
自動取得を止めたい / レートを固定したい場合は、適用後のファイルにある
DSHW_DISPLAY_CUR と DSHW_FX、dshwFxLoad の呼び出し行を編集してください
(src/postpatch.mjs の同じ箇所を直せば再適用でも維持されます)。
注意点
- 非公式です。上流プロジェクト・DeepSeek 社とは関係ありません(NOTICE)。
- 画像・GIF・効果音は同梱していません。上流プラグインの素材をそのまま使います。
- 上流の破壊的な変更(文言や関数の書き換え)があった場合、
applyは安全側に倒して中止します。 そのときは issue で知らせてもらえれば追従します。 - 日本語は中国語より文字数が多いため、メニュー行が多少窮屈に見えることがあります。
開発
npm test # 辞書・パッチ定義の整合性チェック
node bin/cli.mjs apply --dry-run
翻訳の追加・修正は src/dict.json(キー = 元の中国語リテラル、値 = 日本語リテラル)で行います。
{cost} {session} などのプレースホルダと HTML タグはそのまま残してください(npm test が検証します)。
公開(メンテナ向け)
npm へ出す場合はどちらか:
# ローカルから
npm login --registry https://registry.npmjs.org
npm publish --registry https://registry.npmjs.org --access public
または GitHub の Release を作成する(.github/workflows/publish.yml が動きます)。
事前に Settings → Secrets and variables → Actions で NPM_TOKEN(Automation トークン)を登録してください。
この環境の既定 registry は npmmirror ミラーなので、--registry https://registry.npmjs.org の指定が必要です。
ライセンス
MIT。LICENSE を参照してください。 コードの著作権は上流の MeteorNOX 氏に、翻訳データとツールは本プロジェクトの貢献者に帰属します。
No comments yet. Be the first to write one.