在 GitHub 文档翻译工具项目中，你是如何规划整体架构的？该架构由哪些核心模块构成？

回答思路

1. 【回答框架 1】该项目架构通常采用分层或模块化设计，核心是分离翻译流程、文档处理、用户交互与外部服务对接。主要模块包括文档解析模块，负责读取并解析 GitHub 上的 Markdown、HTML 等格式文件，提取文本内容并保留格式结构。
2. 【回答框架 2】翻译引擎模块是核心，负责调用翻译服务（如 Google 翻译、DeepL 或自研模型），对提取的文本进行批量翻译，并处理速率限制、重试与错误回退。该模块需设计为可替换接口，以适配不同翻译服务。
3. 【回答框架 3】文档重建模块将翻译后的文本按原格式结构重新组装，生成目标语言文档，并处理链接、代码块、图片等特殊元素的保留与路径调整。
4. 【回答框架 4】任务调度与缓存模块管理翻译任务队列，支持并发处理与去重，同时缓存已翻译片段以减少重复调用和成本。
5. 【回答框架 5】用户接口与配置模块提供命令行、Web 界面或 API 入口，支持配置目标语言、文件范围、翻译服务等参数，并展示任务进度与结果。各模块通过清晰接口协作，降低耦合，便于扩展与维护。
6. 【关键点 1】架构采用模块化设计，各模块职责单一且通过接口交互。
7. 【关键点 2】核心模块包括文档解析、翻译引擎、文档重建、任务调度与缓存、用户接口。
8. 【关键点 3】翻译引擎设计为可替换抽象，便于集成不同翻译服务。
9. 【关键点 4】缓存与任务队列提高效率，减少重复翻译和外部调用。
10. 【关键点 5】文档重建保留原始格式与结构，保证输出可用性。
11. 【易错点 1】架构设计时容易忽略错误处理与重试机制，导致翻译任务失败中断。
12. 【易错点 2】模块间耦合过紧，例如将解析与重建逻辑混在一起，影响后续维护。
13. 【易错点 3】未考虑外部翻译服务的速率限制与配额，可能造成任务堆积或超时。