多语言（i18n）

芯片模板支持多语言，通过 i18n/ 目录下的翻译文件实现 UI 标签的国际化。

文件位置

i18n/
└── zh-CN.cjs        # 简体中文翻译文件

翻译文件格式

zh-CN.cjs 是一个键值对映射表，键为英文原文，值为中文翻译：

module.exports = {
  'ADC Injected Conversion Mode': 'ADC 注入转换模式',
  'ADC Regular Conversion Mode': 'ADC 常规转换模式',
  'ADC Settings': 'ADC 设置',
  'ADC WatchDog': 'ADC 看门狗',
  'Activate Clock Source': '激活时钟源',
  'Advanced Parameters': '高级参数',
  'Analog Watchdog': '模拟看门狗',
  'Asynchronous': '异步',
  'Baud Rate': '波特率',
  'Channel': '通道',
  'Continuous Conversion Mode': '连续转换模式',
  'Data Alignment': '数据对齐',
  // ... 共 700+ 条翻译
}

使用方法

默认情况下，UI 配置中的 label 和提示文本直接写英文即可，系统底层会自动查表翻译为中文：

// 直接写英文，系统自动翻译为中文
parameters: {
  BaudRate: {
    label: 'Baud Rate',          // → 自动查表翻译为 '波特率'
    type: 'input',
    value: '115200'
  },
  Mode: {
    label: 'Mode',
    type: 'select',
    options: [
      { label: 'Asynchronous', value: 'asynchronous' },  // → '异步'
      { label: 'Synchronous', value: 'synchronous' }     // → '同步'
    ]
  }
}

也支持显式调用 t() 函数，两种写法等效：

label: 'Baud Rate'       // 自动翻译（推荐）
label: t('Baud Rate')    // 显式调用（等效）

翻译流程

UI 配置文件                    i18n/zh-CN.cjs              显示
────────────────────────────────────────────────────────────────
label: 'Baud Rate'  ──→  'Baud Rate': '波特率'     ──→   波特率
label: 'Asynchronous' ──→  'Asynchronous': '异步'   ──→   异步

添加新语言

新增语言时创建对应的翻译文件即可，例如英文版 i18n/en-US.cjs：

// i18n/en-US.cjs — 英文（原文即英文，可留空或直接返回原值）
module.exports = {}

翻译覆盖范围

zh-CN.cjs 当前覆盖的翻译类别：

类别	示例
外设参数标签	'Baud Rate', 'Stop Bits', 'Word Length'
模式选项	'Asynchronous', 'Synchronous', 'Master', 'Slave'
状态描述	'Enable', 'Disable', 'Active'
时序参数	'1.5 Cycles', '7.5 Cycles', '13.5 Cycles'
ADC 专用	'ADC Injected Conversion Mode', 'Scan Conversion Mode'
GPIO 专用	'analog input', 'floating input', 'output push-pull'
时钟树	'Activate Clock Source', 'Clock Security System'
通用	'Advanced Parameters', 'Settings', 'Channel'