1. 实际应用场景与痛点
场景
上班族早晨时间紧张，常常：
- 来不及准备早餐，随便吃点零食或直接空腹上班
- 想吃得健康但不知道做什么
- 食材有限，需要根据家里现有的东西推荐
- 收藏喜欢的食谱，方便重复使用
痛点
1. 时间紧迫：早上只有 5~15 分钟准备时间。
2. 选择困难：面对众多食谱无从下手。
3. 食材限制：需要根据现有食材推荐。
4. 缺乏记录：喜欢的食谱容易忘记，下次还得重新搜索。
2. 核心逻辑讲解
1. 输入条件
- 可用时间（5/10/15 分钟）
- 可选输入现有食材（后续可扩展）
2. 食谱筛选
- 根据时间筛选匹配的食谱
3. 随机推荐
- 从符合条件的食谱中随机推荐一款，避免单调
4. 详细步骤展示
- 显示食材清单与制作步骤
5. 收藏功能
- 可将喜欢的食谱保存到本地 JSON 文件
6. 模块化设计
- 分离数据、推荐逻辑、收藏管理、界面交互
3. 项目结构
breakfast_recommender/
├── main.py # 主程序入口
├── recipes.py # 食谱数据与筛选逻辑
├── favorites.py # 收藏管理
├── data/
│ ├── recipes.json # 食谱数据库
│ └── favorites.json # 收藏列表
├── README.md
└── USAGE.md
4. 核心代码
"recipes.py"
import json
import random
RECIPES_FILE = "data/recipes.json"
class RecipeRecommender:
def __init__(self):
with open(RECIPES_FILE, "r", encoding="utf-8") as f:
self.recipes = json.load(f)
def recommend(self, max_time):
candidates = [r for r in self.recipes if r["time"] <= max_time]
if not candidates:
return None
return random.choice(candidates)
"favorites.py"
import json
import os
FAVORITES_FILE = "data/favorites.json"
class FavoriteManager:
def __init__(self):
os.makedirs("data", exist_ok=True)
try:
with open(FAVORITES_FILE, "r", encoding="utf-8") as f:
self.favs = json.load(f)
except FileNotFoundError:
self.favs = []
def add(self, recipe):
if recipe not in self.favs:
self.favs.append(recipe)
self.save()
def save(self):
with open(FAVORITES_FILE, "w", encoding="utf-8") as f:
json.dump(self.favs, f, ensure_ascii=False, indent=4)
def list_favorites(self):
return self.favs
"main.py"
from recipes import RecipeRecommender
from favorites import FavoriteManager
def print_recipe(recipe):
print(f"\n🍳 {recipe['name']} ({recipe['time']}分钟)")
print("食材:", ", ".join(recipe["ingredients"]))
print("步骤:")
for i, step in enumerate(recipe["steps"], 1):
print(f" {i}. {step}")
def main():
recommender = RecipeRecommender()
fav_manager = FavoriteManager()
while True:
print("\n=== 早餐食谱推荐工具 ===")
print("1. 推荐早餐")
print("2. 查看收藏")
print("0. 退出")
choice = input("请选择: ").strip()
if choice == "1":
time_map = {"1": 5, "2": 10, "3": 15}
print("选择可用时间: 1)5分钟 2)10分钟 3)15分钟")
t_choice = input("> ").strip()
max_time = time_map.get(t_choice, 10)
recipe = recommender.recommend(max_time)
if recipe:
print_recipe(recipe)
if input("\n收藏此食谱? (y/n): ").lower() == "y":
fav_manager.add(recipe)
print("✅ 已收藏")
else:
print("❌ 无匹配食谱")
elif choice == "2":
favs = fav_manager.list_favorites()
if not favs:
print("暂无收藏")
else:
for r in favs:
print(f"- {r['name']} ({r['time']}分钟)")
elif choice == "0":
break
else:
print("无效选择")
if __name__ == "__main__":
main()
5.
"data/recipes.json" 示例
[
{
"name": "牛奶燕麦粥",
"time": 5,
"ingredients": ["燕麦片", "牛奶"],
"steps": ["锅中加水煮沸", "加入燕麦片煮2分钟", "倒入牛奶搅匀即可"]
},
{
"name": "鸡蛋三明治",
"time": 10,
"ingredients": ["面包", "鸡蛋", "生菜"],
"steps": ["煎蛋", "面包烤热", "夹入鸡蛋和生菜"]
},
{
"name": "香蕉酸奶杯",
"time": 5,
"ingredients": ["香蕉", "酸奶"],
"steps": ["香蕉切片", "倒入酸奶拌匀"]
}
]
6. README.md
# 🥣 早餐食谱推荐工具
一个用 Python 编写的 CLI 工具，根据可用时间推荐简单易做的早餐，支持收藏喜欢的食谱。
## 功能
- 按时间（5/10/15分钟）推荐早餐
- 显示食材与详细步骤
- 收藏喜欢的食谱
- 数据持久化（JSON）
## 安装
bash
git clone "https://github.com/yourname/breakfast_recommender.git" (https://github.com/yourname/breakfast_recommender.git)
cd breakfast_recommender
## 运行
bash
python main.py
7. USAGE.md
# 使用说明
1. 运行 `python main.py`。
2. 选择可用时间，获取推荐食谱。
3. 可收藏喜欢的食谱，下次直接查看。
4. 数据保存在 `data/` 目录下。
8. 核心知识点卡片
知识点 说明
JSON 数据持久化 存储食谱与收藏列表
模块化设计 分离数据、逻辑、交互
随机选择 避免推荐单调
条件筛选 根据时间匹配食谱
CLI 交互 简单易用
收藏功能 提升用户体验
9. 总结
这个工具解决了时间紧、选择难、无记录三大痛点，通过条件筛选 + 随机推荐 + 收藏管理，让上班族在几秒钟内获得合适的早餐方案，并可持续积累自己的早餐库。
它适合：
- 个人日常使用
- 合租室友共享
- 扩展为 Web/APP 服务
如果你需要，可以在下一步：
- 增加 食材过滤（根据现有食材推荐）
- 增加 营养标签（高蛋白、低脂等）
- 开发 手机端 GUI（Kivy/Flutter）
利用AI解决实际问题，如果你觉得这个工具好用，欢迎关注长安牧笛！
