progect106-1/README.md

# 谁是卧底游戏 - Streamlit Web应用

## 一、团队成员与贡献

<table>
<tr>
<td>姓名</td>
<td>学号</td>
<td>主要贡献（具体分工）</td>
</tr>
<tr>
<td>王子欣</td>
<td>2411020210</td>
<td>(组长)核心逻辑开发、Prompt编写、AI集成</td>
</tr>
<tr>
<td>赵珂蔓</td>
<td>2411020219</td>
<td>前端界面设计、PPT制作、UI优化</td>
</tr>
<tr>
<td>徐晨颖</td>
<td>2411020116</td>
<td>文档撰写、测试与Bug修复、游戏规则设计</td>
</tr>
</table>

## 二、项目简介 & 运行指南

### 简介
这是一个基于Streamlit开发的在线"谁是卧底"游戏，解决了线下多人聚会时难以组织、角色分配不便的痛点。通过AI模拟玩家发言，让单人也能体验多人推理游戏的乐趣。

### 如何运行
1. 安装依赖：`uv sync`
2. 启动应用：`uv run streamlit run app.py`
3. 在浏览器中访问：`http://localhost:8501`

## 三、开发心得

### 1. 选题思考
**为什么做这个？解决了谁的痛苦？**

我选择开发"谁是卧底"游戏，主要是想解决两个实际问题：首先，很多朋友喜欢玩推理类桌游，但线下聚会时间难凑齐，线上平台又缺乏沉浸感；其次，传统AI游戏大多是对抗型，缺少社交推理元素。这个项目让**单人玩家**也能体验到多人推理的乐趣，通过AI模拟不同性格的玩家，创造出丰富的互动体验。

这个项目主要服务于三类用户：一是想一个人练习推理技巧的桌游爱好者；二是想了解"谁是卧底"游戏规则的新手；三是需要团建活动的组织者。我们通过**动漫角色命名**（如熊大、熊二）、**智能发言生成**、**多轮投票机制**等功能，让游戏体验更加真实有趣。

### 2. AI协作体验

#### 2.1 初体验
第一次用AI写代码的感觉既兴奋又忐忑。兴奋的是，AI能快速生成基础框架，省去了很多重复性工作；忐忑的是，需要不断调整prompt才能得到想要的结果。最大的感受是：**AI不是取代程序员，而是变成了一个"超级实习生"**——能快速完成任务，但需要明确的指令和监督。

#### 2.2 Prompt交互

**最牛的Prompt：**