桌宠日语化补丁 drydeuterium/dsh-pet-ja

dsh-pet-ja 🐾🇯🇵

DSH (DeepSeek Harness) 的桌面宠物插件
dsh-pet 的日语化本地补丁。

把仍是中文的菜单、设置页、气泡文案改成日语，字体换成面向日语的 にくまるフォント。在上游加入日语 locale 之前，先用它顶着。

$ node apply.mjs
=== profile "desktop": C:\Users\you\.dsh\profiles\desktop\node_modules\dsh-pet
dsh-pet 0.3.7
font: assets/fonts/Nikumaru.ttf を配置 client.js: menu: PET_JA_ANIM / PET_JA_CATEGORY を挿入 client.js: locale: ja 辞書 + addLanguage を追加 ... 完了: 5 ファイルを更新反映: ブラウザ半側はページ再読み込み／ホスト半側はプロファイル再構成か DSH 再起動

哪些地方会变成日语

| 对象 | 内容 |
| 右键菜单 | 「动作」→「アクション」、「碎碎念」→「ひとりごと」、「对话」→「おしゃべり」、「回到初始位置」→「初期位置に戻る」、分类（待機 / 方向転換 / ドラッグ / クリック反応 / 移動 / 小ワザ / 遊び / 食べもの / 季節行事 / 文字もの / 残高 / 作業ステータス） |
| 动画名 106 种 | 只把菜单里显示的名字改成日语（吃白饭 → 白ごはんを食べる、原地专心玩魔方 → その場でルービックキューブ 等）。素材文件名保持中文不动，所以播放不会坏 |
| 设置页 | 「ペット設定」页整页（把 130 个键的 ja 字典作为语言包注册到 DSH 的 locale 服务。设置 → General → Language 里会出现「日本語」） |
| 通知、余额气泡、聊天窗 | 会話完了 / 生成失敗 / 出力が打ち切られました / 残高照会に失敗しました 等 |
| DSH 命令 | /pet /chat /balance 的说明文字和结果消息 |
| 发给 LLM 的提示词 | ひとりごと 的指令、时间上下文、星期（宿主侧） |
| 字体 | 气泡和菜单换成 にくまるフォント（见下文「换字体」） |
| 附带的修复 | 抑制「desktop 显示的宠物不在」时桌面最前面一直冒红色错误条的问题，并且在这种状态下不再重启桌面助手 |

台词本体（人设、作业状态文案、梗图说明）在 配置文件 里，不在插件代码里，所以把 config/main-config.ja.jsonc 放到 ~/.dsh/dsh-pet/main-config.jsonc 就能日语化（可用 --install-config 复制）。

需要什么

- Windows / macOS / Linux 上的桌面版 DSH（dsh web 也行）
- Node.js 22 及以上（用 DSH 自带的 Node 也行）
- dsh-pet 0.3.7（已验证。其他版本也能跑，但文案变了的话有些地方对不上）
- 验证环境：dsh-pet 0.3.7 / DSH 0.2.1-rc.2 / Windows 11

用法

1) 先装好 dsh-pet（没装的话）
dsh plugin --profile desktop add dsh-pet

2) clone 这个仓库并打补丁
git clone https://github.com/drydeuterium/dsh-pet-ja.git
cd dsh-pet-ja
node apply.mjs # 自动检测所有装了 dsh-pet 的配置档并应用
node apply.mjs --dry-run # 只确认改动内容
node apply.mjs --profile web # 指定配置档时

3) 放入日语台词配置（可选，不覆盖已有文件）
node apply.mjs --install-config

4) 生效浏览器侧: 刷新 DSH 页面（F5）宿主侧 : 重启 DSH（或重新构建配置档）

设置页的语言在「设置 → General → Language」里选 日本語（浏览器是日语的话会自动选中）。

主要选项

| 选项 | 含义 |
| --profile <name> | 目标配置档（省略时自动检测 ~/.dsh/profiles//node_modules/dsh-pet） |
| --pkg <dir> | 直接指定插件目录 |
| --font <path> | 使用的字体（默认 fonts/Nikumaru.ttf） |
| --install-config | 把日语示例配置复制到 ~/.dsh/dsh-pet/main-config.jsonc（已存在则什么都不做） |
| --dry-run | 不写入，只显示结果 |
| --verbose | 全量显示「没匹配上的项」 |

换字体

字体的做法是 放到插件的 assets/fonts/ 里，再从 @font-face 引用。
想换的话，下面两种任选其一：

A) 替换仓库里的字体后重新应用
cp /path/to/your-font.ttf fonts/Nikumaru.ttf
node apply.mjs

B) 指定字体后应用（会以指定的文件名复制到插件侧）
node apply.mjs --font /path/to/your-font.ttf

- 扩展名 推荐 .ttf（插件的 @font-face 声明的是 format("truetype")。
Chromium 基本能读 .otf，但更稳妥的是 .ttf）
- 只要字体带日文字形，用什么字体都行（例如：源柔ゴシック、M PLUS Rounded 1c、はれのそら明朝 等）
- 已经应用过一次，想换成别的字体名时，先重装插件再重新应用更稳妥
（dsh plugin --profile desktop remove dsh-pet && dsh plugin --profile desktop add dsh-pet --save-exact）

随包附带的 fonts/Nikumaru.ttf 是 にくまるフォント（M+ FONTS 派生）。
同时附带 fonts/MPLUS-LICENSE_J.txt / MPLUS-LICENSE_E.txt（M+ 许可证允许再分发）。
不需要的话，删掉 fonts/Nikumaru.ttf，用 --font 指定你自己的字体即可。

还原

dsh plugin --profile desktop remove dsh-pet
dsh plugin --profile desktop add dsh-pet --save-exact # 重装即可回到原始状态

补丁直接改写 node_modules/dsh-pet 里的内容，所以更新插件后就会还原。
这时重新执行本仓库的 apply.mjs 即可（执行多少次都安全）。

原理

- data/dict-ja.json … 设置页面用的 130 键日文词典。data/.json 是替换表
- data/anim-ja.json … 106 种动画的显示名（素材名保持中文，只替换显示）
- data/lit-ja.json / data/host-ja.json … 代码内直接写死的文案替换表（浏览器侧 / 宿主侧）
- apply.mjs … 应用上述内容。保留词典块（zh/en），只替换块外的部分。
宿主侧的星期、时间段表格按整块替换，以免受缩进和逗号写法差异影响

「未匹配项」默认只按文件显示数量。多数情况只是「那个文件里本来就没有」，并非异常。
上游改了文案时这里的数量会增加，用 --verbose 查看内容，再修正替换表。

限制与注意

- 直接改写 node_modules。上游更新后会消失（需要重新应用）
- 上游目前没考虑多语言支持（已在 dsh-pet#132 提过建议 → 2026-10-19 以「DSH 本身只有中文/英文」「菜单的动作名就是文件名本身，做多语言并不简单」为由搁置）。目前这个补丁是日文 UI 的唯一手段
- 替换基于字符串匹配，插件实现大改的版本可能有一部分匹配不上（遇到这种情况请通过 issue 或 PR 告知）
- 梗图里画的中文文字本身是图片，保持原样（只把说明文字日文化）

致谢与许可证

- dsh-pet by PC2005-cloud —— 本补丁的对象。MIT（素材禁止商用，二次创作时须注明原作者的 GitHub）
- にくまるフォント（fonts/Nikumaru.ttf）—— M+ FONTS 派生。附带 fonts/MPLUS-LICENSE_.txt
- 本仓库的脚本与翻译数据：MIT（LICENSE）

dsh-pet-ja (English)

一个本地补丁，把 DSH 桌面宠物插件 dsh-pet 的中文 UI 改成日文，并把气泡字体换成日文字体（Nikumaru 字体）。

测试环境： dsh-pet 0.3.7 / DSH 0.2.1-rc.2 / Windows 11。

dsh plugin --profile desktop add dsh-pet # install the plugin first
git clone https://github.com/drydeuterium/dsh-pet-ja.git
cd dsh-pet-ja
node apply.mjs # auto-detects every profile that has dsh-pet installed
node apply.mjs --install-config # optional: Japanese persona / status texts sample
reload the DSH page; restart DSH for the host-side strings

本地化的范围：右键菜单（包括全部 106 个动画显示名 —— 素材文件名保持原样）、插件设置页面（注册为 DSH 语言包的 130 键 ja 词典）、系统通知、余额气泡、聊天窗口、/pet /chat /balance 命令说明，以及宿主侧的 LLM 提示词。它还抑制了插件在没有宠物使用桌面显示时于桌面弹出的红色错误横幅。

字体：补丁把 fonts/Nikumaru.ttf 复制进插件，并重新指向 @font-face。
用你自己的字体：node apply.mjs --font /path/to/font.ttf（推荐 .ttf）。

补丁会改动 node_modules，所以升级 dsh-pet 之后要重新运行 apply.mjs。
它是幂等的，--dry-run 会显示将要改动的内容。

上游目前没有支持其他语言的计划（提案见 dsh-pet#132；2026-10-19 答复称 DSH 本身只提供中文和英文，菜单操作名就是文件名）。在这一点改变之前，这个补丁就是获得日文界面的办法。

License: MIT for the scripts and translation data (see LICENSE).
dsh-pet 本身是 MIT（素材：非商业用途）；Nikumaru 字体是 M+ FONTS 的衍生字体，按 M+ 许可证分发（见 fonts/MPLUS-LICENSE_.txt）。