分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

setube/github-chinese

效率与系统工具

在本地把 GitHub 界面翻译成简体或繁体中文的浏览器扩展,只译界面,不改用户内容。

181
13
TypeScript
MIT
创建于 6 天前

项目介绍

GitHub 界面默认是英文,中文用户浏览仓库、议题、设置时容易卡在术语上。这个扩展在 github.com、gist.github.com 和 www.githubstatus.com 上把界面文字替换成简体中文或繁体中文,翻译全部在本地完成。

它只翻译界面,不碰用户内容:自述文件、评论、代码、提交消息、仓库名、用户名和自定义标签都保持原文。简繁两套词典各 3 万余条,按页面类型(仓库、议题、拉取请求、Actions、设置等)分文件组织。繁体不是由简体转换而来,而是按台湾、香港、澳门用语从英文翻译,简繁术语表分别记录在简体和繁体文档里。翻译跟随 GitHub 的 React 渲染和页面切换进行,文字被框架改写后会重新翻译;aria-label、placeholder、title 等属性和标签页标题一并处理,<relative-time> 按翻译语言显示为「3 天前」「2026 年 10 月 26 日」。

另有一个默认关闭的加速功能,把下载链接、HTTPS 克隆地址和加载失败的图片改走第三方加速源,加速源可自定义、删除和测速。

快速使用

最省事的方式是从商店安装:Chrome 应用商店、Microsoft Edge 加载项或 Firefox 附加组件。安装后立即生效,已打开的 GitHub 页面无需刷新。

也可以从发行版下载压缩包手动加载:

  • Chrome:下载 github-chinese-<版本>-chrome.zip,解压后打开 chrome://extensions,开启「开发者模式」,点「加载已解压的扩展程序」选择解压出的文件夹。
  • Edge:下载 github-chinese-<版本>-edge.zip,在 edge://extensions 中开启「开发人员模式」,同样加载解压后的文件夹。
  • Firefox:下载 github-chinese-<版本>-firefox.xpi,已签名版本用 Firefox 打开即安装;未签名版本通过 about:debugging#/runtime/this-firefox 的「临时载入附加组件」加载,重启浏览器后失效。

Safari(macOS)需要 macOS 13+、Safari 18+。宿主应用未签名、未经公证,解压并把「GitHub Chinese.app」放进应用程序后,先解除隔离:

xattr -dr com.apple.quarantine "/Applications/GitHub Chinese.app"

然后打开一次该应用完成扩展注册,在 Safari「开发者」菜单勾选「允许未签名的扩展」,再到「设置」→「扩展」中授权三个站点。该选项在退出 Safari 后失效,每次启动都要重新勾选。

从源码构建需要 Bun 1.3+ 和 Node.js 22.13+:

git clone https://github.com/setube/github-chinese.git
cd github-chinese
bun install
bun run build

产物在 .output/chrome-mv3,Edge、Firefox、Safari 分别用 build:edge、build:firefox、build:safari。加载方式与上面的解压安装相同。

设置与页面控制

弹出页提供总开关、当前页状态、排除此页、时间本地化、翻译标题、加速下载、界面语言、翻译语言和外观。翻译语言默认按浏览器语言识别:语言列表中第一个中文若是台湾、香港、澳门或 Hant 就用繁体,没有中文时按时区判断;手动切换后已打开的页面随即重译。

选项页可以设置排除路径(每行一条,以 / 开头,不区分大小写,* 匹配一段、** 匹配任意多段),维护以 {"原文": "译文"} JSON 导入导出的自定义词条,以及配置加速。

使用约束

  • 浏览器支持:Chrome、Edge 需支持 Manifest V3,Firefox 140+,Firefox Android 142+,Safari 18+(macOS)。
  • 翻译在本地完成,不向开发者发送数据;开启加速后,下载链接、克隆地址和加载失败的图片地址会交给你选的第三方加速源。
  • 加速源地址只接受 https,用 {url} 或 {path} 占位;各内置加速源支持的地址范围不同,且都是第三方公益服务,可用性随时变化,加速源能看到你的 IP 和下载地址,也能改动下载的文件。用加速地址克隆后远程地址指向加速源,推送时凭据会发给加速源,推送前用 git remote set-url origin https://github.com/<owner>/<repo>.git 改回 GitHub。
  • 私有、内部仓库和私密代码片段不加速。页面的 CSS、JS 不加速,因为 GitHub 的内容安全策略只允许从 github.githubassets.com 加载。
  • 设置存 storage.sync,可能随浏览器账号同步;自定义词条存 storage.local。
  • 许可证为 MIT。繁体词典是从英文独立翻译的,不是简繁转换。

HotRepo 点评

本站对 GitHub 中文化的记录只有一条:2026-11-01 它以 174 星、13 复刻出现在 TypeScript 新项目榜,统计窗口为 2026-10-31 13:45 UTC 至 2026-11-01 09:45 UTC,窗口内新增 74 星。同一窗口的逐小时 Star 采样从 100 平缓走到 174,看不出突然跳涨,符合一个刚发布、稳步积累的年轻仓库。没有记录到全语言日榜名次,因此不能据此把它放到 GitHub 日榜上讨论。从技术上看,它值得注意的地方是繁体词典按港澳台用语从英文翻译,并用简繁对照检查保证两边结构一致,这使它区别于只做简繁转换的翻译扩展。

本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。