苹果maccms10采集模块大改造：从手填到资源站中心一键采

苹果maccms10采集模块大改造：从手填到资源站中心一键采

适用版本：苹果maccms10 v2026.1000.4053 起

老站长都熟悉过去采集的折腾流程：找一个新的资源站 → 验 API → 手动建分类对应关系 → 一个一个配播放器 → 跑采集 → 出问题再回头查……一套下来半小时起步。v2026.1000.4053 把这一套压缩到 3 次点击搞定。

改造前后对比

总耗时从 30 分钟降到 3 分钟。

一、苹果maccms10资源站中心（核心新功能）

入口

后台 → 采集 → 资源站中心（路径 /admin/resourcehub）

页面结构

顶部按 综合推荐 / 影视 / 短剧 / 动漫 / 资讯 / 午夜 / 自定义 分组展示：

云端站点目录：官方维护的资源站列表，含可用性、推荐级别、覆盖分类

本地自定义资源站：你自己加的私有源

每行 9 个按钮，按使用顺序排列：

[验证资源站] [同步分类] [自动分类绑定] [自动播放器配置]

[一键采集] [添加到采集列表] [添加定时任务] [海报推荐] [多站采集]

一键采集详细流程

验证资源站：点击「验证」按钮，系统调 ac=list 接口验通讯

同步分类：成功后点「同步分类」，远端分类全量拉到 mac_type 待绑定

自动分类绑定：核心功能，详见下节

自动播放器配置：扫描资源站视频的 vod_play_from，自动注册缺失的播放器

一键采集：分类已绑定 + 播放器已配，可以直接开采

添加到采集列表：长期采集就保存为采集源配置，下次进采集页直接用

添加定时任务：选周期（2h / 12h / 24h / 48h / 每周 / 全天循环），后台 cron 自动跑

二、自动分类绑定（最 magic 的功能）

这是把远端资源站的分类自动映射到本地分类的功能。三级匹配算法：

第一级：去后缀精确匹配（强规则）

远端「動作片」，本地「動作」——去掉后缀「片/類/劇」后精确匹配上。

后缀清单：片、類/类、劇/剧、電影/电影、連續劇/连续剧...

第二级：同义词词库匹配

通过 application/extra/type_synonyms.php 词库，把繁简、港台、近义词全部归一：

return [

'動作' => ['动作', '動作片', '动作片'],

'喜劇' => ['喜剧', '喜劇片', '喜剧片', '搞笑'],

'科幻' => ['科幻片', '科幻类'],

'愛情' => ['爱情', '愛情片', '爱情片', '言情'],

'懸疑' => ['悬疑', '懸疑片', '悬疑片', '推理'],

'動漫' => ['动漫', '動畫', '动画', '卡通', '番劇', '番剧'],

'日韓劇' => ['日韩剧', '韓劇', '韩剧', '日劇', '日剧', '韓國劇', '韩国剧'],

// ... 词库内置 20+ 类

];

站长可自行扩展：直接编辑这个文件加新条目，不用改代码、不用升级。

第三级：模糊算法匹配

仍未匹配的，走 mb_substr 重叠度 + Levenshtein 距离，给出置信度分数。只对置信度 > 0.6 的自动建映射，低于阈值的留在「待人工确认」列表。

结果

苹果maccms10页面表格显示三栏：远端分类 → 本地分类 → 置信度 + 来源（精确/同义词/模糊），可以手动改任何一项。确认无误点「保存映射」入库。

三、批量播放器配置

是什么

后台 → 采集 → 批量播放器（/admin/batchplayer）

视频采集进来后，vod_play_from 字段可能是 youku, qiyi, ckm3u8, ckyun 等各种名字。播放器必须先在「播放器配置」里注册过这些名字，前台才能正常解析播放。

老流程每次有新名字就要人工进「播放器」配置页手动建，很容易漏。

新版「批量播放器」一键扫描所有 vod 的 vod_play_from，列出已注册 / 缺失 两栏，缺失的一勾就批量建（用预设模板：m3u8 → HLS 解析、ckyun → CK 解析等）。

四、苹果maccms10批量数据替换

是什么

后台 → 采集 → 批量数据替换（/admin/datareplace）

支持的场景：

替换播放来源名：所有视频数据中 play_from = "ckm3u8" 改成 "m3u8"（资源站升级播放协议后兼容历史数据）

替换播放 URL 域名：旧 CDN 域名换新域名

替换分类：把 type_id = 5 的视频全部改成 type_id = 12（分类合并）

替换字段值：vod_remarks 里把"高清"统一改成"超清"

三模块支持

vod / art / manga 全覆盖。

注意

操作不可撤销，操作前自动备份到 application/data/replace_backup/<timestamp>.json，万一弄错可以从这个文件手动回滚。

五、采集后自动清缓存（修复 #1341）

老 bug

采集进来一批新片，前台首页/分类页仍显示旧缓存，要等缓存过期或手动「清空缓存」按钮——客户体验差。

新行为（3263e5a5）

采集完成后系统自动调一次 mac_cache_clear('all')，清掉：

页面缓存（mac_cache:page:*）

列表缓存（vod_search 相关）

首页推荐缓存

分类卡片缓存

对原本「为了不破缓存所以采集不敢勤」的站长，现在可以放开胆子设 1 小时一次定时采集了。

六、漫画站外入库接口（修复 #1346）

是什么

POST /receive/manga —— 新增的漫画专用站外入库接口，对接漫画资源站（之前只有 vod 有）。

用法

curl -X POST 'https://你的站/receive/manga' \

-d 'data=<json 数据>' \

-d 'token=<接口密码>'

JSON 数据格式遵循 application/data/install/install.sql 里 mac_manga 表的字段。

分类转换

接收端自动应用 application/extra/maccms.php 里 collect.manga.classmap 配置，把外部分类映射到本地分类——和 vod 入库一致的体验。

七、苹果maccms10海报推荐

每次采集会把海报也拉下来，但默认推荐级别为 0（普通）。

海报推荐功能（资源站中心 → 海报推荐按钮）：进海报库，按推荐级别筛选（0/1/2/3），可以批量改推荐级别或一键取消推荐。配合前台首页的「编辑精选」「编辑推荐」位用。

八、多站采集（并行）

资源站中心 → 多站采集按钮：弹出多个浏览框并行采集多个资源站，每个框独立显示进度。适合每日批量更新多个源的站长。

实战流程：新加一个资源站到上线

1. 找到资源站 URL（云端目录 or 自己加）

↓

2. 点「验证」                  ← 5 秒

↓

3. 点「同步分类」              ← 10 秒

↓

4. 点「自动分类绑定」          ← 30 秒（含人工确认低置信度项）

↓

5. 点「自动播放器配置」        ← 10 秒

↓

6. 点「一键采集」              ← 走起

↓

7.（可选）点「添加定时任务」 → 选 12h 一次循环

总耗时约 1 分钟（实操采集时间不算）。

常见问题

Q：自动分类绑定准吗？ A：三级匹配整体准确率约 90% 以上，置信度 < 0.6 的会列出来人工确认，不会乱绑。同义词词库随时可以扩展。

Q：一键采集会不会把垃圾片也采进来？ A：会沿用站点本身的「采集过滤」配置（系统 → 采集参数 → 过滤词 / 过滤分类 / 过滤年份）。先把过滤规则配好再开采。

Q：定时任务能跑多频繁？ A：选项为 2h / 12h / 24h / 48h / 每周 / 全天循环。对资源站友好起见，不建议 < 1h 的频率，会被对方限流。

Q：批量数据替换出错能恢复吗？ A：每次替换前自动备份到 application/data/replace_backup/<timestamp>.json，从这个文件可以手动恢复。建议大批量替换前先全库 mysqldump 备份。

Q：清重复分类是干嘛的？ A：用了几个不同资源站，可能本地建了「動作 / 动作 / 动作片」三个意思一样的分类。资源站中心 → 清理重复分类按钮，会两步式给你：① 预览重复 + 引用量 ② 选保留哪条，自动转移引用 + 删除冗余。操作前自动备份。