一个网页版传统玩具模拟器，模拟竹知了（竹蝉）在弹性绳上旋转发出 ” 哇哇 ” 声的玩法。可独立部署到你自己的 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: 后台提示 ” 无法连接后端服务 ” 怎么办？
- 确认 PHP 已安装：命令行执行
php -v - 确认 Web 服务器能处理
.php文件 - 直接访问
api.php?action=ping测试后端是否正常 - 测试时使用 PHP 内置服务器：
php -S 0.0.0.0:8000
Q: 弹窗设置保存后用户页面没变化？
用户页面通过 PHP 注入设置，刷新页面即可看到最新效果。
Q: 没有 SQLite 能用吗？
可以。系统会自动检测，SQLite 不可用时使用 user_data.json 文件存储，功能完全一致。
Q: 如何重置所有数据？
登录后台 → 修改密码区域 → 点击「重置账号」。这会清除管理员账号和所有弹窗设置。
—
📄 许可
仅供娱乐与学习交流，严禁用于商业用途。
