需启用沉浸式翻译插件、配置Qoder语言偏好、手动触发翻译、绑定AI模型及设置文档流水线。具体包括：一、启用插件并授权；二、设源语言为auto-detect、目标语言为zh-CN并开启注释翻译；三、用Alt+Shift+T快捷键选中代码翻译；四、在AI服务中选用DeepSeek-V3-Coding等模型并导入术语表；五、通过.config.yml配置自动翻译流水线并执行qoder translate --watch命令。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在 Qoder 中希望对代码文件或开发文档启用沉浸式翻译功能，但界面未显示翻译入口或翻译结果异常，则可能是由于插件未启用、语言配置缺失或代码上下文未被正确识别。以下是开启 Qoder 沉浸式翻译与代码翻译功能的具体操作路径：
一、确认并启用沉浸式翻译插件集成
Qoder 本身不内置翻译引擎，需通过已安装的沉浸式翻译浏览器插件协同工作，该插件负责解析代码块语法结构并调用后端翻译服务。必须确保插件处于激活状态且与当前网页环境兼容。
1、打开浏览器扩展管理页（Chrome：chrome://extensions/；Edge：edge://extensions/）。
2、找到“沉浸式翻译”插件，确认其右侧开关为开启状态，并勾选“在所有网站上运行”选项。
3、点击插件详情页中的“详细信息”，检查权限列表是否包含“读取和更改您在所访问网站上的数据”。
4、返回 Qoder 网页界面，右键任意代码块区域，观察右键菜单中是否出现“翻译选中内容”或“沉浸式翻译”子项。
5、若未出现，尝试刷新页面或在 Qoder 设置中关闭“代码高亮沙箱模式”（路径：设置 → 编辑器 → 安全增强 → 取消勾选“启用 DOM 隔离渲染”）。
二、配置 Qoder 内置代码翻译语言偏好
Qoder 在解析代码注释、文档字符串及错误提示时，会依据用户显式设定的语言偏好触发翻译流程。该设置独立于浏览器插件，影响代码上下文语义识别与目标语言映射准确性。
1、登录 Qoder 平台，进入右上角个人中心图标。
2、点击“QoderSetting”进入系统设置页。
3、在左侧导航栏选择“Developer Experience” → “Code Translation”。
4、将“Default source language”设为auto-detect，避免强制源语言导致注释误判。
5、将“Target display language”设为zh-CN，确保所有代码相关文本（含报错信息、文档生成内容）优先输出中文译文。
6、开启“Translate inline comments”与“Translate docstrings”两个开关。
三、在编辑器中手动触发代码块沉浸式翻译
对于单个代码片段，可通过快捷操作直接调用沉浸式翻译服务，适用于调试时快速理解第三方库报错、阅读英文文档注释或翻译 JSDoc/Python Docstring。
1、在 Qoder 编辑器中选中一段含英文注释或异常堆栈的代码区域。
2、按下快捷键Alt + Shift + T（Windows/Linux）或Option + Shift + T（macOS）。
3、弹出浮动翻译面板后，确认顶部语言标签显示为“en → zh”，若非此状态，点击语言图标手动切换。
4、点击面板右下角“Apply to Comments Only”按钮，仅翻译注释部分而不改动代码逻辑。
5、翻译完成后，译文将以悬浮气泡形式叠加在原注释行右侧，支持鼠标悬停查看与点击复制。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
四、绑定专用 AI 翻译模型提升代码术语准确性
默认翻译服务对编程术语（如“memoization”“side effect”“type coercion”）易产生泛化意译。需在 Qoder 设置中指定支持技术语境的模型，以保障术语一致性与句式严谨性。
1、进入“QoderSetting” → “AI Services” → “Translation Backend”。
2、在“Model Provider”下拉菜单中选择DeepSeek-V3-Coding或GLM-4-Code（二者均经代码语料微调）。
3、点击“Configure Model Parameters”，将“glossary_mode”设为strict，启用术语表强制匹配。
4、在“Custom Glossary JSON”文本框中粘贴以下标准代码术语映射：
{"null safety":"空安全","hot reload":"热重载","tree shaking":"摇树优化","closure":"闭包","currying":"柯里化"}
5、点击“Save & Validate”，系统将测试术语加载状态并返回校验成功提示。
五、启用项目级代码文档自动翻译流水线
针对整个代码仓库的 README.md、API 文档、单元测试说明等富文本资源，可配置后台任务定时抓取并调用沉浸式翻译 API 批量生成中文版本，无需人工逐页操作。
1、在 Qoder 项目根目录下创建 .qoder/config.yml 文件（若不存在则新建）。
2、写入以下配置项：
translation_pipeline:
enabled: true
source_patterns: ["README.md", "docs/**/*.md", "tests/**/*_test.py"]
target_locale: zh-CN
preserve_code_blocks: true
model: GLM-4-Code
3、保存后，在 Qoder 控制台执行命令：qoder translate --watch。
4、系统将监听上述路径变更，一旦检测到文件修改，立即触发后台翻译任务并生成同名_zh.md 或 _zh.py 输出文件。
