项目文件夹
wehub-resource-syncNote
本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。
English · 原始项目 · 上游 README
原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。
E-book to Mind Map
厚书读薄，真知易懂
中文 | 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），不经过任何第三方代理或中间服务器，确保数据安全与隐私。
- 点击「Configure」按钮
- 选择 AI 服务提供商，建议试用 Google Gemini
- 输入对应的 API Key
- 填写模型
获取 API Key
以 Google Gemini 为例：
- 访问 Google AI Studio
- 使用 Google 账号登录
- 创建新的 API Key
- 将 API Key 复制到配置中
有关 AI 服务商选项的更多信息，请参阅：免费与付费 AI API 选型指南
方式二：免 Key 选项（星星算力 / Star Power）🌟 推荐
如果你没有自己的 AI 服务商 API Key，或希望跳过复杂配置，可以登录 Mind Elixir 账号使用内置托管模型（星星算力）：
- ⚡ 开箱即用：无需配置 API Key，登录即可使用。
- 🪙 按量计费：从你的星星算力余额中扣除。
- 🔄 跨应用共享：星星算力余额在整个 Mind Elixir 应用生态中共享（例如，在 M10C 浏览器扩展). 中同样共享）
- ⏳ 永不过期：购买或获得的星星算力余额永久有效，无时间限制。
如需充值或管理星星算力，请访问 Mind Elixir 官网.
2. 上传电子书文件
- 点击「Select EPUB or PDF File」按钮
- 选择要处理的电子书文件
- 支持格式：
.epub、.pdf
你可以从 Project Gutenberg 和 Standard Ebooks. 等网站获取免费电子书
3. 配置处理选项
在配置对话框中设置处理参数：
处理模式
- 文本摘要模式：适用于需要文本摘要的场景
- 章节思维导图模式：为每个章节生成独立的思维导图
- 全书思维导图模式：为整本书生成统一的思维导图（若书籍内容过长，可能因模型上下文不足而失败）
书籍类型
- 小说（Fiction）：适用于小说、故事类书籍
- 非虚构（Non-fiction）：适用于教材、参考书、技术书籍等
高级选项
- 智能章节检测：启用后，使用 AI 智能识别章节边界
- 跳过无关章节：自动跳过前言、目录、致谢等
- 子章节深度：设置提取子章节的层级深度（0-3）
4. 提取章节
- 点击「Extract Chapters」按钮
- 系统将自动解析文件并提取章节结构
- 提取完成后，将显示章节列表
- 你可以选择要处理的章节
章节分组（可选）
对于内容较为丰富的书籍，你可以将多个小章节合并为一个分组进行处理，从而获得更有结构的结果。通过分组，AI 会一并分析这些章节的内容。
- 选择章节：点击章节列表项（不要点击复选框区域）进行选择。支持多选。已选中的章节会显示高亮边框。
- 添加标签：
- 点击列表顶部的「Add Tag」按钮
- 或使用快捷键
Ctrl + G
- 输入分组名称：在弹出的对话框中输入分组名称（例如「Part 1」「Chapter 1」等）。确认后，所选章节将被标记为同一分组。
- 移除分组：点击章节列表中已有标签后的「X」图标，即可移除该章节的分组。
4.5. 自定义提示词（高级）
你可以在「Custom Prompts」页面管理专属提示词，并在处理书籍时使用它们，以获得更符合需求的结果。
-
管理提示词：
- 点击导航栏中的「Custom Prompts」进入管理页面
- 点击「Add Prompt」创建新的提示词模板
- 填写名称、描述和具体的提示词内容
- 支持编辑、复制和删除已有提示词
-
使用提示词：
- 在提取章节后的配置界面底部，找到「Custom Prompts」选项
- 从下拉菜单中选择你预先创建的提示词
- 仅使用自定义提示词（Use Custom Prompt Only）：勾选后，你的提示词将完全替换系统默认提示词（此选项仅适用于 Text Summary Mode（文本摘要模式））。若未勾选，你的提示词将作为补充说明发送给 AI。
5. 开始处理
- 确认所选章节
- 点击「Start Processing」按钮
- 系统将显示处理进度和当前步骤
- 完成后将展示结果
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 文件。
🙏 致谢
感谢以下开源项目：
如有问题或建议，请提交 Issue 或联系开发者（微信👇）
