108 lines
3.1 KiB
Markdown
108 lines
3.1 KiB
Markdown
# 见素 - 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 生成
|
||
- [ ] 高级定制服务
|
||
- [ ] 微音效优化
|