liuziting 7 mesiacov pred
rodič
commit
456c4c874a
1 zmenil súbory, kde vykonal 132 pridanie a 52 odobranie
  1. 132 52
      README.md

+ 132 - 52
README.md

@@ -1,31 +1,62 @@
 # 一饭封神 🍳
 
-一个基于 AI 的智能菜谱生成平台,让不同菜系的厨艺大师为您量身定制美味佳肴。
+> **UPLOAD YOUR INGREDIENTS | SPIT OUT RECIPES!**
 
-## 功能特色
+一个基于 AI 的智能菜谱生成平台,采用现代扁平化设计风格,让不同菜系的厨艺大师为您的食材创造美味传奇。
 
--   🥬 **智能食材识别**: 输入任意食材组合
--   👨‍🍳 **多菜系大师**: 支持苏菜、鲁菜、川菜、粤菜、浙菜、湘菜、闽菜、徽菜等八大菜系
--   🍽️ **个性化菜谱**: 每个菜系大师都有独特的烹饪风格和技法
--   📝 **详细步骤**: 提供完整的制作流程和烹饪技巧
--   🎨 **精美界面**: 采用温暖的黄色系设计,营造温馨的厨房氛围
+## ✨ 功能特色
 
-## 技术栈
+### 🥬 智能食材识别
+
+-   支持任意食材组合输入
+-   最多可添加 10 种食材
+-   一键添加/删除食材标签
+
+### 👨‍🍳 多菜系大师
+
+支持 8 大传统菜系的专业厨艺大师:
+
+-   **苏菜** - 清淡鲜美,刀工精细
+-   **鲁菜** - 咸鲜为主,火候精准
+-   **川菜** - 麻辣鲜香,变化多端
+-   **粤菜** - 清淡鲜美,原汁原味
+-   **浙菜** - 清香淡雅,鲜嫩爽滑
+-   **湘菜** - 香辣浓郁,口味厚重
+-   **闽菜** - 鲜香清淡,汤鲜味美
+-   **徽菜** - 重油重色,醇厚朴实
+
+### 🎨 自定义要求
+
+-   支持个性化烹饪需求
+-   智能理解用户特殊要求
+-   如:清淡汤品、减肥餐、儿童营养餐等
+
+### 📱 现代化界面
+
+-   采用鲜明的黄色系配色方案
+-   扁平化设计风格,简洁直观
+-   响应式布局,完美适配各种设备
+-   分步骤引导,用户体验友好
+
+## 🚀 技术栈
 
 -   **前端框架**: Vue 3 + TypeScript
 -   **样式框架**: Tailwind CSS
 -   **构建工具**: Vite
 -   **路由管理**: Vue Router
 -   **HTTP 客户端**: Axios
+-   **AI 服务**: 智谱 AI GLM-4-Flash
 
-## 项目结构
+## 📦 项目结构
 
 ```
 src/
 ├── components/          # 组件目录
-│   └── RecipeCard.vue  # 菜谱卡片组件
+│   ├── RecipeCard.vue  # 菜谱卡片组件
+│   └── CookingLoader.vue # 加载动画组件
 ├── config/             # 配置文件
-│   └── cuisines.ts     # 菜系配置
+│   ├── cuisines.ts     # 菜系配置
+│   └── ai.ts          # AI配置
 ├── services/           # 服务层
 │   └── aiService.ts    # AI接口服务
 ├── types/              # 类型定义
@@ -37,7 +68,12 @@ src/
 └── style.css           # 全局样式
 ```
 
-## 快速开始
+## 🛠️ 快速开始
+
+### 环境要求
+
+-   Node.js 18+
+-   npm 或 yarn
 
 ### 安装依赖
 
@@ -57,84 +93,128 @@ npm run dev
 npm run build
 ```
 
-## AI 接口配置
+### 类型检查
+
+```bash
+npm run type-check
+```
+
+## 🤖 AI 配置
 
-项目已配置智谱 AI 接口,开箱即用:
+项目已集成智谱 AI 接口,开箱即用:
 
 ```typescript
 const AI_CONFIG = {
     baseURL: 'https://open.bigmodel.cn/api/paas/v4/',
-    apiKey: 'a835b9f6866d48ec956d341418df8a50.NuhlKYn58EkCb5iP',
+    apiKey: 'your_api_key_here',
     model: 'glm-4-flash-250414',
     temperature: 0.7,
     timeout: 30000
 }
 ```
 
+### 自定义 AI 服务
+
 如需更换其他 AI 服务,请修改 `src/services/aiService.ts` 中的配置。
 
-## 菜系大师介绍
+## 🎯 使用指南
 
-### 🥢 苏菜大师
+### 基础使用流程
 
--   **特色**: 清淡鲜美,刀工精细
--   **擅长**: 江南水乡的精致美味
+1. **输入食材** - 在输入框中添加您现有的食材
+2. **选择方式** - 选择菜系大师或输入自定义要求
+3. **生成菜谱** - 点击"交给大师"或"按要求生成"
+4. **查看结果** - 浏览 AI 大师为您定制的菜谱
 
-### 🍖 鲁菜大师
+### 菜系选择模式
 
--   **特色**: 咸鲜为主,火候精准
--   **擅长**: 齐鲁大地的豪放风味
+-   可选择一个或多个菜系
+-   每个菜系都有独特的烹饪风格和技法
+-   支持随机选择菜系
 
-### 🌶️ 川菜大师
+### 自定义要求模式
 
--   **特色**: 麻辣鲜香,变化多端
--   **擅长**: 巴蜀之地的麻辣传奇
+-   输入具体的烹饪需求
+-   如:"做一道清淡的汤,适合老人食用"
+-   AI 会根据要求生成个性化菜谱
 
-### 🦐 粤菜大师
+## 🎨 设计特色
 
--   **特色**: 清淡鲜美,原汁原味
--   **擅长**: 岭南文化的鲜美诠释
+### 配色方案
 
-### 🐟 浙菜大师
+-   **主背景**: 明亮黄色 (#fbbf24)
+-   **头部区域**: 粉色 (#f472b6)
+-   **步骤标签**: 多彩分类(粉色、绿色、蓝色、黑色)
+-   **卡片区域**: 白色背景配黑色边框
 
--   **特色**: 清香淡雅,鲜嫩爽滑
--   **擅长**: 江南水乡的清雅之味
+### 交互设计
 
-### 🔥 湘菜大师
+-   扁平化按钮和卡片
+-   2px 黑色边框设计语言
+-   悬停和点击动画效果
+-   清晰的视觉层次
 
--   **特色**: 香辣浓郁,口味厚重
--   **擅长**: 湖湘文化的辣味人生
+## 📱 响应式设计
 
-### 🦀 闽菜大师
+-   **移动端**: 单列布局,触摸友好
+-   **平板端**: 双列菜谱展示
+-   **桌面端**: 多列布局,充分利用屏幕空间
 
--   **特色**: 鲜香清淡,汤鲜味美
--   **擅长**: 八闽大地的海鲜盛宴
+## 🔧 部署
 
-### 🍄 徽菜大师
+### Netlify 部署
 
--   **特色**: 重油重色,醇厚朴实
--   **擅长**: 徽州文化的朴实醇香
+项目已配置 Netlify 自动部署:
 
-## 使用说明
+```toml
+[build]
+  command = "npm install && npx vite build --config vite.config.prod.ts"
+  publish = "dist"
+
+[build.environment]
+  NODE_VERSION = "18"
+```
 
-1. **输入食材**: 在食材输入框中添加您现有的食材
-2. **选择大师**: 点击选择一个或多个菜系大师
-3. **生成菜谱**: 点击"开始创作美味佳肴"按钮
-4. **查看结果**: 浏览不同大师为您定制的菜谱
+### 手动部署
+
+```bash
+npm run build
+# 将 dist 目录部署到您的服务器
+```
 
-## 开发计划
+## 🚧 开发计划
 
--   [ ] 集成真实 AI 接口
 -   [ ] 添加菜谱收藏功能
--   [ ] 支持菜谱分享
--   [ ] 添加营养分析
+-   [ ] 支持菜谱分享到社交媒体
+-   [ ] 添加营养成分分析
 -   [ ] 支持语音输入食材
--   [ ] 添加购物清单功能
+-   [ ] 添加购物清单生成
+-   [ ] 多语言支持
+-   [ ] 用户账户系统
+-   [ ] 菜谱评分和评论
 
-## 贡献指南
+## 🤝 贡献指南
 
 欢迎提交 Issue 和 Pull Request 来帮助改进项目!
 
-## 许可证
+### 开发规范
+
+-   使用 TypeScript 进行类型安全开发
+-   遵循 Vue 3 Composition API 最佳实践
+-   使用 Tailwind CSS 进行样式开发
+-   保持代码简洁和可读性
+
+## 📄 许可证
 
 MIT License
+
+## 🙏 致谢
+
+-   [Vue.js](https://vuejs.org/) - 渐进式 JavaScript 框架
+-   [Tailwind CSS](https://tailwindcss.com/) - 实用优先的 CSS 框架
+-   [智谱 AI](https://open.bigmodel.cn/) - 提供强大的 AI 能力
+-   [Vite](https://vitejs.dev/) - 下一代前端构建工具
+
+---
+
+**让 AI 厨艺大师为您的食材注入灵魂,创造属于您的美味传奇!** 🍽️✨