日语界面语言包 yuuturn/dsh-locale-ja

dsh-locale-ja

这是 DSH（DeepSeek Harness）Web GUI 的日语语言包（客户端插件）。

English: README.en.md

- 把 UI 日语化 — 在 设置 → 通用 → 语言 里加上「日本語」，界面文案就会变成日语。DSH 0.2.0-rc.2 自带的 57 个命名空间 / 2433 个键全部翻译完毕（未翻译的键回退到英语）
- 切换到日语字体 — 只在选中日语期间，把字体设为 Noto Sans JP（没装就用 Hiragino Sans / Yu Gothic UI）。DSH 自带的主题在 CJK 回退里把中文字体（PingFang SC）排在日语前面，不做处理的话日语会以中文字形显示
- 不改 DSH 本体的语言环境 — ja 作为外部语言注册，所以自带的英语、中文显示保持原样

运行要求

| 项目 | 要求 |
| DSH | 0.2.0-rc.2（使用 @deepseek-ai/dsh-client-locale 的语言包 API） |
| Node.js | 20 以上（安装脚本和构建要用） |
| 字体 | Noto Sans JP（可选。没有就回退到操作系统的日语字体） |
| OS | macOS / Windows / Linux（DSH 桌面应用，或命令行的 web 配置档） |

支持的界面

桌面应用的画面和 dsh web 提供的是同一个 Web UI（@deepseek-ai/dsh-web-app + @deepseek-ai/dsh-web-frontend）。配置档构成两边也都是 @deepseek-ai/dsh-base + @deepseek-ai/dsh-web-app，桌面应用只是把它显示在 Electron 上，再以追加插件的形式加上原生目录选择（dsh-host-directory-picker-native）和更新 UI 等。UI 本身并不是另一套实现。

所以这个语言包不是桌面专用，凡是带 Web 界面的配置档都能通用。

| 用法 | 配置档 | 装入方式 |
| 桌面应用 | desktop | node tools/install.mjs（这个配置档由 Electron 独占管理，所以没法从 dsh plugin 等命令行操作） |
| dsh web（命令行） | web | node tools/install.mjs --profile web，或者 pnpm 依赖 + dsh.profile.bundles |
| 其他 Web 界面 | 任意 | 同上（构成里要包含 @deepseek-ai/dsh-client-locale） |

桌面特有的文案（settings.desktop.update. 等）也收进了词典。

安装

git clone https://github.com/yuuturn/dsh-locale-ja.git
cd dsh-locale-ja

node tools/install.mjs --dry-run # 确认改动内容
node tools/install.mjs # 装进默认配置档（~/.dsh/profiles/desktop）

要装进别的配置档，比如命令行的 Web 配置档：

node tools/install.mjs --profile web
或者用环境变量指定: DSH_PROFILE_DIR=/path/to/profile node tools/install.mjs

之后重启 DSH，在 设置 → 通用 → 语言 里选 日本語。

脚本只做 2 处改动，跑多少次结果都一样。

1. <profile>/node_modules/dsh-locale-ja → 指向这个仓库的 symlink（Windows 上是 junction）
2. 在 <profile>/cordis.patch.yml 里加 1 行带标记注释的 insert

dsh-locale-ja: Japanese language pack (managed by tools/install.mjs)
- insert:
- id: locale-ja
name: dsh-locale-ja

卸载

node tools/install.mjs --uninstall

另一种方式（作为 bundle 装入）

这个包也自带 DSH 的 bundle 定义（dsh.bundle.patch），所以作为 pnpm 依赖装进去、再加进 dsh.profile.bundles，也会装入同一行。

dsh plugin --profile web add "git+https://github.com/yuuturn/dsh-locale-ja"
之后在配置档的 package.json 的 dsh.profile.bundles 里加上 "dsh-locale-ja"

tools/install.mjs 检测到已经作为依赖装进去时，会为了避免重复插入这一行而什么都不做。

这个包没有发布到 npm。 npm 注册表里的 dsh-locale-ja 是另一个项目（gepeiyu 氏）的同名包，和本仓库无关。npm install dsh-locale-ja 装不了这个包。

日语字体

主题里只是指定了字体名，所以即使没有 Noto Sans JP 也能正常工作（macOS 会回退到 Hiragino Sans，Windows 会回退到 Yu Gothic UI / Meiryo，不会回退到中文字体）。要用 Noto Sans JP 的话：

macOS
brew install --cask font-noto-sans-jp

Windows / 其他：从 Google Fonts 安装「Noto Sans JP」 https://fonts.google.com/noto/specimen/Noto+Sans+JP

Chromium 启动时会枚举系统字体，所以安装后需要重启 DSH。

不想切换字体的话，删掉 locale/ja/font.css 再执行 node tools/build.mjs（翻译会原样保留）。覆盖范围限定在 html:lang(ja)，不影响英文和中文显示。

更新 DSH 之后

DSH 侧改了文案或键名时，重新拉取英语词典并翻译差异。

npm run refresh-reference # 从已安装的 DSH 重新拉取 reference/en
npm test # 检测未译、多余键、占位符不一致
补充、修改 locale/ja/.json 后
npm run build # 重新生成 lib/client.js

结构

| 路径 | 作用 |
| lib/client.js | DSH 通过 /plugins 分发的客户端 bundle。属于生成物，不要直接编辑，用 npm run build 重新生成 |
| lib/index.js | 宿主侧入口（apply() 为空。日语化是浏览器侧的事） |
| locale/ja/.json | 按命名空间划分的日语词典。文件名就是命名空间（例如 settings.locale.json） |
| locale/ja/font.css | 只在日语区域时应用的字体覆盖。删掉后构建产物不带字体覆盖 |
| locale/STYLE.md | 翻译风格指南（术语表、表记规则） |
| reference/en/.json | 作为翻译基准的 DSH 内置英语词典快照 |
| cordis.patch.yml | 以 bundle 形式安装时的补丁层 |
| tools/ | 抽取、构建、校验、安装脚本 |

开发

npm run build # 从 locale/ja/.json + font.css 生成 lib/client.js
npm run verify # 校验键集合、占位符、风格、bundle 契约
npm test # build --check + verify + 安装器往返 + 针对真实应用的集成测试

npm test 的集成测试会从已安装 DSH 的 app.asar 里加载真实的区域服务，确认「日本語」出现在选项中、通过行操作能实际切换、 和字体覆盖生效。没有 DSH 的环境会自动 skip（可用 DSH_APP_ASAR 指定位置）。

翻译分工在 tools/translate-groups.json，词典抽取在 tools/extract-dicts.py。欢迎提 PR。DSH 侧英文有变动时，请一并附上 npm run refresh-reference 的结果。

与其他日语包的关系

同样目的（DSH Web UI 日语化）的实现还有其他公开版本。选哪个可以作为参考。机制（官方的 ctx.locale.addLanguage() 和命名空间词典）都一样，区别在于作为翻译基准的 DSH 版本、收录量、字体处理、安装途径。

| | 本仓库 | fang2hou/dsh-locale-ja | gepeiyu/dsh-locale-ja |
| 翻译基准 | DSH 0.2.0-rc.2 | DSH 0.1.5-rc.2 | DSH 0.2.1-alpha.2 |
| 收录量 | 57 命名空间 / 2,433 键 | 42 / 1,257 | 62 / 2,773 |
| 日语字体 | 优先 Noto Sans JP（没有则用 OS 的日语字体） | OS 标准日语字体 | 未提及 |
| 桌面应用 | 支持（tools/install.mjs） | 未记载（--profile web 的命令行步骤） | 未记载（同上） |
| 分发 | GitHub（未发布到 npm） | npm @fang2hou/dsh-locale-ja | npm dsh-locale-ja |

本仓库的特点是：全量收录你所用的 DSH 版本（0.2.0-rc.2）的词典、能集成进桌面应用的配置档、可以显式指定 Noto Sans JP，以及在 CI 里跑针对真实应用区域服务的集成测试。如果在翻译覆盖率或更新频率上不如其他实现，建议不要勉强并用，改用对方或把差异回馈过去。

已知限制

- command.token. 保持英文。这不是显示用文案，而是在斜杠菜单里选中命令时进入 composer 的「输入拼写」，用来解析输入拼写的别名表只能从 DSH 内置的 zh / en 词典生成（外部区域的拼写不会被注册）。日语化后就无法作为命令解析，所以有意保持英文
- 注册时固定文案的部分文本（例如命令注册表的说明）不会跟随语言切换（这是 DSH 侧的规格）
- 翻译基于 DSH 0.2.0-rc.2 时点的词典。DSH 还是 RC 版，更新后键可能增减（npm test 会检测出来）
- 设置的语言选择器里出现的「日本語」，是本包提供的外部语言。选中期间 会变成 ja

许可证

MIT（LICENSE）。关于 DSH 英文文本的处理与 Noto Sans JP，请参阅 NOTICE（字体本体不再分发）。