README file from
Github词忆 · Word Memo
专攻难词 · 趣味高效
一款永久免费、共创生态的单词记忆工具，与笔记深度集成：悬浮取词 · 划词翻译 · 难词可视化 · 间隔复习 · AI 工坊
Obsidian 1.4.0+ · 仅桌面端 · MIT
词忆不是「查词弹窗」的堆砌，而是把 查 → 记 → 复习 → 玩 串成闭环：在笔记里即查即存，用可交互的可视化封面看清自己的词汇版图，用 SM-2 安排每一次复习，再让 AI 把枯燥的重复变成想玩的事。
📦 安装
社区市场（推荐）
设置 → 第三方插件 → 浏览 → 搜索 Word Memo → 安装 → 启用。
手动安装
- 从最新 Release 下载
main.js、manifest.json、styles.css。 - 放入
<你的库>/.obsidian/plugins/word-memo/。 - 在 设置 → 第三方插件 中启用 Word Memo。
🔍 在 Obsidian 中取词
| 能力 | 说明 |
|---|---|
| 悬浮取词 | 鼠标悬停在笔记或文本型 PDF 的单词上，右侧栏即刻给出释义 |
| 划词翻译 | 选一个词查词典，选一句话交给 AI 翻译；支持浮动按钮与右键菜单 |
| 侧栏查词 | 独立的词忆面板常驻右侧栏，由内置查词引擎驱动 |
| 完整应用 | 在标签页打开词忆全功能界面（词书、可视化封面、复习、AI 工坊） |
悬浮取词与划词翻译可在 设置 → 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 读取文本，词典内容不会作为代码执行。
🌐 网络使用
词忆在本地查词、复习与可视化封面上完全离线。以下远程服务仅在你主动触发对应功能时才会访问，列于此以保持透明：
| 服务 | 触发时机 | 说明 |
|---|---|---|
GitHub（raw.githubusercontent.com、github.com/.../releases/download/...） |
打开「关于」页、点击词典包的下载，或进入英文扑克的开桌设置 | 公开只读下载说明文档、你指定的词典数据，以及英文扑克音效包（约 160 KB，首次进入开桌设置时自动拉取并缓存到本机，之后离线可用）。不发送任何数据。 |
| 你的 AI 服务商（OpenAI、SiliconFlow 或任意 OpenAI 兼容端点） | 请求翻译、AI 讲解或导入后补齐词条时 | 端点与密钥由你配置、存于本地；未经你操作不会发送任何内容。 |
欧路词典 OpenAPI（api.frdic.com） |
使用欧路词典联动时 | 需要你自己的授权码。 |
微信读书（i.weread.qq.com） |
加载英文原著榜 / 导出划线时 | 需要你自己的 Key。 |
古登堡计划元数据（gutendex.com） |
浏览英文原著榜时 | 仅公开元数据。 |
热点榜单（zj.v.api.aa1.cn） |
在口语角话题中点击 搜索热点 时 | 公开的微博 / 百度榜单数据，不发送任何数据。 |
tianapi（apis.tianapi.com） |
在口语角话题中点击 搜索热点，且你已在其中 ☰ 设置里填入自己的 tianapi Key | 需要你自己的 Key；未填 Key 时完全跳过。 |
Google Translate TTS（translate.google.com） |
仅作为发音兜底 | 无本地音频时使用。 |
无遥测、无统计、无广告、无自动更新。 除非调用上述功能，应用不会联系任何服务器。
🔒 数据与隐私
- 全部设置、词书与复习进度都保存在你的本地：Web 端为浏览器本地存储，Obsidian 端为库内的
.word-memo/user/。从不上传。 - API 密钥存于本地配置，不写入插件的
data.json。 - 插件只访问库内文件（
.word-memo/），不触碰磁盘上的其他内容。
🤝 参与贡献
欢迎贡献代码、报告问题或提出建议。想为英文学习添一个插件？词忆的 AI 工坊面向所有人开放——Fork 本项目，把你的插件放进工坊目录并提交 PR 即可（详见「核心能力 · 英文学习插件共创生态」）。
- Fork 本项目
- 创建特性分支（
git checkout -b feature/AmazingFeature） - 提交更改（
git commit -m 'Add some AmazingFeature'） - 推送到分支（
git push origin feature/AmazingFeature） - 开启 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 后重新构建。
💬 联系与支持
📄 许可
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.
如果这个项目对你有帮助，请给个 ⭐️ Star 支持一下！
Made with ❤️ by [Losecloud]
