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

4.2 KiB
Raw Blame History

「见素」开发文档 (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 生成,按次收费。