CRX 极简插件主题 · 使用说明（v1.0.00）

适用宿主：BBS 社区插件（community）。主题只存在于 themes/crx 目录，安装/启用过程会自动生成 plugins/crx/routes.php 路由胶水，不修改任何宿主文件。

1. 环境要求

2. 安装与启用

方式一：后台启用（推荐）

1. 将 themes/crx 完整上传到站点 themes/ 目录。
2. 进入后台 模板主题，找到「CRX 极简插件主题」，点击启用。
3. 启用后自动完成：生成路由胶水、注册后台菜单、同步静态资源、重建前台合并模板。

方式二：命令行注册（保数据）

在项目根目录执行：

php themes/crx/bin/register.php

脚本会安装主题、补齐 plugin 表记录、启用主题（自动停用同宿主其它主题），可重复执行。

⚠️ 首次安装会清空数据：数据库里还没有 crx 记录时，安装钩子会删除社区全部分类、文章及其回复/标签/点赞/收藏等依附数据，让站点从空数据开始。升级或重复安装不会触发该逻辑。启用前请务必备份。

3. 后台设置

启用后，后台 插件列表 → CRX 主题设置（图标入口也位于左侧边栏的齿轮）可维护全部配置。

• 设置页地址：/admin/community_crx/config
• 保存后即时生效，无需清理缓存。

配置分组

左侧菜单示例：

首页|ri-home-4-line|/
综合讨论|ri-chat-3-line|/category/1.html

手动轮播示例（图片地址|标题|描述|链接，描述可留空）：

/static/crx/demo/banner-1.png|豆包 AI 助手|侧边栏 AI 助手|

4. 前台功能

• 首页：顶部轮播、站长推荐、分类区块、左侧固定栏（菜单 + 热门推荐 + 最新收录），整体宽度与 chrome.zzzmh.cn 对齐。
• 详情页：双栏布局（左侧内容 + 右侧软件信息/截图/参数），截图轮播，两个下载入口——推荐下载（本地/光鸭直链优先）与备用下载（直链校验，非直链自动回退主下载）。
• 响应式：覆盖 1400+ / 1200–1399 / 992–1199 / 768–991 / <768 多档断点，移动端隐藏顶部横向导航、保留底部 tabbar。
• 页脚：备案号后自动拼接「页脚链接」配置中的友情链接、网站地图等入口，外链自动 target="_blank"。

下载扣费规则

1. 游客无下载权限，需登录。
2. 普通用户下载时自主选择扣除积分或金币其中一种（默认 10 积分 / 1 金币，可在后台调整，0 表示不扣）。
3. 同一资源同一用户仅扣费一次，重复访问/下载不再扣费。
4. VIP 用户免费直达；管理员（后台会话管理员及拥有后台权限的前台用户）完全豁免扣费。

5. 资源采集

后台一键采集

「CRX 主题设置 → 采集同步」中点击一键采集，按已保存的配置抓取目标站列表与详情，自动创建/更新分类与资源帖子：

• 图标与截图直接引用源站地址，不落本地。
• 安装包先下载到本地，光鸭网盘可用（已安装、已启用、已登录）时上传光鸭并删除本地 zip；光鸭不可用时保留本地 static/sync 作为兜底。
• 同页提供「清空采集」（删除采集入库的 CRX采集 帖子，不影响手动发布内容）与「清空日志」。

命令行 / 定时任务

在项目根目录执行（宝塔请用 PHP 8 可执行文件）：

# 按主题配置同步（默认 1 页）
php themes/crx/bin/sync.php

# 抓 2 页，本次最多处理 12 条
php themes/crx/bin/sync.php --pages=2 --limit=12

# 全量（最多 43 页）
php themes/crx/bin/sync.php --all

# 指定源站
php themes/crx/bin/sync.php --source=https://chrome.zzzmh.cn

# 清空采集数据（交互确认）
php themes/crx/bin/sync.php --clear
php themes/crx/bin/sync.php --clear --force   # 跳过确认，供脚本调用

宝塔「Shell 脚本」定时任务示例（每日执行一次）：

/www/server/php/82/bin/php /www/wwwroot/你的站点目录/themes/crx/bin/sync.php --pages=1

Windows（phpstudy）：

H:\phpstudy_pro\Extensions\php\php8.0.2nts\php.exe H:\phpstudy_pro\WWW\crx123.zz\themes\crx\bin\sync.php --pages=1

采集状态/日志/锁文件写入宿主 runtime/（crxsyncstate.json、crxsynclog.json、crx_sync.lock），无需手工维护。

6. 演示数据

（20 条资源、4 个分类），帖子昵称统一为「CRX演示」，可反复导入/清理：

# 导入演示分类与资源帖子（含本地化的图标/截图/安装包资源）
php themes/crx/bin/demo.php import

# 本地化：下载并补齐演示资源的静态文件与详情信息
php themes/crx/bin/demo.php localize

# 清理：删除演示帖子，无其它帖子的演示分类一并删除
php themes/crx/bin/demo.php clean

7. 常见问题

8. 目录结构

themes/crx/
├── plugin.json              # 主题元信息（名称/版本/作者）
├── theme.json               # 样式与脚本入口
├── CrxPlugin.php            # 主题主类：安装钩子、后台菜单、路由胶水、首页数据、配置 Schema
├── SyncService.php          # 采集服务：列表/详情抓取、去重更新、安装包本地化/光鸭转存、日志
├── controller/
│   ├── admin/               # 后台设置页、保存、一键采集、清空采集/日志
│   └── front/Download.php   # 下载预检与扣费（积分/金币二选一，仅扣一次，管理员与 VIP 免费）
├── view/                    # 首页与全局模板覆写
├── static/                  # 主题样式/脚本与演示资源
├── demo/demo.json           # 演示数据
└── bin/
    ├── register.php         # 保数据注册/启用
    ├── sync.php             # 采集命令行（支持定时任务）
    └── demo.php             # 演示数据导入/清理/本地化

作者：kuakeba.cn