MDX 批量查词与导出

用本地 MDX 词典批量填充笔记字段，并把选中的卡片导出成排版精美、可直接打印的 HTML。全程离线运行，不发送任何网络请求。

如果你手头有 MDict 格式的词典（牛津高阶、朗文、柯林斯、韦氏、陆谷孙英汉大词典等），这个插件可以一次性为成百上千张卡片补齐释义，并且完整保留词典原本的排版——音标、词性、例句、同义词辨析框的颜色和层次都和你在 MDict 里看到的一致。导出功能则把这些内容整理成一份自包含的 HTML 文件，换台电脑打开、或粘贴进 Word，格式都不会散。

主要特性

• 批量查词填充：在浏览窗口选中若干笔记，一次为所有卡片补齐释义。
• 一词多典：同一个单词可以同时查多本词典，分别写入不同字段，方便对照。
• 忠实还原词典排版：自动读取词典自带的 CSS 并内联到内容里。不依赖外部样式文件，卡片、浏览器、Word 三处显示一致。
• 智能词形还原：查不到时自动尝试还原原形，例如 observed → observe、humanities → humanity、relocation → relocate、criticise → criticize（英美拼写互换）。实测可将未命中率降低约一半。
• 三种输出格式：词典原生排版、纯文本、原始 HTML，按字段分别设定。
• 安全的写入方式：可选「目标字段非空时跳过」「覆盖」「追加」，默认不覆盖已有内容。
• 一次撤销：整批写入合并为单个撤销步骤，按一次 Ctrl+Z 即可全部回退。
• 后台执行：带进度条，随时可取消，不卡界面。
• 导出 HTML：两种版式（表格式 / 文档式），列的顺序与显隐可自由调整。
• 完全离线：不联网，不上传笔记内容，也不上传词典数据。

安装方法

从 AnkiWeb 安装（推荐）

1. 打开 Anki，选择「工具 → 插件 → 获取插件」。

2. 输入本插件的 AnkiWeb 代码：

   1616953407
   

3. 点击确定，然后完全退出并重启 Anki。

手动安装

1. 下载 .ankiaddon 文件。
2. 打开 Anki，选择「工具 → 插件 → 从文件安装…」。
3. 选择下载的文件，重启 Anki。

提示：插件需要 Qt6 版本的 Anki，详见下方「兼容性说明」。

使用说明

一、批量查词

1. 打开浏览窗口（快捷键 B）。

2. 选中要补齐释义的笔记。请一次只选择同一种笔记类型——字段映射是按笔记类型保存的。

3. 点击菜单栏上的 「MDX 查词」（与 Notes、Cards、Go、Help 并列），或在选中的笔记上点右键选择「从 MDX 词典批量查词…」。

4. 在弹出的窗口里完成配置：

   • 词头字段：存放单词的字段，例如 Front。
   • 词典 → 目标字段：点「管理词典…」添加本地 .mdx 文件，然后为每本词典指定要写入的字段。点「+ 添加映射」可以增加多行，实现一词多典。
   • 格式：一般选「词典原生排版」。
   • 写入方式：首次批量补全建议用「目标字段非空时跳过」。

5. 点击 「预览第一个词」 确认效果无误。

6. 点击「确定」开始。处理过程中可随时取消；完成后如果结果不理想，Ctrl+Z 可整批撤销。

上图配置的含义是：从 Front 字段取词，同时查牛津高阶和陆谷孙两本词典，分别写入 Oxford 8th Edition 和 陆谷孙 两个字段，都采用词典原生排版。

二、导出 HTML

1. 在浏览窗口选中要导出的笔记。

2. 点击菜单栏上的 「导出 HTML」。

3. 选择版式：

   • 表格式：每个词一行，各本词典分列对照，适合打印成词汇表。
   • 文档式：每个词一节，带目录，适合精读。

4. 在「列」区域调整版面：

   • 勾选表示显示，取消勾选即隐藏。可用的列包括序号、单词，以及笔记类型的每一个字段。
   • 列表从上到下对应表格从左到右。选中某行后用「↑ 上移 / ↓ 下移」调整，也可以直接拖动。
   • 顺序和显隐会被记住，下次打开仍是这套设置。

5. 设置标题、副标题与排序方式（原顺序 / 字母序 / 随机），选择保存位置即可。

导出的文件是自包含的：样式已内联，不依赖任何外部文件，可以直接发给别人、用浏览器打印成 PDF，或整段复制进 Word。

三、配置文件

绝大多数设置通过界面完成。「工具 → 插件 → 选中本插件 → 配置」中还有一项进阶开关：

{
  "use_mdd": false
}

• use_mdd：是否加载词典的 .mdd 资源包，默认关闭。 .mdd 里存放的是插图和发音音频（牛津高阶那本有 370 MB），本插件不导入图片和音频，因此正常情况下无需加载，关闭它可以显著加快查词速度。仅当某本词典把 CSS 也打包在 .mdd 里、导致排版丢失时，才需要改为 true。

关于图片与发音

本插件有意不导入词典中的插图和发音按钮：这些资源存放在体积庞大的 .mdd 文件中，写进卡片后会显著增加collection 体积，且导出后往往显示为裂图。如果你需要发音，建议搭配 AwesomeTTS 等专门的插件使用。

兼容性说明

关于旧版本：插件使用了 Qt6 风格的枚举写法，因此不兼容 Qt5 版本的 Anki（2.1.49 及更早，以及 2.1.50–2.1.54 中的 Qt5 安装包）。开发者仅在 26.08.1 上做过完整测试，如果你在其他版本上遇到问题，欢迎反馈。

关于词典：理论上支持任何未加密的 MDX 词典。已实测：牛津高阶英汉双解（第 8 版）、英汉大词典（第二版·陆谷孙）、朗文当代、韦氏高阶英汉双解。采用 LZO 压缩或带加密的词典可能无法读取。

更新日志

1.0.1

• 修复：同形异义词只写入了第一个词条。 很多词典把同形异义词分成多条记录存放（如牛津的 lead「带领 / 铅」、陆谷孙的 bow 有三条），此前只取第一条，其余释义会丢失。现在全部写入，顺序与词典文件一致。在英汉大词典（陆谷孙）上，抽样约 9% 的单词受影响。
• 修复：少数单词查不到。 例如 offset——词典里有，但此前始终显示未收录；含双引号的词条也会查询失败。
• 修复一处潜在问题：同一本词典的样式表可能被重复应用，导致 » ◙ ➤ 等符号成倍出现。

1.0.0

• 首次发布。
• 批量查词填充，支持一词多典、多字段映射。
• 自动内联词典 CSS，忠实还原原始排版。
• 词形还原与英美拼写互换回退。
• HTML 导出：表格式 / 文档式两种版式，列可自由排序与显隐。

截图

表格式导出成品

序号、单词、各本词典都是独立的「列」，顺序和显隐都可自由调整。下图是「序号 + 牛津高阶 + 陆谷孙」的三列对照，每本词典都保持着各自的原生排版。

更多

批量查词的配置窗口见「使用说明 · 一」，导出设置窗口见「使用说明 · 二」。

<!-- 可选：补充一张文档式导出的截图 -->

许可证与致谢

本插件以 GPL-3.0 授权发布。

其中的 MDX 词典解析模块（mdict/ 目录）来自以下开源项目，同为 GPL-3.0：

• readmdict — 作者 Xiaoqiang Wang
• FastWordQuery — 作者 sth2018

感谢上述项目的作者。本插件的功能构想亦受 FastWordQuery 启发，但界面与查词、导出逻辑均按当前 Anki API 重新实现。

问题反馈

使用中遇到问题，欢迎在插件页面留言，或到 GitHub 仓库 提交 issue。反馈时请附上：

• Anki 版本（帮助 → 关于）
• 使用的词典名称
• 完整的错误信息（如果有弹窗报错，请复制全文）