Skip to main content
Browse the docs

The developer docs are currently available in Chinese only. The SDK, the CLI and every code sample work the same in any language.

Chapter 8

国际化

文案文件、插值、复数

  • 文案放在 locales/<lang>.json；en.json 必需，官方插件要求 en 与 zh 齐全。
  • ctx.t(key, options)（命令里）与 panel.t(key, options)（面板里）是同一个实现：
    • key 用点分隔取嵌套值：t('errors.notFound')；
    • {{name}} 插值（不转义：面板用 React 渲染会自己转义；用 innerHTML 时请自己转义）；
    • 带 count 时取复数形式 key_one / key_other（按 Intl.PluralRules；中文只有 _other）；
    • 当前语言找不到的 key 退回英文，英文也没有就返回 key 本身。
  • 插件名（nameKey）≤ 40 字；每个命令的 title 必须在 en.json 里有文案（build 时检查）。
  • 给模型看的 description 与参数说明一律英文（模型对英文工具说明最稳定），给人看的一律走文案文件。
  • 日期时间用 toLocaleString(ctx.locale / panel.locale) 格式化；不要把 "Oct 3" 这类格式写死在文案里。