maboloshi/github-chinese：README 來源編輯指南

maboloshi/github-chinese 的 README 將專案描述為「GitHub 汉化插件，GitHub 中文化界面。 (GitHub Translation To Chinese)」。本文只整理倉庫可直接核對的內容，不把 star、Fork 或宣傳語當成品質證明。README 在「🌐 兼容环境」下寫到：浏览器类型 | 支持的脚本管理器 :------------------: | :---------------: Chrome / Chromium 内核 | [Tampermonkey][Tampermonkey], [Violentmonkey][Violentmonkey] Safari（全平台） | [Tampermonkey][Tampermonkey], [Macaque][Macaque], [Stay][Stay] Firefox / Gecko 内核 |。這說明的是專案邊界，不是已完成的生產驗證。

從 README 的「v1.9.4.1 (2026-06-16)」與相關條目，可以先判斷它是否處理你的實際問題：关于 GitHub 引入 React 机制导致头部搜索框消失。副作用整个头部导航全部加入忽略规则，无法翻译。。若需求不同，不應只因專案熱度就採用。本文保留原始專案名、命令與元件名，方便回到一手來源核對。 README 另外列出一項可核對的資訊：区分 React GlobalNav 与页面主体共享的 Primer 弹层，恢复下拉菜单即时、完整翻译。。這類原文條目可用來設計試跑步驟，但不能取代實際環境測試。

README 將運作方式分散在「浏览器（Tampermonkey）」等段落。可確認的線索包括：> [!NOTE] > 版本说明： > - 🚀 开发版：实时更新，每周五自动更新词库 > - 🛡️ 稳定版：每周一同步开发版词库，更稳定。本文不把未寫出的架構、效能或安全邊界補成結論；真正的執行鏈仍要配合目錄、設定檔與版本標籤檢查。

第一次安裝應從 README 指出的入口開始。目前可核對的命令是： README 没有给出可直接复制的安装命令。 如果倉庫沒有命令，本文不會自行編造步驟，而是建議先閱讀「TOC」，確認系統依賴、預設埠與首次初始化。

日常使用取決於專案文件。README 的「🔧 本地调试」段落提到：1. 安装 [Tampermonkey][Tampermonkey]，并启用 "允许访问文件网址"。 1. 下载词库文件到本地（如：D:\github-chinese\locals.js） 1. 在脚本管理器中修改引用路径：。設定檔、環境變數、權限與資料目錄只在來源明確時才會記錄；沒有寫出的預設值，應在測試環境驗證並保留回滾副本。 同一部分也提到：函数拆分细化：watchUpdate → setupMutationObserver + processMutations，transDesc → handleTransClick + requestRemoteTrans + showTransResult。

README 能確認的限制比宣傳頁更重要。現有來源沒有證明maboloshi/github-chinese具備固定相容矩陣、服務等級、效能基準或長期支援承諾。README 只明確寫到「> [!IMPORTANT] > 若无效： > 1. 进入 [Tampermonkey][Tampermonkey] 插件设置页 > 1. 将 通用 - 配置模式 设置为高级，进入高级设置模式 > 1. 找到 安全 - 允许脚本访问本地文件 并设置为 外部(@require 和 @resource)」。這些未知項應列入選型紀錄，不要改成肯定句。