MDX 词典转 macOS 原生词典：用 Agent Skill 自动生成 .dictionary 和 DMG

Sat, 08 Aug 2026 14:00:00 +0200

本文介绍 MDX to macOS Dictionary：一个开源 Agent Skill，可以把本地 MDict .mdx 词典转换成可搜索的 macOS 原生 .dictionary 词典，并生成可以拖拽安装的 DMG 镜像。

MDX 是一种常见的词典数据格式，但 macOS 自带的“词典”App 不能直接打开 .mdx 文件。过去要完成转换，通常需要准备 XML、调用 Apple Dictionary Development Kit 编译、保留样式，再手动打包安装镜像。这个 Skill 把这些步骤整理成了一套连贯的转换流程。

它可以生成什么？

把本地 .mdx 文件或词典文件夹交给支持的 coding agent 后，这个 Skill 可以：

从 MDX 中提取词条；
转换成 Apple Dictionary 可搜索的原生格式；
在存在配套 CSS 时保留原有样式；
使用词典自带的封面或 Logo 作为词典图标；
自动生成拖拽安装 DMG；
在需要时将完成的词典安装到 ~/Library/Dictionaries/。

原始的 MDX、CSS、JavaScript 和 MDD 文件不会被修改。生成的 .dictionary 是 macOS 原生词典格式，可以在“词典”App 中启用，也可以配合系统的 Spotlight 和“查找”功能使用。

为什么要把 MDX 转成 macOS 词典？

MDX 适合在支持它的第三方词典软件中使用，但它并不属于 macOS 自带的词典服务。转换成原生 .dictionary 后，词典可以更自然地融入 Mac：

在“词典”App 中直接搜索词条；
选中文字后使用 macOS 的“查找”功能；
在支持的场景中通过 Spotlight 查词；
把多本词典统一放进 macOS 自己的词典目录；
通过熟悉的 DMG 窗口拖拽安装。

如果你已经有一本好用的 MDX 词典，又希望它像系统自带词典一样工作，这个 Skill 就能省下不少重复的转换和打包工作。它尤其适合语言学习、翻译、研究和个人词典整理等场景。

安装 Agent Skill

项目已经开源在 GitHub：

Jingyuan-Zheng/mdx-to-macos-dictionary-skill

如果你使用兼容的 coding agent，可以运行下面的命令安装：

`1`	`npx skills add Jingyuan-Zheng/mdx-to-macos-dictionary-skill --agent codex`

安装完成后，只要告诉 agent 转换一个本地 .mdx 文件或文件夹即可。Skill 会先检查 Mac 是否具备所需条件，再说明需要处理的问题，不会一开始就直接执行转换。

转换过程是怎样的？

整个流程被整理成几个连续步骤：

准备本地 MDX 词典，以及可能存在的 CSS、JS、MDD、封面或 Logo 文件。
让 Skill 检查 macOS 所需工具。
提取词条，并生成 Apple 原生词典数据。
验证 .dictionary 词典包，再创建 DMG 安装镜像。
将词典放进用户词典目录，并在“词典”App 中启用。

如果你只想生成文件、不希望自动安装，可以明确要求“仅输出转换结果”。默认情况下，Skill 会将生成的词典安装到当前账户的 ~/Library/Dictionaries/。如果那里已经有同名词典，它不会在没有确认的情况下直接覆盖。

Mac 需要具备什么条件？

这个项目运行在 macOS 上，并使用 Apple 的词典构建工具。根据 Mac 型号和词典来源，可能需要：

Python 3；
Xcode Command Line Tools；
Apple Silicon Mac 上的 Rosetta；
Homebrew 的 create-dmg 工具。

Skill 会在转换前检查这些条件，也可以自动获取所需的开源组件，包括 mdict-utils、Apple Dictionary Development Kit 和 DMG Maker。转换过程会使用独立的工作目录，原始词典文件保持不变。

生成词典后怎么使用？

安装完成后，打开 macOS 自带的“词典”App，在“词典 → 设置”中勾选新词典。较旧版本的 macOS 可能显示为“词典 → 偏好设置”。你也可以拖动词典调整优先顺序，决定多个词典同时匹配时优先显示哪一本。

启用之后，在支持的 Mac App 中选中文字并使用“查找”，或者直接打开“词典”App 搜索即可。如果你使用的是兼容的触控板，还可以在选中的单词上用三指轻点；支持 Force Touch 的触控板则可以直接重按，也就是使用 Force Click。这些手势对应“系统设置 → 触控板”里的“查找与数据检测器”选项，具体可用方式会根据 Mac 型号和 macOS 版本有所不同。Apple 的在 Mac 上查找单词说明了三指轻点和 Force Click 的设置方式。

我已经开源的两本 Mac 词典

这个 Skill 的目的，就是让类似下面的词典项目更容易转换、打包和分享。我已经在博客中介绍过两本转换成 macOS 原生词典的作品：

The Little Dict Mac 版：安装到系统词典，用三指查词直接查单词：把体积较大的英文 MDX 词典转换成 Apple 原生 .dictionary 格式，可在“词典”App 和触控板“查找”中使用。
Maltese Dictionary for Mac: Look Up Ġabra Words in Dictionary, Spotlight, and Three-Finger Tap：一个开源的马耳他语词典，包含数百万个词形，并支持在“词典”App、Spotlight 以及三指轻点或 Force Click 查词。

它们展示了这种转换流程的实际结果：词典不再只是需要单独打开的文件，而是可以直接参与 Mac 自带的查词体验。

原理简介

Skill 使用 mdict-utils 读取 MDX 词条，将它们转换成 Apple Dictionary Development Kit 所需的 XML 结构，再编译为 .dictionary 词典包。它会先验证 XML 是否完整，再检查生成的词典是否包含索引、元数据、样式表和词典正文，最后才进行 DMG 打包。

项目采用 MIT 许可证，源码和完整说明都在 GitHub 仓库。如果你关心 DMG 安装镜像的制作过程，也可以看看 DMG Maker：自动化创建精美的 macOS 安装包。

MDX on 小景