Skip to content
cddd-yinPublic

About

GitHub 界面中文化油猴脚本:只翻译界面词汇,不碰代码、文件名、正文和用户名。

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

7 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

GitHub 中文化(油猴脚本)

把 GitHub 的界面词汇翻译成中文的 Tampermonkey(油猴)脚本。 只翻界面,不碰代码、文件名、README / 议题正文、提交信息和用户名——比浏览器整页机翻干净得多。

为什么不用浏览器翻译?

浏览器整页翻译会把代码、文件路径、Issue 正文、用户名一起翻掉:语法高亮里的 const 会变成「常量」,报错信息翻得没法搜索,链接也可能被改坏。本脚本采用整节点精确匹配:只有整个文本恰好是界面词汇时才翻译,并主动跳过代码、文件名、正文等区域。

安装

前置要求(Chrome 138+)

Chrome 新版默认禁止油猴执行脚本:请在 chrome://extensions 中找到「篡改猴 / Tampermonkey」→「详情」→ 打开「允许用户脚本」开关(或者打开扩展页右上角的「开发者模式」)。否则任何油猴脚本都不会运行(本脚本、其他汉化脚本都一样)。

方式一:本地 URL 安装(本机推荐)

  1. 在项目根目录启动本地服务(只监听 127.0.0.1):

    powershell -ExecutionPolicy Bypass -File tests\serve.ps1
  2. 在浏览器打开 http://127.0.0.1:8787/GitHub-中文化.user.js

  3. 油猴会拦截并弹出安装页,点「安装」即可。

仓库当前为私有(个人使用):raw.githubusercontent.com 的链接需要登录才能访问,所以「从 GitHub 安装 + 自动更新」在仓库公开前不可用(不影响本机使用)。将仓库设为公开后,安装与 @updateURL 自动更新即可正常工作。

方式二:手动安装

油猴面板 → 「添加新脚本」→ 粘贴 GitHub-中文化.user.js 全文 → Ctrl+S 保存。

功能

  • 导航、仓库页签、按钮、设置、Actions、Issues / PR 等界面词汇翻译;
  • 个人主页:屏蔽 / 举报、热门仓库、贡献图(月份、星期、贡献等级)、活动概览与活动列表(Created 42 commits in 4 repositories → 在 4 个仓库中创建了 42 个提交);
  • 中文日期与相对时间:Oct 5, 2026 → 2026年10月5日、2 days ago → 2 天前(含 Shadow DOM 中 <relative-time> 组件渲染的时间);
  • 动态句式:48,917 Commits → 48,917 个提交、This branch is 3 commits ahead of main. → 此分支领先 main 3 个提交。;
  • 悬停提示、输入框占位符、无障碍标签(title / placeholder / aria-label / alt)同步翻译;
  • Actions(操作)页:表头(工作流 / 事件 / 执行者)、运行时长(3m 40s → 3 分 40 秒)、工作流运行计数;
  • 议题 / 拉取请求列表:全部 / 搜索、各类「按…筛选」、排序与分页提示、opened、成员标识;
  • 发行版页:released this、Assets、Jump to release、Tag、提交签名校验等;
  • 全站页脚与站点地图栏目(平台 / 功能 / 资源 / 社交链接等)、on <日期> 与带时区的时间戳;
  • 适配 GitHub 无刷新导航(Turbo / PJAX),新加载的内容自动翻译;
  • 油猴菜单可随时开关,关闭时还原成英文。

不会翻译的区域(设计如此)

  • 代码、diff、行内代码(code / pre / .highlight / 新版代码视图)
  • README、Issue / 评论正文(.markdown-body)
  • 文件名、目录名、面包屑路径
  • Issue / PR 标题、提交信息、用户名
  • 搜索筛选框(防止 is:open 被改成 is:打开)

测试与验证

测试 运行方式 实测结果(2026-10-06)
单元断言 ×97 启动 tests\serve.ps1 后运行 powershell -ExecutionPolicy Bypass -File tests\e2e\run-unit.ps1(或手动打开 http://127.0.0.1:8787/tests/test.html) ✅ 97 / 97 通过
个人主页体检 powershell -ExecutionPolicy Bypass -File tests\e2e\probe-profile.ps1 -Url https://github.com/cddd-yin ✅ 主页按钮 / 贡献图 / 页脚全部中文;剩余英文仅用户名与版权行(62 → 2)
模拟页面预览 http://127.0.0.1:8787/tests/demo.html 界面词变中文;代码、README 正文、文件名保持英文
端到端(真实 GitHub) powershell -ExecutionPolicy Bypass -File tests\e2e\run.ps1 ✅ nodejs/node:导航 / 按钮 / 占位符全部中文;README 正文零中文、首段一致;代码、文件名、正文探针均未被改动;开关可还原
  • tests/test.html 加载与发布版同一份脚本,覆盖词库匹配、动态句式、跳过区域、属性翻译、开关还原、标题翻译、Shadow DOM;
  • tests/e2e/run-unit.ps1 用无头 Chrome 自动运行 test.html 并输出 JSON 结果;
  • tests/e2e/run.ps1 用无头 Chrome + CDP 注入脚本,在真实页面上执行 checks.js 并输出 JSON 报告与截图;
  • tests/e2e/probe-profile.ps1 + probe.js:输出「页面剩余英文」清单(区分词库缺口与时序漏翻),用于个人主页等页面的漏翻体检。

目录结构

GitHub-中文化.user.js    主脚本(安装这个)
tests/
  test.html              97 项自动化断言
  demo.html              模拟 GitHub 页面(可视化预览)
  serve.ps1              本地静态服务器(127.0.0.1:8787)
  e2e/
    run.ps1              CDP 端到端测试(真实 GitHub 页面)
    run-unit.ps1         无头 Chrome 运行 test.html 并输出 JSON
    probe-profile.ps1    页面剩余英文体检(个人主页 / 仓库页)
    probe.js             体检用的页面内逻辑
    checks.js            页面内校验逻辑
README.md
LICENSE

自定义

  • 加词 / 改词:编辑脚本里的 DICT 对象(英文: 中文),保存后刷新页面;
  • 某区域不翻译:给该元素加属性 data-ghzh-skip;
  • 调试入口:控制台可用 window.__ghzh.setEnabled(false)、window.__ghzh.translateRoot(document)、window.__ghzh.translateCore('Issues') 等。

更新日志

  • v1.4.0:在真实 GitHub 页面上体检后定向扩充——词库再增 120+ 条并新增句法/属性规则:Actions 页(工作流 / 事件 / 执行者、运行时长、工作流运行计数)、议题与 PR 列表(全部 / 搜索、各类「按…筛选」、排序、分页、opened、成员)、发行版页(released this、Assets、Jump to release、Tag、签名校验)、全站页脚与站点地图栏目;新增「on <日期>」「<月 日, 年, 时:分 时区>」「3m 40s → 3 分 40 秒」等句式;单元断言扩至 97 项。
  • v1.3.1:修复登录态空状态提示(You don't have any public repositories yet.、You don't have any activity yet for this period. 等);单元断言 76 项。
  • v1.3.0:个人主页专项——补齐主页词汇(屏蔽 / 举报、热门仓库、贡献图、活动概览、页脚等);中文日期与相对时间(Oct 5, 2026 → 2026年10月5日、2 days ago → 2 天前),支持 Shadow DOM 中 <relative-time> 组件渲染的时间;活动列表句式(Created 42 commits in 4 repositories → 在 4 个仓库中创建了 42 个提交);补仓库页词条(+ 519 releases、Sponsor this project 等);修复 1 contribution in the last year 单数不命中;单元断言扩至 75 项,新增主页体检工具。
  • v1.2.0:词库扩充至 450 条(新增智能体 / 安全与质量 / 代码审查 / 大纲 等);动态句式增加相对时间(33 minutes ago → 33 分钟前)、归档提示、关注 / 贡献计数;加载后分阶段补扫 + 聚焦 / 可见性补扫,减少个别标签偶发回退英文;E2E 测试脚本容忍长加载页面,更健壮。
  • v1.1.0:修复输入框 placeholder 未翻译的问题(表单控件自身放行);补充词库(概览 / 仓库 / 发行版 / Actions 等);新增 tests/ 自动化测试与模拟预览页;接入 GitHub 仓库与更新地址。
  • v1.0.0:初版。

License

MIT

About

GitHub 界面中文化油猴脚本:只翻译界面词汇,不碰代码、文件名、正文和用户名。

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages