GitHub 中文化插件使用指南

核心功能解析

GitHub 中文化插件是一款能够将 GitHub 界面元素转换为中文的浏览器增强程序，主要提供以下核心能力：

• 界面元素全量翻译：自动将页面中的菜单、按钮、提示文本等界面组件转换为中文
• 双语对照支持：保留部分专业术语的英文原文，确保技术表述准确性
• 自适应主题兼容：完美适配 GitHub 浅色/深色模式，保持界面美观度
• 实时更新机制：通过词库动态更新，持续优化翻译质量

快速上手步骤

准备工作

🔍 安装用户脚本管理器（二选一）：

• Tampermonkey：适用于 Chrome、Edge、Firefox 等主流浏览器
• Violentmonkey：轻量级选择，支持多浏览器环境

安装插件

🔍 选择合适的安装渠道：

1. 开发版：适合希望体验最新功能的用户
2. 稳定版：适合注重使用稳定性的用户

安装过程中，脚本管理器会自动弹出确认窗口，点击"安装"即可完成。

验证安装

🔍 安装完成后：

1. 访问 GitHub 网站
2. 观察页面元素是否已转为中文显示
3. 如有未翻译内容，可尝试刷新页面

进阶配置说明

本地词库定制

💡 高级用户可通过以下步骤自定义翻译内容：

1. 启用脚本管理器的"允许访问文件网址"设置
2. 克隆项目仓库：git clone https://gitcode.com/gh_mirrors/gi/github-chinese
3. 修改本地词库文件（locals.js 或对应语言版本）
4. 在脚本管理器中替换脚本的词库加载路径

主题切换

📌 插件会自动适应 GitHub 的主题设置：

• 浅色模式：对应 preview/img1.png 显示效果
• 深色模式：对应 preview/img3.png 显示效果

技术原理简析

该插件通过以下技术路径实现界面翻译：

1. DOM 元素监听：实时监测页面加载的 HTML 元素
2. 翻译规则匹配：根据预设的选择器和翻译词库进行内容替换
3. 动态注入机制：在不影响原有功能的前提下修改页面显示内容
4. 样式保持策略：确保翻译后页面布局和样式不受影响

核心实现文件包括：

• main.user.js：主脚本执行逻辑
• locals.js：默认中文词库
• t2s_rules.conf：繁简转换规则配置

常见问题解决

安装问题

Q: 安装后插件不生效怎么办？ A: 尝试以下步骤：

1. 确认脚本管理器已启用该脚本
2. 清除浏览器缓存并刷新页面
3. 检查脚本管理器是否有更新

兼容性问题

Q: Chrome 127+ 版本无法使用怎么办？ A: 确保您的脚本管理器已更新至支持 Manifest V3 的版本，建议使用 Tampermonkey v4.18+ 或 Violentmonkey v2.13+。

翻译质量问题

Q: 发现翻译不准确或遗漏怎么办？ A: 可以通过项目仓库提交 issue，或修改本地词库文件并提交 Pull Request。

使用注意事项

📌 重要提示：

• 插件仅修改页面显示内容，不会影响 GitHub 的功能和数据
• 对于动态加载的内容，可能需要短暂延迟才能完成翻译
• 随着 GitHub 界面更新，部分新元素可能暂时未被翻译
• 建议定期更新插件以获取最佳翻译效果

通过以上指南，您应该能够顺利使用 GitHub 中文化插件，享受更友好的中文界面体验。如有其他问题，欢迎参与项目讨论或提交反馈。