女声优猜谜小游戏

初心为2026西电晒你祭预热打造的趣味声优猜谜互动小游戏，轻松上手、玩法丰富，适合现场互动与线下娱乐。

---

项目介绍

本项目是一款基于本地图片资源的女声优猜谜桌面小游戏，以趣味答题形式帮助大家熟悉声优角色，为西电晒你祭活动预热。 游戏通过本地文件夹管理声优资源，无需联网，打开即用，支持多企划混合答题、两种题型交替、计时挑战、XD惩罚模式等特色玩法。

---

核心内容

• 主程序：趣味猜女声优器，完整游戏交互界面
• 辅助脚本1：声优图鉴导出工具，一键生成带图片的Excel统计表
• 辅助脚本2：文件夹批量重命名工具，统一管理声优资源编号
• 资源结构：按「企划文件夹 → 编号-声优名文件夹 → 图片」组织

---

游戏玩法

基础流程

1. 选择要挑战的声优企划（支持Ctrl多选）
2. 开启/关闭XD模式，开始游戏
3. 系统随机出题，共12题，每题10分，满分120分
4. 答题结束自动结算分数与用时

两种题型交替

1. 看图选名字：给出声优图片，从4个名字中选择正确答案
2. 看名字选图：给出声优名字，从4张图片中选择正确答案

特色机制

• 真随机出题：每轮正确答案声优不重复，避免重复答题
• 键盘快捷答题：支持按1/2/3/4键快速选择
• 实时计时：记录总答题用时，挑战速度与正确率
• 自动图片校验：自动过滤损坏图片，稳定运行

---

游戏模式

普通模式

正常答题计分，答对得分，答错不扣分，结束展示总分与用时。

XD模式（挑战模式）

• 开启后，若正确率低于50%，最终分数直接归零
• 高风险高刺激，适合现场挑战与节目效果
• 界面红色醒目提示，增强仪式感

---

项目特点

✅ 开箱即用：无需配置环境，双击运行即可开始游戏
✅ 多企划支持：可同时选择多个声优企划混合答题
✅ 界面友好：python自带的UI库Tkinter实现的可视化窗口，图片清晰、操作简单
✅ 资源自由：本地图片管理，可自行添加/删除声优与企划
✅ 轻量化：无依赖冗余，运行流畅，适合现场投影互动
✅ 专属预热：为2026西电晒你祭定制，校园氛围拉满

---

辅助工具

1. 声优图鉴导出工具（num_nsy.py）

• 一键遍历所有企划文件夹
• 自动生成带清晰头像的Excel统计表
• 按编号排序，方便查看与整理声优资源

2. 批量重命名工具（shuffle_num_nsy.py）

• 统一声优文件夹为「XXX（数字编号）-声优名」格式
• 自动去重、排序，规范资源目录
• 预览修改后再执行，安全不翻车

---

开始：按规范准备声优图片文件夹

（总文件夹命名为assets可以直接运行，里面只有少量文件，目前已经整理好的nsy图片合集请从这里下载：jyajya）

游戏资源按以下结构存放，自动识别加载：

RandomNsyGame/
└─ assets/
   ├─ 企划文件夹1/
   │  ├─ 001-声优A/
   │  │  ├─ 图片1.jpg
   │  │  └─ 图片2.png
   │  └─ 002-声优B/
   │     └─ 图片文件...
   └─ 企划文件夹2/
      └─ ...

支持的图片格式包括 .jpg、.jpeg、.png、.gif、.webp、.avif。

使用说明

1. 配置环境并启动

python -m venv .venv #创建虚拟环境
source .venv/bin/activate #激活虚拟环境（仅供参考，具体请结合你的操作系统和shell类型）
pip install -r requirements.txt #安装依赖
python main.py #启动！

2. 可选：用重命名工具规范目录、用导出工具生成图鉴
3. 选择企划、开启模式，开始趣味答题

---

网页版

在保留原版桌面程序（main.py，Tkinter）全部玩法与逻辑的基础上，额外提供一套本地网页版： Flask 后端 + 原生 HTML/CSS/JS 前端

与桌面版完全一致的功能

• 多企划多选、XD 模式（正确率低于 50% 得分归零）
• 共 12 题、每题 10 分、满分 120 分
• 两种题型交替：看名字选图 / 看图选名字
• 每轮正确答案声优绝不重复
• 实时计时、键盘 1/2/3/4 快捷作答、自动校验损坏图片
• 图片统一缩放白底填充（300x300）

网页版文件结构

web_app.py              # Flask 后端（出题/判题/计时/结算/图片服务）
web/
  ├─ index.html         # 页面结构（选择页 / 答题页 / 弹窗）
  ├─ style.css          # 样式
  └─ app.js             # 前端逻辑（渲染、计时、键盘、交互）
requirements-web.txt    # 网页版依赖
启动网页版.bat           # Windows 一键启动脚本
start.sh                #Linux/macOS一键启动脚本

运行网页版

pip install -r requirements-web.txt   # 安装 Flask、waitress 等网页版依赖
python web_app.py                     # 启动！浏览器会自动打开 http://127.0.0.1:5000

• 服务器统一使用 waitress（纯 Python 多线程 WSGI 服务器），支持多人同时在线游玩，不会出现并发卡死 / 400。
• 统一监听 0.0.0.0:5000：本机、局域网、服务器均可直接访问，无需额外设置环境变量。

  python web_app.py

Windows 用户也可直接双击 启动网页版.bat 一键启动。 Linux/macOS用户可以使用bash start.sh一键启动（激活虚拟环境+启动服务器）

提示：桌面版（python main.py）与网页版互不影响，可同时保留、按需运行。

---

西电晒你祭预热 · 女声优猜谜小游戏