词忆不是「查词弹窗」的堆砌，而是把 查 → 记 → 复习 → 玩 串成闭环：在笔记里即查即存，用可交互的可视化封面看清自己的词汇版图，用 SM-2 安排每一次复习，再让 AI 把枯燥的重复变成想玩的事。

📦 安装

社区市场（推荐）

设置 → 第三方插件 → 浏览 → 搜索 Word Memo → 安装 → 启用。

手动安装

1. 从最新 Release 下载 main.js、manifest.json、styles.css。
2. 放入 <你的库>/.obsidian/plugins/word-memo/。
3. 在 设置 → 第三方插件 中启用 Word Memo。

🔍 在 Obsidian 中取词

悬浮取词与划词翻译可在 设置 → Word Memo 中开关。

⚙️ 环境要求

• Obsidian 1.4.0 或更高版本，桌面端（Windows / macOS / Linux）。
• 无需额外文件：词忆应用已内嵌于 main.js。首次运行时插件会把它解压到库内的 .word-memo/，并通过本地 127.0.0.1 服务加载，使应用运行在独立 origin 上以正常保存配置。
• 唯一会按需联网取用的资源是英文扑克的音效包（约 160 KB）。它不随插件打包，原因有二：一是社区市场对插件包体积有上限，音频文件会无谓地增大每个用户的下载量；二是音效并非核心功能，不必让不玩英文扑克的用户一起承担。因此改为首次进入英文扑克的开桌设置时自动拉取并缓存到本机（Obsidian 端缓存于浏览器存储，Web 端同样），之后完全离线、可反复使用；下载失败也不影响对局，只是没有音效。

✨ 核心能力

1️⃣ 难词可视化：蒲公英聚类 与 混沌星云

两套自研封面——2D 力导向的仿生蒲公英，与 WebGL 流场粒子的 3D 星云

蒲公英聚类把词按词义一级分类聚成花冠外圈，种子大小取 CEFR 词频，正确率 ≤ 50% 的重点难词自动标红；切换「忘记词」口径，待复习的词即从花头飘向空中——花头留下的是已掌握，飘着的就是要复习的，还可直接拖拽整理清单。 混沌星云以无散度流场驱动上万粒子，点选任一词即以贝塞尔曲线连出最强关联（词根、形近可跨星团）并标注关系依据。难词由此不再是散点，而是一张有优先级、有联想路径的网。

2️⃣ 智能导入生词清单 × 五种学习模式 × SM-2 智能复习

把任何形态的生词清单丢进来，选一个适合的模式开始记，剩下的交给算法

支持 TXT / CSV / Excel / DOCX 导入并自动识别表结构，缺音标释义时先正则提取单词立即入库、再由 AI 后台补齐。五种模式可选——看单词选释义、看释义拼单词、记得么、同义替换、熟词僻义，由「认得出」递进到「分得清」。复习交给跟随艾宾浩斯曲线的 SM-2 自动排程，配合弱点自查定位最该补的词；也可接入任意 OpenAI 兼容 API 辅助记忆。

3️⃣ 130K+ CEFR 分级词汇 × 社区词典工坊 × 自带词典导入

13 万+ 词条自带 CEFR 等级标签 · 词典免费按需下载 · 你自己的 MDX / JSON 词典也能直接用

内置 130,000+ 条带 CEFR 分级标签的词汇数据：写作评估、可视化着色、生词分档全部建立在这套分级之上。社区工坊免费收录牛津、柯林斯、词根词缀、同义词典等词库，点一下就装进你的库，不预置、不捆绑。

同时支持导入你自己的 MDX / JSON / JS 词典（含配套 MDD 样式与真人发音），详见下方「词典数据」。

4️⃣ 英文学习插件共创生态

已发布，且持续上新

词忆把「AI 工坊」开放给了所有人：任何人都能为英文学习贡献一个插件。目前官方已发布的应用包括但不限于——

• 阅读联想记忆（生词串文） — 用你收藏的生词生成可读的短文与考题，在语境中记住它
• CEFR 写作评估 — 实时按 CEFR 等级高亮你写的英文，看得见自己的用词层次
• 英文原著分级推荐 — 接古登堡计划榜单，按难度挑下一本该读的原著
• 微信读书划线导出 — 把阅读中的划线与想法导出为 Markdown，或直接提取成词书
• 文字游戏 — 沉浸式剧情（恐怖 / 科幻 / 恋爱）中记单词

5️⃣ 一键收藏进欧路词典

直连欧路词典 OpenAPI · 增量静默同步

把词单与你的欧路生词本链接起来，之后每次收藏都自动、静默地增量推送到欧路——在笔记里看到的词，手机上打开欧路就能复习，两套工具的数据从此是一条线。

📖 词典数据

① 社区工坊（可选，免费按需下载）

应用不预置词典数据，内置引擎已覆盖核心查词流程；更大的词典包（柯林斯、词根词缀、同义词表等）为可选项。打开 AI 工坊 → 词典，点击对应词库的 下载：它会从本项目的公开 GitHub 仓库拉到本地并自动启用（Web 端存于浏览器本地，Obsidian 端存于库内的 .word-memo/data/）。

每个词库都是单个 JSON 数据文件（<name>-dict.json），只含词典文本；读取方式为 fetch + JSON.parse，不会作为代码执行，且仅存于本地、从不上传。文件名对应一个词典变量名（如 collins-dict.json → COLLINS_DICT），记录在 data/dict-manifest.js 中。

② 导入你自己的词典（MDX / JSON / JS）

内置 MDictionary（MDX）格式的解析器，同时支持直接导入 JSON / JS 词典，把你手头的词典装进来：

• 直接导入：在查词面板点击 导入 选择 .mdx / .json / .js；插件端还支持把文件拖进 Obsidian 右侧栏的导入区。MDX 解析在本地完成——自动识别 v1 / v2 头部、UTF-8 / UTF-16 编码、LZO 与 zlib 压缩块，乃至带密钥的 key-block 加密；JSON 直接读取，JS 仅剥离外层 var 变量名 = {...} 赋值语句（不执行任何脚本，不接受含函数的脚本词典）。三者解析结果都转为纯 JSON 文本写入 data/ 并立即启用，文件名与变量名沿用 oaldpe-dict.json → OALDPE_DICT 的约定。
• 保留原版样式与真人发音：配套的 MDD 资源包（原版 CSS 排版、mp3 发音、插图）解出为同名资源目录后会被自动识别，词条 HTML 中的图片 / 音频 / CSS 均按该目录解析——带样式的词典能保留原貌，点发音键走词典自带的真人音频，仅在缺失时才回退 TTS。

解析全程只使用 fetch + JSON.parse 读取文本，词典内容不会作为代码执行。

🌐 网络使用

词忆在本地查词、复习与可视化封面上完全离线。以下远程服务仅在你主动触发对应功能时才会访问，列于此以保持透明：

无遥测、无统计、无广告、无自动更新。 除非调用上述功能，应用不会联系任何服务器。

🔒 数据与隐私

• 全部设置、词书与复习进度都保存在你的本地：Web 端为浏览器本地存储，Obsidian 端为库内的 .word-memo/user/。从不上传。
• API 密钥存于本地配置，不写入插件的 data.json。
• 插件只访问库内文件（.word-memo/），不触碰磁盘上的其他内容。

🤝 参与贡献

欢迎贡献代码、报告问题或提出建议。想为英文学习添一个插件？词忆的 AI 工坊面向所有人开放——Fork 本项目，把你的插件放进工坊目录并提交 PR 即可（详见「核心能力 · 英文学习插件共创生态」）。

1. Fork 本项目
2. 创建特性分支（git checkout -b feature/AmazingFeature）
3. 提交更改（git commit -m 'Add some AmazingFeature'）
4. 推送到分支（git push origin feature/AmazingFeature）
5. 开启 Pull Request

🛠️ 开发

本插件由词忆应用生成。宿主源码位于 src/（plugin.js 为宿主，styles.css 为插件样式）；应用内核由主仓库的 tools/web2ob.py 打包为 main.js 中的单个 WM_APP_BUNDLE 字符串——容器为朴素的 WMB1 分帧，随后经 brotli 压缩与 base64 编码，不含加密或混淆。

python tools/web2ob.py                     # 打包应用内核（不内嵌任何词典）

请勿手改 main.js——修改 src/plugin.js 后重新构建。

💬 联系与支持

• 问题反馈：GitHub Issues
• 功能建议：GitHub Discussions
• 主项目：https://github.com/Losecloud/Word-Memo

📄 许可

MIT

English

Word Memo is a permanently free vocabulary tool for Obsidian, deeply integrated with your notes: hover lookup · selection translate · hard-word visualization · spaced repetition review · AI workshop. The plugin UI is currently in Chinese; the full English documentation is in README_EN.md.

Installation

From Obsidian: Settings → Community plugins → Browse → search Word Memo → Install → Enable.

Manually: download main.js, manifest.json and styles.css from the latest release into <your vault>/.obsidian/plugins/word-memo/, then enable Word Memo under Settings → Community plugins.

Usage

• Hover lookup — hover a word in a note or a text-based PDF and its definition appears in the right sidebar.
• Selection translate — select a word for its dictionary entry, or a sentence for an AI translation (floating button or right-click menu).
• Sidebar panel — a dedicated Word Memo panel docked in the right sidebar, powered by the built-in dictionary engine.
• Full app view — open the complete app (word books, visual covers, review, AI workshop) in a tab.

Hover lookup and selection translate can be turned off in Settings → Word Memo.