CSS注释与代码分离翻译方案
核心思路是使用翻译云API的“内容类型标记”功能，通过正则表达式预处理CSS文件，将注释内容与CSS属性值/选择器进行隔离标记，确保翻译引擎仅处理注释部分，避免破坏代码结构。
1 获取并配置API鉴权Token
登录翻译云控制台，点击左侧导航栏【API管理】->【我的密钥】，复制您的SecretId和SecretKey。在您的脚本环境变量中配置：export FY_SECRET_ID='your_id' 与 export FY_SECRET_KEY='your_key'。
2 封装异步并发请求脚手架
使用Node.js的async库或Python的asyncio封装批量请求。关键是在发送请求前，用正则/\/\*[\s\S]*?\*\/|\/\/.*$/gm匹配CSS注释，并将其内容替换为如<tran>原文注释</tran>的标记。将处理后的文本放入API请求体的Content字段。
在请求 Header 中加入 `X-Fanyiyun-Priority: high` 提升队列优先级，并使用异步 Webhook 接收回调避免超时。
3 处理Webhook回调与结果还原
在翻译云控制台【项目设置】->【Webhook配置】中，填写您的回调URL。API处理完成后，会将包含<tran>翻译后注释</tran>标记的结果POST到该URL。您的服务接收到回调后，需解析JSON，提取translatedContent，并反向将标记还原为CSS注释格式/* 翻译后注释 */，写回原文件。
常见操作避坑指南
Q：正则匹配后，内联注释`//`导致下一行属性被误标记？
A：将正则表达式修改为
/\/\*[\s\S]*?\*\/|\/\/[^\n\r]*/gm，并确保在替换标记后，对源文件按行处理，避免跨行匹配。Q：高并发下触发API限流，返回`429 Too Many Requests`错误？
A：在脚手架中集成指数退避重试逻辑，并检查请求头是否已正确设置
X-Fanyiyun-Priority: high。同时，在控制台【配额管理】中申请提升QPS限制。⚠️ 技术规范与免责声明：本文档提供的配置指令与操作步骤基于翻译云当前最新版本。受限于源文档的加密级别、扫描件分辨率及第三方软件（如 InDesign/WPS）的底层排版逻辑差异，最终翻译与排版还原效果可能存在合理波动。涉及机密合同与财务数据的处理，请务必在工作台中开启「阅后即焚」或使用企业级私有化部署方案。
