技术文档（docs）

• 后端文档
• API 文档
• 前端概览
• 前端页面与结构、前端状态、前端工作区
• SSE 技术文档、Streaming JSON Parser
• 交互与多代理架构、交互时序图、multiagent 架构
• UI 设计与组件、前端视觉实现

项目结构

thinking-map/
├── server/          # 后端服务 (Go)
├── web/             # 前端应用 (Next.js)
├── docs/            # 项目文档与博客
├── docker/          # Docker 与 Compose 配置
└── logs/            # 日志文件

开发指南

方式一：Docker 启动（推荐）

1. 准备环境变量（在 docker/ 目录下）：

cd docker
cp .env.example .env
# 编辑 .env，填入你的 AI 服务密钥（如 OPENAI/DeepSeek/Claude）和 tavily API 密钥

2. 构建并启动所有服务：

docker-compose up -d --build
# 查看状态与日志
docker-compose ps
docker-compose logs -f

3. 访问应用：

• 前端：http://localhost:3030
• 后端 API：http://localhost:8080
• PostgreSQL：localhost:5432
• Redis：localhost:6379

4. 常用命令：

# 启动 / 停止
docker-compose up -d
docker-compose down

# 重新构建
docker-compose up -d --build

# 查看日志/进入容器
docker-compose logs -f [service_name]
docker-compose exec [service_name] sh

# 清理数据卷（会删除所有数据）
docker-compose down -v

5. 开发模式（本地跑前后端，使用容器中的 DB/Redis）：

cd docker
docker-compose up -d postgres redis

# 后端本地启动
cd ../server
go mod download
go run cmd/server/main.go

# 前端本地启动
cd ../web
pnpm install
pnpm run dev

方式二：源码启动（本地环境）

后端（server）

cd server
go mod download

# 编辑 configs/config.local.yaml，设置 PostgreSQL 与 Redis 连接信息

# 启动服务
go run cmd/server/main.go

前端（web）

cd web
pnpm install
pnpm run dev

提示：若本地未安装数据库与缓存，可按上文先启动 docker-compose up -d postgres redis，然后本地运行前后端。

环境要求

• Go 1.24+
• Node.js 18+
• PostgreSQL 14+
• Redis 7+
• pnpm

许可证

Apache-2.0 license