# GuruMind Documentation

> 全能学习与知识管理工具 - 以你的方式学习，让知识自然连接

## Site Information

- **Website**: https://gurumind.kevin2li.com
- **Repository**: https://github.com/kevin2li/GuruMind
- **Language**: 简体中文 (Simplified Chinese)
- **Platform**: Flutter + Rust (Cross-platform: macOS, Windows, Linux, iOS, Android, Web)

## Product Overview

GuruMind 是一款集思维导图、PDF批注、富文本笔记于一体的全能学习与知识管理应用。通过革命性的子导图系统和节点笔记功能，打破传统笔记工具的局限，让知识结构清晰可见，让信息连接自然流畅。

### Core Features

1. **PDF-导图双向联动** - 拖拽PDF批注到思维导图，点击节点跳转到PDF对应位置，阅读和思考无缝切换
2. **节点笔记 + 双向链接** - 思维导图提供"骨架"（结构），Markdown笔记提供"血肉"（内容），wiki风格[[链接]]自动建立双向连接
3. **子导图 + 浏览器式导航** - 无限嵌套子导图，书签/前进后退/面包屑导航，每个视图独立布局和主题，彻底解决大型导图可读性问题
4. **批注笔记** - 每个PDF批注可绑定独立Markdown笔记，让标注不只是划线，更是深度思考的载体
5. **PDF复习模式** - 自动遮盖批注内容，像翻闪卡一样主动回忆，直接在原文中高效复习
6. **批量挖空制卡** - 基于Rust图像识别，自动检测高亮区域，批量生成Anki挖空卡片，节省90%制卡时间
7. **智能闪卡生成** - PDF批注和思维导图节点一键生成Anki卡片，支持挖空模式和问答模式
8. **云同步 + 多设备协作** - 支持S3、WebDAV、本地文件系统，智能冲突检测，知识库随时随地可用
9. **跨平台支持** - 基于Flutter + Rust，原生支持macOS、Windows、iOS、Android、Web，所有平台功能完全一致
10. **本地优先 + 数据掌控** - 所有核心功能离线可用，数据存储在本地Hive数据库，云同步完全可选

## Site Structure

### Main Pages

- `/` - 首页 (Homepage)
- `/pricing.html` - 定价 (Pricing)
- `/terms.html` - 用户协议 (Terms of Service)
- `/guide/getting-started.html` - 快速开始 (Getting Started)

### Documentation Sections

#### 1. 开始使用 (Getting Started)
- `/guide/philosophy.html` - 产品理念 (Product Philosophy)
- `/guide/getting-started.html` - 快速开始 (Quick Start)

#### 2. PDF模块 (PDF Module)
- `/guide/pdf-module/pdf-annotation.html` - PDF批注 (PDF Annotation)
- `/guide/pdf-module/annotation-notes.html` - 批注笔记 (Annotation Notes)
- `/guide/pdf-module/batch-cloze.html` - 批量挖空 (Batch Cloze)
- `/guide/pdf-module/review-mode.html` - 复习模式 (Review Mode)

#### 3. 导图模块 (Mind Map Module)
- `/guide/mindmap-module/basic-features.html` - 基本功能 (Basic Features)
- `/guide/mindmap-module/sub-maps.html` - 子导图 (Sub-maps)
- `/guide/mindmap-module/node-notes.html` - 节点笔记 (Node Notes)

#### 4. 功能联动 (Feature Integration)
- `/guide/linking/internal-linking.html` - 内部联动 (Internal Linking)
- `/guide/linking/external-linking.html` - 外部联动 (External Linking)

#### 5. Anki制卡 (Anki Integration)
- `/guide/anki-integration/pdf-cards.html` - PDF制卡 (PDF Cards)
- `/guide/anki-integration/mindmap-cards.html` - 导图制卡 (Mind Map Cards)

#### 6. 云同步 (Cloud Sync)
- `/guide/cloud-sync/quick-start.html` - 快速开始 (Quick Start)
- `/guide/cloud-sync/webdav-sync.html` - WebDAV同步 (WebDAV Sync)
- `/guide/cloud-sync/s3-sync.html` - S3同步 (S3 Sync)

#### 7. 其他 (Others)
- `/terms.html` - 用户协议 (Terms of Service)
- `/guide/privacy.html` - 隐私政策 (Privacy Policy)

## Key Concepts

### 子导图系统 (Sub-maps System)
革命性的思维导图扩展方案，解决传统思维导图节点过多导致的可读性问题：
- 无限嵌套的子导图结构
- 类浏览器的导航体验（书签、前进/后退、面包屑）
- 每个子导图视图独立的布局算法和主题
- 像浏览网站一样导航思维导图

### 节点笔记 (Node Notes)
混合知识架构，结合层次结构和网络连接的优势：
- 思维导图提供知识"骨架"（结构）
- 富文本笔记提供知识"血肉"（详细内容）
- 自动双向链接（wiki风格的[[链接]]）
- 超越树形结构限制，避免纯网络笔记的混乱

### 跨格式联动 (Cross-format Integration)
打破不同笔记格式之间的壁垒：
- PDF批注可直接拖入思维导图
- 思维导图节点可链接到PDF批注
- 双向导航，点击即可跳转
- 统一的文档管理和搜索

## Technical Stack

- **Frontend**: Flutter 3.0+ (Dart SDK >=3.0.0 <4.0.0)
- **Backend**: Rust (Edition 2024)
- **Bridge**: Rinf (Flutter-Rust Bridge)
- **Database**: Hive CE (NoSQL)
- **State Management**: GetX
- **UI Design**: Cupertino (iOS-style) widgets

## Target Audience

- 学生 (Students) - 教材笔记、学习导图、考试准备
- 研究人员 (Researchers) - 论文批注、文献综述、概念图谱
- 知识工作者 (Knowledge Workers) - 项目文档、头脑风暴、信息组织

## Use Cases

1. **学术研究** - 批注论文、构建概念图、撰写文献综述
2. **深度学习** - 创建知识结构、填充详细说明、通过子导图导航复杂主题
3. **教材学习** - 分解章节、链接教材高亮到概念节点、维护学习笔记
4. **项目规划** - 组织项目结构、附加详细规范、链接参考文档
5. **个人知识管理** - 构建第二大脑，层次化导图提供结构，富文本笔记提供内容

## Competitive Advantages

### vs. 传统思维导图工具 (MindNode, XMind, MindManager)
- 革命性的子导图系统解决可扩展性问题
- 节点笔记结合层次化和网络化思维
- 集成PDF批注用于研究和学习工作流

### vs. PDF批注工具 (PDF Expert, MarginNote, LiquidText)
- 内置思维导图，支持高级布局算法
- 节点笔记系统，从阅读材料构建知识结构
- 多格式统一工作空间

### vs. 笔记应用 (Notion, Obsidian, Roam Research)
- 可视化思维导图，专业布局算法
- 子导图解决文本大纲无法解决的"节点过多"问题
- 混合架构：层次结构（思维导图）+ 网络连接（双向链接）
- 专业PDF批注集成到知识工作流
- Rust后端原生性能（非Electron）

## Contact & Support

- **GitHub**: https://github.com/kevin2li/GuruMind
- **Documentation**: https://gurumind.kevin2li.com
- **License**: Open Source

## Last Updated

2025-01-02

---

# 页面索引 (Page Index)

## 首页和主要页面
- https://gurumind.kevin2li.com/ - GuruMind 首页
- https://gurumind.kevin2li.com/pricing.html - 定价方案
- https://gurumind.kevin2li.com/terms.html - 用户协议

## 指南文档
- https://gurumind.kevin2li.com/guide/philosophy.html - 产品理念
- https://gurumind.kevin2li.com/guide/getting-started.html - 快速开始
- https://gurumind.kevin2li.com/guide/pdf-module/pdf-annotation.html - PDF批注
- https://gurumind.kevin2li.com/guide/pdf-module/annotation-notes.html - 批注笔记
- https://gurumind.kevin2li.com/guide/pdf-module/batch-cloze.html - 批量挖空
- https://gurumind.kevin2li.com/guide/pdf-module/review-mode.html - 复习模式
- https://gurumind.kevin2li.com/guide/mindmap-module/basic-features.html - 思维导图基本功能
- https://gurumind.kevin2li.com/guide/mindmap-module/sub-maps.html - 子导图
- https://gurumind.kevin2li.com/guide/mindmap-module/node-notes.html - 节点笔记
- https://gurumind.kevin2li.com/guide/linking/internal-linking.html - 内部联动
- https://gurumind.kevin2li.com/guide/linking/external-linking.html - 外部联动
- https://gurumind.kevin2li.com/guide/anki-integration/pdf-cards.html - PDF制卡
- https://gurumind.kevin2li.com/guide/anki-integration/mindmap-cards.html - 导图制卡
- https://gurumind.kevin2li.com/guide/cloud-sync/quick-start.html - 云同步快速开始
- https://gurumind.kevin2li.com/guide/cloud-sync/webdav-sync.html - WebDAV同步
- https://gurumind.kevin2li.com/guide/cloud-sync/s3-sync.html - S3同步
- https://gurumind.kevin2li.com/guide/privacy.html - 隐私政策