墨香起名 | Name Generator

一个优雅的中华文化姓名生成应用，融合传统文化与现代设计。

✨ 应用简介

墨香起名是一款专为中华文化量身定制的姓名生成器，在保持国际化支持的同时，特别注重中文命名的文化内涵和美学体验。应用采用书香墨韵的视觉设计，为用户提供富有诗意的起名体验。

🎯 核心特色

🖋️ 墨香文化主题 - 融入传统书香文化元素的优雅界面
🌸 中英双语支持 - 完整的国际化体验
🎨 智能筛选系统 - 多维度的姓名定制功能
💫 流畅动画效果 - 优雅的交互动画和视觉反馈
📱 全平台支持 - Web、iOS、Android、桌面端全覆盖

🚀 技术栈

核心框架

Flutter 3.x - 跨平台UI框架
Dart - 编程语言
Material Design 3 - 设计语言

状态管理

Provider - 轻量级状态管理
SharedPreferences - 本地数据持久化

UI/UX

Google Fonts - 字体系统 (Noto Sans SC, Poppins, Playfair Display)
Custom Animations - 自定义动画系统
Responsive Design - 响应式布局

国际化

Flutter Intl - 国际化支持
ARB格式 - 本地化资源管理

📁 项目结构

lib/
├── app.dart                    # 应用主入口
├── main.dart                   # 程序启动点
├── data/                       # 数据层
│   └── chinese_names.dart      # 中文姓名数据库
├── l10n/                       # 国际化
│   ├── app_*.arb              # 本地化资源文件
│   └── app_localizations*.dart # 生成的本地化类
├── models/                     # 数据模型
│   ├── enums.dart             # 枚举定义
│   └── name_entry.dart        # 姓名条目模型
├── pages/                      # 页面层
│   ├── generator_page.dart    # 起名生成页
│   ├── favorites_page.dart    # 收藏页面
│   ├── history_page.dart      # 历史记录页
│   └── settings_page.dart     # 设置页面
├── providers/                  # 状态管理
│   └── app_state.dart         # 全局应用状态
├── utils/                      # 工具类
│   └── preferences_helper.dart # 偏好设置助手
└── widgets/                    # 通用组件
    ├── filter_dialog.dart     # 筛选对话框
    └── navigation_wrapper.dart # 导航包装器

🎭 核心功能

1. 智能姓名生成

文化背景选择: 中文/英文姓名风格
性别筛选: 男性/女性/中性名字
姓氏定制: 120+常用中文姓氏选择
寓意筛选: 吉祥如意、才华横溢、品德高尚、自然清雅、智慧聪颖
字数控制: 单字名/双字名
首字母: 自定义名字首字母

2. 个性化体验

收藏系统: 保存喜爱的姓名
历史记录: 追踪生成历史
一键复制: 快速复制到剪贴板
主题切换: 明亮/暗黑模式
语言切换: 中文/英文界面

3. 中国风设计

墨香主题: 专为中文模式设计的传统色彩方案
呼吸动画: 背景装饰的微妙动画效果
书法字体: 适配中文显示的优雅字体
渐变背景: 米白、玉米丝色的温暖色调

🛠️ 开发指南

环境要求

Flutter SDK >= 3.0.0
Dart SDK >= 2.19.4
iOS 11.0+ / Android API 21+ / Web (Chrome, Firefox, Safari)

快速开始

# 克隆项目
git clone [repository-url]
cd name-generator

# 安装依赖
flutter pub get

# 生成国际化文件
flutter gen-l10n

# 运行应用
flutter run

# Web端运行
flutter run -d web-server --web-port 8080

构建发布版本

# Android APK
flutter build apk --release

# iOS
flutter build ios --release

# Web
flutter build web --release

# Windows
flutter build windows --release

# macOS
flutter build macos --release

📦 依赖包

dependencies:
  flutter:
    sdk: flutter
  flutter_localizations:
    sdk: flutter
  provider: ^6.0.0              # 状态管理
  shared_preferences: ^2.2.2    # 本地存储
  google_fonts: ^6.1.0          # 字体系统
  english_words: ^4.0.0         # 英文词库
  intl: ^0.20.2                 # 国际化支持

dev_dependencies:
  flutter_test:
    sdk: flutter
  flutter_lints: ^2.0.0         # 代码规范检查

🌍 国际化支持

应用支持以下语言：

🇨🇳 简体中文 (zh)
🇺🇸 英语 (en)

添加新语言：

在 lib/l10n/ 目录下创建 app_[locale].arb 文件
运行 flutter gen-l10n 生成本地化类
在 app.dart 中添加新的 locale 支持

🎨 设计理念

色彩方案

墨色主题 (#8B4513) - 传统墨汁的深沉色调
金色装饰 (#E8D5B7) - 宣纸的温润质感
米色辅助 (#D4B896) - 古籍的雅致色彩
背景渐变 - 从米白到玉米丝色的柔和过渡

动画设计

弹性进入 - 名字生成时的弹性缩放效果
渐显动画 - 透明度渐变的优雅出现
呼吸效果 - 背景装饰的微妙律动

📱 平台支持

✅ Web - 现代浏览器全支持
✅ Android - API 21+ (Android 5.0+)
✅ iOS - iOS 11.0+
✅ macOS - macOS 10.14+
✅ Windows - Windows 10+
✅ Linux - Ubuntu 18.04+

🤝 贡献指南

欢迎提交 Issue 和 Pull Request！

开发规范

遵循 Dart 官方代码规范
使用 flutter analyze 检查代码质量
提交前运行 flutter test 确保测试通过
国际化文本必须添加到 ARB 文件中

提交规范

feat: 新功能
fix: 修复bug
docs: 文档更新
style: 代码格式调整
refactor: 重构
test: 测试相关
chore: 其他修改

📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。

🙏 致谢

Flutter 团队提供的优秀跨平台框架
Material Design 的设计指导
中华传统文化的灵感来源
所有贡献者的支持与帮助

墨香起名 - 传承文化，智慧命名

Made with ❤️ by Flutter

fengzhenbing/name-generator

README