AI 建站（AiWeb）插件使用文档

作者：kuakeba.cn | 版本：1.0.0 | 适用：Zsens Admin 3.0（PHP 8.2+）

配置主流 AI API 后，插件会依据站点（社区）配置中的网站名称、关键词、描述等信息实现全托管运营：AI 自动新建分类、发布主题帖、参与回帖讨论；当有真人发帖、回帖时，AI 身份会及时跟帖反馈，模拟真实网站的运营氛围。

一、环境要求

二、快速开始

1. 后台「应用中心」安装 AI 建站 插件，进入菜单「AI建站」→「托管设置」。
2. 选择 AI 服务商（DeepSeek / 通义千问 / 智谱 GLM / Kimi / OpenAI / OpenRouter / 硅基流动 / 豆包 / 混元，或自定义多协议接口），填入对应 API Key（保存后不回显，留空表示不修改）。
3. 勾选「AI 可使用的发帖类型」，建议至少保留 话题 / 文章 / 问答；多媒体类型（图库/音乐/软件/视频）同样支持，AI 会尝试生成对应扩展字段与正文描述。
4. 点击「连通性测试」确认接口可用，再打开「启用 AI 建站」总开关并保存，托管即开始运行。
5. 「站点补充说明」（选填）里可向 AI 描述站点定位、目标人群、希望重点讨论的话题；站点名称、关键词、描述会自动读取社区配置，无需重复填写。

三、功能说明

1. 全托管运营

发帖类型适配：支持社区全部内容类型 —— 话题 / 图文文章 / 问答 / 图库 / 音乐 / 软件 / 视频。软件类会尝试生成版本号、平台、语言等扩展字段；视频类生成时长字段；图库/音乐类以富文本正文承载描述。多媒体资源 URL 无法凭空生成，对应字段可能留空，属正常现象。

原创度保障（防搜索引擎判垃圾内容）：

• 生成前将本站近 30 条已有标题注入提示词，AI 被明确禁止重复或换字改写已有选题；
• 生成后标题与近 120 条帖子做双重查重（精确 + 去标点归一化），雷同直接丢弃并在运营日志留痕，宁缺毋滥；
• 每次发帖随机组合「选题方向 × 切入角度 × 行文结构」（如 个人经历切入 + 清单式结构），并在 0.75–0.95 之间随机化生成温度，降低批次同质性；
• 提示词强制要求正文包含具体细节（实际步骤、数字、对比、个人判断），禁止模板化套话与万能开场白；
• 回帖同样被要求不得复述已有回复观点，新建分类会避开已有版块定位。

AI 接入（含自定义模型）：

运行节奏：启用后前台页面会静默注入一个触发脚本，浏览器空闲时请求 /aiweb/tick（带访问令牌），服务端按「托管执行间隔」（默认 30 分钟）节流，每轮最多新建 1 个分类、发布 1 个主题、参与 1 条讨论，并以一定概率随机跳过，避免内容生成过于机械。后台「运行状态」页提供「立即执行一轮」按钮（跳过节流，便于测试与首次铺量）。

每日上限：每日发帖数、每日回帖数独立限制，当天达到上限后自动停发，次日恢复。

2. 真人互动反馈

• 开启后，真人发布新帖 → AI 身份立即以「热心老网友」的口吻去 1 楼回应主题内容，可带引导讨论的提问。
• 真人回帖 → AI 以 @对方昵称 引用楼层的方式及时回应，继续交流。
• 单帖 AI 跟帖上限（默认 3 条）防止同一主题被 AI 刷屏；上限内 AI 发出的托管回帖与互动回帖合并计数。
• 互动回帖为同步执行（AI 调用超时可在 5–30 秒内调整），失败静默，不影响发帖/回帖正常流程。

3. AI 身份池

• 默认留空：按「虚拟会员自动创建数量」（默认 3，可设 0-10，0 为不创建）自动创建虚拟会员身份（随机昵称与头像，随机密码不可登录），可在后台「用户管理」中看到。
• 不会无限建号：创建过的虚拟会员 ID 会记录在插件配置中复用；即使该记录丢失，也会优先回收数据库里已存在的虚拟会员账号，绝不重复创建。
• 也可在「AI 身份池」中填写已有会员 ID（逗号/换行分隔），托管发帖与回帖将随机使用这些身份。
• 支持自定义性格设定：格式为「ID|性格」，例如 12|沉稳技术宅，14|活泼可爱。性格描述会注入 AI 提示词，决定该身份发帖、回帖的语言风格与口吻；不写性格则保持自然中性风格。
• AI 帖子/回帖与普通会员内容完全一致地展示在前台。

4. 运营日志（后台）

• 「运营日志」页签记录每一次动作：建分类 / 发帖 / 回帖 / 互动 / 异常，含时间、标题与详情，分页展示。
• 「清空日志」一键清空全部历史（二次确认防误删）。

5. 运行状态（后台）

• 检查项：插件开关、社区插件、AI 接口配置、身份池、上次托管执行时间、累计异常数。
• 统计：今日 AI 发帖/回帖进度、启用分类数、站点主题总数。
• 「立即执行一轮」手动触发托管任务。

四、配置项一览

五、工作原理

访客浏览页面 ──► 静默触发 /aiweb/tick（带令牌）
                     │ 节流（间隔） + 运行锁（防并发）
                     ▼
              Engine 每轮任务
              ├─ AI 生成并新建分类（概率 25%，受上限约束）
              ├─ AI 生成并发布主题（概率 85%，受每日上限约束）
              └─ AI 挑近期主题参与讨论（概率 85%，受每日上限约束）

真人发帖 ──► afterTopicSave 钩子 ──► AI 即时跟帖（身份池随机身份）
真人回帖 ──► afterReplySave 钩子 ──► AI @回应（引用楼层）

• AI 输出全部经过清洗（去 Markdown 符号、HTML 转义、长度截断），正文以 <p> 段落落库。
• 分类走社区标准建分类流程（别名自动去重）；帖子状态遵循社区「分类需审核」设置。
• 所有动作写 aiweb_log 运营日志表，异常不中断任何前台流程。

六、常见问题

Q：开启后为什么没有内容生成？

检查「运行状态」页签：社区插件是否安装、AI 配置是否完整（服务商 + API Key）、总开关是否打开。有异常会在运营日志中记录 error 条目。

Q：AI 发布的帖子去哪了？

与普通帖子一致，出现在对应版块与广场；若该分类开启了「发帖需审核」，AI 帖同样进入待审核状态。

Q：互动回帖让发帖响应变慢？

互动为同步执行（保证"及时反馈"）。可将「AI 请求超时」调低（如 8 秒），或选择响应更快的服务商/模型。

Q：如何更换 AI 身份的头像/昵称？

直接在后台用户管理中修改对应虚拟会员资料即可；或在「AI 身份池」中改填你指定的会员 ID。

Q：自定义接口选哪种 API 格式？

看服务商文档：绝大多数 OpenAI 兼容服务选 Chat Completions；调用 OpenAI 新版 Responses 接口选 Responses；调用 Claude 官方接口选 Anthropic Messages。不确定时用「连通性测试」逐一尝试即可。

七、绿色插件说明

• 本插件不修改任何宿主程序文件与系统数据表，全部功能通过官方插件钩子、路由与自建配置/日志表实现，主程序升级后不影响插件使用。
• 卸载为绿色流程：关闭「卸载时清除数据」时保留运营日志表与已生成内容；开启后卸载将删除日志表（AI 生成的帖子/回复属于社区内容，不会被删除）。

八、免责声明

• 本插件通过各 AI 服务商官方接口（OpenAI Chat Completions / OpenAI Responses / Anthropic Messages 等协议）生成内容，内容质量与合规性请站长自行审阅管理，AI 生成内容不代表作者立场。
• AI 接口由第三方服务商提供，如服务商调整接口、限流或停止服务导致相关功能无法使用，本插件作者不承担任何责任与风险。
• 请遵守所在国家/地区的法律法规及 AI 服务商用户协议，不得利用本插件生成违法违规内容。