Skip to content

PGshen/thinking-map

Repository files navigation

Thinking Map

简体中文 | English

一个基于思维导图的智能思考辅助系统,用结构化可视化与 AI 代理协作,帮助你更清晰地梳理问题、探索方案与记录知识。

项目介绍

  • 产品定义:ThinkingMap 是一款交互式 AI 问题解决可视化助手,将 AI 的思考和问题解决过程转化为可视化的图结构,允许用户在过程中随时干预、提问。
  • 产品愿景:使 AI 辅助问题解决过程变得透明、可控且结构化,让用户真正参与到思考过程中,而不仅仅是得到最终答案。
  • 目标用户:研究人员和学者、学生和教育工作者、内容创作者和写作者、分析师和决策者、产品和项目管理人员。
  • 用户痛点:答案过程不透明、难以理解和信任;多步骤思路难以清晰展示;过程难以随时干预与调整;缺乏结构化拆解与可视化。
  • 核心价值:透明化思考、用户控制、结构化思维、探索性思考。

首页 工作区 工作区

技术栈

Frontend

  • 框架:Next.js 15(App Router)
  • 语言:TypeScript
  • UI:shadcn/ui + Radix UI
  • 状态管理:Zustand
  • 可视化:ReactFlow
  • 样式:Tailwind CSS
  • 包管理:pnpm
  • 图标:Lucide React

Backend

  • 语言/框架:Go 1.24+,Gin,eino
  • ORM/数据库:GORM + PostgreSQL 14+
  • 缓存:Redis 7+
  • 认证:JWT
  • 日志:Zap
  • 配置:Viper

博客与文档

博客(docs/blog)

技术文档(docs)

项目结构

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 密钥
  1. 构建并启动所有服务:
docker-compose up -d --build # 查看状态与日志 docker-compose ps docker-compose logs -f
  1. 访问应用:
  1. 常用命令:
# 启动 / 停止 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
  1. 开发模式(本地跑前后端,使用容器中的 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

About

一个基于思维导图的智能思考辅助系统

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages