# 见素 - AI 起名应用

一个专注于"留白"与"故事化"体验的 AI 起名应用，融合古典诗意与现代审美。

## 项目简介

「见素」取自《道德经》"见素抱朴"，意指呈现本色、回归本真。应用通过极简的视觉设计、带有物理反馈的微交互，以及基于 AI 的深度叙事解读，为用户创造一种"审美溢价"的起名体验。

## 技术架构

```
├── backend/                    # Spring Boot 后端
│   └── src/main/java/com/jiansu/naming/
│       ├── NamingApplication.java    # 应用入口
│       ├── controller/
│       │   └── NamingController.java # REST API 控制器
│       ├── model/
│       │   └── NameCard.java         # 名字卡片数据模型
│       └── service/
│           ├── MiniMaxService.java   # AI 名字生成服务
│           └── ToneAnalysisService.java # 声韵分析服务
│
└── miniprogram/               # 微信小程序
    ├── app.js                  # 应用入口
    └── pages/
        ├── home/               # 首页（关键词输入）
        └── index/              # 名字卡片展示页
```

## 核心功能

### AI 故事化起名
- 基于 AI 模型生成富有诗意的名字
- 每个名字配有出处诗句和"通感"叙事描述
- 拒绝生硬的 JSON 返回，扮演"隐居的诗人"角色

### 声韵分析
- **平仄匹配**：1、2 声为平，3、4 声为仄
- **优选模式**：平仄平、仄平仄、平平仄、仄仄平（有起伏感）
- **开口度检查**：避免连续闭口音，确保名字响亮大气

### 小程序交互
- 带阻尼感的卡片滑动体验
- 左滑跳过（卡片淡出）
- 右滑收藏（触觉震动反馈）
- 点击翻转查看名字的叙事性解读

## 技术栈

| 端 | 技术 |
|---|---|
| 后端 | Java 8 + Spring Boot 2.7 |
| AI 服务 | MiniMax API |
| 拼音处理 | Pinyin4j |
| 小程序 | 原生微信小程序 |
| 构建工具 | Maven |

## 快速开始

### 后端启动

```bash
cd backend
mvn spring-boot:run
```

后端服务将在 `http://localhost:8080` 启动。

### API 接口

| 接口 | 方法 | 参数 | 说明 |
|---|---|---|---|
| `/api/names/generate` | GET | keyword (可选，默认"清冷") | 生成名字列表 |

### 小程序开发

1. 导入 `miniprogram` 目录到微信开发者工具
2. 配置项目 AppID
3. 启动开发调试

## 配置说明

后端配置文件：`backend/src/main/resources/application.yml`

```yaml
server:
  port: 8080
miniMax:
  api-key: your-api-key-here
  base-url: https://api.minimax.chat
```

## 项目理念

### 视觉设计
- **主背景**：`#FFFFFF` 纯白，营造空灵感
- **文字**：`#2D2D2D` 带有温度的深灰
- **字体**：思源宋体展示名字，苹方用于正文

### 命名哲学
> "你是「见素」的灵魂导师。当用户输入期待时，请从《诗经》、《楚辞》或宋词中提取意象，生成3个名字。每个名字必须配有一段 50 字以内的'通感'描述，包含气味、光线或声音的描写，拒绝说教。"

## 未来规划

- [ ] 名字壁纸 Canvas 生成
- [ ] 高级定制服务
- [ ] 微音效优化