进化之路插件（Evolve）使用说明

版本：1.0.4 ｜ 作者：kuakeba.cn ｜ 适用宿主：Zsens Admin（社区版）

把 Evolve 放置类文字游戏移植到 ZsAdmin 的插件：从原始汤里的一个细胞开始，一路进化到星际帝国。游戏本体为纯前端 SPA，存档保存在玩家浏览器 localStorage，不占用任何服务器资源、不写数据库。

游戏本体上游项目：pmotschmann/Evolve（MPL-2.0）；

一、功能概览

• 完整游戏体验：原始汤 → 单细胞 → 多细胞 → 文明 → 太空 → 星际，完整的进化/建造/科研/重置玩法
• 简体中文界面：内置上游官方汉化包（strings.zh-CN.json），默认简中，玩家可在游戏内「设置」切换 12 种语言
• 独立前台页面：/evolve 打开游戏，不影响站点其它页面
• 首页接管（可选）：开启后站点首页 / 直接显示游戏
• 仅登录可见（可选）：开启后未登录访问游戏页会跳转登录页；关闭则任何人可玩
• 自动模式（可选）：加载社区「释放双手」自动游玩脚本，仅建议在单独测试环境开启
• 本地存档：进度存在浏览器 localStorage（键名 evolved），换设备/清缓存即丢失，属预期行为
• 后台管理页：状态总览、静态资源自检、一键重建静态资源

二、运行环境

• PHP 8.0+（本机 8.0.2 实测可用）
• ZsAdmin / Zsens Admin 宿主，前台已启用路由
• 玩家浏览器需支持 Worker 与 localStorage（现代浏览器均满足）

三、安装

1. 把 plugins/Evolve 目录整体上传到项目 plugins/ 下。
2. 后台「应用中心 → 进化之路 → 安装」。
3. 安装时自动把插件包 static/ 拷贝到 public/static/Evolve/，并注册后台菜单「进化之路」。

卸载会移除已部署的静态资源并注销菜单，请先确认无玩家依赖（本插件无服务端数据，卸载不影响站点数据）。

更新插件后如资源路径有变化，可在后台菜单「进化之路 → 重建静态资源」手动重新部署。

四、配置项

后台「应用中心 → 进化之路 → 配置」：

五、游戏地址

• 前台游戏：/evolve（如 http://admin.zz/evolve）
• 后台管理：/admin/evolve（应用中心 → 进化之路）

六、玩法提示

• 早期「原始汤」阶段没有自动收入，需要点击右侧「进化」选项卡里的 RNA 按钮手动采集 RNA，用 RNA 逐步解锁 DNA、细胞膜、细胞器、细胞核等。
• 解锁「细胞器」后 RNA 才会随主循环自动增长。
• 时间/天数在真正进入「城市」阶段（calendar.day > 0）后才开始推进，原始汤阶段显示 0 属正常。
• 如需重置进度：游戏内「设置 → 重置」；或清除浏览器该站点数据。

七、移植适配说明

• 原本依赖 Z-Blog 的 zbp 全局与首页过滤器，改为 ZsAdmin 前台路由 /evolve。
• 游戏资源路径由 zbp.options.bloghost + "zb_users/plugin/evolve/static/..." 改写为 /static/Evolve/。
• 默认语言由英文改为简体中文。
• main.js 中 midLoop（构建队列自适应高度）对 #buildQueue 缺失时的访问做了防御（填充默认高度对象），避免极端时序下 Cannot read properties of undefined (reading 'scrollHeight') 崩溃。除此之外未改动游戏逻辑。

八、目录结构

plugins/Evolve/
├── EvolvePlugin.php          # 插件主类（配置 / 菜单 / 静态资源部署）
├── routes.php                # 前台 /evolve、后台 /admin/evolve 路由
├── plugin.json               # 插件元信息
├── icon.png / icon.svg       # 插件图标
├── controller/
│   ├── Game.php              # 前台游戏页（输出完整 HTML 壳）
│   └── admin/                # 后台：Base 基类 + Index 状态总览/重建/自检
├── view/admin/index.html     # 后台页面模板
└── static/                   # 游戏静态资源（安装时拷贝到 public/static/Evolve/）
    ├── evolve/               # main.js（游戏主程序 2.2MB）、evolve.css、evolve.js（循环 Worker）
    ├── lib/                  # jQuery / Vue / Buefy / Prism / Chart.js / LZString 等
    ├── strings/              # 多语言包（含 strings.zh-CN.json 简中汉化）
    ├── font/                 # 天气图标字体
    └── wiki/                 # 内置 Wiki

九、版权与致谢

• 游戏本体：Evolve，© pmotschmann，MPL-2.0，见 static/LICENSE
• Z-BlogPHP 移植版：豫唐网络
• ZsAdmin 适配：kuakeba.cn

更新记录

1.0.4

• 修复：midLoop 构建队列高度计算在 #buildQueue 缺失时的崩溃（scrollHeight 读取报错），恢复主循环稳定运行
• 移除全部临时调试代码，仅保留最小防御补丁
• 确认游戏可玩：点击 RNA 采集、DNA/细胞膜等解锁、UI 随主循环正常刷新

1.0.0

• 首个版本：从 Z-BlogPHP 版 Evolve 插件移植到 ZsAdmin，含简中汉化、后台管理页与静态资源自检