可借助codebuddy与i18n-mcp协同实现前端中文硬编码自动化国际化改造：先用codebuddy提取中文字符串生成raw-zh.txt，再用i18n-mcp生成语义化key及多语言文件，接着用codebuddy比对验证并修正边界场景，最后集成vue i18n完成运行时替换。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您正在维护一个前端项目，但发现其中散落着大量硬编码中文字符串，手动替换为 i18n key 不仅效率低下且极易遗漏或出错，则可借助 CodeBuddy 的辅助能力与 i18n-mcp 工具链协同完成自动化改造。以下是具体实施路径：
一、利用 CodeBuddy 提取并预处理源码中的中文字符串
CodeBuddy 本身不直接执行 AST 级代码改写，但其“源码解析”模块可快速加载 HTML/JS/TS 文件内容，并结合正则规则高亮、筛选、导出所有连续中文字符段。该步骤旨在生成待治理的原始文案清单，为后续 i18n-mcp 输入提供结构化文本基础。
1、在 CodeBuddy 主界面选择【源码解析】工具模块。
2、点击“上传文件”按钮，批量导入项目中需处理的 .vue、.ts、.js 文件。
3、在解析设置中启用“提取中文字符串”选项，并关闭“自动翻译”与“格式化 JSON”等无关功能。
4、点击“开始解析”，系统将逐行扫描并识别 Unicode 范围 \u4e00-\u9fa5 内的连续字符序列，过滤掉注释块与字符串外的中文（如 HTML 标签属性值需额外配置白名单）。
5、导出结果为纯文本列表，每行一条未去重中文文案，保存为 raw-zh.txt。
二、调用 i18n-mcp 进行智能 Key 生成与翻译
i18n-mcp 是专为前端国际化设计的 CLI 工具，支持基于上下文的语义化 Key 推断与缓存驱动的低开销翻译。它接收原始中文列表，输出标准化的多语言资源文件及 AST 替换映射表，是实现无损代码改造的核心环节。
1、在项目根目录执行命令：npx i18n-mcp extract --input raw-zh.txt --output src/locales/zh.ts。
2、工具自动对 raw-zh.txt 内容进行去重，并依据所在文件路径、父级标签名、相邻 JSX 属性等上下文，为每条文案生成唯一 Key，例如 <button>提交</button> 生成 submitButtonLabel。
3、检查生成的 zh.ts 文件，确认 Key 命名符合团队规范；若需调整策略，可修改 .i18nrc.json 中的 keyGenerationStrategy 配置项。
4、运行翻译命令：npx i18n-mcp translate --source zh --target en --cache ./translation-cache.json，自动生成 en.ts 并复用历史翻译结果。
CodeBuddy Code CLI 的安装、配置与使用指南。CodeBuddy Code 是腾讯推出的 AI 驱动 CLI 编程助手，支持自然语言驱动开发。 - 必备触发词：CodeBuddy, codebuddy, AI CLI, Tencent AI coding, @tencent-ai/codebuddy-code, terminal AI assistant - 适用场景：安装 CodeBuddy CLI、配置 CodeBuddy、使用 CodeBuddy 命令、排查 CodeBuddy 问题
三、使用 CodeBuddy 辅助验证与局部手动修正
自动化流程无法覆盖全部边界场景，例如动态拼接字符串、带变量插值的模板、或含 HTML 标签的富文本。此时可借助 CodeBuddy 的“文本比对”与“代码片段运行”功能，对可疑区域做人工校验与微调。
1、将原始文件与经 i18n-mcp 处理后的文件分别粘贴至 CodeBuddy 【文本比对】面板左右两侧。
2、观察差异高亮区域，重点关注 t('xxx') 调用是否完整包裹原字符串，以及插值语法（如 `${t('hello')}, ${name}`）是否被正确保留。
3、对未被识别的拼接文案，切换至【代码片段运行】模块，输入简易 JS 模拟环境，验证 t 函数调用行为是否符合预期。
4、将修正后的代码块复制回项目，确保所有 data-i18n 属性或 t() 调用均指向已声明 Key。
四、集成 Vue I18n 或 i18next 完成运行时替换
完成代码层替换后，需在运行时注入翻译能力。CodeBuddy 不提供框架绑定逻辑，但可快速生成初始化脚本模板，帮助开发者跳过样板代码编写阶段。
1、在 CodeBuddy 【代码生成】模块中选择“Vue I18n 初始化”模板。
2、输入项目语言列表（如 ['zh', 'en']）、默认语言（zh）、资源文件路径（src/locales）。
3、点击生成，获得包含 createI18n 实例、自动加载 locale 文件、监听 localStorage 语言变更的完整 setup 代码。
4、将生成代码保存为 src/i18n/index.ts，并在 main.ts 中通过 app.use(i18n) 注册。
5、验证页面中所有 或 {{ t('welcome') }} 是否实时响应语言切换。
