开源项目 on 小景

macOS 美式键盘增强：输入重音字母、拼音声调、希腊字母和马耳他语字符

Mon, 25 May 2026 12:00:00 +0200

本文介绍 ABC Custom Keyboard：日常输入仍然是美式键盘，但按住 Option 就能输入重音字母、拼音声调、希腊字母、马耳他语字符和常用符号。

我开源了 ABC Custom Keyboard，这是一个面向 macOS 的自定义键盘布局。

项目地址在这里：Jingyuan-Zheng/ABC-Custom-Keyboard。

它的目标很直接：保留标准 US ABC / 美式键盘的日常输入体验，同时在 Option 层加入一套有规律、容易联想的扩展输入，用来输入欧洲拉丁字母、希腊字母、汉语拼音声调、马耳他语相关扩展字母、数学符号、编号符号和技术符号。

为什么要做这个键盘

美式键盘很适合英文、编程和快捷键，但一旦进入多语言写作，问题就来了。

你可能要写德语、法语、意大利语、西班牙语、葡萄牙语、马耳他语，也可能要输入拼音声调、希腊字母或论文里常见的数学符号。系统自带的特殊字符输入不够统一，切换到语言专用键盘又会改变物理键位记忆。比如德语键盘里的 Y 位置就和美式键盘不同。

ABC Custom Keyboard 的思路是：基础层完全保持标准 US ABC，只把多语言和学术符号放到有规律的 Option / dead key 层里。这样一把美式键盘就能覆盖更多写作场景。

基础层保持 US ABC

ABC Custom 假设你使用的是标准 US ABC 物理键盘。基础层不做重新排列，所以日常英文输入、常见 Command / Control 快捷键都尽量保持原样。

图 1：基础层保持标准 US ABC 布局。

直接 Option 层

按住 Option 再按键，就可以输入键帽上显示的符号。蓝色键是 dead key 前缀：先按前缀组合，松开，再按目标键。

图 2：Option 层提供常用符号和容易记忆的 dead key 前缀。

Shift + Option 是另一组直接符号层，也包含上标和圈号字符的 dead key 前缀。

图 3：Shift + Option 在不改变基础键位的前提下扩展更多符号。

这些直接层覆盖了 ℕ、ℤ、ℚ、ℝ、π、Σ、√、∂、≠、≤、≥、箭头、破折号、货币符号、勾选符号、方框和星号标记等常用字符。

更容易记的 Dead Key

dead key 的使用方式是：先按前缀组合，松开，再按目标键。

例如：

Option + 1 后再按 a，输出 ā
Option + 2 后再按 e，输出 é
Option + 5 后再按 u，输出 ü
Option + G 后再按 p，输出 π

拼音声调层直接对应声调编号：Option + 1 到 4 分别对应一到四声。

图 4：一声使用 Option + 1，再按目标元音。

两点 / umlaut 层使用 Option + 5，因为 % 这个键上有两个圈，容易联想到字母上的两点。上点字母层使用 Option + 8，因为 * 可以联想到点或星号。

图 5：umlaut 层覆盖 ä、ë、ï、ö、ü 等字符。

图 6：上点字母对马耳他语和学术转写很有用。

希腊字母、上下标和技术符号

学术写作里常见的希腊字母也被放到了联想位置。Option + G 表示 Greek，例如 p 对应 π，m 对应 μ，l 对应 λ，w 对应 ω，d 对应 δ。

图 7：希腊字母层尽量使用拉丁字母的联想位置。

此外，它还提供成对的下标和上标层，以及度数、直径、空集、版权、注册、商标、圈号字符和圆形运算符等技术符号。

图 8：上标可以通过 Shift + Option + 9 进入。

安装方式

最简单的方式是使用 DMG：

从最新 GitHub Release 下载 ABC-Custom-Keyboard.dmg。
打开 DMG，把 ABC Custom.bundle 拖到窗口里的 Keyboard Layouts 文件夹。
退出登录后重新登录，或重启 macOS。
打开系统设置，在键盘输入源里添加 ABC Custom。

也可以手动安装，把 bundle/ABC Custom.bundle 复制到：

`1`	`~/Library/Keyboard Layouts/`

然后退出登录后重新登录，或重启 macOS。

如果你想自己修改

可编辑的布局文件在 layouts/ABC Custom.keylayout。发布用的 macOS 键盘布局 bundle 在 bundle/ABC Custom.bundle，README 里的键位图来自 assets/*.svg，可以通过 tools/generate_keymap_svg.py 重新生成。

如果你经常在欧洲语言、拼音声调、马耳他语字符、希腊字母和数学符号之间切换，ABC Custom Keyboard 可以把这些字符放到一套更稳定、更容易记忆的位置上，同时不牺牲标准美式键盘的输入习惯。

Mac 上一键翻译文档：PDF、Word、Markdown、图片和录音都能处理

Mon, 25 May 2026 10:00:00 +0200

本文介绍 Translate Document Quick Action，一个可以从 Finder 调用的 Mac 文档翻译工具，支持 PDF、Word、Markdown、TXT、图片 OCR 和音视频转录文本。

我开源了一个新的小工具：Translate Document Quick Action。

项目地址在这里：Jingyuan-Zheng/translate-document-quick-action。

它最初是一个 macOS Finder Quick Action：选中文档，右键运行，就在原文件旁边生成翻译后的文件。后来我把核心逻辑整理成了普通 Python 脚本，所以它也可以从命令行使用。

为什么要做这个工具

实际工作里的“翻译文档”很少只有一种格式。

今天可能是 PDF 报告，明天是 Word 文档，后天又变成 Markdown 笔记、截图、扫描图，甚至是一段会议录音，需要先转录再翻译。

很多工具只能解决其中一小段流程。Translate Document Quick Action 想解决的是更日常的问题：尽量把这些常见文件格式放进同一个入口里，让你不用每次都临时找工具、改脚本、搬文件。

支持哪些格式

目前项目支持：

PDF：通过 pdf2zh-next 翻译
DOCX：直接修改 Word XML，尽量保留原始包结构和媒体引用
Markdown：保护常见 Markdown 结构后翻译
TXT：按行保留文本结构
图片：可使用 macOS Vision OCR 的轻量方案，或接入 manga-image-translator
音频和视频：通过 MacWhisper 的 mw CLI 生成转录文本，并可继续翻译转录稿

输出文件会生成在原文件旁边，并且不会覆盖已有文件。单语译文会使用目标语言后缀，例如 _CN.docx；双语文件会使用源语言和目标语言后缀，例如 _EN_CN.docx。

翻译效果预览

PDF 双语输出使用 pdf2zh-next 的双语 PDF 模式，适合对照检查原文和译文，也尽量保持页面布局的可读性。

图 1：PDF 双语输出，方便对照原文与译文。

Markdown 和 TXT 的双语输出会按段落交错排列。这个形式很适合审校，因为你可以直接看到每段原文下面对应的译文。

图 2：TXT 输出保留按行检查的便利性。

图 3：Markdown 双语输出会尽量保留常见文档结构。

DOCX 的双语输出会在原段落后插入译文段落，同时尽量保留文档里的图片、媒体引用和原有结构。

图 4：DOCX 双语输出适合在 Word 里继续审阅。

图片翻译则可以走 macOS Vision OCR 的轻量路径：识别图片里的文字，翻译后再把译文画回检测到的文本区域。它适合截图、图表、幻灯片这类相对干净的图片。

图 5：图片双语输出会把原图和译图并排放在一起。

翻译引擎与隐私选择

文本翻译部分目前支持 Google、Bing 的网页端点，也支持本地 Ollama 适配器。

Google 和 Bing 的方式胜在方便，但它们不是官方付费 API，可能遇到限流，也可能因为上游行为变化而失效。如果是敏感文档，我更建议使用本地 Ollama 后端，或者把翻译适配器替换成正式的官方 API。

这个项目刻意把“文件结构处理”和“翻译后端”分开，后续要换引擎会比较直接。

安装方式

先安装 Python 依赖：

1
2
3

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

如果要翻译 PDF，需要单独安装 pdf2zh-next：

`1`	`uv tool install --python python3.13 "pdf2zh-next==2.6.4" --with "BabelDOC==0.5.16"`

如果要使用 macOS Finder Quick Actions，可以运行：

`1`	`python3 macos/install_quick_actions.py`

命令行用法

翻译 TXT、Markdown 和 DOCX：

`1`	`python3 scripts/translate_document_worker.py --engine google --lang-out zh --mode both file.txt notes.md paper.docx`

用 macOS Vision OCR 的轻量方案翻译图片：

`1`	`python3 scripts/translate_image_worker.py --image-engine simple-macos --text-engine google --lang-in auto --lang-out zh --mode both image.png`

转录音频或视频，并翻译转录稿：

`1`	`python3 scripts/translate_audio_worker.py --operation both --engine google --lang-out zh --mode dual interview.m4a`

使用时要注意什么

这是一个面向日常自动化的工具，不是“所有复杂文档都能完美翻译”的承诺。

DOCX 目前覆盖正文、页眉、页脚、脚注、尾注和批注等常见内容。像 SmartArt、嵌入对象、公式、复杂文本框这类 Word 高级结构，仍然需要更多测试。

图片里的 simple-macos 引擎适合干净截图、图表和幻灯片。它不是 AI 修图或智能重绘。如果背景复杂，或者是漫画这类场景，更适合接入可选的 manga-image-translator。

如果你的翻译工作经常在 PDF、Word、Markdown、截图和录音之间来回切换，这个项目至少能把入口统一起来，让常见任务不用再散落在一堆临时脚本里。

Mac DMG 安装包怎么做？用 DMG Maker 自动生成带背景的安装镜像

Tue, 12 May 2026 20:10:17 +0800

本文介绍 DMG Maker，一个帮 macOS 小工具自动生成 DMG 安装包的脚本，适合需要背景图、图标摆放和快捷链接的分发场景。

我刚刚开源了 DMG Maker，这是一个旨在简化 macOS 专业安装包制作过程的小工具。

为什么使用 DMG Maker？

手动制作带背景图的 DMG 通常需要编写复杂的 AppleScript 或者繁琐的 Finder 手动操作。DMG Maker 通过一行命令将这一切自动化。

核心功能

自动软链接: 自动识别文件类型（如 .dictionary 或 .app）并链接到对应的系统目录。
自定义视觉: 轻松应用背景图并根据坐标定位图标。
开源: 欢迎在 GitHub 上查看源码。

快来尝试为你的项目制作精美的安装包吧！

开源项目 on 小景

macOS 美式键盘增强：输入重音字母、拼音声调、希腊字母和马耳他语字符

为什么要做这个键盘

基础层保持 US ABC

直接 Option 层

更容易记的 Dead Key

希腊字母、上下标和技术符号

安装方式

如果你想自己修改

相关阅读

Mac 上一键翻译文档：PDF、Word、Markdown、图片和录音都能处理

为什么要做这个工具

支持哪些格式

翻译效果预览

翻译引擎与隐私选择

安装方式

命令行用法

使用时要注意什么

相关阅读

Mac DMG 安装包怎么做？用 DMG Maker 自动生成带背景的安装镜像

为什么使用 DMG Maker？

核心功能

相关阅读