yaoys_ai_post — AI 自动发帖插件

版本：1.0.10 ｜ 适用系统：XIUNOX v1.1+ ｜ 作者：yaoys ｜ 类型：内容自动化插件

简介：基于论坛内置 AI 中台（AIService）的自动发新主题插件——定时或手动触发 AI 生成内容，以指定机器人账号自动发布，支持多种"主题类型"任务模板、自定义提示词、多提供商故障转移，配套完整日志与 Token 消耗统计。

一、功能特性

1. 自动发帖双模式

2. 多种"主题类型"任务模板

每个任务 = 一种主题类型（名称 + 自定义提示词 + 目标版块 + 机器人账号 + 发帖频率），可无限创建。例如：

3. 自定义提示词 + 变量

每个任务独立提示词，系统自动附加"首行标题 + Markdown 正文"的输出格式约束，稳定解析标题与正文。支持变量：

4. 指定机器人账号发布

为每个任务指定一个机器人账号 UID，AI 帖子以该账号身份发布，积分、发帖数、关注者通知均计入该账号，不暴露管理员/触发者身份。

5. 复用系统 AI 中台，多提供商容错

直接复用后台「AI」→「提供商」的 API Key/模型，支持 4 种调用模式：

• failover 故障转移（默认）：按顺序尝试，失败自动切换下一个

• round_robin 轮询：轮流使用，均衡负载

• random 随机

• concurrent 并发竞速：多提供商同时请求，取最快

自带健康检查（失败提供商冷却恢复）、每个提供商重试次数、超时与温度控制。所有调用进入「AI」→「日志」，可用 source=yaoys_ai_post 筛选。

6. 辅助能力

• 标题模板：填写后固定标题（支持变量），AI 只生成正文，如 每日科技资讯 {date}

• 正文长度控制：按字符数截断，防止超长灌水

• Token 消耗统计：今日 / 累计 / 近 7·15·30 天每日明细

• 完整生成日志：标题、正文、提供商、模型、Token、耗时、成功/失败原因、触发来源（cron/manual）

• 后台数据看板：任务数、启用数、累计发帖、成功/失败、Token 趋势

7. 安全设计

• 帖子内容经 xn_html_purify 过滤（防存储型 XSS）

• 附件关联隔离（page_token），不会误关联到触发者上传中的附件

• 机器人帖 IP 统一为 0.0.0.0，不泄露触发者地址

• 后台操作全部 CSRF 校验 + 管理员权限校验

• 定时任务带并发锁 + 时间预算（单次最多处理任务数 / 单次占用秒数），避免刷版与拖慢访问

二、配置方法

第 1 步：安装

1. 后台 →「插件」→ 上传 yaoys_ai_post.zip 安装并启用。

2. 侧边栏出现「AI 发帖」入口（机器人图标）。

第 2 步：配置 AI 提供商（必做）

后台 →「AI」→「提供商」→ 添加并填写至少一个文本类提供商的 API Key 与模型（如 openai / deepseek / glm / kimi / qwen）。本插件复用系统 AI 配置，无需单独填写 Key。

第 3 步：基础设置

侧边栏 →「AI 发帖」→「基础设置」：

第 4 步：新建任务

侧边栏 →「AI 发帖」→「新增任务」：

提示词示例：请写一篇关于人工智能应用落地的资讯帖，面向普通网民，语气专业但不晦涩，篇幅 800-1200 字，分 3-4 个小节，结尾给出实用建议。

第 5 步：验证与发布

• 列表页点「预览」→ 弹层查看 AI 生成的标题与正文（不发布）

• 内容满意后点「立即生成」→ 正式发布，日志区可查看结果

• 开启定时后，系统每 5 分钟自动检查到期任务并发布

三、达成效果

1. 内容供给自动化，更新频率稳定

• 无需人工，按设定频率自动产出并发布新主题，站点保持持续更新；

• 多任务并行，一天可稳定覆盖多个话题方向，不再受运营人手与灵感波动影响。

2. 成本可控、效果可量化

• Token 消耗统计（今日/累计/近 7·15·30 天）让每个任务的成本一目了然；

• 生成日志记录成功率、失败原因、耗时，便于优化提示词与提供商选择；

• 多提供商故障转移保证单点 API 故障不断更。

3. 身份与内容安全可控

• 帖子以机器人账号发布，管理员/运营身份不可被追溯；

• 内容经 HTML 净化，机器人发帖与人工发帖同等安全；

• 后台完整操作审计与生成日志，问题可回溯。

4. 典型收益场景

四、注意事项

1. 定时依赖页面访问（web cron）：站点无访问时不会执行；daily 模式实际发帖时间精确到 5 分钟粒度。

2. 手动「立即生成」为同步请求：AI 生成期间会等待（已放宽执行时限），建议非高峰期使用。

3. 机器人帖绕过论坛审核：自动发布不受机器人用户组「发帖免审」设置影响，帖子直接发布。请为机器人账号规划好内容尺度与目标版块。

4. 卸载影响：卸载会删除任务表、日志表与插件配置，已发布的帖子不会被删除。

5. 成本提示：AI 调用按 Token 计费，建议通过「每次定时最多处理任务数」和「正文长度」控制消耗。

五、更新日志（近期）