Menu
NaiveTab 浏览器扩展的 i18n 国际化开发指南。当用户要新增/修改翻译文本、添加多语言 key 时使用。涵盖中英文同步更新规则、变量替换模式等，防止遗漏或格式错误。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | add-i18n-locale |
| description | NaiveTab 浏览器扩展的 i18n 国际化开发指南。当用户要新增/修改翻译文本、添加多语言 key 时使用。涵盖中英文同步更新规则、变量替换模式等，防止遗漏或格式错误。 |
新增或修改 i18n 翻译文本需遵守以下规则。
src/locales/zh-CN.jsonsrc/locales/en-US.json两个文件必须同步更新，不能只改一个。
采用扁平嵌套结构，按功能分组：
{
"common": {
"save": "保存",
"cancel": "取消"
},
"setting": {
"group": {
"myPane": "我的面板"
}
}
}
引用方式：window.$t('common.save') 或模板中 $t('setting.group.myPane')。
使用 __key__ 占位符 + .replace() 方式，禁止使用 vue-i18n 默认的 {key} 语法：
<!-- 正确 -->
{{ $t('key.xxx').replace('__n__', value) }}
<!-- 错误 -->
{{ $t('key.xxx', { n: value }) }}
// 正确
window.$t('key.xxx').replace('__count__', String(count))
所有面向用户的文本都必须 i18n，包括但不限于：
title/content/positiveText/negativeTextshowToast / $notification 文案placeholder、按钮文案labelKeyNaiveTab 浏览器扩展的 Widget 开发指南。当用户要在 newtab-naivetab 项目中新增 Widget 组件、添加新功能组件时使用。涵盖需要修改的完整文件清单、配置规范、类型注册等，防止遗漏关键步骤。
NaiveTab 浏览器扩展的 Setting 面板开发指南。当用户要新增 Setting 设置面板、添加新的设置页时使用。涵盖需要修改的完整文件清单、注册规范等，防止遗漏关键步骤。
NaiveTab 浏览器扩展的配置迁移开发指南。当用户要修改持久化配置结构（新增/重命名/删除字段、修改类型）时使用。强制走 handleAppUpdate 迁移流程，防止破坏老用户数据。
NaiveTab 浏览器扩展的全局命令快捷键开发指南。当用户要新增/修改命令快捷键（如新增 tab 操作、页面滚动、窗口操作等命令）时使用。涵盖需要修改的完整文件清单、执行环境分类、类型注册等，防止遗漏关键步骤。