海龟汤游戏项目

团队成员与贡献

姓名	学号	主要贡献 (具体分工)
徐艺桐	2412131221	(组长) 核心逻辑开发、代码编写、创意提供与整合
陈晓璐	2410511126	前端界面设计、HTML版本开发、撰写心得
尚小雅	2410511127	前期工作台配置、后期测试与Bug修复

项目简介 & 运行指南

简介

这是一个海龟汤游戏项目，提供了一个交互式平台，用户可以通过提问来猜测海龟汤题目的答案。项目包含HTML版本海龟汤和python版本（需配置）也可以直接运行structaul.py游玩文字版，可AI编写也可以自定义海龟汤题目，包括许多主题，具有完善的关键词匹配系统和现代化的用户界面。

开发心得

开发海龟汤推理游戏，解决传统游戏中主持人负担重、体验不均和故事有限等痛点。通过AI担任主持人，玩家可随时游戏，推理爱好者能获得无限新故事。 首次用AI编码时颇为震撼，它快速生成出清晰的状态管理代码，但随后发现其缺乏业务理解，需不断调校提示词。最惊喜的是，在描述“提问匹配逻辑”后，AI不仅实现关键词匹配，还建议加入语义相似度计算。而最挫败的是实现进度保存时，AI反复给出简单方案，忽略隔离、兼容等系统设计问题，甚至有时无法理解我的要求，最终仍需自主重构。它无法前瞻性地考虑未来故事数据结构变更带来的“兼容性”挑战。它给出的往往是教科书式的、孤立的代码块，而非一个考虑了数据流、错误边界和长期演进的稳健系统设计。 这段经历让我反思：AI时代，程序员的核心竞争力正转向问题定义、系统架构与调试能力。AI擅长执行明确指令，但无法替代人类对复杂系统的理解、对用户体验的洞察以及伦理责任的把握。我们不再是单纯的代码实现者，更是人机协作的架构师——善于拆解问题、设计稳健架构，并以创造力和判断力确保最终质量。技术工具会进化，但人类的深度思考与综合判断，始终无可替代。AI不会让程序员失业，但它会重新定义什么才是“优秀”的程序员。那些只会写基础代码的程序员可能会被替代。

如何运行

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. 题目特点：

   • 包含多个多样化的海龟汤题目
   • 涵盖代孕、犯罪、情感等多种主题
   • 每个题目都有详细的关键词匹配系统

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