AI助手内容

一、插件简介

AI 助手（aiassistant）面向社区站点，提供 自动回帖、、自动发帖、发帖内容优化、右侧悬浮对话 三类能力。对接兼容 OpenAI 协议的国内大模型 API，支持多服务商配置、知识库增强与调用日志。

适合智能客服、内容润色、新帖引导回复等场景。

• 前台入口：
• 发帖/编辑页「AI 优化」按钮（compose_assets 插槽）
• 右侧悬浮 AI 对话按钮（renderAssets）
• 后台入口：插件列表 → AI助手（/admin/aiassistant）
• 主要接口（伪静态后缀下同）：
• POST /aiassistant/optimize — 前台内容优化
• POST /aiassistant/chat — 悬浮对话
• GET|POST /aiassistant/chatHistory — 对话历史
• POST /admin/aiassistant/optimize — 后台优化

二、核心能力

三、依赖与安装

硬性依赖：

• 社区（community） 插件（plugin.json require）

建议环境：

• 可用的 OpenAI 兼容 API（base_url + api_key + model）
• 悬浮对话扣积分时需社区积分体系
• 自动回帖需配置机器人账号（bot_uid）

安装步骤：

1. 应用中心安装并启用 AI助手
2. 应用中心打开总开关及所需场景开关
3. 进入 AI助手 管理页配置 API 提供商、模型、系统提示词、触发规则
4. 发送测试请求验证连通性
5. 用测试帖验证自动回帖与优化按钮

数据表：

• {prefix}aiassistant_log — 调用日志
• {prefix}aiassistant_kb — 知识库
• {prefix}aiassistant_reply_map — 防重复回复映射

四、应用中心基础配置

路径：应用中心 → AI助手 → 配置（轻量开关；完整配置在独立管理页）

五、后台重点配置

路径：插件列表 → AI助手 → 基本设置

完整配置项（defaultConfigStatic）包括：

其他后台页：

• 调用日志 — /admin/aiassistant/log：查看/删除/清空
• 知识库 — 通过 kbSave / kbDel 维护问答条目
• 测试连接 — POST /admin/aiassistant/test

六、前台用户流程

发帖优化

1. 用户在发帖/编辑页编写内容
2. 点击「AI 优化」，请求 POST /aiassistant/optimize
3. 优化结果写回编辑器，用户确认后发布

悬浮对话

1. 登录且有权使用的用户见右侧悬浮按钮
2. 打开对话窗，输入消息（Enter 发送）
3. 若配置扣积分，每次提问扣除相应积分
4. 积分不足时引导至兑换页（/payment/exchange）

自动回帖（用户无感）

1. 用户在白名单版块发帖或命中规则回帖
2. 系统以机器人身份自动回复
3. @ 助手名称可强制触发（受每日次数限制）

七、后台审核与运维

八、特殊说明

生命周期钩子：

• afterTopicSave($topicId, $isNew) — 新帖触发 AutoReplyService::onNewTopic
• afterReplySave($replyId) — 回帖触发 AutoReplyService::onNewReply

币种流水： aiassistant_chat — AI 助手对话扣费

hookPriority： compose_assets 插槽优先级 200，确保晚于编辑器加载

API 就绪条件（apiReady）： 插件启用 + 有效服务商 + api_key + base_url + 模型名

静态资源： aiassistant.css、aiassistant-editor.js、aiassistant-chat.js、aiassistant-chat.css

九、推荐上线清单

1. 配置至少一个可用的 API 服务商并测试通过
2. 设置 bot_uid 或确认有可用管理员作为机器人
3. 编写 system_prompt，避免编造站内规则
4. 配置版块白名单，避免全站自动回复
5. 设置 @ 强制每日上限与冷却时间
6. 按需开启悬浮对话并设置积分扣费
7. 用测试帖验证优化、自动回复、悬浮对话

十、常见问题

Q：自动回帖不生效？ 检查 API 是否就绪、场景开关、版块/用户组白名单、冷却时间与是否已回复过。

Q：看不到 AI 优化按钮？ 确认「发帖优化按钮」开启且插件总开关开启。

Q：悬浮窗不显示？ 检查「右侧悬浮对话」、用户组权限、是否已登录、API 是否配置完整。

Q：提示积分不足？ 调低 chat_cost_coins 或引导用户充值/兑换积分。

Q：机器人回复了自己发的帖？ 系统会跳过机器人自身触发；检查 bot_uid 是否配置正确。

Q：支持哪些模型？ 凡兼容 OpenAI Chat Completions 协议的接口均可，在后台添加 base_url 与模型名。