Save, search, and manage personal notes and knowledge bases in Get笔记 on explicit request.
Integrations
github-desktop-zh
Try itGithub Desktop 汉化工具 — 自动探测安装目录(支持 loose 与 asar 打包模式),使用内置词典对 JS 源文件执行字符串字面量替换,完成界面汉化。支持预览、部署、回滚、语法校验。
What it does
Github Desktop 汉化技能(Windows / macOS / Linux)
The skill document
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
运行模式
脚本自动识别目标为 resources\app(loose 模式)或 resources\app.asar(asar 模式):
| 模式 | 目标 | 替换流程 | 部署方式 | 依赖 |
|---|---|---|---|---|
| loose | app\main.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.*(可选) - 空行忽略;重复条目自动去重(按 源串+目标文件)
- 脚本按源串长度降序替换,避免短串破坏长串
安全机制
- 混合替换策略:优先字面量匹配(
(["'])source\1,仅命中被相同引号包裹的完整字符串字面量);字面量未命中时,对长度 ≥10 且含空格的 source 回退到子串匹配(UI 文本特征,误伤变量名/注释概率低);短串保持严格字面量匹配 - BOM 保留:读写时检测并保留原文件 BOM 状态
- 备份自动清理:保留最近 5 个时间戳的备份,自动清理更旧的
- 部署后语法校验:若 node 可用,自动对 .js 文件执行
node --check,语法错误时告警 - 回滚前预备份:回滚前将当前文件备份为
.pre_rollback_*
Related skills
Generate and edit Draw.io, Mermaid, and Excalidraw diagrams from natural language using a structured JSON spec.
Stores durable facts in a categorized, plain-markdown vault on disk, alongside your agent's built-in memory.
Find why your productivity system keeps failing, then apply the smallest fix — capacity math, bottleneck routing, durable local notes.
Trade crypto, manage a multi-chain wallet, and query an AI analyst from one CLI.
Run Git operations — commits, branches, merges, rebases, conflict resolution, and recovery — with safety rules enforced.
More from ebandao777-oss
Browse all skills天工.skill(Tiangong Skill)智能体设计师。当用户需要设计、创建或优化AI智能体/Agent,或基于真实人物蒸馏思维框架创建人物Skill时使用。支持两种范式:人物蒸馏(由内而外,复刻心智模型)与岗位型专家(由外而内,定义岗位职责)。目标:创建专业领域专家角色,具备清晰人设和扎实交付力。
工业级RAG切片工具「可落地、可量化、可优化」,将RAG知识库长文档拆解为语义完整、检索就绪的原子化知识切片,内置多层质量门禁(校验→审计→检索可达性评估),确保切片可用性与RAG检索命中率。
工业级RAG Markdown物料生成技能,使用 markitdown 将各类文档和文件转换为 Markdown 格式。支持 .doc/.ppt 老格式自动预处理(Word/PowerPoint COM / LibreOffice)。启动时自动检测 OS/版本/能力,按平台选择最佳执行路径。触发词:转 Markdown / 转换文档 / markitdown / 文档转 md / 批量转换。当需要将 PDF、Word (.docx/.doc)、PowerPoint (.pptx/.ppt)、Excel (.xlsx, .xls)、HTML、CSV、JSON、XML、图片(含 EXIF/OCR)、音频(含语音转写)、ZIP 压缩包、YouTube 链接或 EPub 电子书转换为 Markdown 格式,为知识库提供统一的"通用语言"时触发此技能。
钟馗.Skill——Agent Skill 安全审查专家。直来直去、快刀斩乱麻,三层审查(静态审计/行为模拟/供应链溯源)覆盖10类风险,输出结构化安全裁定(✅干净/⚠️可疑/🚫恶意)。Use when 用户说"审查这个Skill"、"安全检查"、"钟馗看下"、"审一下"、"查一下这个skill"、安装Skill前的安全评估、或需要审计SKILL.md的恶意载荷。
玄奘.skill 当用户明确请求紧箍咒模式,或表现出沮丧、反复失败(2次及以上)、消极被动、抱怨质量、未核实即声称完成、想要放弃,或要求更努力/换种方法时触发。常见触发词:'try harder'、'figure it out'、'stop giving up'、'you keep failing'、'加油'、'别偷懒'、'你再试试'、'为什么还不行'、'你怎么又失败了'、'又错了'、'检查下'、'完善'、'审核'、'质量太差'、'换个方法'、'stop spinning'、'you broke it'、'/pua'、'紧箍咒模式'。对于正常的首次编程或信息查询请求,请勿触发。
鲁班.Skill(luban Skill):工业级智能体技能优化器。当用户提及以下关键词时调用:“优化skill”、“skill评分”、“自动优化”、“auto optimize”、“skill质量检查”、“小鲁班”、“luban”、“优化技能”、“帮我改skill”、“skill怎么样”、“提升skill质量”...