Files
JianSu-Naming/DEVELOPMENT.md
2026-04-16 11:25:29 +08:00

66 lines
4.2 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 「见素」开发文档 (JianSu Naming Dev Doc)
## 1. 项目概述与核心理念
「见素」是一款专注于“留白”与“故事化”体验的起名应用。其核心理念在于摒弃繁杂,回归名字本身的诗意与文化底蕴。应用旨在通过极简的视觉设计、带有物理反馈的微交互,以及基于 AI 的深度叙事解读,为用户提供一种“审美溢价”的起名体验。
## 2. 视觉与 UI 架构
为了对齐“潮汐风格”UI 架构需严格遵循 **0.618 黄金比例**的布局,强调极致的“留白”。
### 2.1 色彩系统
* **主背景**`#FFFFFF`(纯白),营造空灵感。
* **文字**`#2D2D2D`(带有温度的深灰,而非纯黑),减轻视觉疲劳,增加温润感。
* **辅助色**`#E0E0E0`(用于极细的分割线),保持界面的通透。
### 2.2 字体栈 (Typography)
* **标题/名字展示**:优先调用 `Noto Serif SC` (思源宋体),展现汉字的古典韵味与雕刻感。
* **说明文字/正文**:使用 `PingFang SC` (苹方),保证移动端的清晰易读性。
## 3. 交互设计 (Interaction)
摒弃传统的简单 Swiper 效果,为滑动增加“摩擦力”和“阻尼感”,打造“见素”时刻。
### 3.1 卡片设计
* **正面 (Front)**:极致极简,只放置一个巨大的、居中的名字,下方配以一行极小的出处诗句。
* **反面 (Back)**:点击卡片翻转,展示名字背后的“叙事性解读”(通感描述)。
### 3.2 交互与微反馈
* **左滑 (Dislike/Skip)**:无感交互,卡片像烟雾一样逐渐变淡消失。
* **右滑 (Like/Save)**:触发轻微的 Haptic Feedback触觉震动名字化作一个墨点落入底部的“收藏”图标中。
## 4. 技术核心
结合 Gemini API 与声韵学算法,打造有灵魂的起名引擎。
### 4.1 AI 故事化 Prompt 策略
**目标**:拒绝生硬的 JSON 数据堆砌,让 AI 扮演一位“隐居的诗人”。
**System Prompt 示例**
> “你是「见素」的灵魂导师。当用户输入期待时请从《诗经》、《楚辞》或宋词中提取意象生成3个名字。每个名字必须配有一段 50 字以内的‘通感’描述,包含气味、光线或声音的描写,拒绝说教。”
### 4.2 技术栈与核心逻辑 (Tech Stack)
* **后端**Java SpringBoot提供起名接口、声韵分析及 API 转发。
* **小程序端**:原生微信小程序 (Native Mini Program),利用 WXS 与动画库实现阻尼感滑动。
**声韵分析逻辑 (Algorithm)**
在后端 Service 层实现姓名声韵评估:
1. **平仄匹配**:检测姓氏(平/仄)与名字(平/仄)的组合。
2. **优选模式**:推荐“平仄平”、“仄平仄”等有起伏感、抑扬顿挫的组合。
3. **叠音/开口度检查**:避免连续的闭口音(如 iao, iu, in 等连续出现),确保名字喊出来时是响亮、大气的。
## 5. 开发路线图 (MVP Roadmap)
从基础骨架到最终的美化,分为四个阶段进行:
* **Phase 1 (骨架)**
* **后端**:搭建 SpringBoot 基础环境,配置跨域与 API 基础接口。
* **小程序**:使用原生小程序框架,实现带阻尼感的卡片滑动组件与翻转动效。
* **Phase 2 (大脑)**:后端集成 Gemini API调试“故事化起名”的 Prompt确保输出文本的 Vibe 符合“见素”的调性。
* **Phase 3 (细节)**:加入微音效(如类似翻书声或清脆的铃声)和后端的声韵评分逻辑算法。
* **Phase 4 (美化)**:优化字体渲染,增加 Canvas 名字海报生成功能。
## 6. 商业化预留 (暂不实现,仅做架构预留)
商业化路线拒绝弹窗广告,主打“审美溢价”。
### 6.1 名字壁纸生成 (高级感变现)
* 利用 Canvas 生成极简海报:居中的大字 + 用户的姓氏印章 + 独一无二的编号(如:见素第 8921 号灵感)。
* **变现点**:基础版免费,高清无水印版(可设置价格梯度如 ¥1.9 - ¥9.9)。
### 6.2 “见素”锦囊 (深度定制)
* 为难以刷到满意名字的用户提供“深度定制”入口。
* 调用更高级别的模型(如 Claude 3.5 Sonnet 或 Gemini Ultra进行 1v1 生成,按次收费。