72bec8db47
- 添加核心游戏逻辑文件structual.py，实现海龟汤游戏基本功能 - 创建HTML前端界面turtle_soup_html.html，提供交互式游戏体验 - 编写详细README.md文档，包含项目介绍、运行指南和贡献说明 - 添加项目配置文件pyproject.toml和环境变量示例 - 实现游戏数据存储功能，使用JSON保存游戏记录 - 包含15个预设海龟汤题目和关键词匹配系统
104 lines
3.1 KiB
Markdown
104 lines
3.1 KiB
Markdown
# 海龟汤游戏项目
|
||
|
||
## 团队成员与贡献
|
||
|
||
| 姓名 | 学号 | 主要贡献 (具体分工) |
|
||
| ---- | ---- | ------------------ |
|
||
| 张三 | 2023xxxx | (组长) 核心逻辑开发、Prompt 编写 |
|
||
| 李四 | 2023xxxx | 前端界面设计、HTML版本开发 |
|
||
| 王五 | 2023xxxx | 文档撰写、测试与Bug修复 |
|
||
|
||
## 项目简介 & 运行指南
|
||
|
||
### 简介
|
||
这是一个海龟汤游戏项目，提供了一个交互式平台，用户可以通过提问来猜测海龟汤题目的答案。项目包含HTML版本和Python版本，支持15个精心设计的海龟汤题目，包括代孕等主题，具有完善的关键词匹配系统和现代化的用户界面。
|
||
|
||
### 如何运行
|
||
|
||
#### HTML版本（推荐，无需配置）
|
||
1. 直接在浏览器中打开 `turtle_soup_html.html` 文件
|
||
2. 点击"新游戏"按钮开始游戏
|
||
3. 在输入框中输入问题，点击"发送"或按Enter键提交
|
||
4. 使用"提示"、"查看答案"或"我来猜测"按钮辅助游戏
|
||
|
||
#### Python版本（需要配置）
|
||
1. **安装依赖**：
|
||
```bash
|
||
uv sync
|
||
```
|
||
|
||
2. **配置环境变量**：
|
||
- 复制 `.env_example copy` 为 `.env`
|
||
- 在 `.env` 文件中填入你的 DeepSeek API Key
|
||
|
||
3. **启动游戏**：
|
||
```bash
|
||
uv run python main.py
|
||
```
|
||
|
||
或者使用GUI版本：
|
||
```bash
|
||
uv run python turtle_soup_gui.py
|
||
```
|
||
|
||
### 游戏说明
|
||
|
||
1. **游戏流程**：
|
||
- 点击"新游戏"随机选择一个海龟汤题目
|
||
- 输入问题，系统会根据关键词匹配回答"是"、"否"或"无关"
|
||
- 使用"提示"按钮获取线索
|
||
- 使用"我来猜测"按钮尝试猜测答案
|
||
- 使用"查看答案"按钮直接查看完整答案
|
||
|
||
2. **题目特点**：
|
||
- 包含15个多样化的海龟汤题目
|
||
- 涵盖代孕、犯罪、情感等多种主题
|
||
- 每个题目都有详细的关键词匹配系统
|
||
|
||
3. **技术特点**：
|
||
- HTML版本：纯前端实现，无需依赖，可直接运行
|
||
- Python版本：支持AI生成题目和回答，提供命令行和GUI界面
|
||
- 现代化的响应式设计，支持多种设备
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
├── turtle_soup_html.html # HTML版本游戏
|
||
├── main.py # Python命令行版本
|
||
├── turtle_soup_gui.py # Python GUI版本
|
||
├── structual.py # 核心游戏逻辑
|
||
├── pyproject.toml # 项目配置文件
|
||
├── uv.lock # 依赖锁定文件
|
||
├── .env_example copy # 环境变量示例
|
||
└── README.md # 项目说明文档
|
||
```
|
||
|
||
## 技术栈
|
||
|
||
- **前端**：HTML5, CSS3, JavaScript
|
||
- **后端**：Python 3.13
|
||
- **依赖管理**：uv
|
||
- **AI API**：DeepSeek API
|
||
- **GUI框架**：tkinter
|
||
|
||
## 开发与维护
|
||
|
||
### 开发环境
|
||
- Python 3.13
|
||
- uv >= 0.1.0
|
||
|
||
### 测试
|
||
```bash
|
||
uv run python -m pytest
|
||
```
|
||
|
||
### 贡献指南
|
||
1. Fork 项目
|
||
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
|
||
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
|
||
4. 推送到分支 (`git push origin feature/AmazingFeature`)
|
||
5. 开启 Pull Request
|
||
|
||
## 许可证
|
||
|
||
本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。 |