InsightMap AI - 生成式知识图谱智能体

InsightMap AI 是一个基于 Google Gemini 2.5 Flash 模型的生成式学习 Agent。

与传统的线性聊天机器人（Chatbot）不同，InsightMap 是一个**“知识导航员”。它不只是回答问题，而是将复杂的概念、冗长的文章或上传的文档，瞬间转化为结构化的交互式知识图谱**。它利用 LLM 的推理与规划能力，帮助用户从宏观视角掌握知识骨架，再通过微观交互进行深度学习。

---

✨ 核心功能 (Core Features)

1. 🧠 生成式知识结构 (Generative Knowledge Structure)

• 从混沌到有序：输入任何关键词（如“量子物理”、“深度学习”），Agent 会自动规划知识边界，生成包含层级关系的 JSON 数据，并渲染为可视化的思维导图。
• SVG 交互画布：基于 D3 算法定制的 Tidy Tree 布局，支持无限缩放、拖拽。
• 赛博朋克美学：采用霓虹光效、动态数据流线和玻璃拟态（Glassmorphism）设计，提供沉浸式的未来感交互体验。

2. 📂 多模态文档分析 (Multimodal Document Analysis)

• 文件即读：支持上传 PDF, TXT, MD, CSV, JSON 甚至图片。
• 长文理解：不再受限于简短的 Prompt。你可以上传整篇论文或粘贴万字长文，Gemini 2.5 Flash 会利用其长上下文窗口（Context Window）提取核心论点，生成对应的逻辑图谱。
• URL 意图识别：识别并解析输入链接（需配合 AI 知识库），概括网页结构。

3. 💬 上下文感知导读 (Context-Aware Tutoring)

• 节点级对话：点击图谱中的任意节点（例如“正则化”），侧边栏的 Agent 会根据父节点上下文（即“机器学习”下的正则化）进行精准解释。
• 聚焦模式：右侧聊天面板会锁定当前选中的节点，提供针对性的深度解析，避免通用泛泛的回答。

4. 🌐 语言自动镜像 (Auto-Language Mirroring)

• 自适应输出：无需手动设置语言。如果你上传的是中文 PDF，图谱和对话自动为中文；如果是英文 Paper，则全英文输出。Agent 自动跟随源内容的语言习惯。

---

🛠 技术架构 (Tech Stack)

本项目采用 纯前端架构 (Client-Side Only)，轻量且易于扩展。

• 核心模型: Google Gemini 2.5 Flash (通过 @google/genai SDK 调用)。
  • 利用 System Instructions 和 Response Schema 强制模型输出严格的 JSON 格式以驱动图谱渲染。
• 前端框架: React 18 + TypeScript。
• 样式与动画: Tailwind CSS + 原生 CSS Keyframes (实现霓虹呼吸灯与流光效果)。
• 图标库: Lucide React。
• 构建工具: Vite。

---

🚀 使用指南 (User Guide)

1. 关键词模式: 在输入框输入感兴趣的主题（如 "World War II"），回车生成百科式图谱。
2. 文档模式: 点击回形针 📎 图标上传文件（最大 10MB），Agent 将分析文件内容并结构化。
3. 文本模式: 直接粘贴大段文字或笔记，Agent 会为你进行归纳总结。
4. 探索:
   • 滚轮缩放画布，拖拽移动视角。
   • 点击节点，右侧面板将弹出 AI 的详细讲解。

---

5. 部署指南 (Deployment)

本项目完全免费支持部署到 Vercel。

⚠️ 关于 API Key 的说明

• 在 AI Studio / 预览模式下: 系统自动注入 Key，您可以直接使用。
• 在 Vercel / 本地环境部署后: 您必须手动申请并配置 Google Gemini API Key。

方式一：Vercel 一键部署

1. Fork 本仓库到您的 GitHub。
2. 登录 Vercel Dashboard，点击 "Add New Project"。
3. 导入该仓库。
4. 在 Environment Variables 中添加：
   • Key: VITE_API_KEY
   • Value: 您的_Gemini_API_Key (从 Google AI Studio 获取)
5. 点击 Deploy。

方式二：本地运行

# 1. 克隆项目
git clone [your-repo-url]

# 2. 安装依赖
npm install

# 3. 创建环境变量文件
# 在根目录创建 .env 文件，填入：
VITE_API_KEY=your_api_key_here

# 4. 启动
npm run dev

---

🔮 未来规划 (Roadmap)

• Web Search Grounding: 引入 Google Search Tool，让图谱内容包含最新的互联网信息。
• 多节点路径分析: 选中两个节点，AI 分析它们之间的逻辑联系。
• 图谱导出: 支持导出为图片或 XMind 格式。
• 本地记忆: 保存用户的历史图谱记录。