qoder 提供五种自动化翻译方案：一、ide 行间内联翻译；二、ai 聊天面板批量翻译；三、配置规则文件实现静默翻译；四、桌面版 pdf/md 双栏侧边翻译；五、cli 批量处理源码注释。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当您在阅读英文技术文档或源码注释时，频繁切换翻译工具、手动复制粘贴、上下文丢失导致译文不准确，这些问题会显著拖慢理解效率。Qoder 提供原生集成的自动化翻译能力，支持在 IDE 内实时、上下文感知地完成文档与注释的精准翻译。以下是实现该能力的多种方法：
一、启用行间内联翻译（IDE 插件版）
该方法利用 Qoder 的行间对话能力，在不离开当前编辑位置的前提下，对选中的英文注释或文档段落进行即时翻译，保留原始代码结构与语义关联。
1、在 IntelliJ IDEA 或 PyCharm 中打开含英文注释的 Java/Python 文件。
2、用鼠标选中一段英文注释（例如 /** Validates user input against regex pattern */）。
3、右键点击选中文本，选择 Qoder → Translate to Chinese。
4、等待 1–2 秒，翻译结果将以悬浮气泡形式显示在光标旁，内容为：“根据正则表达式模式验证用户输入”。
5、如需插入翻译至注释中，点击气泡右下角的 → 插入为中文注释 按钮。
二、使用 AI 聊天面板批量翻译文档片段
适用于长篇英文 README.md、Javadoc 或 API 文档节选，通过上下文感知模型保障术语一致性与句式连贯性，避免零散翻译造成的语义断裂。
1、按下快捷键 ⌘⇧L（macOS）或 Ctrl+Shift+L（Windows/Linux） 打开 Qoder 聊天面板。
2、在输入框中粘贴待翻译的英文段落（例如 Spring Boot 官方文档中一段关于 @ConditionalOnProperty 的说明）。
3、输入指令：请将以下英文技术文档翻译为简体中文，保持专业术语准确（如 @ConditionalOnProperty 不译），保留代码块与缩进格式。
4、点击发送，Qoder 将返回带格式保留的中文译文，并自动高亮关键注解类名与参数名。
5、点击回复下方的 插入到编辑器 按钮，译文将按原位置插入当前文件光标处。
三、配置自动注释翻译规则（.qoder/rules/translate.md）
通过声明式规则文件，使 Qoder 在代码扫描阶段主动识别并翻译特定模式的英文注释，实现“零操作”静默翻译，特别适合团队统一维护多语言文档。
1、在项目根目录创建隐藏文件夹 .qoder/rules/。
2、新建文件 translate.md，写入以下内容：
rule: auto-translate-javadoc
match: /^\/\*\*[\s\S]*?\*\//gm
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
action: translate-to-zh-CN
preserve-tags: true
3、保存后重启 Qoder 或执行 Qoder → Reload Rules。
4、打开任意含 Javadoc 的 Java 类，Qoder 将在状态栏显示 [✓] 注释翻译规则已激活。
5、将鼠标悬停于任一 Javadoc 块上方，即刻浮现中文翻译摘要；双击可展开完整译文。
四、桌面版专属：PDF/MD 文档侧边翻译视图
针对离线英文 PDF 技术手册或本地 Markdown 文档，Qoder 桌面版提供双栏同步滚动翻译视图，左侧原文、右侧译文实时联动，支持术语库绑定与历史记录回溯。
1、启动 Qoder 桌面版（非插件），点击菜单栏 File → Open Document，选择英文 PDF 或 .md 文件。
2、文件加载完成后，点击右上角 Translate View 图标（图标为两页重叠带箭头）。
3、在弹出面板中选择目标语言为 简体中文，勾选 启用术语库（Spring/Java/Kubernetes）。
4、左侧原文滚动时，右侧译文自动同步定位，且关键术语（如 Ingress Controller）始终译为 入口控制器 而非字面直译。
5、点击某段译文右侧的星标图标，将其加入个人术语收藏夹，后续所有文档中该词均强制采用此译法。
五、CLI 模式下批量翻译源码注释（qoder translate）
适用于 CI/CD 流程或批量处理遗留项目，通过命令行调用 Qoder CLI 工具，对整个模块的源码注释执行结构化翻译并生成 bilingual-comments 分支。
1、确保已安装 Qoder CLI 并完成登录：qoder login --email your@domain.com。
2、进入项目根目录，执行：qoder translate --lang zh-CN --target src/main/java/com/example/ --format javadoc --output bilingual-comments。
3、命令运行期间，终端显示实时进度：[✓] 已处理 42/189 个 Javadoc 块 | 术语匹配率 96.3%。
4、执行完毕后，新分支 bilingual-comments 自动创建，其中每个 Java 文件的英文注释下方新增 // [zh] …… 格式中文对照行。
5、运行 git checkout bilingual-comments && git push origin bilingual-comments，即可推送双语注释至代码仓库。
