一典 Onedict

中文 · English

一本安静、漂亮、飞快的词典。

加载你本地的 MDX / MDD 词典,查询极速、极美;全局划词、维基词源、系统发音 —— 只把「查一个词」这件事,做到安静、漂亮、飞快。

onedict-hero.mp4

_{▶ 一典 · 介绍片 · 54 秒  ·  📱 手机看不到播放器?到 在线观看页 看演示与全部截图}

---

一典是什么

一典是一款 macOS 原生词典应用。它加载你本地的 MDX/MDD 词典文件,提供极速、极美的查询体验;内置维基百科作为在线词源,支持全局划词、收藏回看与系统发音。所有数据都留在你的 Mac 上。

它不是背单词软件、不是翻译软件、不是 AI 学习助手,也不是词典商店 —— 这几个「不是」写进了产品宪法。

为什么做一典

市面上的词典软件,要么臃肿迟缓,要么审美停在上个时代,要么把「查个词」做成了发烧友的配置游戏。

一典只信一件事:简单就是美。每加一个功能,先问能不能不加。排印即界面 —— 词典的内容本身就是最美的素材,设计的全部工作,是为文字提供一个安静、精确、有呼吸感的舞台,然后消失。

界面一览

_{安静的起点 —— 打字即查,或在任意应用选中文字按 ⌃D 划词;左栏是你最近查过的词}

_{聚合查询 —— 多本词典同页展示,顶部胶囊栏一键跳转;左栏邻近词像翻纸质词典一样连续}

_{全局划词 —— 在浏览器 / PDF / 电子书里选中文字,光标旁浮出释义;读完自动还原你的剪贴板,你无感}

_{你的词典库 —— 拖动排序即优先级,查询结果按此顺序展示;把 .mdx 拖到窗口任意位置即可导入}

_{克制的设置 —— 深浅色、词条字号、划词快捷键、维基词源;该有的都有,不该有的都没有}

核心功能

• 聚合查询 —— 多本词典按你的顺序同页展示,顶部胶囊栏一键跳转;支持 * ? 通配、词形还原、近似词「你是不是要找」。
• 双栏阅读 —— 左栏候选 / 邻近词,右栏词条;⌘⇧L 折叠成纯净阅读模式。每本词典的 CSS 用 Shadow DOM 隔离,样式互不串味。
• 全局划词(⌃D) —— 任意应用里选中文字即查。优先用 Accessibility 读取选区,不行则模拟 ⌘C 兜底,读完自动还原剪贴板。快捷键可改。
• 维基百科 —— 中 / 英维基作为在线词典追加在词条末尾,摘要缓存 7 天,离线或超时自动隐藏。
• 发音 —— MDD 内嵌真人音频优先,无则系统 TTS;按词头自动选中 / 英语音(⌘P)。
• 收藏与历史 —— 一键收藏,按今天 / 昨天 / 更早回看;历史自动去重,只存本机。
• 菜单栏迷你搜索 与系统**「服务」**查词入口。

快捷键

快捷键	功能		快捷键	功能
⌃D	全局划词查询		⌘S	收藏 / 取消收藏
⌘F / 打字	聚焦搜索框		⌘Y	历史
↑ ↓ ↵	选择候选		⌘⇧F	收藏列表
⌘P	发音		⌘⇧L	折叠左栏
⌘1…9	跳转第 n 本词典		⌘,	设置
⌘[ / ⌘]	查询后退 / 前进		⌘O	导入词典

安装

要求:macOS 13(Ventura)及以上 · Apple Silicon 或 Intel 均原生支持

1. 到 Releases 下载最新的 Onedict-1.0.0-universal.dmg。
2. 双击打开 DMG,把「一典」拖进 Applications 文件夹,然后打开。
3. 首次使用全局划词(⌃D)时,按提示在 系统设置 → 隐私与安全性 → 辅助功能 里授权 —— 任何全局快捷键应用都需要这一步。

Universal 通用二进制:同一个安装包在 Apple Silicon 与 Intel Mac 上都原生运行。app 与 DMG 均经 Apple 公证(Developer ID)并 staple,双击直接打开,不会被 Gatekeeper 拦截。

自带词典 · 什么是 MDX / MDD?

MDX / MDD 是词典爱好者社区通行的词典文件格式,牛津、朗文、韦氏等主流词典均有此格式流通。MDX 存词条正文,MDD 存图片 / 音频等资源(同名放同一目录会自动关联)。

一典只读取你本地的文件,自身不分发、不打包、不托管任何词典内容 —— 你加载哪些词典、是否有权使用,由你自己负责。上面截图里的词典是作者本机的示例,不随一典分发。

隐私

所有数据 —— 词典索引、收藏、历史 —— 只保存在本机 ~/Library/Application Support/Onedict/,永不上传,无账号,无遥测。仅当你主动开启维基时,才会向 Wikipedia 请求摘要(可在设置里关闭)。

从源码构建

需要:Xcode 15+、XcodeGen(brew install xcodegen)、Rust。

git clone https://github.com/dososo/onedict.git
cd onedict/macos/Onedict
./build-app.sh     # 编译 Rust 核心 → xcframework → app,产物在 .build/xcode/…/Onedict.app

构建通用二进制(arm64 + Intel) 需要 rustup 提供 x86_64 标准库(Homebrew 的 rust 只有宿主架构):

# 一次性:装 rustup 并补齐两个 Apple target
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y --profile minimal
rustup target add aarch64-apple-darwin x86_64-apple-darwin
# 之后 build-xcframework.sh 会自动出 universal 静态库,app 用 ARCHS="arm64 x86_64" 编译即可

平台无关的 Rust 核心在 core/,原生 macOS 外壳在 macos/。

技术栈与架构

• Rust 核心(core/)—— MDX/MDD 解析、SQLite 索引、聚合查询、维基客户端。平台无关、纯离线、可独立测试。
• SwiftUI 应用(macos/)—— 原生外壳、双栏阅读、全局划词、菜单栏与「服务」集成。
• UniFFI 桥接 —— Rust 核心编译成 universal 静态库(OnedictCore.xcframework),通过自动生成的 Swift 绑定被应用调用,单一事实源、无运行时额外依赖。

许可

Apache License 2.0 © 2026 爆裂队长 NEXT(BLCaptain)

MDX/MDD 解析核心是对该文件格式的独立 clean-room 实现(格式本身不受版权保护),不含任何第三方词典内容。

联系作者

爆裂队长 NEXT(BLCaptain)

• GitHub:dososo
• X:@thinkszyg
• 邮箱:blteam2026@outlook.com

_{© 2026 爆裂队长 NEXT · 一典 Onedict —— 简单就是美。}