AI助手内容管理

一、插件简介

AI 助手对接兼容 OpenAI Chat Completions 的国内模型。可在白名单版块自动回帖、按规则回复、定时发帖；发帖/编辑时可一键优化或润色；前台右侧悬浮窗多轮对话。知识库命中后并入提示词。悬浮对话按次扣除积分（名称读取支付中心，未填写时默认「积分」），填 0 不扣费。

二、核心能力

三、依赖与安装

1. 将插件目录置于 plugins/aiassistant/。
2. 在应用中心安装「AI助手」。
3. 安装时创建 aiassistant_log、aiassistant_reply_map、aiassistant_kb 表，注册后台「AI助手」菜单。
4. 硬依赖：社区插件（版块、会员、发帖/回帖钩子、编辑器）。
5. 软依赖：支付中心（积分展示名称）；社区资产（悬浮对话扣积分）。未开支付中心时仍扣积分账户，文案默认「积分」。
6. 需可访问外网的模型 API（Key、兼容 OpenAI 协议的 Base URL）。

四、应用中心基础配置

在应用中心 → AI助手 → 配置，字段来自 configSchema（完整参数在独立管理页）：

五、后台重点配置

菜单「AI助手」/admin/aiassistant 分六个页签。

基本配置

• 总开关、机器人 UID（前台用户；留空则用管理员账号发回帖）
• 系统提示词、内容优化提示词、悬浮对话提示词（留空则用系统提示词）
• 每次对话消耗积分、max_tokens、temperature、超时秒数

模型配置

添加提供商（可一键国内预设或自定义 Base URL）、填写 Key、选择当前提供商与模型。未配齐时自动回帖、优化、对话均不生效。可用测试提示词验证连通。

触发规则

• 场景：新帖自动回帖、回帖自动回复、发帖/编辑内容优化
• 版块白名单：不勾选不限制版块；勾选后仅这些版块自动回帖
• 用户组白名单：不勾选不限制；勾选后仅这些等级可触发（@ 强制可跳过，受每日次数限制）
• 关键词：每行一个；新帖若配置了关键词须命中；回帖须命中关键词或 @
• @ 强制触发：可被 @ 的名称（每行一个，机器人昵称自动并入）；每用户每天次数；冷却秒数

定时发帖

启用后按版块配置每日上限、每次发帖数、创作提示词。计划任务类型选 Shell，命令为站点根目录下 php plugins/aiassistant/bin/auto_post.php。后台也可手动跑一次。

知识库

维护标题、关键词、正文、排序与启停。对话/回复时按用户输入匹配后并入提示词。

调用日志

查看 auto_topic / auto_reply / optimize / float_chat / test 等调用，可单条删除或清空。

六、前台用户流程

1. 发帖优化：登录后在编辑器点击 AI 优化或润色，提交标题与正文，返回改写结果填入编辑器。
2. 自动回帖：用户发帖/回帖命中规则后，由机器人账号异步回复；同一触发不重复回。
3. @ 助手：正文出现配置的 @名称 可强制触发（可跳过用户组限制，受每日上限与冷却约束）。
4. 悬浮对话：登录且用户组允许时点右侧按钮；每条消息可扣积分，不足时提示兑换；支持近期多轮与历史。

七、后台审核与运维

前台路由

八、特殊说明

• API 就绪：须配置提供商、Key、当前模型，否则自动回帖、优化、悬浮窗均不工作。
• 机器人身份：建议独立前台账号，UID 填入基本配置，并把昵称写入 @ 名称。
• 去重：aiassistant_reply_map 按主题 + 触发表唯一，避免同一帖重复自动回。
• 冷却：cooldown_seconds 同时约束自动回帖与悬浮发送（默认 20 秒）。
• 积分流水：类型 aiassistant_chat，备注「AI助手对话」；单位名随支付中心积分名称。
• 多轮上限：悬浮窗最多携带 12 条历史，单条消息最长 2000 字。
• 部分模型：Kimi 等接口固定采样时，后台 temperature 会被忽略。
• 静态资源：社区布局在开启悬浮窗时加载 /static/aiassistant/ 下样式与脚本。

九、推荐上线清单

• 应用中心启用插件，并打开所需场景（优化 / 新帖回帖 / 回帖回复 / 悬浮对话）
• 配置至少一个可用提供商与模型，后台「发送测试」成功
• 填写机器人 UID，核对 @ 名称与机器人昵称
• 按运营需求勾选版块、用户组、关键词；设定 @ 每日上限与冷却
• 需要知识库时先录入启用条目并抽检命中
• 需要定时发帖时开启开关、配版块规则，并添加 Shell 计划任务
• 核对悬浮对话用户组与每次消耗积分；抽检积分不足提示
• 到支付中心确认积分展示名称

十、常见问题

Q：管理页提示 API 未就绪？ 在「模型配置」补全提供商、Key、当前模型，并用测试提示词验证。

Q：发帖后机器人不回？ 检查总开关、新帖/回帖场景、版块与用户组白名单、关键词或 @ 规则、冷却与 @ 每日上限，以及调用日志错误信息。

Q：看不到优化按钮或悬浮窗？ 对应开关须开启，且 API 已就绪。悬浮窗还需登录，且用户组在允许范围内（管理员不受限）。

Q：对话提示积分不足？ 将「每次对话消耗积分」改为 0，或引导用户兑换积分。单位名称以支付中心为准。

Q：@ 了也不回？ 确认已开启 @ 强制触发、名称匹配（含机器人昵称），且当日未达次数上限。

Q：定时发帖不跑？ 须启用定时自动发帖、配置版块规则，并在服务器用 Shell 执行 php plugins/aiassistant/bin/auto_post.php（目录为当前站点根）。

Q：优化不生效但对话可以？ 检查「发帖优化按钮 / 内容优化」场景是否关闭，以及触发规则中的用户组白名单（优化仍受用户组限制）。