# 期末作业

**Repository Path**: song-xiaom/final-assignment

## Basic Information

- **Project Name**: 期末作业
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-25
- **Last Updated**: 2025-12-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 咖啡馆经营模拟游戏

## 游戏介绍
这是一个基于Python的文本交互咖啡馆经营模拟游戏。玩家将扮演一名咖啡馆老板，通过购买原料、制作咖啡、服务顾客来赚取利润，逐步发展自己的咖啡馆事业。

## 游戏特色

### 核心功能
1. **多难度选择**：简单、中等、困难三个难度级别，对应不同的初始资金和游戏节奏
2. **经营决策**：购买原料、制作咖啡、升级设备等多种经营选择
3. **时间管理**：每天有固定的营业时长，需要合理安排时间
4. **顾客系统**：不同类型的顾客有不同的耐心和消费习惯
5. **升级系统**：可以升级咖啡机和服务台，提高效率和顾客满意度
6. **财务管理**：详细记录收入、支出和利润

### 进阶功能
1. **历史记录**：保存每天的经营数据，可随时查看
2. **等级系统**：通过服务顾客获得经验值，提升等级
3. **游戏进度保存**：自动保存游戏进度，可随时加载
4. **详细统计**：提供游戏总览统计信息

## 如何运行游戏

### 环境要求
- Python 3.8 或以上版本

### 运行步骤
1. 确保已安装Python 3.8或以上版本
2. 下载或克隆项目到本地
3. 打开命令行或终端，进入项目目录
4. 运行以下命令启动游戏：

```bash
python cafe_management.py
```

## 游戏玩法

### 主菜单
游戏启动后，您将看到以下主菜单选项：

1. **开始新的一天**：开始当天的营业
2. **查看历史记录**：查看之前每天的经营数据
3. **查看游戏统计**：查看游戏的总览统计信息
4. **保存游戏**：手动保存当前游戏进度
5. **退出游戏**：退出游戏

### 营业中操作
在每天的营业过程中，您可以进行以下操作：

1. **购买原料**：购买制作咖啡所需的原料
2. **制作咖啡**：根据菜单制作咖啡出售
3. **查看菜单**：查看所有可制作的咖啡及其配方
4. **升级设备**：升级咖啡机或服务台
5. **结束当天**：提前结束当天营业

### 游戏目标
- 经营好自己的咖啡馆，赚取尽可能多的利润
- 服务更多的顾客，减少顾客流失
- 提升咖啡馆等级，解锁更多可能性

## 游戏机制

### 难度系统
| 难度 | 初始资金 | 营业时长 | 顾客间隔 | 原料成本倍率 |
|------|----------|----------|----------|--------------|
| 简单 | $1000    | 30分钟   | 2秒      | 1.0          |
| 中等 | $800     | 25分钟   | 1.5秒    | 1.2          |
| 困难 | $500     | 20分钟   | 1.0秒    | 1.5          |

### 咖啡菜单
| 咖啡名称 | 价格 | 配方 | 制作时间 |
|----------|------|------|----------|
| 美式咖啡 | $15  | 咖啡粉×2, 水×10 | 2秒 |
| 拿铁     | $20  | 咖啡粉×2, 牛奶×8 | 3秒 |
| 卡布奇诺 | $22  | 咖啡粉×2, 牛奶×6, 奶泡×3 | 4秒 |
| 摩卡     | $25  | 咖啡粉×2, 牛奶×5, 巧克力×3 | 5秒 |

### 顾客类型
| 顾客类型 | 耐心值 | 小费比例 | 出现概率 |
|----------|--------|----------|----------|
| 普通顾客 | 10     | 10%      | 60%      |
| 匆忙顾客 | 5      | 20%      | 20%      |
| 挑剔顾客 | 8      | 15%      | 15%      |
| VIP顾客  | 15     | 30%      | 5%       |

### 设备升级

#### 咖啡机升级
| 等级 | 升级费用 | 制作速度提升 |
|------|----------|--------------|
| 1    | $500     | 20%          |
| 2    | $1200    | 40%          |
| 3    | $2000    | 60%          |

#### 服务台升级
| 等级 | 升级费用 | 顾客耐心提升 |
|------|----------|--------------|
| 1    | $300     | 2点          |
| 2    | $800     | 4点          |
| 3    | $1500    | 6点          |

## 开发说明

### 核心技术点

1. **变量与数据类型**：使用字典、列表等数据结构存储游戏配置和状态
2. **流程控制**：使用if-elif-else条件判断和while循环实现游戏逻辑
3. **自定义函数**：将游戏功能模块化，提高代码可维护性
4. **模块调用**：使用random、time、json等内置模块实现游戏功能
5. **异常处理**：处理用户输入错误等异常情况
6. **文件操作**：保存和加载游戏进度
7. **字符串/列表操作**：处理游戏界面显示和数据管理
8. **循环控制**：使用break和continue控制游戏流程
9. **字典/集合应用**：管理游戏配置和状态

### 代码结构

- `cafe_management.py`：游戏主文件，包含所有游戏逻辑

### 游戏配置
游戏配置存储在`GAME_CONFIG`字典中，包含以下内容：

- `difficulty_levels`：难度级别配置
- `menu_items`：咖啡菜单配置
- `ingredients`：原料配置
- `customers`：顾客配置
- `upgrades`：设备升级配置

### 游戏数据
游戏数据存储在`CafeGame`类的实例变量中，包括：

- `game_data`：游戏核心数据（金钱、天数、等级等）
- `inventory`：当前库存
- `upgrades`：设备升级状态
- `history`：历史经营记录

## AI工具使用说明

### AI工具名称
本项目使用了AI编程助手辅助开发。

### AI提示词
核心提示词："用Python创建一个咖啡馆经营模拟游戏，包含购买原料、制作咖啡、服务顾客、升级设备等功能，并支持不同难度级别。"

### AI生成代码的修改与优化

1. **初始生成代码**：AI生成了基本的游戏框架和核心功能

2. **修改与优化**：
   - 完善了游戏配置，增加了更多的咖啡种类和顾客类型
   - 优化了游戏界面显示，提高了用户体验
   - 增加了游戏进度保存和加载功能
   - 实现了历史记录和统计功能
   - 优化了异常处理，提高了程序稳定性
   - 增加了详细的中文注释，提高了代码可读性

## 测试说明

### 测试内容
1. **功能测试**：测试游戏的各项功能是否正常工作
2. **边界测试**：测试极端情况下游戏的表现
3. **兼容性测试**：测试在不同Python版本下的运行情况
4. **用户体验测试**：测试游戏的操作流畅度和界面友好性

### 测试结果
- 所有核心功能正常工作
- 边界情况处理良好
- 兼容Python 3.8及以上版本
- 用户体验良好

## 改进方向

1. **图形界面**：增加图形用户界面，提升游戏视觉效果
2. **更多咖啡种类**：添加更多种类的咖啡和饮品
3. **更多设备**：增加更多可升级的设备
4. **营销活动**：添加营销活动功能，吸引更多顾客
5. **员工系统**：可以雇佣员工，提高工作效率
6. **竞争对手**：增加竞争对手，增加游戏挑战性

## 许可证

本项目采用MIT许可证，可自由使用和修改。

## 作者

咖啡馆经营模拟游戏开发团队

---

感谢您选择游玩咖啡馆经营模拟游戏！祝您游戏愉快！