04 · AI 功能详解
适用版本:ZL-综合插件 2.1.2(2026-10-08 校准) 覆盖内容:AI服务配置、女仆聊天、图片识别、联网搜索、群聊总结、管家模式、Agent 45工具、知识库、技能市场、冷却与额度
⚙️ 一、AI服务页配置(控制台)
控制台左侧「AI服务」页,是所有AI功能的总配置。
基础接入
| 配置项 | 默认值 | 说明 |
|---|---|---|
| 启用AI服务 | 关 | 总开关,不开则所有AI功能静默 |
| API地址 | https://open.bigmodel.cn/api/paas/v4 | OpenAI兼容格式的服务商地址 |
| API Key | 空 | 服务商提供的密钥(必须保存) |
| 模型名称 | glm-4-flash | 聊天用的模型 |
| 🔍 自动识别模型 | 按钮 | 填好地址+Key后,一键拉取该服务商可用模型列表,点击直接选择 |
频控与上下文
| 配置项 | 默认值 | 说明 |
|---|---|---|
| 每日回复上限 | 50次/人/群 | 每个群友每天的AI对话额度(含图片识别),防刷token |
| 聊天冷却时间 | 15秒 | 同一成员同一群两次AI对话的最小间隔,0=不限 |
| 最大回复长度 | 500字 | AI回复超出会被裁剪 |
| 上下文轮数 | 6轮 | AI记住最近几轮对话,越大越连贯但更耗token |
| 总结缓冲条数 | 200条 | 群聊总结默认读取的近期消息量 |
扩展能力
| 配置项 | 默认值 | 说明 |
|---|---|---|
| 🌐 联网搜索 | 关 | 女仆聊天时注入服务商搜索能力(支持:智谱GLM、阿里千问) |
| 🔍 搜索等待提示 | 开 | 联网查询开始时立即提示,查询完成后先撤回提示,再发送答案 |
| 🖼️ 图片识别 | 开 | 群里发图+@机器人 自动识别图片 |
| 视觉模型 | glm-4v-flash | 必须是支持图片输入的多模态模型(智谱免费,推荐) |
三套人设
人设在「分群配置 → 基础配置」里按群选择角色,人设文本在AI服务页自定义(留空用内置默认):
| 角色 | 内置人设 | 特点 |
|---|---|---|
| 🍭 萝莉 | 软萌可爱小女仆,爱用叠词"好的呢""知道啦" | 日常聊天卖萌 |
| 🌸 御姐 | 成熟优雅姐姐,温柔自信从容 | 治愈系聊天 |
| 🎩 管家 | 专业干练群管家,礼貌简洁有分寸 | 大白话执行指令(见下文) |
| 🌹 御姐管家 | 御姐口吻 + 管家办事能力 | 兼顾聊天温度与管理执行 |
页面右上角还有 ❓帮助按钮(紫色圆形问号),点击用系统浏览器打开在线文档站 blog.zxiaolin.com/docs;群内发送 帮助文档 会直接打开 2.1.2 指令大全。
AI状态面板(页面顶部)
实时显示以下状态,配置是否生效一眼可见:
🔌 AI服务接入状态
🧠 当前模型
✅ 连通状态(最近一次请求结果:✅正常 或 ❌具体错误)
🌐 联网搜索状态(三态:❌未开启 ⚠已开启但服务商不支持 ✅服务商名)
🖼️ 图片识别状态(三态:❌未开启 ⚠未配置视觉模型 ✅视觉模型名)
💬 本群AI辅助状态
🎭 当前角色
⌨️ 触发前缀
🕹️ AI控制指令状态
页面底部有「🧪 测试连接」和「🌐 测试联网」按钮,配置完先测一下。
🏪 二、服务商怎么选(附配置示例)
只要支持 OpenAI 兼容协议的服务商都能接:
智谱AI(免费,推荐新手)
DeepSeek
💡 新模型自动适配(1.8.5新增):GLM-5.3-flash 等思考型模型会自动匹配请求参数(自动附加 reasoning_effort、省略不适用的参数),思考消耗不再导致空回复;万一空回复,诊断信息会包含模型类型和 finish_reason 方便排查。
阿里千问
💡 豆包火山方舟等其他 OpenAI 兼容服务商同理:填地址 → 填Key → 自动识别模型 → 选择即可。
💬 三、女仆聊天(@机器人 / #前缀)
触发方式
两种都行;前缀可在「分群配置→基础配置」改。
回复特点
🎭 按当前群的角色人设回复
📏 排版规范内置:信息类回答每行一个信息点+emoji图标、闲聊2~4行、禁Markdown(QQ不渲染);创作类任务(写文案/故事/代码等)完整输出,不强行截断(1.8.5放宽)
🌐 问天气/新闻等时效问题时,若开了联网搜索会自动联网
⏳ 联网开始:群里立即出现“🔍 正在联网搜索中,请稍等…”,查询结束后先撤回提示,再发送最终答案
🆔 身份感知(1.8.5新增):AI知道插件全部功能,并识别提问者身份(主人/插件管理员/群主/群管/普通成员)分级回应,不再答非所问
🧭 2.1.1 修复:问答类提问不再误走联网搜索;联网提示与工具调用提示互斥,不会同时弹出两条重叠提示
未配置AI时
机器人不会装死:@机器人 会提示"AI 服务还没配置好呢~ 请主人在控制台「AI服务」页填好 API 地址和密钥"。
冷却与额度
| 机制 | 规则 |
|---|---|
| ❄️ 冷却 | 同人同群15秒内(默认)第二次AI对话被静默忽略;请求失败自动回滚冷却,可立即重试 |
| 📊 额度 | 每人每天50次(默认),超了回复"女仆今天聊够了,明天再来找我吧~" |
| 🎯 范围 | 冷却覆盖:女仆聊天、联网搜索聊天、图片识别;管家指令和菜单功能不受影响 |
🖼️ 四、图片识别
使用方法
群里发一张图片 + @机器人(可带文字提问):
也可以引用一条文字或图片消息后 @机器人 提问:
2.1.2 起,AI 会同时读取当前消息和被引用消息中的文字、图片。只发“这里面是什么”但没有图片或引用内容时,机器人无法凭空识别。
机制细节
🧠 走视觉模型(默认 glm-4v-flash 免费)
📥 插件自动下载图片转base64提交,绕过图床防盗链
📏 超 8MB 的图片拒绝处理(防卡死)
⏱️ 下载超时 20秒
📸 闪照/拿不到链接的图片 → 提示"拿不到链接,暂时识别不了"
📊 计入每人每日额度 + 冷却
🎭 回复保持女仆人设和排版规范
🧾 引用消息会先解析原消息文字和图片,再与本次问题一起交给模型
🤝 官机群中同样支持;官机事件缺少引用详情时,插件会尝试通过真实群消息映射补全
📝 五、群聊总结
让AI帮你总结这段时间群里聊了什么。
指令
| 写法 | 效果 |
|---|---|
总结 群聊总结 总结一下 / 总结群聊 | 总结全群近期聊天 |
总结@某人 或 总结+QQ | 只总结这个人的发言(定向总结) |
💡 直接发「总结」两个字即可,不需要@机器人(@机器人也能触发,但机器人自己不会被当成总结对象)。
输出模板(2.0.5 起升级为六大板块)
🛡️ 防编造规则:只基于真实聊天记录总结,引用成员原话可轻度润色,但严禁编造群里没发生过的事
每个要点单独一行,以「· 」开头,每条 40 字内;总输出不超过 26 行
成员一律用昵称,禁止用 QQ 号;没有内容的板块会自动省略
AI输出经过后端清洗兜底:自动剥除
**、#、反引号等Markdown符号,QQ里不会出现乱码🤖 AI生成仅供参考
智能补历史
内存缓冲不足时自动调用历史消息接口补充(最多100条)
机器人重启后也能总结(历史从接口拉取)
无发言记录时返回明确提示
历史消息统一转干净文本,图片/表情等显示为占位符
前置条件
AI服务已配置(否则提示去控制台配置)
计入冷却与额度
未授权群不执行
🎩 六、管家模式(大白话执行指令)
角色选「管家」后,群友可以用自然语言让AI直接执行插件指令:
机制
🚪 总门控:AI服务页「允许AI控制指令」开关(默认开)
🏘️ 分群门控:分群配置→基础配置 里可按群单独关闭
🔄 单次AI调用同时完成意图识别+人设聊天(快一倍)
✅ 命中指令后按原指令的回复样式输出(不是女仆腔改写),保持管理指令的严谨格式
❌ 未命中指令 → 走普通管家聊天
💡 2.1.1 起,更强大的口语化执行由 Agent 提供(内置 45 个工具,见第九节),管家模式继续可用。
🕹️ 七、AI相关群内指令
| 指令 | 权限 | 说明 |
|---|---|---|
AI菜单 AI服务 AI辅助 / 聊天女仆 | 无 | 回复AI功能说明子菜单 |
AI状态 | 无 | 查看本群AI服务状态 |
开启AI辅助 / 关闭AI辅助 | 管理员 | 开关本群女仆聊天 |
开启AI控制指令 / 关闭AI控制指令 | 管理员 | 开关本群"AI执行指令"能力 |
总结 / 总结@某人 | 无 | 群聊总结 |
回应表情 | 无 | 查看回应表情设置 |
回应表情+ID 回应表情开 回应表情关 | 管理员 | 更换/开关指令成功贴的表情 |
🛡️ 八、AI功能安全边界(重要)
🔞 未授权群:所有AI功能静默,不会响应
🎫 未绑定/受限状态:AI聊天和图片识别被限制,并提示绑定
❄️ 冷却期内:静默忽略,不刷屏
📊 额度用尽:明确提示明天再来
🚫 黑名单成员:无法触发AI
💰 防滥用:额度+冷却+每日上限三重防护,防止被人刷token
🧩 九、技能市场、我的技能与 Agent
技能市场怎么使用
技能市场中的卡片是插件已经安装的技能。卡片右下角紫色开关表示启用,切换后立即生效,无需再点保存。
群内触发格式:
例如:
群内发送 技能列表 可以查看本群当前能够使用的技能。
💡 支持缩写(2.1.1 新增):技能名可以只写一部分,如「互译晚上好」等同「中英互译 晚上好」;用完整技能名直发时建议带上分隔符(空格/
#/:/:),识别更稳。 💡 自动调用(2.1.1 新增):不记格式也行,直接 @机器人 说「帮我翻译一下晚上好」,Agent 会自动匹配合适的技能执行。 💡 技能市场支持在线安装,技能可导出为.skill文件分享、也可导入安装。
插件同时内置“全能助手”。它不是普通提示词,而是 Agent 的明确入口;2.1.1 起 Agent 内置工具从 15 个扩展到 45 个,覆盖插件全部功能。所有动作仍按发起人的真实权限执行,禁言、踢人等危险操作必须由发起人二次确认。用法示例:全能助手+查看本群的定时任务。
我的技能怎么设置
提示词技能适合翻译、写作、起名、总结等需要 AI 处理的任务:
点击“+ 新建技能”。
填写技能名称、图标、分类、一句话说明和触发词。
类型选择“提示词技能”。
在提示词模板中写清楚角色、任务、输出格式和禁止事项。
点击“保存技能”,然后去技能市场确认开关已经开启。
HTTP 技能适合接入已有接口,不消耗 AI 对话额度:
类型选择“HTTP 技能”。
填写完整的 HTTP/HTTPS 请求地址和 GET/POST 方法。
POST 接口填写 JSON 请求体模板;需要时填写响应取值路径,如
data.text。在页面下方开启“HTTP 技能”,把接口主机名逐行加入域名白名单,只写域名,不写协议和路径。
保存 HTTP 设置,再保存技能。
支持变量:{content} 用户内容、{user} 用户昵称、{group} 群号、{time} 当前时间。
技能编辑规则:自建技能和已经安装的在线技能可直接编辑;内置提示词技能使用“复制编辑”,生成本地副本后再修改,避免插件升级覆盖;全能助手由 Agent 工具注册表维护,只能启停,不能修改其安全边界。
Agent 分群设置规范
Agent 是分群功能,每个群的开关和额度独立保存。
在 Agent 页“配置目标分群”中直接选择群,不必先跳到分群配置页面。
0表示该群不限制 Agent 请求次数;1~999表示每位成员每天在该群可发起的次数。一次用户请求即使内部调用多个工具,也只计 1 次。
点击“保存到所选分群”后,按钮会显示保存状态;切换群会自动回填新群的设置。
Agent 只接管需要查询或操作插件数据的请求;普通聊天、写作、知识查询仍使用原聊天人设链路。
🤖 Agent 2.1.1:45 个内置工具
2.1.1 起 Agent 内置工具从 15 个扩展到 45 个,覆盖插件全部功能,并按发言人身份动态注入:
| 分类 | 工具 |
|---|---|
| 🔍 查询类 | 群成员列表、成员详情、发言统计、邀请统计、签到统计、金币概览、入群审核记录、分群功能开关、问答规则、违禁词、定时任务、黑白名单、聊天记录、加群请求、AI识图 |
| 🛠️ 操作类 | 禁言与解除禁言、踢人、全员禁言、设置群名片、欢迎语、入群审核、黑白名单、问答增删、违禁词增删、定时任务、签到、点赞、戳一戳、酷狗点歌、专属头衔、设置或撤销管理员、金币玩法配置、分群功能开关、撤回机器人消息、处理加群申请 |
| 🧩 调度类 | use_skill 调用任意技能、search_knowledge 检索知识库 |
💬 口语化用法(不用记指令)
@机器人 直接说话即可,AI 自动理解意图并调用对应工具:
⚠️ 危险操作二次确认
踢人、全员禁言、撤回机器人消息、同意/拒绝加群申请、设置/撤销管理员等高危操作,AI 会先发送 ⚠️ 确认话术,回复「确认」后才真正执行,防止误触。
🪪 身份卡与权限注入
Agent 工具按发言人身份动态注入:普通成员看不到管理类工具,管理员才拥有群管工具
AI 手持身份卡,清楚自己与发言人的群主/管理员/成员身份和插件权限
问「群主是谁」「你是不是群主」会按真实身份回答,不再瞎编
📚 知识库(2.1.1 新增)
控制台新增「知识库」页面:管理词条(全局/本群两种范围)、查看命中统计
内置 42 条知识包,覆盖插件功能用法
AI 回答功能用法类问题前强制检索知识库、按原文回答,不再自由发挥
群里直接问「知识库里有什么」可查看词条概览
✨ 回复美化(2.1.1 新增)
所有 AI 回复统一「段落 + emoji + 分隔线┈┈┈┈」排版;名单类内容一行一条,超过 10 条只列前 10 并注明总数,不再刷屏。
✅ 2.1.1 修复:解除禁言不生效、AI 只回复不真执行(必须真调工具才承认完成)、技能缩写识别失败等问题。
在线技能市场怎么搭建
项目根目录提供了可直接修改的 技能市场服务端示例:
部署方法:
在控制台“我的技能”创建技能并导出
.skill,或者复制示例文件修改。把
.skill上传到支持 HTTPS 的静态站点、对象存储或 CDN。在
list.json的skills数组添加技能信息,把downloadUrl改为.skill的公网完整地址。上传
list.json,确认浏览器直接访问时返回 JSON,而不是登录页或网页模板。插件固定从
https://i.zxiaolin.com/skills/list.json加载官方市场,用户不能修改地址。打开“AI中心 → 技能市场”时列表会自动加载;需要主动重试时点击“重新加载”。出现技能卡片后点击“安装技能”。
注意:list.json 能访问不等于技能可以安装。清单中每一项的 downloadUrl 也必须返回 HTTP 200 和真实 .skill JSON;如果返回 404、HTML 页面或登录页,控制台会显示实际失败原因并写入运行日志。
普通自建市场的技能包保持 signature: null。官方签名使用插件内置公钥校验,不能通过填写任意字符串伪造;伪造或被篡改的签名包会被拒绝。