浏览代码

Update README.md

liuziting 7 月之前
父节点
当前提交
5100490e8f
共有 1 个文件被更改,包括 117 次插入260 次删除
  1. 117 260
      README.md

+ 117 - 260
README.md

@@ -1,340 +1,197 @@
-# 一饭封神 🍳
+# 🍳 一饭封神
 
-> **UPLOAD YOUR INGREDIENTS | SPIT OUT RECIPES!**
+> **让 AI 厨艺大师为你的食材注入灵魂,创造属于你的美味传奇!**
 
-一个基于 AI 的智能菜谱生成平台,采用现代扁平化设计风格,让不同菜系的厨艺大师为您的食材创造美味传奇。支持营养分析、效果图生成等全方位烹饪指导。
+一个基于 AI 的智能菜谱生成平台,支持中华八大菜系 + 国际料理,提供营养分析、效果图生成等全方位烹饪指导。
 
-## ✨ 功能特色
+[![Live Demo](https://img.shields.io/badge/🌐_Live_Demo-一饭封神-yellow?style=for-the-badge)](https://yifan-fengshen.netlify.app)
+[![GitHub](https://img.shields.io/badge/GitHub-liu--ziting/what--to--eat-black?style=for-the-badge&logo=github)](https://github.com/liu-ziting/what-to-eat)
 
-### 🥬 智能食材识别
+## ✨ 核心功能
 
--   支持任意食材组合输入
--   最多可添加 10 种食材
+### 🥬 智能食材管理
+
+-   支持任意食材组合(最多 10 种)
+-   快速选择器 + 手动输入双模式
 -   一键添加/删除食材标签
--   智能食材搭配建议
 
-### 👨‍🍳 八大菜系大师
+### 👨‍🍳 多元化料理大师
+
+**中华八大菜系:**
 
-支持中华传统八大菜系的专业厨艺大师:
+-   🦐 苏菜 - 江南精致,刀工精细
+-   🐟 鲁菜 - 齐鲁豪放,火候精准
+-   🌶️ 川菜 - 巴蜀麻辣,变化多端
+-   🦆 粤菜 - 岭南鲜美,原汁原味
+-   🐠 浙菜 - 江南清雅,鲜嫩爽滑
+-   🔥 湘菜 - 湖湘火辣,口味厚重
+-   🦀 闽菜 - 八闽海鲜,汤鲜味美
+-   🐷 徽菜 - 徽州醇香,重油重色
 
--   **苏菜大师** - 江南水乡的精致美味,清淡鲜美,刀工精细
--   **鲁菜大师** - 齐鲁大地的豪放风味,咸鲜为主,火候精准
--   **川菜大师** - 巴蜀之地的麻辣传奇,麻辣鲜香,变化多端
--   **粤菜大师** - 岭南文化的鲜美诠释,清淡鲜美,原汁原味
--   **浙菜大师** - 江南水乡的清雅之味,清香淡雅,鲜嫩爽滑
--   **湘菜大师** - 湖湘文化的辣味人生,香辣浓郁,口味厚重
--   **闽菜大师** - 八闽大地的海鲜盛宴,鲜香清淡,汤鲜味美
--   **徽菜大师** - 徽州文化的朴实醇香,重油重色,醇厚朴实
+**国际料理:**
+
+-   � 日式料理 - 和食美学,季节本味
+-   🥢 韩式料理 - 发酵智慧,营养均衡
+-   🍝 意式料理 - 地中海阳光,简约精致
+-   🥖 法式料理 - 高卢优雅,酱汁丰富
+-   🍛 印度料理 - 香料王国,层次复杂
+-   🌶️ 泰式料理 - 酸甜平衡,香草丰富
+-   🌮 墨西哥料理 - 阿兹特克传承,辣椒文化
 
 ### 🎨 双模式生成
 
--   **菜系模式**: 选择 1-8 个菜系,每个大师创作独特菜谱
--   **自定义模式**: 输入个性化需求,AI 智能理解并生成
--   **智能随机**: 不选择时自动随机选择 2 个菜系
+-   **菜系模式:** 选择 1-15 个菜系,每个大师创作独特菜谱
+-   **自定义模式:** 输入个性化需求(如"清淡汤品,适合老人,少盐低脂")
+-   **智能随机** 不选择时自动随机选择菜系
 
-### 🥗 营养分析功能 ⭐ NEW
+### 🥗 营养分析系统
 
--   **营养成分**: 详细的卡路里、蛋白质、碳水化合物等数据
--   **健康评分**: 1-10 分的营养健康评分系统
--   **饮食标签**: 自动识别"高蛋白"、"低脂"、"素食"等特点
--   **营养建议**: 个性化营养均衡建议
--   **份量指导**: 科学的建议食用份量
+-   详细营养成分表(卡路里、蛋白质、碳水、脂肪等)
+-   1-10 分健康评分系统
+-   自动标注饮食特点(高蛋白、低脂、素食等)
+-   个性化营养建议和改进方案
+-   科学的建议食用份量
 
-### 🖼️ AI 效果图生成
+### ️ AI 效果图生成
 
 -   一键生成精美菜品效果图
 -   基于菜谱内容智能绘制
 -   高质量视觉呈现
--   支持图片保存和分享
 
-### 📱 现代化界面
+### 🍷 酒水搭配推荐
 
--   采用鲜明的黄色系配色方案
--   扁平化设计风格,简洁直观
--   响应式布局,完美适配各种设备
--   分步骤引导,用户体验友好
--   卡片式菜谱展示,信息层次清晰
+-   专业侍酒师推荐
+-   基于菜品特色的完美搭配
+-   详细的搭配理由和饮用建议
 
 ## 🚀 技术栈
 
-### 前端技术
-
--   **框架**: Vue 3.4+ (Composition API)
--   **语言**: TypeScript 5.3+
--   **样式**: Tailwind CSS 3.4+
--   **构建**: Vite 5.0+
--   **路由**: Vue Router 4.2+
--   **工具**: @vueuse/core 10.7+
-
-### AI 服务
-
--   **主要**: DeepSeek Chat API
--   **备用**: 智谱 AI GLM-4-Flash
--   **图像**: AI 图像生成服务
--   **营养**: 智能营养分析算法
-
-### 开发工具
-
--   **类型检查**: vue-tsc
--   **代码质量**: ESLint + Prettier
--   **包管理**: npm/yarn
--   **部署**: Netlify 自动化部署
+-   **前端框架:** Vue 3.4 + Composition API
+-   **开发语言:** TypeScript 5.3+
+-   **样式方案:** Tailwind CSS 3.4+
+-   **构建工具:** Vite 5.0+
+-   **AI 服务:** DeepSeek Chat API + 智谱 AI GLM-4-Flash
+-   **部署平台:** Netlify 自动化部署
 
-## 📦 项目结构
-
-```
-src/
-├── components/              # 组件目录
-│   ├── RecipeCard.vue      # 菜谱卡片组件
-│   ├── NutritionAnalysis.vue # 营养分析组件 ⭐ NEW
-│   └── CookingLoader.vue   # 加载动画组件
-├── config/                 # 配置文件
-│   └── cuisines.ts         # 八大菜系配置
-├── services/               # 服务层
-│   ├── aiService.ts        # AI菜谱生成服务
-│   └── imageService.ts     # AI图像生成服务
-├── types/                  # 类型定义
-│   └── index.ts           # 通用类型(含营养分析类型)
-├── views/                  # 页面组件
-│   └── Home.vue           # 主页面
-├── App.vue                # 根组件
-├── main.ts               # 入口文件
-└── style.css             # 全局样式
-```
-
-## 🛠️ 快速开始
+## 🎯 快速开始
 
 ### 环境要求
 
 -   Node.js 18+
--   npm 或 yarn
 -   现代浏览器支持
 
-### 安装依赖
+### 本地运行
 
 ```bash
+# 克隆项目
+git clone https://github.com/liu-ziting/what-to-eat.git
+cd what-to-eat
+
+# 安装依赖
 npm install
-```
 
-### 启动开发服务器
+# 配置环境变量
+cp .env.example .env
+# 编辑 .env 文件,添加你的 AI API 密钥
 
-```bash
+# 启动开发服务器
 npm run dev
 ```
 
 访问 http://localhost:5173
 
-### 构建生产版本
-
-```bash
-npm run build
-```
-
-### 类型检查
-
-```bash
-npm run type-check
-```
-
-### 预览构建结果
-
-```bash
-npm run preview
-```
-
-## 🤖 AI 配置
-
-### 文本生成服务配置
-
-项目使用 DeepSeek API 进行菜谱生成和营养分析:
-
-```typescript
-const AI_CONFIG = {
-    baseURL: 'https://api.deepseek.com/v1/',
-    apiKey: import.meta.env.VITE_TEXT_GENERATION_API_KEY, // 从环境变量读取
-    model: 'deepseek-chat',
-    temperature: 0.7,
-    timeout: 300000
-}
-```
-
-### 图像生成服务配置
-
-项目使用独立的图像生成 API:
-
-```typescript
-const IMAGE_CONFIG = {
-    apiKey: import.meta.env.VITE_IMAGE_GENERATION_API_KEY // 从环境变量读取
-}
-```
-
 ### 环境变量配置
 
-创建 `.env` 文件(基于 `.env.example` 模板):
-
 ```env
-# Text Generation Service Configuration
+# DeepSeek API 菜谱生成配置
 VITE_TEXT_GENERATION_API_KEY=your_deepseek_api_key_here
 
-# Image Generation Service Configuration
+# Bigmodel API 图像生成配置
 VITE_IMAGE_GENERATION_API_KEY=your_image_api_key_here
 ```
 
-## 🎯 使用指南
-
-### 基础使用流程
+## � 使用指南始
 
-1. **输入食材** - 在输入框中添加您现有的食材(最多 10 种)
-2. **选择方式** - 选择菜系大师或输入自定义要求
-3. **生成菜谱** - 点击"交给大师"或"按要求生成"
-4. **查看结果** - 浏览 AI 大师为您定制的菜谱
-5. **营养分析** - 展开查看详细营养信息和建议 ⭐ NEW
-6. **生成效果图** - 点击生成按钮获取菜品效果图
+### 基础流程
 
-### 菜系选择模式
+1. **添加食材** - 输入你现有的食材(支持快速选择)
+2. **选择菜系** - 选择喜欢的菜系大师,或输入自定义要求
+3. **交给大师** - 点击生成按钮,AI 开始创作
+4. **查看结果** - 浏览专业菜谱,展开查看详细步骤
 
--   可选择一个或多个菜系(最多 8 个)
--   每个菜系都有独特的烹饪风格和专业提示词
--   不选择时自动随机选择 2 个菜系
--   支持菜系组合创新
+### 高级功能
 
-### 自定义要求模式
-
--   输入具体的烹饪需求和偏好
--   支持复杂需求:口味、营养、人群、场合等
--   示例:"做一道清淡的汤,适合老人食用,少盐低脂"
--   AI 智能理解并生成个性化菜谱
-
-### 营养分析功能 ⭐ NEW
-
--   **营养成分表**: 卡路里、蛋白质、碳水、脂肪、纤维等
--   **健康评分**: 基于营养均衡的 1-10 分评分
--   **饮食标签**: 自动标注菜品特点(高蛋白、低脂、素食等)
--   **营养建议**: 个性化的搭配和改进建议
--   **份量指导**: 科学的建议食用份量
+-   **营养分析** - 点击获取详细营养信息和健康建议
+-   **酒水搭配** - 获取专业的酒水搭配推荐
+-   **效果图生成** - 一键生成精美的菜品效果图
+-   **时间格式化** - 自动将长时间转换为天+小时+分钟格式
 
 ## 🎨 设计特色
 
-### 配色方案
-
--   **主背景**: 明亮黄色 (#fbbf24) - 温暖食欲感
--   **头部区域**: 粉色 (#f472b6) - 活力品牌色
--   **步骤标签**: 多彩分类(粉色、绿色、蓝色、黑色)
--   **卡片区域**: 白色背景配 2px 黑色边框
--   **营养区域**: 绿色系 - 健康自然感 ⭐ NEW
-
-### 交互设计
-
--   扁平化按钮和卡片设计
--   2px 黑色边框设计语言
--   悬停和点击动画效果
--   清晰的视觉层次和信息架构
--   展开/收起式详情查看
-
-### 响应式设计
-
--   **移动端**: 单列布局,触摸友好的按钮尺寸
--   **平板端**: 双列菜谱展示,合理利用空间
--   **桌面端**: 多列布局,充分利用大屏幕空间
+### 视觉设计
 
-## 🔧 部署配置
+-   **配色方案:** 明亮黄色主题 + 多彩步骤标签
+-   **设计语言:** 扁平化 + 2px 黑色边框
+-   **交互动效:** 悬停动画 + 展开收起过渡
 
-### Netlify 自动部署
+### 用户体验
 
-项目已配置 Netlify 自动部署:
+-   **响应式布局:** 完美适配手机/平板/桌面
+-   **分步引导:** 4 步完成菜谱生成
+-   **智能提示:** 实时显示当前配置状态
+-   **折叠设计:** 自定义要求默认折叠,界面更简洁
 
-```toml
-[build]
-  command = "npm install && npx vite build --config vite.config.prod.ts"
-  publish = "dist"
-
-[build.environment]
-  NODE_VERSION = "18"
-
-[[redirects]]
-  from = "/*"
-  to = "/index.html"
-  status = 200
-```
-
-### 手动部署
-
-```bash
-# 构建项目
-npm run build
+## 📦 项目结构
 
-# 部署 dist 目录到您的服务器
-# 支持静态托管服务:Netlify、Vercel、GitHub Pages 等
 ```
-
-### Docker 部署
-
-```dockerfile
-FROM node:18-alpine
-WORKDIR /app
-COPY package*.json ./
-RUN npm install
-COPY . .
-RUN npm run build
-EXPOSE 3000
-CMD ["npm", "run", "preview"]
+src/
+├── components/           # 组件目录
+│   ├── RecipeCard.vue   # 菜谱卡片(含时间格式化)
+│   ├── NutritionAnalysis.vue # 营养分析组件
+│   └── WinePairing.vue  # 酒水搭配组件
+├── config/              # 配置文件
+│   ├── cuisines.ts      # 菜系大师配置
+│   └── ingredients.ts   # 食材分类配置
+├── services/            # 服务层
+│   ├── aiService.ts     # AI菜谱生成服务
+│   └── imageService.ts  # AI图像生成服务
+├── types/               # 类型定义
+│   └── index.ts        # 通用类型定义
+├── views/               # 页面组件
+│   └── Home.vue        # 主页面(左右布局)
+└── App.vue             # 根组件
 ```
 
-## 🚧 开发计划
-
-### 已完成 ✅
+## 🌟 核心亮点
 
--   [x] 八大菜系 AI 大师系统
--   [x] 智能食材输入和管理
--   [x] 双模式菜谱生成(菜系/自定义)
--   [x] 营养分析功能 ⭐ NEW
--   [x] AI 效果图生成
--   [x] 响应式现代化界面
--   [x] 随机菜系选择优化
+### AI Prompt 工程
 
-### 开发中 🚧
+-   每个菜系大师都有独特的专业提示词
+-   国际菜系强制中文输出,确保用户理解
+-   自定义模式支持复杂需求理解
 
--   [ ] 菜谱收藏和历史记录
--   [ ] 用户偏好学习系统
--   [ ] 社交分享功能
+### 用户体验优化
 
-### 计划中 📋
+-   菜系选择支持 3 列网格布局
+-   步骤 2 和 3 在 PC 端采用左右布局
+-   自定义要求默认折叠,减少界面复杂度
+-   移除菜系悬浮弹窗,界面更简洁
 
--   [ ] 语音输入食材
--   [ ] 购物清单自动生成
--   [ ] 多语言支持(英文、日文)
--   [ ] 用户账户系统
--   [ ] 菜谱评分和评论
--   [ ] 食材营养数据库
--   [ ] 个性化推荐算法
--   [ ] 移动端 APP 版本
+### 功能完整性
 
-## 📄 许可证
-
-MIT License - 详见 [LICENSE](LICENSE) 文件
+-   完整的营养分析系统
+-   专业的酒水搭配推荐
+-   全方位的菜谱展示(食材、步骤、技巧、营养)
 
 ## 🙏 致谢
 
-### 技术支持
-
 -   [Vue.js](https://vuejs.org/) - 渐进式 JavaScript 框架
 -   [Tailwind CSS](https://tailwindcss.com/) - 实用优先的 CSS 框架
--   [Vite](https://vitejs.dev/) - 下一代前端构建工具
--   [TypeScript](https://www.typescriptlang.org/) - JavaScript 的超集
-
-### AI 服务
-
--   [DeepSeek](https://www.deepseek.com/) - 提供强大的对话 AI 能力
+-   [DeepSeek](https://www.deepseek.com/) - 强大的 AI 对话能力
 -   [智谱 AI](https://open.bigmodel.cn/) - 备用 AI 服务支持
 
-### 设计灵感
-
--   中华传统八大菜系文化
--   现代扁平化设计理念
--   用户体验最佳实践
-
 ---
 
-**让 AI 厨艺大师为您的食材注入灵魂,创造属于您的美味传奇!** 🍽️✨
+**🍽️ 让 AI 厨艺大师为你的食材注入灵魂,创造属于你的美味传奇!**
 
-_一饭封神 - 不只是菜谱,更是烹饪的艺术与科学_ 🎨🔬
+_一饭封神 - 不只是菜谱,更是烹饪的艺术与科学_ ✨