04 · AI 功能详解

适用版本:ZL-综合插件 2.1.2(2026-10-08 校准) 覆盖内容:AI服务配置、女仆聊天、图片识别、联网搜索、群聊总结、管家模式、Agent 45工具、知识库、技能市场、冷却与额度


⚙️ 一、AI服务页配置(控制台)

控制台左侧「AI服务」页,是所有AI功能的总配置。

基础接入

配置项默认值说明
启用AI服务关总开关,不开则所有AI功能静默
API地址https://open.bigmodel.cn/api/paas/v4OpenAI兼容格式的服务商地址
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(免费,推荐新手)

API地址:https://open.bigmodel.cn/api/paas/v4
API Key:在开放平台注册获取
聊天模型:glm-4-flash(免费);glm-5.3-flash 等新模型也已适配(1.8.5)
视觉模型:glm-4v-flash(免费)
联网搜索:✅ 支持

DeepSeek

API地址:https://api.deepseek.com
API Key:sk-开头
聊天模型:deepseek-chat(V3直出,响应快)
⚠️ 避免用 deepseek-reasoner(思考模型,响应慢,群聊体验差)

💡 新模型自动适配(1.8.5新增):GLM-5.3-flash 等思考型模型会自动匹配请求参数(自动附加 reasoning_effort、省略不适用的参数),思考消耗不再导致空回复;万一空回复,诊断信息会包含模型类型和 finish_reason 方便排查。

阿里千问

API地址:https://dashscope.aliyuncs.com/compatible-mode/v1
聊天模型:qwen-turbo / qwen-plus
视觉模型:qwen-vl-plus
联网搜索:✅ 支持

💡 豆包火山方舟等其他 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 起升级为六大板块)

📊 今日概览
· 用一两句话概括今天群里的整体热度和氛围

💬 主要话题
· 话题名:简要内容(按讨论热度排,最多 4 条)

🔥 活跃成员
· 昵称:发言特点或干了什么(最多 4 条)

🎤 金句名场面
· 昵称:「原话或神回复」(最多 3 条,没有可省略)

🌈 氛围风向
· 群内情绪与整体氛围点评(1-2 条)

💡 值得关注
· 未解决的问题、重要信息、约定的事项(最多 3 条,没有可省略)
  • 🛡️ 防编造规则:只基于真实聊天记录总结,引用成员原话可轻度润色,但严禁编造群里没发生过的事

  • 每个要点单独一行,以「· 」开头,每条 40 字内;总输出不超过 26 行

  • 成员一律用昵称,禁止用 QQ 号;没有内容的板块会自动省略

  • AI输出经过后端清洗兜底:自动剥除 **、#、反引号等Markdown符号,QQ里不会出现乱码

  • 🤖 AI生成仅供参考

智能补历史

  • 内存缓冲不足时自动调用历史消息接口补充(最多100条)

  • 机器人重启后也能总结(历史从接口拉取)

  • 无发言记录时返回明确提示

  • 历史消息统一转干净文本,图片/表情等显示为占位符

前置条件

  • AI服务已配置(否则提示去控制台配置)

  • 计入冷却与额度

  • 未授权群不执行


🎩 六、管家模式(大白话执行指令)

角色选「管家」后,群友可以用自然语言让AI直接执行插件指令:

@机器人 看看运行状态        → 自动执行「运行状态」并回复结果
@机器人 把这个群关了吧       → 执行「关闭本群」
@机器人 帮我禁言他10分钟     → 执行禁言指令

机制

  • 🚪 总门控:AI服务页「允许AI控制指令」开关(默认开)

  • 🏘️ 分群门控:分群配置→基础配置 里可按群单独关闭

  • 🔄 单次AI调用同时完成意图识别+人设聊天(快一倍)

  • ✅ 命中指令后按原指令的回复样式输出(不是女仆腔改写),保持管理指令的严谨格式

  • ❌ 未命中指令 → 走普通管家聊天

💡 2.1.1 起,更强大的口语化执行由 Agent 提供(内置 45 个工具,见第九节),管家模式继续可用。


🕹️ 七、AI相关群内指令

指令权限说明
AI菜单 AI服务 AI辅助 / 聊天女仆无回复AI功能说明子菜单
AI状态无查看本群AI服务状态
开启AI辅助 / 关闭AI辅助管理员开关本群女仆聊天
开启AI控制指令 / 关闭AI控制指令管理员开关本群"AI执行指令"能力
总结 / 总结@某人无群聊总结
回应表情无查看回应表情设置
回应表情+ID 回应表情开 回应表情关管理员更换/开关指令成功贴的表情

🛡️ 八、AI功能安全边界(重要)

  1. 🔞 未授权群:所有AI功能静默,不会响应

  2. 🎫 未绑定/受限状态:AI聊天和图片识别被限制,并提示绑定

  3. ❄️ 冷却期内:静默忽略,不刷屏

  4. 📊 额度用尽:明确提示明天再来

  5. 🚫 黑名单成员:无法触发AI

  6. 💰 防滥用:额度+冷却+每日上限三重防护,防止被人刷token


🧩 九、技能市场、我的技能与 Agent

技能市场怎么使用

技能市场中的卡片是插件已经安装的技能。卡片右下角紫色开关表示启用,切换后立即生效,无需再点保存。

群内触发格式:

技能名 内容
技能名+内容
技能名#内容
技能名:内容
@机器人 技能名 内容

例如:

文言文翻译 学而时习之,不亦说乎
文案创作 双十一活动宣传
起名器 科技公司

群内发送 技能列表 可以查看本群当前能够使用的技能。

💡 支持缩写(2.1.1 新增):技能名可以只写一部分,如「互译晚上好」等同「中英互译 晚上好」;用完整技能名直发时建议带上分隔符(空格/#/:/:),识别更稳。 💡 自动调用(2.1.1 新增):不记格式也行,直接 @机器人 说「帮我翻译一下晚上好」,Agent 会自动匹配合适的技能执行。 💡 技能市场支持在线安装,技能可导出为 .skill 文件分享、也可导入安装。

插件同时内置“全能助手”。它不是普通提示词,而是 Agent 的明确入口;2.1.1 起 Agent 内置工具从 15 个扩展到 45 个,覆盖插件全部功能。所有动作仍按发起人的真实权限执行,禁言、踢人等危险操作必须由发起人二次确认。用法示例:全能助手+查看本群的定时任务。

我的技能怎么设置

提示词技能适合翻译、写作、起名、总结等需要 AI 处理的任务:

  1. 点击“+ 新建技能”。

  2. 填写技能名称、图标、分类、一句话说明和触发词。

  3. 类型选择“提示词技能”。

  4. 在提示词模板中写清楚角色、任务、输出格式和禁止事项。

  5. 点击“保存技能”,然后去技能市场确认开关已经开启。

HTTP 技能适合接入已有接口,不消耗 AI 对话额度:

  1. 类型选择“HTTP 技能”。

  2. 填写完整的 HTTP/HTTPS 请求地址和 GET/POST 方法。

  3. POST 接口填写 JSON 请求体模板;需要时填写响应取值路径,如 data.text。

  4. 在页面下方开启“HTTP 技能”,把接口主机名逐行加入域名白名单,只写域名,不写协议和路径。

  5. 保存 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 自动理解意图并调用对应工具:

@机器人 群里都有谁
@机器人 帮我签到
@机器人 来一首晴天
@机器人 赞我
@机器人 戳我一下
@机器人 把@某人 头衔改成lsp
@机器人 把我的名片改成小白
@机器人 有没有人申请进群
@机器人 识别这张图        (配图发送)
@机器人 关闭这个群的点歌功能
@机器人 把xx的禁言解除掉
@机器人 怎么开启内容审核

⚠️ 危险操作二次确认

踢人、全员禁言、撤回机器人消息、同意/拒绝加群申请、设置/撤销管理员等高危操作,AI 会先发送 ⚠️ 确认话术,回复「确认」后才真正执行,防止误触。

🪪 身份卡与权限注入

  • Agent 工具按发言人身份动态注入:普通成员看不到管理类工具,管理员才拥有群管工具

  • AI 手持身份卡,清楚自己与发言人的群主/管理员/成员身份和插件权限

  • 问「群主是谁」「你是不是群主」会按真实身份回答,不再瞎编

📚 知识库(2.1.1 新增)

  • 控制台新增「知识库」页面:管理词条(全局/本群两种范围)、查看命中统计

  • 内置 42 条知识包,覆盖插件功能用法

  • AI 回答功能用法类问题前强制检索知识库、按原文回答,不再自由发挥

  • 群里直接问「知识库里有什么」可查看词条概览

✨ 回复美化(2.1.1 新增)

所有 AI 回复统一「段落 + emoji + 分隔线┈┈┈┈」排版;名单类内容一行一条,超过 10 条只列前 10 并注明总数,不再刷屏。

✅ 2.1.1 修复:解除禁言不生效、AI 只回复不真执行(必须真调工具才承认完成)、技能缩写识别失败等问题。

在线技能市场怎么搭建

项目根目录提供了可直接修改的 技能市场服务端示例:

技能市场服务端示例/
├─ list.json
├─ README.md
└─ packages/
   └─ example-copywriter.skill

部署方法:

  1. 在控制台“我的技能”创建技能并导出 .skill,或者复制示例文件修改。

  2. 把 .skill 上传到支持 HTTPS 的静态站点、对象存储或 CDN。

  3. 在 list.json 的 skills 数组添加技能信息,把 downloadUrl 改为 .skill 的公网完整地址。

  4. 上传 list.json,确认浏览器直接访问时返回 JSON,而不是登录页或网页模板。

  5. 插件固定从 https://i.zxiaolin.com/skills/list.json 加载官方市场,用户不能修改地址。

  6. 打开“AI中心 → 技能市场”时列表会自动加载;需要主动重试时点击“重新加载”。出现技能卡片后点击“安装技能”。

注意:list.json 能访问不等于技能可以安装。清单中每一项的 downloadUrl 也必须返回 HTTP 200 和真实 .skill JSON;如果返回 404、HTML 页面或登录页,控制台会显示实际失败原因并写入运行日志。

普通自建市场的技能包保持 signature: null。官方签名使用插件内置公钥校验,不能通过填写任意字符串伪造;伪造或被篡改的签名包会被拒绝。


共 27 篇 ZL-综合插件知识库 / AI 功能详解 0 字 0 行 zhangxiaolin
创建 2026-09-22T09:39:47.637800292Z 更新 2026-10-13T08:12:33.348797190Z