厚书读薄，真知易懂
[中文](README.md) | English  一款由 AI 技术驱动的智能电子书解析工具，可将 EPUB 和 PDF 格式的电子书转换为结构化思维导图与文本摘要。 官方网站：https://app.mind-elixir.com/en/ebook-to-mindmap 立即体验：https://ebook2me-next.mind-elixir.com/ 使用旧版：https://ebook2me.mind-elixir.com/ ## 💡 与 NotebookLM 的对比 如果你使用过 Google NotebookLM，可能会注意到它在处理电子书时存在一些局限。本工具旨在解决这些痛点，提供更专业、更灵活的电子书阅读与思维导图体验： | Feature | This Tool (ebook-to-mindmap) | Google NotebookLM | | :---------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **思维导图导出与编辑** | 🛠️ **可导出编辑**：虽然在线界面为只读，但你可以**将思维导图导出为数据文件**，并导入 Mind Elixir 桌面客户端或其他编辑器，进行完整编辑与修改。 | ❌ **无法导出或编辑**：思维导图仅供只读查看，无法导出，也不支持任何后续编辑。 | | **提示词灵活性** | 🎯 **完全自定义**：支持自定义提示词，并提供「仅使用自定义提示词」（Use Custom Prompt Only）模式，可完全覆盖系统提示词。AI 会充分尊重你的指令。 | 🚫 **系统提示词过于强势**：主要面向检索与摘要（RAG）优化。其内置系统提示词占主导地位，难以完全遵循你的自定义指令。 | ## ✨ 功能特性 ### 📚 多格式支持 - **EPUB 文件**：完整支持 EPUB 格式电子书的解析与处理 - **PDF 文件**：智能解析 PDF 文档，支持基于目录与智能章节提取 ### 🤖 AI 驱动的内容处理 - **多种 AI 服务**：支持 Google Gemini 与 OpenAI GPT 模型 - **双配置模式**：支持自行配置 API Key（BYOK 模式），或登录 Mind Elixir 账号使用内置模型（免 Key 选项） - **BYOK 模式**：使用你自己的 API Key（Bring Your Own Key），所有 AI 请求均由浏览器直接发送至 AI 服务商，确保数据安全与隐私 - **免 Key 选项**：直接使用 Mind Elixir 账号登录，使用内置托管模型（消耗星星算力/Star Power）。开箱即用，无需配置 API Key - **三种处理模式**： - 📝 **文本摘要模式**：生成章节摘要，分析章节关系，输出完整书籍摘要 - 🧠 **章节思维导图模式**：为每个章节生成独立的思维导图 - 🌐 **全书思维导图模式**：将整本书内容整合为一张综合思维导图 ### 💾 高效缓存机制 - **智能缓存**：自动缓存 AI 处理结果，处理中断后可从上次位置继续 - **缓存管理**：支持按模式清理缓存，节省存储空间 - **离线查看**：已处理内容可离线查看 ### 🎨 现代化界面 - **响应式设计**：适配多种屏幕尺寸 - **实时进度**：可视化处理流程，实时显示步骤 - **交互式思维导图**：支持缩放、拖拽、节点展开/折叠 - **内容预览**：支持查看原始章节内容 ## 📖 使用指南 ### 1. 配置 AI 服务 首次使用需配置 AI 服务，支持以下两种方式： #### 方式一：BYOK 模式（Bring Your Own Key） > **🔒 隐私保护说明**：本工具支持使用你自己的 API Key（Bring Your Own Key）。所有 AI 请求均由浏览器直接发送至 AI 服务商（Google 或 OpenAI），不经过任何第三方代理或中间服务器，确保数据安全与隐私。 1. 点击「Configure」按钮 2. 选择 AI 服务提供商，建议试用 **Google Gemini** 3. 输入对应的 API Key 4. 填写模型 ##### 获取 API Key 以 **Google Gemini** 为例： 1. 访问 [Google AI Studio](https://aistudio.google.com/) 2. 使用 Google 账号登录 3. 创建新的 API Key 4. 将 API Key 复制到配置中 有关 AI 服务商选项的更多信息，请参阅：[免费与付费 AI API 选型指南](https://ssshooter.com/en/ai-services-guide/) #### 方式二：免 Key 选项（星星算力 / Star Power）🌟 推荐 如果你没有自己的 AI 服务商 API Key，或希望跳过复杂配置，可以登录 Mind Elixir 账号使用**内置托管模型（星星算力）**： - ⚡ **开箱即用**：无需配置 API Key，登录即可使用。 - 🪙 **按量计费**：从你的星星算力余额中扣除。 - 🔄 **跨应用共享**：星星算力余额在整个 Mind Elixir 应用生态中共享（例如，在 [M10C 浏览器扩展](https://github.com/SSShooter/M10C-Video-Summary)). 中同样共享） - ⏳ **永不过期**：购买或获得的星星算力余额永久有效，无时间限制。 _如需充值或管理星星算力，请访问 [Mind Elixir 官网](https://app.mind-elixir.com/recharge)._ [](https://app.mind-elixir.com/) ### 2. 上传电子书文件 1. 点击「Select EPUB or PDF File」按钮 2. 选择要处理的电子书文件 3. 支持格式：`.epub`、`.pdf` 你可以从 [Project Gutenberg](https://www.gutenberg.org/) 和 [Standard Ebooks](https://standardebooks.org/). 等网站获取免费电子书 ### 3. 配置处理选项 在配置对话框中设置处理参数： #### 处理模式 - **文本摘要模式**：适用于需要文本摘要的场景 - **章节思维导图模式**：为每个章节生成独立的思维导图 - **全书思维导图模式**：为整本书生成统一的思维导图（若书籍内容过长，可能因模型上下文不足而失败） #### 书籍类型 - **小说（Fiction）**：适用于小说、故事类书籍 - **非虚构（Non-fiction）**：适用于教材、参考书、技术书籍等 #### 高级选项 - **智能章节检测**：启用后，使用 AI 智能识别章节边界 - **跳过无关章节**：自动跳过前言、目录、致谢等 - **子章节深度**：设置提取子章节的层级深度（0-3） ### 4. 提取章节 1. 点击「Extract Chapters」按钮 2. 系统将自动解析文件并提取章节结构 3. 提取完成后，将显示章节列表 4. 你可以选择要处理的章节 #### 章节分组（可选） 对于内容较为丰富的书籍，你可以将多个小章节合并为一个分组进行处理，从而获得更有结构的结果。通过分组，AI 会一并分析这些章节的内容。 1. **选择章节**：点击章节列表项（不要点击复选框区域）进行选择。支持多选。已选中的章节会显示高亮边框。 2. **添加标签**： - 点击列表顶部的「Add Tag」按钮 - 或使用快捷键 `Ctrl + G` 3. **输入分组名称**：在弹出的对话框中输入分组名称（例如「Part 1」「Chapter 1」等）。确认后，所选章节将被标记为同一分组。 4. **移除分组**：点击章节列表中已有标签后的「X」图标，即可移除该章节的分组。 ### 4.5. 自定义提示词（高级） 你可以在「Custom Prompts」页面管理专属提示词，并在处理书籍时使用它们，以获得更符合需求的结果。 1. **管理提示词**： - 点击导航栏中的「Custom Prompts」进入管理页面 - 点击「Add Prompt」创建新的提示词模板 - 填写名称、描述和具体的提示词内容 - 支持编辑、复制和删除已有提示词 2. **使用提示词**： - 在提取章节后的配置界面底部，找到「Custom Prompts」选项 - 从下拉菜单中选择你预先创建的提示词 - **仅使用自定义提示词（Use Custom Prompt Only）**：勾选后，你的提示词将完全替换系统默认提示词（此选项仅适用于 **Text Summary Mode（文本摘要模式）**）。若未勾选，你的提示词将作为补充说明发送给 AI。 ### 5. 开始处理 1. 确认所选章节 2. 点击「Start Processing」按钮 3. 系统将显示处理进度和当前步骤 4. 完成后将展示结果 ### 6. 查看结果 根据所选的处理模式，你可以查看不同类型的结果： #### Text Summary Mode（文本摘要模式） - **Chapter Summaries（章节摘要）**：各章节的详细摘要 - **Chapter Relationships（章节关系）**：章节之间逻辑关系的分析 - **Book Summary（全书摘要）**：整本书核心内容的摘要 #### Mind Map Mode（思维导图模式） - **Interactive Mind Maps（交互式思维导图）**：可缩放、可拖拽的思维导图 - **Node Details（节点详情）**：点击节点查看详细内容 - **Export Function（导出功能）**：支持导出为图片或其他格式 ## 🛠️ 技术架构 ### 核心技术栈 - **Frontend Framework（前端框架）**：React 19 + TypeScript - **Build Tool（构建工具）**：Vite - **Styling（样式）**：Tailwind CSS + shadcn/ui - **State Management（状态管理）**：Zustand - **File Parsing（文件解析）**： - EPUB: @smoores/epub + epubjs - PDF: pdfjs-dist - **Mind Maps（思维导图）**：mind-elixir - **AI Services（AI 服务）**： - Google Gemini: @google/generative-ai - OpenAI: Custom implementation ## 📄 许可证 本项目采用 MIT License 许可。详情请参阅 [LICENSE](LICENSE) 文件。 ## 🙏 致谢 感谢以下开源项目： - [React](https://reactjs.org/) - [Vite](https://vitejs.dev/) - [Tailwind CSS](https://tailwindcss.com/) - [shadcn/ui](https://ui.shadcn.com/) - [mind-elixir](https://github.com/ssshooter/mind-elixir-core) - [PDF.js](https://mozilla.github.io/pdf.js/) - [epub.js](https://github.com/futurepress/epub.js/) --- 如有问题或建议，请提交 Issue 或联系开发者（微信👇）