WorkBuddy支持四种GitHub README中文翻译方式：一、启用内置实时翻译功能；二、自定义CSS选择器绑定翻译作用域；三、调用GitHub API预取并翻译原始Markdown；四、接入本地离线翻译引擎保障隐私。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您在使用WorkBuddy阅读GitHub项目README文件时发现内容为非中文语言，而希望快速获取可理解的中文信息，则可能是由于WorkBuddy未启用自动翻译或翻译配置未正确关联到README解析流程。以下是实现自动翻译的多种操作方式：
一、启用WorkBuddy内置README实时翻译功能
WorkBuddy支持对GitHub页面中渲染后的Markdown内容进行DOM层捕获与即时翻译，该功能依赖浏览器扩展权限及语言检测机制，需确保其翻译模块处于激活状态。
1、点击浏览器右上角WorkBuddy图标，选择“设置”进入插件配置页。
2、在“文档处理”分类下，找到“GitHub README自动翻译”选项，将其开关切换为开启状态。
3、在“目标语言”下拉菜单中，选择简体中文作为默认输出语言。
4、返回任意GitHub仓库页面，刷新README.md预览区域，观察右上角是否出现翻译完成提示气泡。
二、通过自定义CSS选择器触发翻译锚点
部分GitHub仓库使用动态加载或非标准class命名导致WorkBuddy无法自动识别README容器，此时可通过手动指定CSS选择器强制绑定翻译作用域。
1、在GitHub仓库README页面按F12打开开发者工具，切换至Elements面板。
2、右键点击README主内容区域，选择“Inspect”，定位到最外层包裹元素，记录其class或id属性值，例如"markdown-body boxed-group"。
3、回到WorkBuddy设置页，在“高级翻译规则”中点击“添加新规则”，填入页面URL匹配模式：https://github.com/*/readme。
4、在“CSS选择器”字段中粘贴上一步获取的选择器，并勾选“启用此规则下的翻译注入”。
三、配合GitHub官方API预取翻译后Markdown
WorkBuddy可调用GitHub REST API获取原始README内容，经本地语言模型预处理后再渲染，规避前端渲染差异带来的翻译失败问题。
1、前往WorkBuddy设置页的“API集成”模块，点击“连接GitHub账号”并完成OAuth授权。
2、在“README处理策略”中选择“优先使用Raw API响应”选项。
3、启用“翻译前文本清洗”，关闭HTML标签保留，确保仅对纯Markdown文本执行语言识别。
4、在当前GitHub README页面按下快捷键Ctrl+Shift+T（Windows/Linux）或 Cmd+Shift+T（macOS），强制触发API拉取与翻译流程。
四、使用本地离线翻译引擎替代云端服务
当网络受限或需保障代码文档隐私时，WorkBuddy支持接入本地运行的翻译服务（如OpenNMT、CTranslate2），所有文本处理均在设备端完成，不上传任何内容。
1、在本地部署CTranslate2模型，启动HTTP服务监听端口8081，确保响应路径为/translate且接受POST JSON请求。
2、进入WorkBuddy设置页“翻译引擎”栏目，选择“自定义HTTP翻译服务”。
3、填写服务地址为http://127.0.0.1:8081/translate，设置请求头Content-Type为application/json。
4、保存配置后，在GitHub README页面长按右键，从上下文菜单中选择“用本地引擎翻译当前段落”。
