一个网页版传统玩具模拟器，模拟竹知了（竹蝉）在弹性绳上旋转发出"哇哇"声的玩法。

可独立部署到你自己的 PHP 服务器上，支持弹窗广告自定义。

## ✨ 功能特性

### 核心玩法
- **手动拖拽**：按住屏幕画圈，竹筒在弹性绳上旋转，转速越快声音越大
- **自动甩**：点击按钮自动匀速旋转
- **甩手机**：移动端支持体感操作（通过设备陀螺仪检测摇晃）
- **真实物理**：模拟重力、弹性绳拉力、空气阻力
- **声音引擎**：首选真实竹知了录音采样，解码失败自动回退到 Web Audio 合成音效

### 皮肤 & 场景
| 皮肤 | 场景 |
|------|------|
| 🎋 竹知了（默认） | ☀️ 白天 |
| 🐷 猪猪侠 | 🌤 中午 |
| 🕷️ 蜘蛛侠 | 🌙 夜间 |

### 弹窗广告系统
点击右上角按钮可弹出自定义弹窗，支持 3 种内容样式：

| 样式 | 说明 |
|------|------|
| **富文本** | 支持 HTML，自由排版文字、图片、链接 |
| **文字+图片** | 广告文字 + 广告图片，可选"一键复制"按钮 |
| **QQ群推广** | 显示加群提示 + QQ群跳转按钮 |

弹窗支持可选二维码展示区域。

### 数据统计
- 右下角显示在线人数、访问量、"哇"声次数等全站实时数据
- 每次甩出竹知了叫声都会计入全球统计

---

## 📦 文件结构

> 上传到你服务器后，目录结构如下：

```
/
├── index.php          # 用户面向的主页面（竹知了玩具 + 弹窗）
├── api.php            # 后端 API（认证 + 设置存取）
├── admin/
│   └── index.html     # 管理后台（配置弹窗内容）
├── user.db            # SQLite 数据库（自动生成，首次设置管理员时创建）
└── user_data.json     # 备用存储（SQLite 不可用时自动切换）
```

---

## 🚀 部署指南

### 环境要求

| 项目 | 要求 |
|------|------|
| PHP | ≥ 7.0（推荐 7.4+） |
| SQLite3 扩展 | 推荐开启（默认开启），不可用时会自动使用 JSON 文件存储 |
| Web 服务器 | Apache / Nginx（需配置 PHP 处理） |
| 目录权限 | `user/` 目录需可写（755 或 777） |
| 浏览器 | 支持 Canvas 2D、Web Audio API 的现代浏览器 |

### 部署步骤

**1. 上传文件**

将 `user/` 目录下所有文件上传到你的 PHP 服务器的任意目录，例如：

```
https://你的域名/                         → 根目录部署
https://你的域名/zhuzhiliao/              → 子目录部署
```

**2. 验证 PHP 是否正常**

浏览器访问：
```
https://你的域名/api.php?action=ping
```

正常应返回类似：
```json
{"ok":true,"storage":"sqlite","php":"8.0.26","sqlite":true,"time":1785750894}
```

**3. 配置后台**

访问管理员后台：
```
https://你的域名/admin/
```

首次打开会进入「创建管理员」页面，设置你的账号和密码。

**4. 自定义弹窗**

登录后台后，可配置：
- 右上角按钮文字
- 弹窗标题和描述
- 弹窗内容样式（富文本 / 文字图片 / QQ群）
- 二维码图片和名称
- 左下角站点链接

**5. 打开用户页面**

配置完成后，访问用户页面即可看到自定义效果：
```
https://你的域名/
```

---

## 🎛️ 后台配置项

### 基本信息

| 配置项 | 说明 | 默认值 |
|--------|------|--------|
| 按钮文字 | 右上角"关于"按钮的文字 | 关于 |
| 弹窗标题 | 弹窗顶部的标题 | 关于小程序 |
| 弹窗副标题 | 标题下方的描述文字 | — |
| 站点链接 | 左下角链接跳转地址 | zhiliao.y1g.cc |
| 链接文字 | 左下角链接显示的文字 | — |

### 弹窗内容（三选一）

**富文本模式**
- 富文本内容：支持 HTML 标签，可插入图片、链接、排版文字

**文字+图片模式**
- 广告文字：展示的文字内容
- 图片链接：广告图片的 URL
- 一键复制开关：开启后用户可一键复制广告文字

**QQ群模式**
- QQ群链接：点击后跳转到 QQ 加群页面

### 二维码（可选）

| 配置项 | 说明 |
|--------|------|
| 二维码图片 | 二维码图片的 URL（留空不显示） |
| 二维码名称 | 二维码下方显示的名称 |

---

## 🔒 安全说明

- 管理员密码使用 SHA-256 + 盐值哈希存储，不会明文保存
- 登录态使用随机 Token，有效期 2 小时
- 弹窗设置接口（GET）公开可读（用户页面需要），写入（POST）需要管理员认证
- 如果不慎忘记密码，可在后台登录页点击「忘记密码」重置（使用安全密钥 `zzl_reset_2024`）

---

## ❓ 常见问题

**Q: 后台提示"无法连接后端服务"怎么办？**

1. 确认 PHP 已安装：命令行执行 `php -v`
2. 确认 Web 服务器能处理 `.php` 文件
3. 直接访问 `api.php?action=ping` 测试后端是否正常
4. 测试时使用 PHP 内置服务器：`php -S 0.0.0.0:8000`

**Q: 弹窗设置保存后用户页面没变化？**

用户页面通过 PHP 注入设置，刷新页面即可看到最新效果。

**Q: 没有 SQLite 能用吗？**

可以。系统会自动检测，SQLite 不可用时使用 `user_data.json` 文件存储，功能完全一致。

**Q: 如何重置所有数据？**

登录后台 → 修改密码区域 → 点击「重置账号」。这会清除管理员账号和所有弹窗设置。

---

## 📄 许可

仅供娱乐与学习交流，严禁用于商业用途。