cctrv
1
大家好，我最近把一个老项目 aDict 重写了一版，想放到这里听听词典用户的意见。
aDict 最早在 2019 年上架，当时主要是我自己用来查词。后来项目放了很久。这次重写之后，我把它重新定位成一个 iPhone / iPad / Mac 上的词典工具，重点不是内置多少内容，而是让本地词典文件和在线来源能在同一个查词流程里使用。
最近有一位用户向我提了一个需求：希望 aDict 支持多个词典联合查询。
这个需求表面上看是「一次查多本词典」，但实际会牵涉到输入提示、自动完成、词典来源排序、结果合并方式，以及本地 MDX / StarDict 和在线来源之间的优先级。所以我现在还没有直接把它完整做进去，想先听听长期使用多本词典的人会怎么设计这个功能。
目前重写版主要支持：
- MDict / MDX / MDD
- StarDict
- 本地词典文件管理
- 多个词典来源切换
- 输入时的词条提示
- 在线词典来源，例如 Youdao、V2EX Dict
- iPhone / iPad / Mac
我自己一直有一个需求：读东西时不想只依赖一个在线词典，也不想把以前收集的 MDX / MDD / StarDict 文件丢掉。以前这些词典文件通常只能留在某几个固定工具里使用，换到手机、平板或 Mac 上就会有割裂感。所以这次重写 aDict 时，我优先做的是「能不能把这些词典来源放到一个简单的查词入口里」。
下面这张是词典来源切换和输入提示。这里能看到本地 MDX 词典、V2EX、Youdao 等来源可以并列存在，输入时也会给出候选词。
本地词典这部分目前还比较基础，但已经可以管理 MDict / StarDict 文件，并用本地 MDX 做查询。下面左侧是词典文件管理，右侧是 MDict 词典查询结果。
Mac 版也可以使用同一套词典来源。我的目标不是做一个很复杂的资料库，而是让查词这件事在手机和 Mac 上都尽量轻。
这次也尝试接入了一些在线词典来源。比如 V2EX Dict 的内容形式和传统词典不太一样，除了释义和音标，也有例句、词源、相关词和语境补充。我觉得它适合作为一个独立在线来源，而不是替代本地词典。
这里是深色和浅色下的显示效果：
补充：根据后续测试，我已经开始用 Cambridge Dictionary English 2024、LDOCE5+++Activ、Merriam-Webster Online 202605 这类更复杂的 MDict 包做兼容性验证。当前 3.0 beta 对基础 MDX lookup 和建议词已经能跑通，但 MDD 资源、非同名 CSS / JS、内部链接和脚本行为还有遗漏。这个部分我会在接下来的 build 里重点改善。
如果你手里有格式丢失、按钮失效、图片/音频出不来的 MDict 词典，也欢迎把词典文件或文件结构发到 llqoli@gmail.com，我会按真实词典来做适配。
回到「多词典联合查询」这个需求，我现在比较不确定的是：
- 多词典查询应该是「同时查所有已启用词典」，还是「先用当前词典做输入提示，提交后再查多本」？
- 自动完成候选词应该来自哪里？当前词典、全部本地词典，还是最近常用的几个词典？
- 多本词典都有结果时，应该合并在同一页，还是按词典分段 / Tab 展示？
- 本地 MDX / StarDict 和在线词典来源应该混在一起查，还是分开查询？
- 对 MDX / MDD / CSS / JS 的支持，哪些部分最影响这种联合查询的实际可用性？
我也做了一个简单的介绍页：aDict Landing Page。
目前这个版本还在 TestFlight 阶段，功能仍然比较阳春。如果你也需要一个可以接入 MDict、StarDict 和在线词典来源的查词工具，欢迎试用，也欢迎直接指出现在的设计不合理之处。对我来说，这个版本最需要的不是夸奖，而是真正使用本地词典文件的人帮忙指出边界和坑。
提示：aDict 3.0 目前是 TestFlight 测试版，还没有发布到 App Store。TestFlight 页面里显示的 App Store 信息可能仍然来自已经上架的旧版；通过下面的 TestFlight 链接加入测试并安装后，才会看到 3.0 测试版。
TestFlight：https://testflight.apple.com/join/dCGMvyw9
Landing Page：https://adict.ronniewong.cc/
我iPhone上有TestFlight,怎么找到这个aDict3.0的测试版呢？
cctrv
3
是我原帖没有说明清楚：aDict 3.0 现在还是 TestFlight 测试版，还没有发布 App Store 更新。
你可以直接点原帖里的 TestFlight 链接加入测试；TestFlight 页面上如果看到的是已经上架的商店信息，那部分可能仍然是旧版 App Store 信息，不代表 3.0 已经在商店发布。加入测试并安装后，才会拿到 3.0 的测试 build。
cctrv
6
目前支持的是同名资源文件放在一起的结构，例如：
MDict/
OxfordA.mdx
OxfordA.mdd
OxfordA.css
OxfordA.js
也就是 .mdx 以及同名的 .mdd、.css、.js 会被识别为同一组词典资源。
你提到的文件夹形式确实是我考虑不周。目前还不支持把一本 MDict 词典放在单独文件夹里，例如 MDict/OxfordA/OxfordA.mdx 这种结构。这个使用方式很合理，后续版本我会更新支持这种文件夹放入/识别方式。
如何加载本地词典呢，aDict文件夹只在iCloud Drive里有，本地没有
cctrv
8
可以在 aDict 里面先到设置里的 Dictionary Files，点 Open folder，让系统直接打开当前实际读取的目录。
现在这部分有两种位置：
- 如果开启了 Sync with iCloud，词典会从 iCloud Documents 里读取；
- 如果关闭 Sync with iCloud，词典会从本机 Local Documents 里读取。
所以如果你现在只在 iCloud Drive 里看到 aDict 文件夹，通常可以直接把词典放到那个目录下；如果你想放本机目录，可以先在 aDict 里关掉 iCloud sync，然后再点 Open folder。
目前推荐的结构是：
MDict/
OxfordA.mdx
OxfordA.mdd
OxfordA.css
MDict/
OxfordA/
OxfordA.mdx
OxfordA.mdd
OxfordA.css
StarDict/
Sample.ifo
Sample.idx
Sample.dict
放进去之后回到 aDict 的 Dictionary Files 页面刷新/重新进入，应该就能扫到。
这个地方现在确实不够直观，特别是 iOS 文件 App 里 iCloud / 本机目录的显示很容易让人误解。我后面会把导入说明和入口做得更清楚一些。
现实是本地存储就没有adict文件夹，开关设置也没用。点击open folder也没用，打开的不是目录文件夹而是上一次的files路径。
cctrv
10
我重新确认了一下，这里主要是 Files app 已经打开时的状态恢复问题，不是 aDict 读取目录变了。
在 aDict 里点 Open folder 时，aDict 会把当前设置对应的 Documents 目录交给系统 Files 打开：
- Sync with iCloud 开启：打开 iCloud Documents 里的 aDict 目录；
- Sync with iCloud 关闭：打开本机 Local Documents 目录。
但如果 Files / 文件 app 此时已经在后台打开着，iOS 很容易恢复到 Files 上一次停留的路径，而不是切到这次传入的 folder URL。这个时候看起来就会像「开关没用」或者「Open folder 还是旧位置」，但核心是 Files 没有切换当前目标。
可以先这样处理：
- 进入 iOS 多任务管理；
- 把 Files / 文件 app 完全划掉关闭；
- 回到 aDict；
- 在 Dictionary Files 里确认 Sync with iCloud 开关状态；
- 再点一次 Open folder。
所以这里先不要从 Files 当前显示的路径判断本机目录不存在；先完全关闭 Files 后，再从 aDict 的 Open folder 入口打开一次。
cctrv
13
是的，这里可以先按 MDict 支持还不完整 来理解。目前 aDict 对 MDict 的支持还有一些遗漏，尤其是某些词典依赖比较复杂的 CSS / JS / MDD 资源时，显示格式可能会不完整。
如果方便的话，希望你能把遇到问题的词典文件发到这个邮箱：llqoli@gmail.com。这样我可以直接用这个词典做测试，专门针对它的资源结构和引用方式做适配。只看截图或者描述的话，很难判断具体是 CSS、JS、MDD 资源，还是路径结构的问题。
目前扫描规则大概是这样：
MDict/
OxfordA.mdx
OxfordA.mdd
OxfordA.css
或者：
MDict/
OxfordA/
OxfordA.mdx
OxfordA.mdd
OxfordA.css
也就是说，即使放在同一个 folder 下面，.mdx、.mdd、.css 也最好保持相同的文件名 stem，例如都叫 OxfordA。如果资源文件是另外的名字，或者 CSS / JS 放在更深的子目录里，现在就可能识别不到或显示不完整。
cctrv
14
补充一个进展：我刚选了三套比较复杂的 MDict 包做验证：Cambridge Dictionary English 2024、LDOCE5+++Activ、Merriam-Webster Online 202605。这些包都不是简单的单文件 MDX，而是包含 MDD、CSS、JS、图片/音频、内部跳转、折叠/展开、脚本行为等。
目前测试结果大概是：基础的 MDX header / lookup / suggest 已经能跑起来，但复杂资源支持还不完整。三套词典都有非同名 CSS / JS 或 MDD 资源引用，现有逻辑还没有覆盖完整；真实 MDD 资源抽取也暴露出一些 buffer offset / key-info decode 之类的问题。
所以如果现在遇到「词典能查，但格式丢了 / 按钮失效 / 图片或音频出不来」，这个反馈是合理的。接下来的 build 我会优先改善 MDict 的 CSS / JS / MDD 资源加载、内部链接和脚本行为。
alipay
15
我用的是论坛里的牛津高阶10完美版，考虑到文件过大可能不适合邮箱发送，这是查询的效果。
cctrv
16
谢谢反馈，这个情况我已经理解了。
目前确实是 aDict 对复杂 MDict 词典的支持还不完整，不是你放置文件的问题。像你提到的牛津高阶 10 完美版这类词典，本身会依赖比较完整的 CSS / JS / MDD 资源和内部交互；现在 aDict 能把基础查询跑起来，但在样式、脚本、资源加载这些地方还有明显缺口。
这个问题我已经在处理了。建议你可以先等下一个 TestFlight build，再用同一套词典测试一次。下一版我会优先改这类复杂 MDict 包的资源加载和显示问题。
也非常感谢你愿意实际拿词典测试并把问题贴出来，这类反馈对 3.0 很有价值。方便的话，也希望你给我发一封邮件到 llqoli@gmail.com，让我后续能联系到你。等 aDict 3.0 正式上架时，我会给你一个兑换码，作为参与测试和提供高价值反馈的感谢。
最近不少 iOS 词典 App，真用户福音，之前好像也有同名app，不知是不是同一作者，不过此 adict 的导入方法真没搞懂，文件已经复制到 APP 文件夹下 MDICT 文件夹内还是不能识别，尝试iCloud同步，显示已加载，还是不能查词
cctrv
18
谢谢反馈，这个情况我大概看明白了。
先回答一下：以前那个 aDict 也是我做的，这次 3.0 是重新写的一版，所以名字是同一个项目。
从你截图看，aDict 其实已经扫到了 oaldpe.mdx，Session 里也能选到这本词典；所以这里可能不是「完全没有识别」，而是只识别到了基础 MDX。Dictionary Files 里现在显示 Files: 1，也就是目前只看到一个 oaldpe.mdx 文件。
像 OALDPE 这类词典通常还会依赖 .mdd、CSS、JS、图片/音频和内部交互。如果这些配套资源没有被完整识别或加载，就会出现「能看到词典，但查词显示不正常 / 格式丢失 / 看起来不能用」的问题。
这部分确实是目前 aDict 3.0 beta 的不足，不是你操作的问题。我正在改复杂 MDict 词典的资源加载和导入识别，建议你可以先等下一个 TestFlight build，再用同一套文件测试一次。
也谢谢你贴截图，这张图很有帮助，尤其是 Files: 1 这个信息能直接说明当前只识别到了主 MDX。
期待新版，我也是传了截图才发现读取了 mdx，配套的还有 4 个 mdd，一个 css 和一个 js
今天又尝试了2个早期的mdict 词典，应该都是freegut制作的，似乎能正常显示，我今天也弄懂了查词逻辑，一次只能显示一本词典内容，切换词典后还要再查一次才能切换显示内容
oaldpex 的文件命名也符合 aDict 规范，但还是无法读取到样式？
