Github Desktop 汉化工具 — 自动探测安装目录（支持 loose 与 asar 打包模式），使用内置词典对 JS 源文件执行字符串字面量替换，完成界面汉化。支持预览、部署、回滚、语法校验。
Github Desktop 汉化技能（Windows / macOS / Linux）
功能概述
Github Desktop 汉化技能（Windows / macOS / Linux）是一项面向实际任务的技能，主要用于调用内置脚本自动探测 Github Desktop 安装目录，识别 loose 或 asar 打包模式，使用内置词典执行 JS 字符串字面量替换；脚本自动识别目标为 resourcesapp （loose 模式）或 resourcesapp.asar （asar 模式）：。
核心要点
- 它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
- 从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。
- 实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；
使用与执行
若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；
结果检查与注意事项
涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。
Github Desktop 汉化技能（Windows / macOS / Linux）
调用内置脚本自动探测 Github Desktop 安装目录，识别 loose 或 asar 打包模式，使用内置词典执行 JS 字符串字面量替换。
资源结构
GitHubDesktop-zh/
├── SKILL.md # 本文件
├── dict/
│ └── dictionary.txt # 汉化词典（首行可声明 # @gh-version: 3.*）
└── scripts/
└── apply_zh.py # 汉化脚本 v1.1.0
运行模式
脚本自动识别目标为 resourcesapp（loose 模式）或 resourcesapp.asar（asar 模式）：
| 模式 | 目标 | 替换流程 | 部署方式 | 依赖 |
|---|---|---|---|---|
| loose | appmain.js 等 loose 文件 |
直接读写 | 复制覆盖 | 无 |
| asar | app.asar 打包文件 |
extract → 替换 → pack | 重新打包覆盖 | 需 asar 工具 |
asar 工具安装：npm install -g @electron/asar
执行前检查（Agent 必须执行）
在执行任何命令前，Agent 应检查：
# ① Python 版本
python --version
# ② 脚本存在性
Test-Path "{技能根目录}/scripts/apply_zh.py"
# ③ 词典存在性
Test-Path "{技能根目录}/dict/dictionary.txt"
以上任一失败即中断，告知用户缺失项。
执行命令
汉化（默认：自动探测 + 备份 + 替换 + 部署）
python "{技能根目录}/scripts/apply_zh.py" --deploy
预览（不修改任何文件，仅展示匹配统计）
python "{技能根目录}/scripts/apply_zh.py" --dry-run
回滚
python "{技能根目录}/scripts/apply_zh.py" --rollback
自定义词典
python "{技能根目录}/scripts/apply_zh.py" --deploy --dict "{用户提供的词典路径}"
手动指定 GH 路径（loose 目录或 asar 文件）
python "{技能根目录}/scripts/apply_zh.py" --deploy --src "D:...app"
python "{技能根目录}/scripts/apply_zh.py" --deploy --src "D:...app.asar"
GH 运行时强制执行
python "{技能根目录}/scripts/apply_zh.py" --deploy --force
流程断点与验证
脚本内部每个步骤失败时均会 sys.exit(1) 并打印 [ERROR]。Agent 应在执行后检查退出码和 stdout：
| 断点 | 关键输出 | 失败动作 |
|---|---|---|
| 依赖 | （无显式输出，通过即继续） | 缺 reg/tasklist → 中断；asar 模式缺 asar → 中断并提示安装 |
| 探测 | Github Desktop 版本: x.x.x + 模式: LOOSE/ASAR |
无此输出 → 探测失败，提示用户提供 --src |
| 词典 | 词典条目: N + 词典声明版本: x.* |
无此输出 → 词典加载失败；版本不匹配且未 --force → 中断 |
| 解包 | 解包 asar 到临时目录... |
仅 asar 模式；失败 → 中断 |
| 备份 | 已备份: N 个文件 |
无此输出 → 备份失败，脚本已中断 |
| 替换 | 应用结果: N/N 已替换 (x.x%) |
含"未匹配"行 → 部分条目未命中；匹配率 <80% → WARN 提示更新词典 |
| 部署 | 已部署到: |
无此输出 → 部署失败，检查权限/进程占用 |
| 验证 | 文件名 (N KB) ✓ 语法✓ |
语法✗ → 替换破坏 JS，需回滚并更新词典 |
| 验收 | [提示] 请启动 Github Desktop 目视确认... |
Agent 应建议用户启动 GH 目视检查 |
故障处理
| 场景 | 处理 |
|---|---|
| Python 不可用 | 提示安装 Python ≥ 3.6 |
| 无法定位 GH | 提示用户确认已安装，或提供 --src 路径（loose 目录或 asar 文件） |
| GH 正在运行 | 检测 GitHubDesktop.exe / Update.exe，提示关闭后重试，或询问是否 --force |
| asar 模式缺 asar 工具 | 提示 npm install -g @electron/asar |
| 词典版本不匹配 | 打印 WARN，非 --force 时中断，提示更新词典或加 --force |
| 大量条目未匹配 (≥20%) | 可能版本升级，提示用户提供新版词典 |
| 替换后语法校验失败 | 提示词典含危险条目，建议回滚并修正词典 |
| --no-backup --deploy 组合 | 脚本拒绝执行，提示加 --force 确认风险 |
| 回滚无备份 | 提示无法回滚，建议重装 Github Desktop |
| 脚本执行报错 | 将完整 stderr 反馈给用户 |
词典格式
每行一条：源串>*.*<译串>*.*<分组>*.*<目标文件
- 源串/译串可用引号包裹（脚本自动剥离外层引号）
- 首行可声明版本：
# @gh-version: 3.*（可选） - 空行忽略；重复条目自动去重（按 源串+目标文件）
- 脚本按源串长度降序替换，避免短串破坏长串
安全机制
- 混合替换策略：优先字面量匹配（
(["'])source1，仅命中被相同引号包裹的完整字符串字面量）；字面量未命中时，对长度 ≥10 且含空格的 source 回退到子串匹配（UI 文本特征，误伤变量名/注释概率低）；短串保持严格字面量匹配 - BOM 保留：读写时检测并保留原文件 BOM 状态
- 备份自动清理：保留最近 5 个时间戳的备份，自动清理更旧的
- 部署后语法校验：若 node 可用，自动对 .js 文件执行
node --check，语法错误时告警 - 回滚前预备份：回滚前将当前文件备份为
.pre_rollback_*
热门AI工具
相关专题
github中文官网入口https://docs.github.com/zh/get-started，GitHub 是一种基于云的平台，可在其中存储、共享并与他人一起编写代码。 通过将代码存储在GitHub 上的“存储库”中，你可以： “展示或共享”你的工作。 持续“跟踪和管理”对代码的更改。
7965
2026.01.21
要对比两个版本的 git 文件，请使用 git diff 命令：git diff 比较工作树和暂存区之间的差异。git diff 比较两个提交或标签之间的差异。git diff 输出显示差异块，其中 + 表示添加的行，- 表示删除的行， 表示修改的行。可使用 gitkraken、meld、beyond compare 等可视化工具更直观地查看差异。本专题为大家提供相关的文章、下载、课程内容，供大家免费下载体验。
2281
2024.04.09
git提交错误撤回的方法：git reset head^：撤回最后一次提交，恢复到提交前状态。git revert head：创建新提交，内容与之前提交相反。git reset ：使用提交的 sha-1 哈希撤回指定提交。交互式舞台区：标记要撤回的特定更改，然后提交，排除已撤回更改。本专题为大家提供相关的文章、下载、课程内容，供大家免费下载体验。
2517
2024.04.09
Git是一个强大的版本控制系统，它提供了很多功能帮助开发人员有效地管理和控制代码的变更，本专题为大家提供git 撤销提交的commit相关的各种文章内容，供大家免费下载体验。
714
2023.07.24
git和svn的区别：1、定义不同；2、模型类型不同；3、存储单元不同；4、是否拥有全局版本号；5、内容完整性不同；6、版本库不同；7、克隆目录速度不同；8、分支不同。php中文网为大家带来了git和svn的相关知识、以及相关文章等内容。
1260
2023.07.06
本专题从实际API接口调试场景出发，讲解Postman身份认证的完整配置流程，包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查，帮助用户正确完成接口授权与访问验证。
0
2026.11.06
围绕Postman HTTP请求头配置展开，讲解Headers选项的具体使用方式，包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法，帮助用户解决接口调试过程中遇到的请求头配置问题。
0
2026.11.06
热门下载
相关下载
精品课程
最新文章
