苹果 maccms10 超棒AI 套件实战：用 AI 把视频站的内容、SEO、运营全包了
适用版本：maccms10 v2026.1000.4053 起
中小站长普遍没有内容运营团队，每天采集来一堆视频，标题千篇一律、简介靠脑补、关键词随手填——后果是搜索引擎抓不到、用户搜不到、广告位空着没人点。v2026.1000.4053 把 5 个 AI 能力一次性补齐，让一个人也能把内容运营做出团队的效果。
套件总览
| 模块 | 入口 | 解决的问题 |
|---|---|---|
| AI SEO 元数据生成 | 系统 → AI SEO | 自动写标题、关键词、描述（单条/批量/采集时自动） |
| UEditorPlus + AI 后端代理 | 编辑器右上角 AI 按钮 | 编辑器内一键润色、扩写、翻译、改写 |
| 后台管理员 AI 助手 | 系统 → 管理员助手 | 后台不会用的功能直接对话提问 |
| AI 内容助手插件 | 插件 → AI Content Assistant | 批量改写、扩写采集来的简介 |
| AI 搜索 + 聊天问答 | 前台搜索框 → AI 搜索 | 前台用户用自然语言找片，聊天式推荐 |
5 个模块共用同一套大模型配置——填一次 API Key，5 个地方都能用。
一、AI SEO 元数据生成（最常用）
是什么
进入「系统 → AI SEO」页面，开启之后系统会为每条 vod/art/manga 自动生成 SEO 三件套：
seo_title：搜索引擎友好的标题
seo_keywords：核心关键词
seo_description：100-200 字 meta description
生成结果存到新表 mac_seo_ai_result，按 (seo_mid, seo_obj_id) 唯一索引，重复生成会跳过（除非内容 hash 变了）。
3 种用法
单条手动生成：vod 详情页右上角「AI 生成 SEO」按钮，秒级返回。
**批量生成（提交 b5ded6ae）：列表页顶部「批量 AI SEO」按钮，弹窗显示进度条（已处理 / 失败 / 跳过），支持随时取消。**建议勾选「跳过已有结果」避免重复消耗 token。
苹果 maccms10 采集时自动：系统 → AI SEO → 开启「采集后自动生成」。新片入库时同步生成，无人工介入。
提供商配置
支持任意 OpenAI 兼容接口：
提供商：OpenAI / DeepSeek / Moonshot / 通义千问 / 自建服务
Base URL：api.openai.com/v1 ← 自建/中转可改
Model：gpt-4o-mini / deepseek-chat / qwen-turbo / ...
API Key：sk-xxxxxxxxxxxx
提示词模板可在配置页改，默认模板已根据视频站场景调优。
成本控制
内置 token 限流：单次请求 max_tokens 默认 800，可调
跳过已有结果：批量生成默认开启，重复跑也不烧钱
失败重试：网络抖动自动重试 2 次，仍失败标记 seo_status=2 不阻 塞
二、UEditorPlus + AI 后端代理
是什么
vod / art 后台编辑长简介时，编辑器右上角多了一个「AI」按钮，下拉菜单：
润色（修语病）
扩写（短简介补到 200 字）
翻译（中→英 / 英→中）
改写（同义不同表达，规避采集源重复内容降权）
自定义指令（"用更口语化的口吻重写一遍"）
调用走服务端代理——前端不直接调 OpenAI，避免 API Key 暴露在浏览器，也方便统一计费、限流、审计。
配置入口
系统 → AI 编辑器代理 → 启用 + 配置上游。配置项与 AI SEO 复用（默认走同一套）。
CSRF 保护
考虑到 UEditor 表单提交特殊性，AI 代理路径 upload/ueditorai 已在 CsrfGuard 里硬豁免——但加了独立的 Token + IP 限流机制* （UeditorAiCsrf + SlidingWindowIpLimiter），后台未登录用户调不通。
三、后台管理员 AI 助手
是什么
后台右下角有个浮动 AI 图标，点开就能聊：
Q：怎么把采集来的视频自动绑定到「短剧」分类？ A：进入「采集 → 资源站中心」→ 选你的资源站 → 点「自动分类绑定」，系统会通过三级匹配（精确名→同义词词库→模糊算法）把远端分类映射到本地……
知识库放在 application/data/admin_assistant/*.md，24 篇文档，从基础参数到 SEO、AI、菜单全覆盖。可以理解为「内置的后台说明书 + 智能搜索」。
适合谁
新接手 CMS 不知道按钮在哪的运维
老站长升级后想知道新功能在哪
找不到「关闭注册」开关、想搜「广告位怎么配」的纯小白
苹果 maccms10 知识库可以自己扩展——直接往 application/data/admin_assistant/ 加 .md 文件，系统下次重启自动索引。
四、AI 内容助手插件
是什么
addons/aicontent/ 独立插件，定位是批量内容改造工厂：
选一批 vod_id（或全选某分类）
选改造动作（改写 / 扩写 / 翻译 / 加 emoji / 去广告水印）
选目标字段（vod_blurb / vod_content）
配置模型、提示词
跑批，进度条 + 失败重试
适合「采集来 1 万条简介都长一样、想批量改写规避降权」的场景。
模型支持
不止 OpenAI 兼容——这个插件单独实现了多 provider：
service/models/
├── OpenAiModel.php ← OpenAI / DeepSeek / Moonshot / 任意兼容接口
├── ClaudeModel.php ← Anthropic Claude
└── GeminiModel.php ← Google Gemini
可以根据成本/质量灵活切换：批量任务用 DeepSeek、关键页面用 Claude。
PHP 7.0 兼容
a7ad442e 已修复 PHP 7.0 兼容性，不会因为 8.0+ 语法在老主机崩。
五、AI 搜索 + 聊天问答
是什么
苹果 maccms10 前台搜索框旁多了一个「AI 搜索」入口（提交 60ca8e10 模板对接 + d65431dd 核心实现）：
用户输入「最近有没有什么悬疑剧推荐」→ AI 结合本站索引（Meilisearch 全文 + AI 重排）+ 外部资源（豆瓣/TMDB）给出推荐
用户输入「这部剧讲什么」→ 走 chat 接口，根据 vod_blurb / vod_content 回答
支持外部资源整合（提交 45b82831）——不止你站内的，连豆瓣评分都能聊
路由
/search_hub —— 统一搜索入口，自动判断走传统搜索 or AI 搜索
/ai_chat —— 聊天式搜索
/api.php/search/suggest —— 搜索建议接口（Meilisearch 驱动）
限流
AiChatRateLimit 防止访客刷 token 烧钱：默认 60 秒 / 5 次 / IP，可在 system/configaisearch 调整。
实战流程：一条新片从采集到上线的 AI 全链路
[采集] 资源站中心一键采集
↓
[入库] 系统调 AI SEO 生成 seo_title / keywords / description（自动）
↓
[编辑] vod 详情页用 UEditor AI 把简介润色一遍（手动 30 秒）
↓
[改写] 批量挑同分类下的旧片，用 AI 内容助手插件批量重写简介（防降权）
↓
[上线] 前台用户用 AI 搜索找到这片
↓
[互动] 看完用 AI 聊天问"还有什么类似的"——继续留在站内
苹果 maccms10 整套流程下来，一个人能干过去 3 个内容编辑的活。
安全 & 成本注意
API Key 只存服务端：所有调用走 PHP 后端代理，前端 HTML/JS 看不到 Key
必装 token 限流：批量任务先小批量试跑 10 条看看耗费再放量
跳过已有结果：所有批量功能都默认开启这个选项，避免重复消耗
降级兜底：AI 调用失败时 SEO 字段留空、不阻塞业务流程，前台依然能展示
审计可查：所有 AI 调用经过审计中间件（如开启），后台「审计日志」里能看每次调用的耗时和入参摘要
常见问题
Q：必须用 OpenAI 吗？ A：不必。任何 OpenAI 兼容接口都行——DeepSeek（最便宜）、Moonshot、通义、自建 ollama 都试过。
Q：AI SEO 是不是会写得很 AI 味、被搜索引擎降权？ A：默认提示词已经做了"避免重复用词、口语化、贴合视频站语境"的调优。担心的话可以改模板，加一句"避免使用'引人入胜''扣人心弦'这类词"。
Q：批量任务跑一半失败怎么办？ A：弹窗会显示「已处理 / 失败 / 跳过」三个计数，失败的可以稍后重跑，跳过已成功的——seo_status 字段会区分。
Q：能完全关掉 AI 套件吗？ A：能。所有 AI 功能都是 opt-in 的，配置不填 API Key 就是关闭状态，零调用零费用。
