实战型多语言站点Python脚本编写提示词

角色定义与任务定位

请以“实战型全栈开发工程师”的身份，运用你的Python开发与国际化（i18n）项目经验。你的核心目标是：根据给定的多语言站点功能需求，构思并编写出结构清晰、可维护、符合最佳实践的Python脚本方案。你的产出不是理论探讨，而是能直接指导编码或作为代码生成器提示词的实用蓝图。

适用场景

• 为静态站点生成器（如Hugo、Jekyll）编写多语言内容同步与部署脚本。
• 开发用于提取、转换、加载（ETL）网站多语言词条（如JSON、YAML格式）的自动化工具。
• 构建连接翻译API（如Google Translate, DeepL）与内容管理系统（CMS）的桥梁脚本。
• 编写检测站点国际化完整度（如缺失翻译、过期词条）的监控与报告脚本。
• 创建管理多语言路由、URL映射或语言偏好设置的辅助脚本。

核心提示词

以下提示词组合可直接用于引导代码生成或结构化你的开发思路：

• 基础框架：“编写一个Python脚本，使用`gettext`模块或`babel`库，自动化处理项目中的`.po`和`.mo`文件编译与合并流程。”
• 数据提取与转换：“设计一个脚本，从数据库或多个JSON文件中读取原始词条，按语言代码（如‘zh-CN’, ‘en-US’）分类清洗，并输出为标准化的翻译文件格式。”
• API集成：“创建一个脚本，集成DeepL API，自动翻译指定目录下的Markdown文件中的特定HTML标签内容，并保留原始格式与占位符。”
• 质量检查：“开发一个脚本，递归扫描模板文件（如.html, .jsx），对比不同语言包，找出未被引用的冗余翻译词条或尚未翻译的源文本。”
• 部署辅助：“编写一个脚本，在CI/CD流程中运行，根据目标语言环境变量，动态生成或替换站点配置文件中的静态资源路径与元标签。”

风格方向

• 代码风格：遵循PEP 8规范，注重模块化设计。函数职责单一，使用类型提示（Type Hints）增强可读性。错误处理应使用try-except块并记录到日志文件。
• 脚本风格：提供清晰的命令行接口（使用`argparse`或`click`库），包含`--help`说明、`--source`源路径、`--target-language`目标语言等可配置参数。
• 输出风格：控制台输出应结构化（如使用`logging`分级输出：INFO、WARNING、ERROR）。报告类输出优先生成JSON或CSV文件，便于后续分析。

构图建议（逻辑结构）

• 导入区：集中导入标准库（`os`, `json`, `argparse`）和第三方依赖（`polib`, `python-i18n`, `requests`）。
• 配置区：定义常量（如语言代码映射、API端点、文件扩展名）或从外部配置文件（如`config.yaml`）加载设置。
• 核心函数区：按功能划分函数，例如：`extract_strings()`, `call_translation_api()`, `validate_translations()`, `generate_report()`。
• 主流程控制：在`if __name__ == "__main__":`块中，解析参数，按顺序调用函数，并处理全局异常。
• 文档字符串：为每个模块、函数和类编写详细的docstring，说明其目的、参数和返回值。

细节强化

• 编码处理：明确指定文件读写编码为`utf-8`，使用`with open(...) as f`确保文件正确关闭。
• 路径处理：使用`pathlib.Path`对象进行跨平台的路径操作，增强可读性和可靠性。
• 敏感信息：提醒将API密钥等敏感信息存储在环境变量中，而非硬编码在脚本内。
• 性能考量：处理大量文件时，考虑使用异步IO（`asyncio`）或并行处理（`concurrent.futures`）来优化速度。
• 兼容性：注明脚本所需的Python最低版本（如Python 3.8+）及必要的第三方库及其版本。

使用建议

• 将上述“核心提示词”中的任意一条，结合“细节强化”中的要点，直接输入至AI代码助手或作为你自己编码的提纲。
• 在实际运行脚本前，务必在隔离环境（如虚拟环境）中测试，尤其涉及文件覆盖或API调用时。
• 可根据具体项目技术栈（如Django, Flask, Vue.js i18n），调整脚本处理的文件格式和流程细节。
• 建议将通用功能封装为独立的Python包，方便在不同项目中复用，并通过`setup.py`或`pyproject.toml`管理依赖。