Initial commit

DEVELOPMENT.md

@@ -0,0 +1,66 @@
+# 「见素」开发文档 (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 生成，按次收费。