Calibre WP：为你的WordPress网站整合专业电子书库

Calibre WP 是由 BraveDAO 开发的 WordPress 插件，目前正处于内部测试阶段。本文是关于 Calibre WP 7.x 版本的功能全景介绍。

一、连接两个世界的桥梁

对于任何认真对待知识生产的人来说，书籍是最核心的知识来源之一。你可能已经在 Calibre 中积累了成百上千本电子书——技术手册、学术著作、文学经典、行业报告。它们静静地躺在你自托管的 Calibre-Web 服务器上，按照精心设计的分类体系井然有序。然而，这些书与你的 WordPress 知识平台之间，隔着一堵看不见的墙。

Calibre-Web 作为全球最流行的开源电子书管理工具 Calibre 的 Web 界面，提供了完善的书库管理能力——浏览、搜索、下载、用户管理一应俱全。但它的定位是"书库管理器"，不是"内容发布平台"。界面面向管理而非展示，风格不可深度定制，与你的 WordPress 主站在视觉和交互上完全割裂。更重要的是，直接分享 Calibre-Web 的登录链接，意味着暴露服务器地址和端口——这在安全上是不可接受的。

WordPress 作为全球最流行的内容管理系统，拥有卓越的内容发布和展示能力。它的插件生态系统和灵活的主题使其适合各种内容展示需求。然而，WordPress 本身并不具备电子书管理和在线阅读的能力。

💡 Calibre WP 插件应运而生，巧妙地连接了这两个强大系统。它通过 OPDS（Open Publication Distribution System，开放出版发布系统）协议——一种专为电子书目录设计的开放标准——连接你的 Calibre-Web 服务器，将整个书库无缝嵌入 WordPress。访客可以浏览封面、搜索书目、在线阅读 EPUB，而你的 Calibre-Web 服务器地址始终隐藏在 WordPress 代理层之后。更进一步，插件与 TriliumAI Chat 的集成让 AI 成为了你的"书评编辑"和"阅读伴侣"——每当书库中出现新书，AI 可以自动撰写推介文章并保存到 Trilium Notes 中；而在阅读过程中，你还可以随时划选文字、向 AI 提问，对话记录自动沉淀为知识库笔记。

这不仅仅是一个书籍展示工具。它是连接 书库管理、在线阅读、AI 辅助 与 知识沉淀 的完整桥梁，为你的网站增添独特的价值，创造出 1 + 1 > 2 的协同效果。

二、核心理念与架构概述

Calibre WP 的核心理念是 「面向协议，安全代理，原生体验」——通过开放标准协议获取数据，通过 WordPress 代理层保障安全，通过原生前端渲染提供一流的用户体验。

📡 OPDS：电子书世界的"通用语言"

OPDS 是基于 Atom XML 格式的一种目录标准，专门为电子书的发布和分发而设计。你可以把它理解为"电子书世界的 RSS"——就像 RSS 让博客内容可以被任何阅读器订阅一样，OPDS 让电子书目录可以被任何兼容客户端访问。Calibre-Web 天然支持 OPDS，在 /opds 端点提供标准化的书目订阅源。

OPDS 的价值在于它是一个开放标准。无论你的书库后端是 Calibre-Web、Calibre Server 还是其他任何支持 OPDS 的系统，只要它提供符合标准的 OPDS Feed，Calibre WP 就能连接。这意味着插件不是被绑定在某一个特定产品上——它面向的是一个协议，而非一个实现。

🏗️ 7.x 架构：一次"减法式"重构

Calibre WP 在 7.0 版本经历了自诞生以来最大规模的架构重构。旧版本（≤4.x）的核心是一套 PHP 实现的 HTTP 反向代理，将 Calibre-Web 的全部界面透传到 WordPress 中。这意味着每一次翻页、每一个资源请求，都要经过 PHP 的请求转发和响应改写。当 Calibre-Web 更新内部 URL 结构时，代理层就可能出现兼容性问题；每增加一个前端功能，都需要处理跨域、CSP 等代理引入的额外限制。

7.0 版本做出了一个根本性的决策：彻底移除反向代理，将 Calibre-Web 的角色从"被代理的前端"降级为"纯数据源"。WordPress 与 Calibre-Web 之间的交互缩减为三种明确定义的数据流：

1. OPDS 元数据：通过 OPDS 协议获取书籍列表和详情（结构化 XML，易于缓存）
2. 封面图片：通过轻量级图片代理获取并本地缓存
3. EPUB 文件：直接下载完整 EPUB 文件并本地缓存

旧架构 (≤4.x)                         新架构 (≥7.0)

浏览器 ←→ WordPress(PHP代理) ←→ CW     浏览器 ←→ WordPress ←→ CW(仅OPDS)
  │                                       │
  ├─ 每次翻页 → PHP转发 → CW渲染          ├─ 首次访问 → 下载EPUB → 本地缓存
  ├─ 每个资源 → PHP改写URL → CW返回        ├─ 后续翻页 → 纯前端渲染（零服务器开销）
  ├─ 会话状态 → 文件JSON → PHP恢复         ├─ 阅读进度 → user_meta / Cookie
  └─ TTS → 跨iframe提取 → Edge TTS        └─ 书签 → user_meta + EPUB CFI

这一变化的效果是显著的：在线阅读从「每次操作都涉及服务器往返」变为「EPUB 下载后完全离线可用」，服务器负载从线性增长变为近乎恒定。

📌 三层关注点分离

重构后的插件遵循清晰的三层架构：

在核心三层之外，还有两个重要的 跨生态集成模块：AI 文章生成器（桥接书库、AI 能力与知识沉淀三个独立系统）和阅读器内 AI 助手（嵌入 Foliate.js 阅读器，连接阅读与思考）。关键设计原则是：所有集成模块都是可选的——如果未安装 TriliumAI Chat，AI 相关功能静默禁用，书库核心功能完全不受影响。

三、沉浸式在线阅读系统

Calibre WP 最引人注目的功能之一是内置的在线 EPUB 阅读器。它基于 Foliate.js——一个高质量的开源 Web 阅读引擎（与 GNOME Books 同源），支持在浏览器中直接解析和渲染 EPUB 文件，无需服务器参与翻页和资源加载。

📖 为什么选择 Foliate.js

Foliate.js 的 Shadow DOM 架构特别适合 WordPress 环境——无论主题如何复杂，阅读器内部样式都不受影响。纯客户端渲染、基于 Web Components 和原生 ES Modules、可完整打包在插件内无外部依赖，这些特性使它成为最佳选择。

🔗 优雅的 URL 路由

插件注册了 WordPress 原生的 Rewrite Rules，为阅读器创建了干净的 URL 端点：

/calibre-reader/{book_id}/

这比旧架构中的代理路径 admin-ajax.php?action=calibre_proxy&session=xxx&path=... 不仅更易于分享和记忆，更重要的是——URL 可以被收藏、分享，且不依赖任何服务器端会话状态。旧版本中整个会话状态恢复系统的复杂性由此消除。

📚 EPUB 获取与缓存

CalibreFoliateEpubHandler 负责从 Calibre-Web 获取 EPUB 文件并本地缓存，其设计考虑了不同版本和配置下的 URL 差异：

• 多路径降级策略：优先使用 OPDS 提供的路径，逐步降级到多种备用 URL 格式，确保兼容性
• EPUB 签名验证：每次下载后检查响应体的前两个字节是否为 PK（ZIP 文件魔数），区分真正的 EPUB 文件和登录重定向页面
• 缓存策略：有效的 EPUB 文件本地缓存 30 天，输出时附带完整的 HTTP 缓存头（Cache-Control、ETag）并支持 Range 请求

🔖 书签与阅读进度

插件实现了完整的基于 EPUB CFI（Canonical Fragment Identifier）的书签管理系统：

• 📌 书签功能：用户可在任意位置添加书签，记录 CFI 位置、章节标题、选中文本片段（200 字截断）、阅读百分比、用户笔记。书签按 CFI 去重，按阅读百分比排序
• 📌 阅读进度：采用双存储策略——已登录用户存储在 WordPress user_meta（跨设备同步），匿名用户回退到 Cookie 存储。下次打开同一本书时自动恢复到上次的阅读位置
• 📌 迁移方向：代码中已预留"存储迁移点"，为未来将书签从 WordPress 用户元数据迁移到 Trilium Notes 存储做准备——届时你的阅读标注将与知识库笔记融为一体

🎛️ 阅读器核心功能一览

• ✅ 左右翻页（鼠标点击或触屏滑动）和连续滚动两种阅读模式
• ✅ 自动解析 EPUB 内置目录结构，提供快速跳转
• ✅ 可调整字号、行距、页边距和字体，适应不同阅读偏好
• ✅ 自动适配明暗模式，根据系统设置智能切换
• ✅ Edge TTS 高品质语音朗读（详见下节）
• ✅ AI 阅读助手（详见 AI 功能章节）

四、智能语音朗读系统

Calibre WP 的 TTS 朗读功能并未采用浏览器内置的 Web Speech API（语音质量参差不齐、中文支持有限），而是引入了独立的 Edge TTS 插件，利用 微软 Edge 的神经网络语音合成服务 实现高品质文本转语音。

🔊 "服务端生成、客户端播放"架构

用户点击朗读 → 阅读器提取当前段落文本
      ↓
前端将文本发送到 WordPress 后端
      ↓
WordPress 调用 Edge TTS 服务的 API 端点
      ↓
Edge TTS 服务返回 MP3 音频数据
      ↓
WordPress 缓存音频文件并返回给浏览器
      ↓
浏览器播放音频，同时高亮当前朗读段落

语音合成发生在服务端，利用微软 Edge 的专业级神经网络语音模型，远比浏览器自带的合成语音自然、流畅。生成的音频会被缓存到 WordPress 本地——同一段文本不会被重复合成，大幅降低 API 调用频率。

🎙️ 丰富的语音选择

Edge TTS 提供了多种高品质的中文神经网络语音，包括温暖活泼的女声、沉稳专业的男声等。每种语音还支持多种情感风格——通用、欢快、悲伤、严肃、温柔、抒情等。语速和语调也可自由调节。

🎵 智能朗读体验

阅读器中的 TTS 模块是一个精心设计的播放系统：

• 🏷️ 段落级智能提取——自动识别 EPUB 内容中的可读段落（标题、正文、列表项、引用等），跳过导航栏和侧边栏等非内容区域。超长段落在句子边界处自动切分
• 🏷️ 视觉同步高亮——当前正在朗读的段落以醒目的高亮样式突出显示，并自动滚动到可视区域
• 🏷️ 智能预加载——播放当前段落时，后台提前加载接下来 2 个段落的音频，确保段落切换无缝流畅
• 🏷️ 跨章节连续朗读——一个章节的所有段落朗读完毕后，系统自动翻到下一章节继续朗读
• 🏷️ 点击即读——可点击页面上的任意段落，直接从该段落开始朗读
• 🏷️ 多速播放——支持 1.0x、1.25x、1.5x、2.0x、2.5x 多档语速切换，设置会被记忆
• 🏷️ 位置记忆——朗读位置会被保存，下次打开同一本书时可从上次停止处继续

🎧 为什么选择 Edge TTS 而非浏览器原生语音？浏览器的 Web Speech API 语音质量因浏览器和操作系统而异，中文语音选择非常有限，不同平台的可用语音列表不一致。而 Edge TTS 的神经网络语音在所有平台上都能提供一致的、高品质的中文朗读效果——这对中文为主的知识内容尤为重要。

五、AI 赋能：从书评生成到阅读伴侣

Calibre WP 的 AI 能力分为两个维度：自动化内容生产（文章生成器）和 交互式阅读辅助（阅读器内 AI 助手）。这些功能通过与 TriliumAI Chat 插件的集成实现，是 Calibre WP 与 Brave 基地 AI 生态最直接的交汇点。

🤖 AI 文章生成器

当检测到新书入库时，插件自动调用 AI 生成推介文章并保存到 Trilium Notes 笔记系统。

Calibre-Web 新增书籍
      ↓ 缓存刷新时检测到新书
插件比较当前书目与已处理书目列表
      ↓ 发现未处理的新书
调用 TriliumAI Chat 的 AI 接口
      ↓ 使用预设的提示词模板 + 书籍元数据
AI 生成推介文章
      ↓
保存到 Trilium Notes

三种 AI 后端可选：

提示词支持变量占位符（如 {{title}}、{{author}}），管理员可在后台自定义模板。批量生成时采用顺序处理、间隔延迟的策略避免 API 限流，前端配有进度条和实时日志输出。已处理书籍列表确保幂等性——每本书只触发一次文章生成。

📖 阅读器内 AI 助手

这是一个嵌入在 Foliate.js 阅读器中的交互式 AI 模块，将"阅读"和"思考"两个环节无缝连接：

• 🏷️ 划选文字——选中书中任意文字片段，一个悬浮的"Ask AI"按钮立即出现在选区附近
• 🏷️ 快捷操作——点击后侧面板展开，提供预设的快捷提问（如"解释这段话"、"总结要点"、"深入分析"），也可输入自定义问题
• 🏷️ AI 对话——问题连同选中文本发送给 TriliumAI Chat 处理，AI 回答以 Markdown 格式实时呈现
• 🏷️ 自动归档——每次阅读中的 AI 问答自动保存到 Trilium Notes，成为可搜索、可关联的永久记录

💡 这个功能的价值在于，它打破了"阅读"和"知识管理"之间传统上的割裂。过去，你读书时的灵感和疑问往往停留在脑海中或散落在便签里。现在，AI 即时回答你的疑问，对话记录自动沉淀到知识库——阅读行为本身就在为你的知识库"添砖加瓦"。

在 AI 功能的设计上，Calibre WP 遵循"不重复造轮子"的哲学——阅读器专注于 阅读场景的 prompt 构造（把书名、选中段落、用户问题组织成有意义的上下文），所有 AI 调用、对话管理、笔记保存都交给 TriliumAI Chat 专业处理。

六、多层智能缓存体系

插件的缓存策略是整个性能优化的核心。它构建了一个职责分明的 多级缓存体系，在速度与数据新鲜度之间取得精妙平衡。

⚡ 四级缓存架构

请求到达
  ↓
第一级：PHP 运行时内存缓存（同一次页面加载内的重复调用直接返回）
  ↓ 未命中
第二级：WordPress Transients 缓存（数据库级缓存，12小时有效期）
  ↓ 未命中
第三级：PHP 文件缓存（本地序列化数据文件，Transients 的保险层）
  ↓ 未命中
第四级：实时 OPDS API 调用（从 Calibre-Web 获取最新数据）
  ↓ 获取成功后回写所有缓存层

每一级解决不同的问题：运行时缓存 防止同一页面多个短代码重复请求；Transients 缓存 实现跨请求的数据持久化；文件缓存 确保 Transients 被对象缓存插件意外清除时不会立即触发 API 调用；实时 API 是最后的手段，全部未命中时才触发。

此外还有独立的 图片缓存（封面图片本地缓存 30 天，500MB 上限，LRU 淘汰）和 EPUB 缓存（阅读器 EPUB 文件本地缓存 30 天），确保即使拥有数百本书的大型书库也能保持飞速加载。

🔍 指纹检测：轻量级变更发现

定时缓存刷新采用 指纹检测（Fingerprint Detection） 机制：不拉取完整书目，而是只请求 OPDS Feed 的第一页，提取总书目数量和第一本书的 ID，计算 MD5 指纹。指纹变化才触发全量刷新，不变则跳过。这使得每 12 小时的自动检测从「全量拉取数百本书的元数据」降低为「一次轻量级 HTTP 请求」。

🔄 三种刷新模式

🖼️ 封面图片代理

虽然反向代理被移除了，但封面图片仍需通过 WordPress 代理——这是 7.x 中 唯一保留的"代理"功能，与旧架构的全站反向代理在复杂度上有数量级的差距。代理层集成了本地缓存和 HTTP ETag 支持，对无封面书籍提供多级回退：优先使用预设占位图，不可用时通过 GD 库动态生成包含书名首字母的占位图——确保前端界面不会出现破碎的图片占位符。

七、以用户为中心的界面设计

Calibre WP 在界面设计上遵循 「简洁、直观、响应式」 的原则，让复杂的功能变得易于理解和使用，减少用户的认知负担。

📚 灵活的书库展示

通过简单的短代码 [calibre_books]，即可在任何 WordPress 页面或文章中嵌入完整的书库展示和搜索界面。插件提供了丰富的参数选项：

🎯 举个例子：[calibre_books type="search" query="Python" show_search="false"] 可以创建一个 Python 主题书架；[calibre_books show_download="false"] 可以创建一个只展示不提供下载的预览模式。

🔍 智能搜索与分页

搜索通过 AJAX 异步执行——页面不会刷新，搜索结果动态替换当前展示内容。分页采用"中间省略"算法——当总页数较多时只显示首尾页和当前页附近的页码，中间用省略号表示。

⚡ 混合渲染策略

为保证大型书库的加载速度，短代码实现了混合渲染策略：

• 📌 首屏 10 本：PHP 服务端渲染，确保首次加载即可见
• 📌 剩余书籍：作为 JSON 写入页面，由客户端 JavaScript 使用 DocumentFragment 批量渲染（每批 10 本，通过 setTimeout 调度），避免阻塞主线程
• 📌 CSS Containment：书籍列表容器使用 contain: content，隔离重绘范围

🌓 明暗模式智能切换

插件智能适配明暗模式，能够根据用户系统设置自动切换。在暗色模式下，界面调整为适合夜间阅读的配色，减少屏幕亮度对眼睛的刺激。无论是手机上快速浏览，还是平板或电脑上细细品味，Calibre WP 都能提供完美适配的视觉体验。

📥 安全的下载代理

所有书籍文件的下载都通过 WordPress 代理层中转：Calibre-Web 的服务器地址对用户完全不可见；文件以 8KB 分块流式传输，即使大文件也不会耗尽内存；下载前 HEAD 预检验证文件大小（100MB 上限）；文件名自动提取并通过 sanitize_file_name() 防止路径遍历攻击。

八、完善的后台管理

Calibre WP 的后台管理从简单的设置页面扩展为 四个功能页面，每个页面职责明确：

缓存管理页面采用基于 CSS Grid 的响应式双列布局，按"信息关联度"原则将相关卡片并排排列。所有 AJAX 操作使用 WordPress Nonce 验证，管理操作要求 manage_options 权限。

九、安全设计

整个插件贯穿了严谨的安全实践：

• 🔐 AJAX 端点：全部使用 WordPress Nonce 验证，管理端点要求 manage_options 权限
• 🔐 EPUB 端点：使用书籍级别的 Nonce（calibre_foliate_epub_{book_id}），防止未授权访问
• 🔐 缓存目录：每个目录包含 index.php 和 .htaccess，防止直接浏览
• 🔐 外部 Cron：32 字符随机密钥保护，可随时重新生成
• 🔐 手动刷新：Transient 锁（5 分钟超时）防止并发执行
• 🔐 下载代理：HEAD 预检验证文件大小（100MB 上限），8KB 分块流式传输
• 🔐 文件名处理：sanitize_file_name() 防止路径遍历攻击

十、Brave 基地插件生态中的位置

Calibre WP 不是一个孤立的插件——它是 Brave 基地 主权个人知识基础设施 的有机组成部分。当与 Trilium 系列插件协同使用时，一个完整的知识工作流浮现出来：

你在 Calibre 中管理电子书
      ↓
Calibre WP 将书库展示在 WordPress 上
      ↓
Foliate.js 阅读器让你在浏览器中阅读
      ↓（未来：书签迁移到 Trilium Notes）
阅读中的标注和笔记沉淀到知识库
      ↓
AI 文章生成器为新书撰写推介
      ↓
推介文章保存到 Trilium Notes
      ↓
TriliumAI Chat 的上下文功能让 AI "记住"你读过什么
      ↓
形成 "阅读 → 标注 → 知识沉淀 → AI增强" 的完整循环

与其他插件的关系是"独立但可协作"的：

Calibre WP 可以完全独立运行——即使你没有安装任何 Trilium 系列插件或 Edge TTS，书库展示、搜索、在线阅读、缓存管理等核心功能都完整可用。AI 文章生成、阅读器内 AI 助手和 Edge TTS 朗读是"加分项"，体现了 Brave 基地生态的集成优势，但不是必需品。

十一、实际应用场景

Calibre WP 的灵活性使其适用于多种知识分享和阅读场景。

📚 个人阅读站点

建立一个精美的个人阅读平台，展示你的藏书、在线阅读、让 AI 为你写书评。结合 WordPress 的文章功能，你可以为每月或每季度创建阅读总结，链接到你的电子书库，形成完整的阅读记录系统。通过 Calibre WP，你的 Calibre 书库从一个私人管理工具变为一个活跃的阅读社区入口。

🎓 教育与研究资源中心

教师和教育工作者可以创建课程相关的电子书资源中心——将教材、参考书和扩展阅读材料整合在一处，学生可根据课程需要轻松查找和下载所需资源。在线阅读器让学生无需安装任何客户端软件即可开始阅读。对于研究团队，通过不同页面使用不同的搜索关键词参数创建按主题分类的书架：[calibre_books type="search" query="机器学习"]。

👥 团队与社区共享书库

通过 WordPress 的用户角色系统实现权限分层——所有访客可浏览书目，只有登录用户才能下载和在线阅读。结合会员插件（如 BuddyBoss 或 MemberPress），甚至可实现"高级会员才能访问完整书库"的模式。开启 AI 文章生成后，每本新书自动拥有一篇推介文章，形成"书库 + 书评"的完整内容生态。

🌱 数字花园的阅读层

当 Calibre WP 与 Trilium WP 协同使用时——Trilium WP 提供结构化的知识展示，Calibre WP 提供电子书库和在线阅读——你的 WordPress 站点就从单纯的博客升级为一个完整的"数字花园"。访客不仅可以探索你的知识笔记，还能浏览你的书架、在线阅读你推荐的书籍。阅读中的 AI 对话和批注又回流到 Trilium Notes 知识库，形成知识的良性循环。

十二、Calibre 生态动态

Calibre 生态本身也在快速演进。在 Brave 基地的开源软件研究小组中，社区成员已经在关注和讨论两个值得注意的新生力量：

🔧 Calibre-Web Automated（CWA）

基于 Calibre-Web 的增强版自动化电子书管理系统，定位为"一体化解决方案"。v3.1.x 版本带来了 Hardcover 集成、KOReader 同步、Calibre 插件支持等新特性，基于 SQLite 数据库，万册级别的书库仍能保持良好性能，且完整支持 Unicode/中文内容。CWA 代表的是 Calibre-Web"原地升级"的路线——在保持核心架构不变的前提下，通过自动化能力的叠加让书库管理变得更省心。

📱 Anx Calibre Manager

一个移动端优先的现代化 Web 应用，连接已有的 Calibre Content Server，提供了多角色用户系统、邀请码注册、KOReader 同步、智能 Kindle 推送、内置 WebDAV 服务器，以及一个令人瞩目的功能——与任何一本书进行 AI 对话。更值得关注的是，它内置了一个符合规范的 MCP（Model Context Protocol）服务器，允许 AI 代理或外部工具通过 API 与书库进行安全的交互。

这两个项目的出现印证了一个趋势：书库管理正在从"人操作数据"走向"AI 代理操作数据"。Calibre WP 当前的设计——通过 OPDS 协议获取数据、AI 生成书评、阅读器内 AI 助手——本质上已经在实践这个方向。

十三、未来发展与功能展望

尽管 Calibre WP 已经提供了丰富的功能，但技术和用户需求的不断演进为插件带来了广阔的发展空间。

🔮 书签迁移到 Trilium Notes

将阅读器中的书签和批注从 WordPress 用户元数据迁移到 Trilium Notes 中存储，使阅读标注与知识库笔记完全融合。届时你可以在 Trilium 中搜索"我在哪本书的哪个位置标记了关于'量子计算'的内容"，AI 也能在对话中引用你的阅读批注。

🔮 基于阅读历史的智能推荐

当 AI"知道"你读过什么（通过 Trilium Notes 中沉淀的书评和阅读笔记），它可以基于你的阅读偏好和知识图谱为你推荐下一本值得读的书。

🔮 跨书知识综合

利用 TriliumAI 的上下文能力，AI 可以跨越多本书的内容进行综合分析。比如你问"这三本关于人工智能的书在'意识'这个话题上的观点有何异同"，AI 可以综合你书库中的多本书给出比较分析。

🔮 智能章节摘要与阅读伙伴

每读完一章，AI 自动生成摘要，并关联你的阅读历史，发现书籍之间的思想联系。不只是问答，还有主动提问、观点挑战和费曼检验，真正的"共读"体验。

🔮 语音交互式阅读

将 Edge TTS 的朗读能力与 AI 助手结合——暂停朗读、语音提问、听 AI 回答、继续朗读，形成完全解放双手的智能阅读体验。

十四、开启你的电子书库之旅

Calibre WP 让创建专业电子书库变得简单而优雅。它搭建了从书库管理到在线阅读、从 AI 辅助到知识沉淀的完整桥梁。

🚀 快速上手三步走

1. 准备 Calibre-Web 服务器 — 确保你的 Calibre-Web 已启用 OPDS 功能，能够通过浏览器访问 http://你的地址/opds 并看到 XML 格式的书目数据。
2. 安装配置 Calibre WP — 像安装其他 WordPress 插件一样安装，进入 Calibre Books → OPDS Settings 填写服务地址和凭据，点击"测试连接"确认一切正常。
3. 嵌入书库展示 — 在任何页面或文章中插入 [calibre_books] 短代码，你的电子书库立即呈现。根据需要安装 TriliumAI Chat 解锁 AI 能力，安装 Edge TTS 解锁语音朗读。

🌿 在信息碎片化的今天，书籍仍然是人类知识传承最坚韧的载体。Calibre WP 以及它所在的整个 Brave 基地技术生态，用当下最先进的技术手段——开源软件、自托管、AI——来守护这个古老的内核。当你的 AI 助手可以翻阅你的整个书架，当你的阅读笔记自动融入你的知识图谱，当新书入库就有 AI 为你撰写推介——技术消隐于无形，留下的只是一个人与他的书、他的思考、他的知识之间更紧密、更自由的联结。

注意：使用本插件前，请确保你拥有分享电子书的合法权利，并遵守相关版权法律法规。Calibre WP 致力于促进知识传播，同时尊重创作者的权益。