From 1a749cdf71f9f027075d4535c7c3836f21511a95 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E7=8E=8B=E9=B9=8F?= Date: Thu, 16 Apr 2026 11:30:25 +0800 Subject: [PATCH] docs: add README.md --- README.md | 118 ++++++++++++++++++++++++++++++++++++------------------ 1 file changed, 80 insertions(+), 38 deletions(-) diff --git a/README.md b/README.md index cbd78b7..9512603 100644 --- a/README.md +++ b/README.md @@ -1,65 +1,107 @@ -1. 视觉底座：极致的“留白” -为了对齐“潮汐风格”，你的 UI 架构需要遵循 0.618 黄金比例 的布局。 +# 见素 - AI 起名应用 -色彩系统： * 主背景：#FFFFFF（纯白）。 +一个专注于"留白"与"故事化"体验的 AI 起名应用，融合古典诗意与现代审美。 -文字：#2D2D2D（带有温度的深灰，而非纯黑）。 +## 项目简介 -辅助色：#E0E0E0（极细的分割线）。 +「见素」取自《道德经》"见素抱朴"，意指呈现本色、回归本真。应用通过极简的视觉设计、带有物理反馈的微交互，以及基于 AI 的深度叙事解读，为用户创造一种"审美溢价"的起名体验。 -字体栈： * 标题/名字展示：优先调用 Noto Serif SC (思源宋体)，展现古典韵味。 +## 技术架构 -说明文字：使用 PingFang SC，保证移动端的易读性。 +``` +├── 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/ # 名字卡片展示页 +``` -2. 交互灵魂：卡片滑动与“见素”时刻 -不要简单的 Swiper，要给滑动增加“摩擦力”和“阻尼感”。 +## 核心功能 -卡片设计： +### AI 故事化起名 +- 基于 AI 模型生成富有诗意的名字 +- 每个名字配有出处诗句和"通感"叙事描述 +- 拒绝生硬的 JSON 返回，扮演"隐居的诗人"角色 -正面：只放一个巨大的、居中的名字，下方一行极小的出处诗句。 +### 声韵分析 +- **平仄匹配**：1、2 声为平，3、4 声为仄 +- **优选模式**：平仄平、仄平仄、平平仄、仄仄平（有起伏感） +- **开口度检查**：避免连续闭口音，确保名字响亮大气 -反面（点击翻转）：展示**“叙事性解读”**。 +### 小程序交互 +- 带阻尼感的卡片滑动体验 +- 左滑跳过（卡片淡出） +- 右滑收藏（触觉震动反馈） +- 点击翻转查看名字的叙事性解读 -反馈微交互： +## 技术栈 -左滑（无感）： 卡片像烟雾一样变淡消失。 +| 端 | 技术 | +|---|---| +| 后端 | Java 8 + Spring Boot 2.7 | +| AI 服务 | MiniMax API | +| 拼音处理 | Pinyin4j | +| 小程序 | 原生微信小程序 | +| 构建工具 | Maven | -右滑（收藏）： 触发轻微的 Haptic Feedback（震动），名字化作一个墨点落入底部的“收藏”图标中。 +## 快速开始 -3. 技术核心：AI 故事化与声韵算法 -既然你有 Gemini API 的开发经验，这里可以做得很硬核： +### 后端启动 -AI 故事化 Prompt 策略 -不要让 AI 只返回 JSON，要让它扮演一个“隐居的诗人”。 +```bash +cd backend +mvn spring-boot:run +``` -System Prompt 示例： -“你是「见素」的灵魂导师。当用户输入期待时，请从《诗经》、《楚辞》或宋词中提取意象，生成3个名字。每个名字必须配有一段 50 字以内的‘通感’描述，包含气味、光线或声音的描写，拒绝说教。” +后端服务将在 `http://localhost:8080` 启动。 -声韵分析逻辑 (Algorithm) -你可以写一个简单的 Python 或 Node.js 脚本来处理： +### API 接口 -平仄匹配： 检测姓氏（平/仄）与名字（平/仄）的组合。 +| 接口 | 方法 | 参数 | 说明 | +|---|---|---|---| +| `/api/names/generate` | GET | keyword (可选，默认"清冷") | 生成名字列表 | -优选模式： 平仄平、仄平仄（有起伏感）。 +### 小程序开发 -叠音/开口度检查： 避免连续的闭口音，确保名字喊出来时是响亮的。 +1. 导入 `miniprogram` 目录到微信开发者工具 +2. 配置项目 AppID +3. 启动开发调试 -4. 商业化与衍生：高级感变现(先不实现) -拒绝弹窗广告，我们走**“审美溢价”**路线。 +## 配置说明 -名字壁纸生成： * 利用 Canvas 生成一张极简海报：居中的大字 + 用户的姓氏印章 + 独一无二的编号（如：见素第 8921 号灵感）。 +后端配置文件：`backend/src/main/resources/application.yml` -变现点： 基础版免费，高清无水印版 ￥1.9 - ￥9.9。 +```yaml +server: + port: 8080 +miniMax: + api-key: your-api-key-here + base-url: https://api.minimax.chat +``` -“见素”锦囊： +## 项目理念 -如果用户一直刷不到满意的，提供一个“深度定制”入口，调用更高级别的模型（如 Claude 3.5 Sonnet 或 Gemini Ultra）进行 1v1 生成，按次收费。 +### 视觉设计 +- **主背景**：`#FFFFFF` 纯白，营造空灵感 +- **文字**：`#2D2D2D` 带有温度的深灰 +- **字体**：思源宋体展示名字，苹方用于正文 -5. 开发者视角的 MVP 路径 (Roadmap) -Phase 1 (骨架): 搭建基础的 Next.js 或 Uni-app 框架，实现卡片滑动组件。 +### 命名哲学 +> "你是「见素」的灵魂导师。当用户输入期待时，请从《诗经》、《楚辞》或宋词中提取意象，生成3个名字。每个名字必须配有一段 50 字以内的'通感'描述，包含气味、光线或声音的描写，拒绝说教。" -Phase 2 (大脑): 接入 Gemini API，调试“故事化起名”的提示词，确保输出的 Vibe 符合“见素”。 +## 未来规划 -Phase 3 (细节): 加入音效（类似翻书声或清脆的铃声）和声韵评分逻辑。 - -Phase 4 (美化): 优化字体渲染，增加 Canvas 海报生成功能。 \ No newline at end of file +- [ ] 名字壁纸 Canvas 生成 +- [ ] 高级定制服务 +- [ ] 微音效优化