网页国际化翻译

要解决什么问题

把一个 HTML 页面推向多语言环境时，常见的做法是维护多份静态文案，再靠人工逐条对照替换。一旦页面包含动态区块、表单提示、错误信息或嵌套模板，漏翻、错翻、格式串位就成了常态；更麻烦的是，改完文案后还要重新校验标签结构，确保翻译后的文本没有撑破布局或被当成标签解析。html-i18n 想解决的就是这件事：把「从 HTML 中提取待翻译文本 → 保留结构翻译 → 回填」这条链路交给模型统一处理。

它如何工作

这个技能的核心思路是结构与内容分离。使用时把目标 HTML 交给模型，它会先识别页面中可翻译的文本节点，包括标签内的可见文字、常见文案类属性，以及需要保留占位符的动态内容。

• 提取阶段：梳理出待翻译片段，标注其上下文位置，避免把代码片段、样式值误判为自然语言。
• 翻译阶段：在保持原有标记不变的前提下产出译文，关键步骤是对变量、插值和复数形式做保留处理，防止占位符被翻译或吞掉。
• 回填阶段：将译文按原位置写回 HTML，输出可直接替换原文件的结果。

整个流程在对话中完成，不需要额外安装依赖，也不需要提前准备词表。

适用边界与注意点

• 适合页面结构清晰、文案以静态或模板形式出现的 HTML；对高度动态渲染、由前端框架在运行时拼接的长文本，效果依赖你能否把完整片段提供给模型。
• 术语一致性需要你给出约束，例如指定保留品牌词、专业名词不译，或在提示中提供术语表。
• 翻译结果建议纳入人工 review，尤其是涉及法律、医疗、金融等敏感文案时。
• 它处理的是文本翻译与结构保留，不负责布局适配；译文长度变化导致的排版问题仍需前端样式配合解决。