macOS 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 上查看源码。

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

The Little Dict Mac 版：安装到系统词典，用三指查词直接查单词

Mon, 11 May 2026 00:00:00 +0000

本文分享 The Little Dict 的 macOS 系统词典版本，安装后可以在词典 App、Spotlight 和三指查词里直接使用。

简介

The Little Dict 是一款非常经典的词典，原版为 MDX 格式。虽然 MDX 在第三方词典软件中表现极佳，但对于 macOS 用户来说，没法用系统原生的“三指触摸查词”始终是个遗憾。macOS 的原生查词体验极佳，一按即查，这种系统级的无缝衔接是任何第三方软件很难完美替代的。

因此，为了方便 macOS 用户原生使用，我将其转换成了苹果词典（.dictionary）格式，并打包成了 DMG 镜像，方便安装和分享。

资源说明

词典名称：The Little Dict
目标平台：macOS
格式：Apple Dictionary Service (.dictionary)
文件大小：约 1.3 GB
制作说明：由 MDX 原版转换而来，保留了原有的样式和排版，适配 macOS 系统字体。

关于发音的说明 (重要)

由于原词典的发音库 (MDD) 体积巨大，为了保证下载体验，本转换版 不包含离线发音库。

不过，macOS 自带了极其强大的 TTS (Text-to-Speech) 功能，发音非常自然且极速，完全可以替代 MDD，甚至体验更好：

如何配置 macOS 原生朗读发音：

打开 系统设置 (System Settings) -> 辅助功能 (Accessibility) -> 朗读内容 (Read & Speak)。
打开 “朗读所选内容” (Speak selection) 开关。
点击右侧的 “i” (感叹号) 图标，可以自定义快捷键（默认为 Option + Esc）。
在 “系统语音” (System voice) 旁点击感叹号，选择你喜欢的发音。建议下载带有 Enhanced 或 Premium 标签的高质量语音（例如英音 Jamie 或美音 Samantha），这些声音在 macOS 26 中已经进化得非常拟人。
使用方法：在词典应用中选中单词或例句，按下快捷键（如 Option + Esc）即可即时朗读。

开发者与源码维护

为了方便有开发需求或想定制样式的同学，我已经将该词典的构建源码（包括 CSS 样式、Makefile、逻辑脚本及示例 XML 结构）全部开源。

如果你想参与维护、更新词条或修改 UI，可以查看仓库中的 src 目录：

CSS 排版: The_Little_Dict.css 控制了所有的视觉显示。
构建脚本: 使用提供的 Makefile 配合 Apple Dictionary Development Kit 即可一键编译。
示例结构: sample_structure.xml 展示了如何将数据组织成苹果词典所需的 XML 格式。

安装方法

下载并打开 The_Little_Dict.dmg。
将 The_Little_Dict.dictionary 拖拽到镜像中的 User_Dictionaries 快捷方式（该快捷方式指向 ~/Library/Dictionaries）。
打开 macOS 自带的 词典 (Dictionary) 应用。
在菜单栏点击 设置 (Settings/Preferences)，勾选 “The Little Dict” 即可启用。如果需要首选该词典，可以在列表中将其拖动到第一位。
现在你可以在 Spotlight、Safari 或任何支持文本选择的地方，通过三指查词直接查看内容。

下载链接

提示：由于文件体积较大，建议使用支持断点续传的工具下载。

本人非常不喜欢需要登录且限速的网盘，因此本资源首发于 GitHub。

👉 GitHub Release 下载

👉 GitHub 仓库地址

macOS on 小景

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

为什么要做这个键盘

基础层保持 US ABC

直接 Option 层

更容易记的 Dead Key

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

安装方式

如果你想自己修改

相关阅读

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

为什么要做这个工具

支持哪些格式

翻译效果预览

翻译引擎与隐私选择

安装方式

命令行用法

使用时要注意什么

相关阅读

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

为什么使用 DMG Maker？

核心功能

相关阅读

The Little Dict Mac 版：安装到系统词典，用三指查词直接查单词

简介

资源说明

关于发音的说明 (重要)

如何配置 macOS 原生朗读发音：

开发者与源码维护

安装方法

下载链接

相关阅读