鲸鱼挂件日语化 qnosuke/dsh-whale-widget-ja

dsh-whale-widget-ja

English README

这是非官方补丁，把 DSH（DeepSeek Harness）Web 画面右下角的 小鲸鱼挂件 dsh-whale-widget 改成 日语 + 日元显示。

* 只改写上游插件的文件（不是重新分发的产物）
* 不附带任何素材，图片、GIF、音效都用上游原样
* 适配版本：0.4.2（其他版本也能打，用 check 查看差异）

能做什么

| 项目 | 改动内容 |
| 语言 | 菜单、设置面板、通知、确认对话框、错误、默认气泡文案全部日语（约 1,300 条文案 / 1,600 处） |
| 金额 | 全部按 日元（¥） 显示。USD / CNY 计价的金额会换算 |
| 汇率 | 每 6 小时自动获取（打开画面后也会立刻取一次）。取不到就用上次的值 → 默认值（157 日元/USD） |
| GLM 高峰 | 判断 GLM Coding Plan 的高峰时段（工作日 15:00–19:00 JST，非高峰时 credit 消耗 50%）。quota / plan 模块里可用 {glm_status} {glm_countdown} {glm_until} |
| 日期时间 | zh-CN → ja-JP |
| 逻辑 | 有两处用中文做条件判断（自检成败判定、更新检查超时判定），已按日语调整 |

需要什么

* 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 で実行）

应用流程：

1. 对目标文件做语法解析，只替换字符串字面量的内容（注释和代码不动）
2. 校验引号、{cost} 这类占位符、HTML 标签、转义是否一致
3. 应用代码侧的手工修改（postpatch.mjs）
4. 替换后重新解析。任何一步失败就一个字节都不写，直接中止
5. 只有成功时才创建带时间戳的备份，然后原子替换

金额换算

* USD → ¥：amount × usdJpy
* CNY → ¥：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。
高峰时 credit 按标准费率消耗，非高峰 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}

汇率

1. 宿主的 /dsh-whale/fx.json（缓存 6 小时，$DSH_HOME/.dshw-fx.json）
2. 没有的话，从浏览器直接请求 https://open.er-api.com/v6/latest/USD
3. 还是失败就用默认值（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 所有，翻译数据和工具归本项目的贡献者所有。