HTML代码精准翻译，保留标签不破坏布局
核心思路是使用正则表达式精准分离HTML标签与待翻译文本，通过翻译云API的“仅翻译文本”模式，结合异步并发与Webhook回调，实现大批量文件的高效、无损翻译。
1 获取并配置API鉴权Token
登录翻译云控制台，点击左侧导航栏【API管理】->【我的密钥】，复制您的SecretId和SecretKey。在您的脚本环境变量中，将其配置为FY_SECRET_ID和FY_SECRET_KEY。
2 封装异步并发请求脚手架
使用Python的asyncio与aiohttp库。编写函数，先用正则r‘<[^>]+>’匹配并临时替换所有HTML标签为占位符（如{TAG_1}），将纯文本内容通过POST请求发送至翻译云API端点https://api.fanyiyun.com/translate，请求体参数preserve_format设置为true。
3 处理Webhook回调与结果重组
在API请求中指定callback_url为您服务器的接收端点。当翻译完成后，翻译云会向该URL发送POST回调，数据体包含request_id和翻译后的文本数组。您的服务接收到后，根据原占位符映射关系，将翻译文本精准插回原HTML标签之间，生成最终文件。
在请求 Header 中加入 `X-Fanyiyun-Priority: high` 提升队列优先级，并使用异步 Webhook 接收回调避免超时。
常见操作避坑指南
Q：正则提取后，文本顺序错乱导致重组时标签和内容不匹配。
A：在创建占位符时，必须使用有序的、全局唯一的标识符（如UUID），并建立映射字典。重组时严格按此字典进行反向替换，避免因文本中的尖括号等特殊字符干扰匹配。
Q：高并发下大量文件处理，遭遇API限流（状态码429）。
A：在脚手架中集成指数退避重试逻辑，并确保在请求头中已加入
X-Fanyiyun-Priority: high。对于超大批量任务，建议联系技术支持开通企业级并发配额。⚠️ 技术规范与免责声明：本文档提供的配置指令与操作步骤基于翻译云当前最新版本。受限于源文档的加密级别、扫描件分辨率及第三方软件（如 InDesign/WPS）的底层排版逻辑差异，最终翻译与排版还原效果可能存在合理波动。涉及机密合同与财务数据的处理，请务必在工作台中开启「阅后即焚」或使用企业级私有化部署方案。
