Obsidian Stats logoObsidian Stats

FleurDict

by JC5
5
4
3
2
1
Score: 35/100
Install Code

Description

Elegant English dictionary plugin for Obsidian with AI-powered word explanation and translation

Reviews

No reviews yet.

Stats

2
stars
230
downloads
2
forks
27
days
5
days
5
days
2
total PRs
2
open PRs
0
closed PRs
0
merged PRs
1
total issues
1
open issues
0
closed issues
37
commits

Latest Version

1.5.11
5 days ago

Changelog

1.5.11

新增

  • ✅ PDF 右键菜单独立开关：设置 → 外观与快捷键 中新增「PDF 右键菜单」（默认开启），与「PDF 双击查词」彻底解耦
  • 此前两者共用一个开关 —— 关闭双击查词会连带失去 PDF 右键菜单，想在 PDF 里保留右键查词的用户找不到设置入口

变更

  • 📝 「PDF 双击查词」的描述补充说明：只控制双击，不影响右键菜单
  • 🧹 关闭「PDF 右键菜单」后，插件不再接管 PDF 右键事件，完全交还原生菜单，也不再与其它插件争抢该事件
  • 🔁 升级兜底：旧配置若已关闭「PDF 双击查词」且新开关尚未落盘，升级后新开关同步为关闭，避免行为突变

升级说明

  • 新开关默认开启，老用户升级零感知，已有配置不会被覆盖
  • 升级后请重载插件或重启 Obsidian

English

Added

  • ✅ Standalone toggle for the PDF context menu: a new "PDF context menu" switch in Settings → Appearance & Hotkeys (on by default), fully decoupled from "PDF double-click lookup"
  • The two previously shared a single switch — turning off double-click lookup also removed the PDF context menu, leaving users who want to keep right-click lookup in PDFs with no way to configure it

Changed

  • 📝 The "PDF double-click lookup" description now states that it only controls double-click and does not affect the context menu
  • 🧹 When "PDF context menu" is off, the plugin no longer intercepts right-click events in PDFs, handing the native menu back completely and no longer competing for the event with other plugins
  • 🔁 Upgrade fallback: if an older config had "PDF double-click lookup" disabled and the new key was never written, the new key syncs to disabled so behavior does not change silently

Upgrade notes

  • The new switch is on by default, so existing users see no change and existing configuration is never overwritten
  • Please reload the plugin or restart Obsidian after upgrading.
See all version on GitHub

README file from

Github

FleurDict

一款优雅的 Obsidian 英语词典插件，提供划词查询、AI 智能解析、生词本管理和间隔重复复习等完整学习体验。

An elegant English dictionary plugin for Obsidian, providing word lookup, AI-powered explanations, vocabulary notebook, and spaced repetition review.

中文文档

核心功能

智能词典查询
  • 划词即查：双击单词或划选短语，自动弹出词典释义
  • 多源聚合：支持有道词典、Free Dictionary API、本地 JSON 词典、MDX 格式词典
  • 离线支持：可导入本地词典文件，无网络也能查词
  • 智能缓存：自动缓存查询结果，减少重复请求
PDF 阅读支持
  • PDF 双击查词：在 Obsidian 内置 PDF 阅读器中双击单词即可查询，与笔记内体验一致
  • PDF 右键菜单：选中文本后右键即可「查词 / 加入生词本 / AI 翻译 / AI 详解」
  • 生词高亮驻留：PDF 中的生词按熟练度分级着色，翻页、滚动、缩放都不会丢失
  • 连字还原：自动处理 PDF 常见的软连字符与跨行断词（exam- + ple → example）
  • 两套独立配色：PDF 高亮采用独立配色方案，不会与笔记内高亮互相干扰
AI 智能解析
  • AI 详解：一键获取单词的详细讲解，包括词源、记忆技巧、用法示例
  • AI 翻译：智能翻译选中的文本或整个句子
  • 多模型支持：支持 DeepSeek、Qwen、GLM、SiliconFlow 等主流 AI 服务
  • 流式输出：实时显示 AI 回复，无需等待完整响应
生词本管理
  • 自动收录：查询过的单词可一键加入生词本
  • 词性标注：名词、动词、形容词等词性标签可视化渲染
  • 上下文记录：自动保存单词出现的语境
  • 欧路同步：支持与欧路词典双向同步
间隔重复复习
  • SM-2 算法：基于科学的间隔重复算法，优化记忆效果
  • 闪卡模式：支持到期复习、分类复习、随机复习
  • 进度追踪：记录每个单词的复习次数和掌握程度
  • 每日统计：显示今日待复习单词数量
优雅界面
  • Light/Dark 主题：完美适配 Obsidian 浅色和深色主题
  • 响应式设计：支持桌面端和移动端
  • 可拖拽弹窗：词典弹窗可自由拖拽和调整大小
数据安全与多设备
  • 密钥默认存入系统钥匙串：AI API Key 与欧路 Token 保存在系统钥匙串（macOS 钥匙串 / Windows 凭据管理器），不会以明文写入 data.json
  • 可切换保存位置：设置 > 密钥存储 可在“系统钥匙串”与“data.json”之间随时切换，切换时密钥自动搬运，无需重新填写
    • 系统钥匙串（默认，推荐）：密钥不会离开本机，也不会随 Obsidian Sync / iCloud / OneDrive 扩散。代价是密钥不随 vault 同步，每台设备需要各自填写一次
    • data.json：密钥随 vault 同步，多设备共用一份。代价是以明文保存在仓库中，并会随同步上传到云端
  • 默认不输出日志：插件不会把查词内容、生词本词条或选中文本打印到控制台

安装方式

通过社区插件安装（推荐）
  1. 打开 Obsidian 设置 > 第三方插件
  2. 搜索 "FleurDict"
  3. 点击安装并启用
通过 BRAT 安装
  1. 在 Obsidian 中安装 BRAT 插件
  2. 打开 BRAT 设置，点击 "Add Beta Plugin"
  3. 输入仓库地址：gibsonchan5/fleurdict
  4. 点击 "Add Plugin" 完成安装
手动安装
  1. 从 Releases 下载最新版本
  2. 解压后将文件夹放入 Obsidian vault 的 .obsidian/plugins/ 目录
  3. 在 Obsidian 设置中启用 FleurDict 插件

快速开始

1. 配置 AI 服务（可选）
  1. 打开设置 > FleurDict > AI 设置
  2. 选择 AI 提供商（推荐 DeepSeek）
  3. 填入 API Key
  4. 保存设置
2. 开始使用
  • 划词查词：在编辑器中双击单词或划选短语
  • PDF 查词：直接在 PDF 阅读器中双击单词或划选短语，操作方式与笔记内完全一致
  • 右键菜单：右键点击选中的文本，选择“查词”、“AI 详解”、“加入生词本”
  • 侧栏视图：点击左侧 ribbon 图标打开生词本或 AI 侧栏

English Documentation

Features

Smart Dictionary Lookup
  • Click to look up: Double-click a word or select a phrase to get instant definitions
  • Multi-source: Supports Youdao, Eudic, Free Dictionary API, and more
  • Smart caching: Automatic caching to reduce redundant API calls
PDF Reading Support
  • PDF lookup: Double-click a word inside Obsidian's built-in PDF viewer for the same experience as in notes
  • PDF context menu: Right-click a selection for "Look up / Add to Vocabulary / AI Translate / AI Explanation"
  • Persistent highlights: Vocabulary words in PDFs are colour-coded by proficiency and survive page turns, scrolling, and zooming
  • Dehyphenation: Handles PDF soft hyphens and words broken across lines (exam- + ple → example)
  • Separate palette: PDF highlights use their own colour scheme, so they never clash with in-note highlights
AI-Powered Analysis
  • AI Explanation: One-click detailed explanation including etymology, memory tips, and usage examples
  • AI Translation: Smart translation for selected text or full sentences
  • Multi-model support: Works with DeepSeek and other mainstream AI providers
  • Streaming output: Real-time display of AI responses
Vocabulary Notebook
  • Auto collection: Add looked-up words to your notebook with one click
  • POS tags: Part-of-speech labels rendered as visual tags
  • Context saving: Automatically records the context where the word appeared
  • Eudic sync: Bidirectional sync with Eudic dictionary
Spaced Repetition Review
  • SM-2 algorithm: Scientific spaced repetition for optimal memorization
  • Flashcard mode: Due-only, category-based, or random review
  • Progress tracking: Records review count and mastery level for each word
Elegant Interface
  • Light/Dark theme: Seamlessly adapts to Obsidian light and dark themes
  • Responsive design: Works on desktop and mobile
  • Draggable popup: Freely draggable and resizable dictionary popup
Privacy & Security
  • Keys in the keychain by default: Your API key and Eudic token are stored in the system keychain (macOS Keychain / Windows Credential Manager) and are never written to data.json in plain text
  • Choose where keys live: Settings → 密钥存储 switches between the keychain and data.json on the fly, carrying the existing keys over. The keychain never leaves your machine, so each device needs its own paste; data.json syncs with the vault across devices but keeps keys in clear text
  • No logs by default: The plugin prints no user content (looked-up words, notebook entries, selected text) to the console
  • Controllable highlights: In-note vocabulary highlighting can be toggled on or off at any time in the settings

Installation

From Community Plugins (Recommended)
  1. Open Obsidian Settings > Community Plugins
  2. Search for "FleurDict"
  3. Click Install and Enable
Via BRAT
  1. Install the BRAT plugin
  2. Open BRAT settings, click "Add Beta Plugin"
  3. Enter repository: gibsonchan5/fleurdict
Manual Installation
  1. Download the latest release from Releases
  2. Extract and copy the folder to .obsidian/plugins/
  3. Enable in Obsidian Settings > Community Plugins

Quick Start

1. Configure AI Service (Optional)

Open Settings > FleurDict > AI Settings, enter your DeepSeek API Key to enable AI explanations and translations.

2. Start Using
  • Look up words: Double-click a word or select a phrase in the editor
  • PDF lookup: Double-click a word or select a phrase directly inside the PDF viewer
  • Right-click menu: Right-click selected text for "Look up", "AI Explanation", "Add to Vocabulary"
  • Sidebar: Click the ribbon icon on the left to open the Vocabulary Notebook or AI sidebar

致谢 / Credits

许可证 / License

MIT License

数据来源与免责声明 / Data Sources & Disclaimer

数据来源 / Data Sources

本插件使用的词典数据来源：

  • 有道词典：提供英汉/汉英词典查询服务，数据来源于网易有道词典网页版接口
  • Free Dictionary API：提供英文释义，数据来源于 Wiktionary（CC BY-SA 4.0 许可证）
  • 欧路词典 API：用于生词本同步，用户需自行提供授权 Token

Dictionary data sources used by this plugin:

  • Youdao Dictionary: Provides English-Chinese/Chinese-English dictionary lookup, data sourced from NetEase Youdao Dictionary web API
  • Free Dictionary API: Provides English definitions, data sourced from Wiktionary (CC BY-SA 4.0 license)
  • Eudic API: Used for vocabulary notebook sync, users must provide their own authorization token

免责声明 / Disclaimer

  • 本插件仅供个人学习使用，不得用于商业用途

  • 词典数据版权归原作者或机构所有，插件开发者不拥有相关数据权利

  • 如相关数据提供方认为本插件侵犯其权益，请联系开发者处理

  • 使用本插件即表示您同意遵守各数据提供方的服务条款

  • This plugin is for personal learning use only and may not be used for commercial purposes

  • Dictionary data is owned by its respective authors/organizations; the plugin developer does not own the rights to this data

  • If any data provider believes this plugin infringes on their rights, please contact the developer

  • By using this plugin, you agree to comply with the terms of service of each data provider

联系方式 / Contact

Made with heart for Obsidian community

Sponsors