# topic-mindmap-agent

**Repository Path**: KingSea168/topic-mindmap-agent

## Basic Information

- **Project Name**: topic-mindmap-agent
- **Description**: AI主题脑图生成器 - 含一键展开/收缩功能

- Spring Boot 3.3.6 + Spring AI Alibaba (DashScope/Qwen)
- 自定义SVG脑图渲染器，支持节点级展开/收缩
- 新增全局一键展开、一键收缩功能
- 支持PNG导出、Mermaid源码复制
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-30
- **Last Updated**: 2026-06-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README




基于对项目代码结构的分析，我来为您创建一份全面的README文档。

---

# Topic MindMap Agent

智能思维导图生成器 - 基于AI的思维导图自动生成工具

## 项目简介

**Topic MindMap Agent** 是一个智能化的思维导图生成系统，利用人工智能技术帮助用户快速生成结构化的思维导图。该项目采用 Spring Boot 框架构建后端服务，结合阿里巴巴的 DashScope AI 模型（通义千问），能够将任意主题自动扩展为清晰的思维导图，并支持以 Mermaid 语法可视化展示。

## 技术栈

| 层级 | 技术选型 |
|------|----------|
| 后端框架 | Spring Boot 3.x |
| AI 服务 | Spring AI + 阿里云 DashScope (通义千问) |
| 前端 | HTML5 + CSS3 + Vanilla JavaScript |
| 可视化 | Mermaid.js |
| 构建工具 | Maven |

## 效果展示

### 人工智能

![人工智能脑图](docs/mindmap-ai.svg)

### Spring Boot 开发

![Spring Boot 开发脑图](docs/mindmap-springboot.svg)

### 项目管理方法论

![项目管理方法论脑图](docs/mindmap-project-management.svg)

## 核心功能

### ✨ 主要特性

- **AI 智能生成**: 利用大语言模型理解主题，自动构建思维导图结构
- **多层级深度**: 支持自定义思维导图的展开深度（1-5层）
- **多语言支持**: 输出支持中文、英文等多种语言的思维导图摘要
- **实时预览**: 前端实时渲染 Mermaid 图形，支持展开/折叠节点
- **便捷导出**: 支持复制 Mermaid 源码，一键保存为图片
- **RESTful API**: 提供完整的 HTTP 接口，便于二次开发集成

### 📡 API 接口

| 接口 | 方法 | 说明 |
|------|------|------|
| `/api/mindmap/generate` | POST | 根据请求参数生成思维导图 |
| `/api/mindmap/quick` | GET | 快速生成指定主题的思维导图 |
| `/api/mindmap/health` | GET | 健康检查接口 |

### 请求示例

```bash
# 快速生成
curl "http://localhost:8080/api/mindmap/quick?topic=Python&depth=3"

# 完整请求
curl -X POST http://localhost:8080/api/mindmap/generate \
  -H "Content-Type: application/json" \
  -d '{
    "topic": "机器学习",
    "depth": 3,
    "language": "zh-CN"
  }'
```

## 环境配置

### 前置要求

- JDK 17 或更高版本
- Maven 3.8+
- 阿里云 DashScope API Key

### 配置步骤

1. **克隆项目**
   ```bash
   git clone https://gitee.com/KingSea168/topic-mindmap-agent.git
   cd topic-mindmap-agent
   ```

2. **配置 API Key**

   在 `src/main/resources/application.yml` 中配置您的阿里云 API 凭证：

   ```yaml
   spring:
     ai:
       dashscope:
         api-key: ${DASHSCOPE_API_KEY:your-api-key-here}
   ```

   或者通过环境变量设置：
   ```bash
   export DASHSCOPE_API_KEY=your-api-key-here
   ```

3. **编译运行**
   ```bash
   mvn clean install
   mvn spring-boot:run
   ```

4. **访问应用**

   启动成功后，打开浏览器访问：`http://localhost:8080`

## 使用指南

### Web 界面使用

1. 在输入框中输入您想了解的主题（如"Java编程"、"人工智能"等）
2. 选择思维导图展开深度（层次越多，内容越详细）
3. 点击「生成思维导图」按钮
4. 等待 AI 处理完成后查看结果
5. 可以使用工具栏进行展开/折叠、复制源码、保存图片等操作

### 示例主题

系统提供了一些示例主题供参考：
- Python 基础
- 人工智能
- 数据结构
- 软件架构

## 项目结构

```
topic-mindmap-agent/
├── src/main/java/com/example/mindmap/
│   ├── MindmapApplication.java      # Spring Boot 启动类
│   ├── config/
│   │   └── AiConfig.java           # AI 配置 Bean
│   ├── controller/
│   │   └── MindmapController.java   # REST API 控制器
│   ├── model/
│   │   ├── MindmapRequest.java      # 请求模型
│   │   └── MindmapResponse.java   # 响应模型
│   └── service/
│       └── MindmapService.java     # 业务逻辑服务
├── src/main/resources/
│   ├── application.yml              # 应用配置文件
│   └── static/
│       ├── index.html             # 前端页面
│       ├── app.js                # 前端脚本
│       └── style.css             # 样式文件
└── pom.xml                       # Maven 配置
```

## 注意事项

- 请确保网络畅通，以便成功调用 AI 服务
- 首次生成可能需要较长时间加载，请耐心等待
- 建议合理设置 depth 参数，过大的深度可能导致响应缓慢

## 开源协议

本项目仅供学习交流使用，請遵守相关开源许可协议。

---

如有问题或建议，欢迎提交 Issue 或 Pull Request。