feat(i18n): 接入 @huanlin/dsh-plugin-better-locale 支持 19 语言覆盖（ja/de/fr/...）

[HuanLinOTO]

概述

接入 @huanlin/dsh-plugin-better-locale（可选 peer）让 better-sidebar 支持 19 种第三语言覆盖：ja / de / fr / pt / ko / ar / hi / id / tr / vi / th / ru / it / nl / sv / pl / zh-HK / zh-TW / zh-MO。

better-locale 通过运行时 monkey-patch LocaleRuntime.prototype.lookup 注入第三语言，但 better-sidebar 的内置 t() 不走 ctx.locale（它有自己的 attachLocale + zh/en 词典），所以需要 better-sidebar 自己接入各语言词典才能翻译界面。

覆盖借用 DSH 的英文模式：只在 DSH active locale 为 en 时生效；DSH 在 zh 下覆盖完全惰性（保持原生 zh，界面不混语言）。

改动

• src/client/locales-<lang>.ts（19 个新文件）：各语言词典（每种约 340 keys），与 zh key-set 完全一致，typecheck 守护缺 key/多 key。

• src/client/locales.ts：

  • 新增 attachBetterLocale(store) —— 与 attachLocale 对称，注入 better-locale 的 override store。
  • 新增 19 语言 dict export（从 locales-<lang>.ts 导入，Record<keyof typeof zh, string> 类型注解编译期强制 key 集相等）。
  • t() 改为先查 store.getOverride(active, 'betterSidebar', key)，命中则返回覆盖文本，否则走原 zh/en 链。
  • isZh() 改为 store.isOverrideActive(active) 语义（仅在 DSH=en 且 override 激活时返回 false；Chinese-specific selectors 切回）。

• src/client/index.tsx：apply() 里从 ctx.get('betterLocale') 取得 override store（optional，未安装时为 undefined），attachBetterLocale 注入 t()；同时 store.register('betterSidebar', { ja, de, ... }) 把 19 语言词典注册进 better-locale 的 store，让外部 ctx.locale.lookup('betterSidebar', key) 调用者也能拿到覆盖文本。注册包在 ctx.effect 内，HMR 安全。

• src/client/Sidebar.tsx：新增 BetterLocaleActive uSES 订阅 store.subscribe，覆盖切换时全树重新渲染。

• tests/locales.spec.ts：新增 19 语言 override 测试（命中 / fallback / detach / interpolate / 各 dict key-set 完整性）。

• package.json：@huanlin/dsh-plugin-better-locale 加为 optional peer + devDep link。

• AGENTS.md / README.md：文档化第三语言覆盖机制。

兼容性

未安装 better-locale 时，ctx.get('betterLocale') 返回 undefined，整段为 no-op；zh/en 行为完全不变。

better-locale 是 optional peer（peerDependenciesMeta.optional: true），不影响现有安装。

测试

• pnpm typecheck ✅
• pnpm test -- tests/locales.spec.ts ✅（含 19 语言 dict key-set 完整性断言）

其他平台性失败测试（smoke/pty/sidebar-crash）为 Windows 预存问题（CRLF、pty spawning），与该 PR 无关（stash 验证 main 同样失败）。

关联

依赖插件 @huanlin/dsh-plugin-better-locale（v0.1.0 已发布）：仓库 huanlinoto/dsh-plugin-better-locale，npm @huanlin/dsh-plugin-better-locale。

设计文档：dsh-plugin-better-locale/docs/plans/2026-08-23-better-locale-design.md

鸣谢

俄语词典参考了 @Vladimir-Kryshchenko 在 #302 的贡献。