🎋 竹知了 · 用户站点

一个网页版传统玩具模拟器，模拟竹知了（竹蝉）在弹性绳上旋转发出"哇哇"声的玩法。可独立部署到你自己的 PHP 服务器上，支持弹窗广告自定义。

✨ 功能特性

核心玩法

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

皮肤 & 场景

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

弹窗广告系统

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

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

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

数据统计

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

---

📦 文件结构

user/
├── 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

正常应返回类似：

{"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: 如何重置所有数据？

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

---

📄 许可

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

测试站：https://zhiliao.y1g.cc/
源码链接：https://pan.quark.cn/s/e14da37c913a