# mind-tools

**Repository Path**: jichenstudy/mind-tools

## Basic Information

- **Project Name**: mind-tools
- **Description**: Mind Tools 是一个帮助日常任务的简单工具集合，主要设计用于帮助神经多样性人群完成他们感到不知所措或困难的任务。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-12-18
- **Last Updated**: 2025-12-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Mind Tools

> Mind Tools 是一个帮助日常任务的简单工具集合，主要设计用于帮助神经多样性人群完成他们感到不知所措或困难的任务。我们相信每个人都应该拥有能够使日常生活更加轻松的有用工具。

## 🛠️ 功能特性

| 名称 | 描述 |
|----------|------|
| 神奇待办 | 自动将复杂任务分解成可执行的步骤，支持多层级细化和时间估算 |
| 语气转换器 | 将文本转换成不同风格（专业、口语、简洁等），支持15+种预设风格 |
| 情绪判断 | 分析文本的情感内容并提供建议，帮助理解他人情绪 |
| 解释大师 | 用简单方式解释复杂概念，适应不同理解水平 |
| 决策助手 | 分析决策的利弊并提供建议，列出需要考虑的因素 |
| 时间估算 | 预估活动所需时间，提供时间范围和影响因素 |
| 灵感风暴 | 将脑海中的想法转化为行动清单，支持一键导出到神奇待办 |
| 厨师 | 根据现有食材推荐食谱，考虑饮食限制和可用设备 |
| 智能回复助手 | 分析消息意图和情绪，生成合适的回复选项和沟通策略 |

## 📸 项目截图

### 首页
![首页](./assets/首页.png)

### 神奇待办
![神奇待办](./assets/神奇待办.png)

### 情绪判断
![情绪判断](./assets/情绪判断.png)

### 智能回复助手
![智能回复1](./assets/智能回复1.png)
![智能回复2](./assets/智能回复2.png)

## 🏗️ 技术架构

### 后端
- **框架**: Node.js + Express.js
- **语言**: TypeScript
- **AI服务**: 支持 OpenAI、Claude、通义千问、DeepSeek、智谱AI等多个AI服务商

### 前端
- **框架**: React 18 + TypeScript
- **路由**: React Router
- **UI**: 自定义样式，响应式设计

## 📁 项目结构

```
mind-tools/
├── frontend/              # 前端项目
│   ├── src/
│   │   ├── components/    # 组件
│   │   ├── pages/         # 页面
│   │   ├── services/      # API 服务
│   │   └── styles/        # 样式
│   ├── public/            # 静态资源
│   ├── package.json
│   └── tsconfig.json
│
├── backend/               # 后端项目
│   ├── src/
│   │   ├── config/        # 配置文件
│   │   ├── middleware/    # 中间件
│   │   ├── routes/        # API 路由
│   │   ├── services/      # 服务层
│   │   └── server.ts      # 入口文件
│   ├── package.json
│   └── tsconfig.json
│
└── README.md             # 本文件
```

## 🚀 快速开始

### 环境要求
- Node.js 18+
- npm 或 yarn

### 1. 克隆项目
```bash
git clone https://gitee.com/jichenstudy/mind-tools.git
cd mind-tools
```

### 2. 安装依赖

后端：
```bash
cd backend
npm install
```

前端：
```bash
cd ../frontend
npm install
```

### 3. 配置环境变量

复制后端环境变量模板：
```bash
cd ../backend
cp .env.example .env
```

编辑 `.env` 文件，配置你的AI服务密钥：
```env
# OpenAI
OPENAI_API_KEY=your_openai_api_key_here
OPENAI_MODEL=gpt-3.5-turbo

# Anthropic Claude
ANTHROPIC_API_KEY=your_anthropic_api_key_here
ANTHROPIC_MODEL=claude-3-haiku-20240307

# 阿里云通义千问
QWEN_API_KEY=your_qwen_api_key_here
QWEN_MODEL=qwen-turbo

# DeepSeek
DEEPSEEK_API_KEY=your_deepseek_api_key_here
DEEPSEEK_MODEL=deepseek-chat

# 智谱AI (GLM-4)
ZHIPU_API_KEY=your_zhipu_api_key_here
ZHIPU_MODEL=glm-4

# 默认AI提供商 (openai | anthropic | qwen | deepseek | zhipu)
DEFAULT_AI_PROVIDER=deepseek
AI_PROVIDER=deepseek
```

### 4. 启动开发服务器

启动后端服务器（端口3001）：
```bash
cd backend
npm run dev
```

启动前端服务器（端口3000）：
```bash
cd ../frontend
npm start
```

访问 http://localhost:3000 查看应用。

## ⚙️ 配置说明

### 后端 (.env)

```bash
# 服务端口
PORT=3001

# AI 提供商选择 (deepseek/openai/claude/custom)
CURRENT_AI_PROVIDER=deepseek

# DeepSeek 配置
DEEPSEEK_API_KEY=your_deepseek_api_key_here
DEEPSEEK_BASE_URL=https://api.deepseek.com/v1
DEEPSEEK_MODEL=deepseek-chat

# OpenAI 配置 (可选)
OPENAI_API_KEY=your_openai_api_key_here
OPENAI_BASE_URL=https://api.openai.com/v1
OPENAI_MODEL=gpt-4o-mini

# Claude 配置 (可选)
CLAUDE_API_KEY=your_claude_api_key_here
CLAUDE_BASE_URL=https://api.anthropic.com/v1
CLAUDE_MODEL=claude-3-5-sonnet-20241022

# 自定义模型配置 (可选)
CUSTOM_API_KEY=
CUSTOM_BASE_URL=
CUSTOM_MODEL=

# CORS 设置
ALLOWED_ORIGINS=http://localhost:5173,http://localhost:3000

# 日志级别
LOG_LEVEL=info
```

### 前端 (.env)

```bash
# API 地址
REACT_APP_API_URL=http://localhost:3001
```

## 🔧 开发指南

### 添加新工具

1. 在 `backend/src/services/` 创建新的服务文件
2. 在 `backend/src/routes/` 创建新的路由文件
3. 在 `frontend/src/pages/` 创建新页面组件
4. 在 `frontend/src/App.tsx` 中注册新路由

## 🤝 贡献

欢迎提交 Issue 和 Pull Request！