# OneFile-Quiz

**Repository Path**: TimVanX/OneFile-Quiz

## Basic Information

- **Project Name**: OneFile-Quiz
- **Description**: 极简答题引擎。一个文件，零依赖，直接双击运行！专为线下活动、科普宣传、亲子互动打造的 H5 答题闯关小游戏模板。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-24
- **Last Updated**: 2026-05-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 答题, 活动, 闯关小游戏

## README

<div align="center">
  <h1>🕹️ OneFile-Quiz (极简答题引擎)</h1>
  <p>一个文件，零依赖，直接双击运行！专为线下活动、科普宣传、亲子互动打造的 H5 答题闯关小游戏模板。</p>
  
  <p align="center">
    <img src="pic/1.png" width="400" alt="首页截图" />
    <img src="pic/2.png" width="400" alt="答题截图" />
  </p>
  
  [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
  [![HTML5](https://img.shields.io/badge/HTML5-Strict-orange.svg)]()
  [![Zero Dependency](https://img.shields.io/badge/Dependencies-0-brightgreen.svg)]()
</div>

---

## ✨ 为什么选择它？

很多时候，我们只需要一个**简单、好用、能扫码就玩**的答题页面（比如：社区普法、公司年会、防诈骗宣传），却要面对复杂的 Node.js 环境、Vue/React 编译和繁琐的部署。

**OneFile-Quiz 彻底打破了这个痛点：**

- 📦 **真正的单文件**：没有 `package.json`，没有 `node_modules`，没有跨域报错，只有 1 个纯粹的 `index.html`。
- 🚀 **0 成本部署**：双击就能在本地跑！丢到任何静态服务器、CDN、OSS 甚至 GitHub/Gitee Pages 就能对外发布。
- 🎨 **1 分钟换皮**：只需修改文件开头的 JSON 配置，立刻变成你的专属答题游戏。
- 🎮 **街机级体验**：内置 8-bit 复古音效、连击特效、倒计时进度条、动态称号结算，让答题不再枯燥。
- 🛠 **自带后台**：首页长按左上角标题 1 秒，可呼出隐藏的“工作人员面板”，随时修改限时和题数！

## 🚀 10秒快速上手

1. **获取文件**：直接下载本仓库的 `index.html`。
2. **修改配置**：用任意文本编辑器（记事本 / VSCode）打开它，找到大约第 1670 行的 `GAME_CONFIG`。
3. **替换文案**：修改里面的题目、解析和界面文案。
4. **大功告成**：保存后双击浏览器打开，或者传到你的服务器上生成二维码让大家扫码游玩！

## ⚙️ 配置说明 (GAME_CONFIG)

只需修改 `index.html` 中的 `GAME_CONFIG` 对象：

### 1. `ui` 配置项 (界面文案)
- `pageTitle`: 网页标签栏标题
- `brandName`: 首页左上角的品牌/项目名称
- `eventName`: 首页大标题上方的小字（如活动名称）
- `mainTitle`: 首页主标题
- `subTitle`: 首页主标题下方的活动简介
- `questionText`: 答题界面的核心提问文案（如 "这个做法，对不对？"）
- `allowLabel` / `denyLabel`: 正确与错误按钮的显示文案
- `stampNote`: 结果页的核销/盖章提示

### 2. `titleRules` 配置项 (称号规则)
包含不同得分率的称号判定，`threshold` 为答对率阈值（如 `0.86` 代表 86% 以上）。系统会从上到下匹配第一个符合的规则。

### 3. `questions` 配置项 (题库)
题库为 JSON 数组，系统会默认打乱顺序并在每轮中抽取指定数量的题目。
- `scenario`: 题干/场景描述
- `tag`: 题目分类标签（如 "网络安全"）
- `isCorrect`: `true` 表示该做法正确（应选肯定项），`false` 表示错误（应选否定项）
- `tip`: 答题后的科普解析提示

## 💡 隐藏彩蛋与控制台

- **玩家设置**：点击右上角的 `⚙️ 设置` 按钮，可以随时开启/关闭背景音乐，并查看本机历史最高分与累计体验次数。
- **工作人员设置**：在首页左上角的 `brandName` 品牌标签处，**长按鼠标（或手指长按屏幕）约 1 秒**，即可呼出隐藏的工作人员设置面板。可以实时修改：
  - 本轮题目数量（支持 6题 ~ 20题）
  - 每题限时（支持 6秒 ~ 20秒）

## 📄 开源协议

本项目基于 **MIT License** 开源。
**“压根不在乎版权”** —— 你可以随意修改、商用、二次分发，无需经过任何授权，甚至不需要保留原作者署名。希望这个小工具能帮到你，让你的活动更加出彩！🌟