Python2025-CourseDesign/GROUP123-LYT
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
1 Commit 1 Branch 0 Tags 86 KiB
HTML 61.1%
Python 38.9%
72bec8db47
Go to file
DROUP123 72bec8db47 feat: 初始化海龟汤游戏项目，包含核心逻辑、前端界面和文档 
- 添加核心游戏逻辑文件structual.py，实现海龟汤游戏基本功能
- 创建HTML前端界面turtle_soup_html.html，提供交互式游戏体验
- 编写详细README.md文档，包含项目介绍、运行指南和贡献说明
- 添加项目配置文件pyproject.toml和环境变量示例
- 实现游戏数据存储功能，使用JSON保存游戏记录
- 包含15个预设海龟汤题目和关键词匹配系统
2026-01-07 15:16:59 +08:00
.env_example copy feat: 初始化海龟汤游戏项目，包含核心逻辑、前端界面和文档 2026-01-07 15:16:59 +08:00
.gitignore feat: 初始化海龟汤游戏项目，包含核心逻辑、前端界面和文档 2026-01-07 15:16:59 +08:00
.python-version feat: 初始化海龟汤游戏项目，包含核心逻辑、前端界面和文档 2026-01-07 15:16:59 +08:00
main.py feat: 初始化海龟汤游戏项目，包含核心逻辑、前端界面和文档 2026-01-07 15:16:59 +08:00
pyproject.toml feat: 初始化海龟汤游戏项目，包含核心逻辑、前端界面和文档 2026-01-07 15:16:59 +08:00
README.md feat: 初始化海龟汤游戏项目，包含核心逻辑、前端界面和文档 2026-01-07 15:16:59 +08:00
structual.py feat: 初始化海龟汤游戏项目，包含核心逻辑、前端界面和文档 2026-01-07 15:16:59 +08:00
test_keyword_fix.py feat: 初始化海龟汤游戏项目，包含核心逻辑、前端界面和文档 2026-01-07 15:16:59 +08:00
turtle_soup_data.json feat: 初始化海龟汤游戏项目，包含核心逻辑、前端界面和文档 2026-01-07 15:16:59 +08:00
turtle_soup_html.html feat: 初始化海龟汤游戏项目，包含核心逻辑、前端界面和文档 2026-01-07 15:16:59 +08:00
uv.lock feat: 初始化海龟汤游戏项目，包含核心逻辑、前端界面和文档 2026-01-07 15:16:59 +08:00

README.md

海龟汤游戏项目

团队成员与贡献

姓名 学号 主要贡献 (具体分工)
张三 2023xxxx (组长) 核心逻辑开发、Prompt 编写
李四 2023xxxx 前端界面设计、HTML版本开发
王五 2023xxxx 文档撰写、测试与Bug修复

项目简介 & 运行指南

简介

这是一个海龟汤游戏项目，提供了一个交互式平台，用户可以通过提问来猜测海龟汤题目的答案。项目包含HTML版本和Python版本，支持15个精心设计的海龟汤题目，包括代孕等主题，具有完善的关键词匹配系统和现代化的用户界面。

如何运行

HTML版本（推荐，无需配置）

  1. 直接在浏览器中打开 turtle_soup_html.html 文件
  2. 点击"新游戏"按钮开始游戏
  3. 在输入框中输入问题，点击"发送"或按Enter键提交
  4. 使用"提示"、"查看答案"或"我来猜测"按钮辅助游戏

Python版本（需要配置）

  1. 安装依赖：

    uv sync

  2. 配置环境变量：

    • 复制 .env_example copy 为 .env
    • 在 .env 文件中填入你的 DeepSeek API Key

  3. 启动游戏：

    uv run python main.py

    或者使用GUI版本：

    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

测试

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 文件了解详情。