常见问题（FAQ）

[!IMPORTANT] 重要提示：

• ️ 页面缺失类反馈请直接到这里登记 #558
• 请看完再发议题，如有补充直接修改此评论

❓ 脚本使用常见问题

安装与运行问题

1️⃣ 安装完成后没有翻译，且脚本没有任何动作

** 解决方案：**

• 检查是否已打开开发者模式（仅 Chrome 或基于 Chromium 的浏览器）
• 如果仍然不行，请查看 这个讨论

2️⃣ 提示"词库文件 locals.js 未加载"

⚠️ 现象： 弹窗显示 "GitHub 汉化插件：词库文件 locals.js 未加载，脚本无法运行！"

** 解决方案：** 词库文件不存在，需要联网下载。由于网络原因，建议选择以下任一方案：

• FastGithub
• Steam++
• ️ 开发者边车
• 科学上网
• Ghproxy

** Ghproxy 配置示例：**

// 编辑脚本，在词库链接前添加代理域名
// 修改前：
// @require      https://raw.githubusercontent.com/maboloshi/github-chinese/refs/heads/gh-pages/locals.js

// 修改后：
// @require      https://(ghproxy域名)/https://raw.githubusercontent.com/maboloshi/github-chinese/refs/heads/gh-pages/locals.js

✨ 提示： 成功汉化一次后，后续使用无需重复操作

3 顶部搜索框消失了？

原因：6月12日起 GitHub 更新了前端代码导致原有逻辑失效，更新脚本到最新版即可

注：如果你开了其他网页翻译插件导致搜索框消失（例如 Edge 的自动翻译），关掉后刷新页面

功能相关

1️⃣ 为什么项目页面没有翻译？

** 说明：**

• 不常用页面，故不处理
• @maboloshi 项目主偷懒了
• 欢迎提交 PR 贡献代码！

2️⃣ 会不会适配镜像站？

** 明确答复：**

• 为保证安全（项目主怕查水表 ），永远不会适配
• 如有需要请安装脚本后自行修改
• 不接受此类拉取请求（PR）

️ 开发相关

1️⃣ 发现未翻译词条怎么办？

** 处理流程：**

1. 直接复刻项目并修改
2. 提交拉取请求
3. 本地调试请查看开发文档

[!IMPORTANT] ⚠️ 重要提醒： 请不要修改以下文件：

• locals(greasyfork).js
• locals_zh-TW.js
• main_zh-TW.user.js
• main(greasyfork).user.js

这些文件会定期自动同步

2️⃣ 拉取请求无法合并？

** 原因：** 本仓库强制要求所有提交进行 GPG 签名

** 解决方案：** 在 GitHub 密钥设置页面 设置 GPG 密钥后再提交

反馈与支持

反馈须知

• 请按照议题模板填写完整信息
• 不再接受 1.9.2 版本的问题反馈
• 页面缺失类问题请到 #558 登记

[!TIP] ** 温馨提示：** 提交前请仔细阅读文档，如有补充请直接修改原评论 ✏️