KiviBot 轻量、跨平台的 QQ 机器人框架

机器人框架


插件索引

<h1>插件索引</h1> <p>待更新</p> <p>后面如果开发插件贡献者比较多,可能会开一个插件仓库,以及快捷管理插件的插件。<br /> 要贡献可以看标题栏<code>更多</code></p> <p>目前只有 Dogxi 写的一些插件:<br /> <a href="https://www.123865.com/s/sclKjv-HUsBH">https://www.123865.com/s/sclKjv-HUsBH</a> 也可以群里群文件找找|看标题栏 <code>更多</code></p> <h2>📖 框架助手</h2> <p>下面#开头的都是消息直接发给 bot 就行</p> <pre><code>#助手 框架助手 | Kivibot ---------------- #发好友 &amp;lt;QQ&amp;gt; &amp;lt;内容&amp;gt; #发群聊 &amp;lt;群号&amp;gt; &amp;lt;内容&amp;gt; #发送 &amp;lt;内容&amp;gt; (当前群) #改头像 &amp;lt;图片&amp;gt; #取头像 &amp;lt;QQ&amp;gt; #改昵称 &amp;lt;昵称&amp;gt; #改签名 &amp;lt;签名&amp;gt; #加好友 &amp;lt;QQ&amp;gt; (限同一群) #删好友 &amp;lt;QQ&amp;gt; #拉黑 &amp;lt;QQ&amp;gt; #退群 &amp;lt;群号&amp;gt; ---------------- #取图名 &amp;lt;图片&amp;gt; #取图链 &amp;lt;图片&amp;gt; #取图片 &amp;lt;链接&amp;gt; #取md5 &amp;lt;图片&amp;gt; #取时间戳 &amp;lt;时间&amp;gt; #我的头像 #伪造 &amp;lt;艾特&amp;gt; &amp;lt;内容&amp;gt; #伪造2 &amp;lt;QQ&amp;gt; &amp;lt;内容&amp;gt; #伪造3 &amp;lt;QQ&amp;gt; &amp;lt;内容&amp;gt; &amp;lt;时间&amp;gt; #伪造4 &amp;lt;QQ&amp;gt; &amp;lt;内容&amp;gt; &amp;lt;时间戳&amp;gt; ---------------- /时间格式为 年/月/日-时:分:秒 /伪造除了3均可叠加(空格隔开)</code></pre> <h2>🤖 自定义</h2> <h3>📝 基础命令</h3> <table> <thead> <tr> <th>命令</th> <th>说明</th> <th>示例</th> </tr> </thead> <tbody> <tr> <td>!on</td> <td>🟢 开启插件</td> <td>!on</td> </tr> <tr> <td>!off</td> <td>🔴 关闭插件</td> <td>!off</td> </tr> <tr> <td>!add</td> <td>➕ 添加回复</td> <td>!add 你好 世界</td> </tr> <tr> <td>!del</td> <td>➖ 删除回复</td> <td>!del 你好</td> </tr> <tr> <td>!list</td> <td>📋 查看回复列表</td> <td>!list</td> </tr> <tr> <td>!mode</td> <td>🔄 设置匹配模式</td> <td>!mode 你好 0</td> </tr> <tr> <td>!disable</td> <td>🚫 禁用群聊</td> <td>!disable 123456</td> </tr> <tr> <td>!enable</td> <td>✅ 启用群聊</td> <td>!enable 123456</td> </tr> <tr> <td>!test</td> <td>🧪 测试变量</td> <td>!test [at(123456)]</td> </tr> <tr> <td>!help</td> <td>🏠 命令帮助</td> <td>!help</td> </tr> </tbody> </table> <h3>💡 添加回复指南</h3> <h4>1️⃣ 文字回复</h4> <p>bash</p> <pre><code>!add 触发词 回复内容 [模式] # 模式: 0-模糊匹配(默认) 1-精确匹配</code></pre> <h3>下面都是 ai 生成的了,可以不看,自行使用,很容易上手</h3> <p>配上现有回复变量大合集 ⬇️(使用即可</p> <table> <thead> <tr> <th>变量</th> <th>简介</th> <th></th> <th>变量</th> <th>简介</th> </tr> </thead> <tbody> <tr> <td>[at(QQ 号)]</td> <td>艾特</td> <td></td> <td>[mute(qq 号:分钟)]</td> <td>禁言</td> </tr> <tr> <td>[av(QQ 号) ]</td> <td>头像</td> <td></td> <td>xx</td> <td>xxxxxx</td> </tr> <tr> <td>[poke(QQ 号)]</td> <td>戳一戳</td> <td></td> <td>[cite]</td> <td>引用回复</td> </tr> <tr> <td>[name]</td> <td>发送者昵称</td> <td></td> <td>[reg(reg)]</td> <td>根据正则取消息内容</td> </tr> <tr> <td>[uin]</td> <td>发送者 QQ 号</td> <td></td> <td>[num(1-88)]</td> <td>随机整数</td> </tr> <tr> <td>[atqq]</td> <td>消息中艾特对象的 QQ 号</td> <td></td> <td>[one(吃,摆,睡)]</td> <td>随机选择(,或|分割)</td> </tr> <tr> <td>[msg(num)]</td> <td>消息去除前 num 字符</td> <td></td> <td>[url]</td> <td>取消息中的第一个链接</td> </tr> <tr> <td>[word(num)]</td> <td>根据空格分割消息内容</td> <td></td> <td></td> <td></td> </tr> <tr> <td></td> <td></td> <td></td> <td></td> <td></td> </tr> <tr> <td>[img(图片地址)]</td> <td>图片(file/链接)</td> <td></td> <td>[get(链接)]</td> <td>get 请求(无[return]变量则全部返回)</td> </tr> <tr> <td>[record(链接)]</td> <td>语音</td> <td></td> <td>[post(链接)]</td> <td>post 请求</td> </tr> <tr> <td>[video(链接)]</td> <td>视频</td> <td></td> <td>[return(data1.xx.xx)]</td> <td>get 请求后的返回数据(json)data1 是第一个 get 得到的数据,还可以有 data2...</td> </tr> </tbody> </table> <p>更多变量待补充...</p> <p>可以 <code>!test xxx</code> 测试看看有什么效果(仅可测试无需回复的变量)</p> <h5>示例:</h5> <p>bash</p> <pre><code>!test 你好呀~ [name] !test [at([uin])],今天也要元气满满哦! !test 一言:[get(https://v1.hitokoto.cn/)][return(data1.hitokoto)] !test bing每日一图:[img(https://dailybing.com/api/v1)] !test 我戳死你~[poke(uin)][poke(uin)][poke(uin)][poke(uin)]</code></pre> <h4>2️⃣ 图片回复</h4> <p>bash</p> <pre><code># 发送图片作为触发 !add [图片] 这是回复内容 # 发送图片作为回复 !add 触发词 [图片]</code></pre> <h3>🎯 变量系统(英文方框)</h3> <h4>👤 用户相关</h4> <table> <thead> <tr> <th>变量</th> <th>说明</th> <th>示例</th> </tr> </thead> <tbody> <tr> <td>[name]</td> <td>👤 发送者昵称</td> <td>[name]</td> </tr> <tr> <td>[uin]</td> <td>🆔 发送者 QQ</td> <td>[uin]</td> </tr> <tr> <td>[atqq]</td> <td>📢 发送消息艾特的 qq 号</td> <td>[atqq]</td> </tr> <tr> <td>[av(qq 号)]</td> <td>🖼️ 发送者头像</td> <td>[av(10001)]</td> </tr> </tbody> </table> <h4>🎲 随机变量</h4> <table> <thead> <tr> <th>变量</th> <th>说明</th> <th>示例</th> </tr> </thead> <tbody> <tr> <td>[num]</td> <td>🎲 随机数</td> <td>[num(1-100)]</td> </tr> <tr> <td>[one]</td> <td>🎯 随机选择</td> <td>[one(吃饭</td> <td>睡觉</td> <td>打游戏)]</td> </tr> </tbody> </table> <h4>🛠️ 功能变量</h4> <table> <thead> <tr> <th>变量</th> <th>说明</th> <th>示例</th> </tr> </thead> <tbody> <tr> <td>[mute]</td> <td>🤐 禁言</td> <td>[mute(123456:10)]</td> </tr> <tr> <td>[poke]</td> <td>👉 戳一戳</td> <td>[poke(123456)]</td> </tr> <tr> <td>[get]</td> <td>📡 GET 请求</td> <td>[get(<a href="https://api.com/"><a href="https://api.com">https://api.com</a></a>)]</td> </tr> <tr> <td>[return]</td> <td>📤 返回数据</td> <td>[return(<a href="http://data1.result.text.xxx/">data1.result.text.xxx</a>)]</td> </tr> </tbody> </table> <h4>📺 媒体变量</h4> <table> <thead> <tr> <th>变量</th> <th>说明</th> <th>示例</th> </tr> </thead> <tbody> <tr> <td>[img]</td> <td>🖼️ 图片</td> <td>[img(图片链接)]</td> </tr> <tr> <td>[video]</td> <td>🎥 视频</td> <td>[video(视频链接)]</td> </tr> <tr> <td>[record]</td> <td>🎤 语音</td> <td>[record(音频链接)]</td> </tr> </tbody> </table> <h3>🎯 匹配模式</h3> <h4>模糊匹配 (默认模式 0)</h4> <ul> <li>🔍 消息包含触发词即可</li> <li>💭 适合日常对话</li> <li>📝 例: <code>触发词可以在句子中间</code></li> </ul> <h4>精确匹配 (模式 1)</h4> <ul> <li>✨ 需要完全匹配触发词</li> <li>🎯 适合精确指令</li> <li>📝 例: <code>必须完全等于触发词</code></li> </ul> <h3>🌟 进阶技巧</h3> <h4>1. 变量嵌套</h4> <p>bash</p> <pre><code>!add 天气 [get(https://api.com/weather?city=[msg(2)])] !add 头像 [img([av][uin])]</code></pre> <h4>2. 组合使用</h4> <p>bash</p> <pre><code>!add 打招呼 [at([uin])],[one(早上好|下午好|晚上好)],[name]!</code></pre> <h3>⚠️ 注意事项</h3> <h4>🔒 权限要求</h4> <ul> <li>添加需要管理员权限</li> <li>群聊需要对应权限(默认全开放)</li> </ul> <h4>📸 图片说明</h4> <ul> <li>支持本地图片和 URL</li> <li>图片自动保存备份</li> </ul> <h4>🎯 变量使用</h4> <ul> <li>变量区分大小写</li> <li>支持嵌套使用</li> <li>部分变量需要参数</li> </ul> <h3>🎮 使用小贴士</h3> <ol> <li> <p>善用随机回复</p> <p>bash</p> <pre><code>!add 打招呼 [one(你好|嗨|在吗)],[name]</code></pre> </li> <li> <p>结合多个变量</p> <p>bash</p> <pre><code>!add 签到 [at([uin])] 获得[num(1-100)]积分</code></pre> </li> <li> <p>API 调用示例</p> <p>bash</p> <pre><code>!add 一言 [get(https://v1.hitokoto.cn/)][return(data1.hitokoto)]</code></pre> </li> </ol> <h3>🆘 常见问题</h3> <ol> <li> <p>❓ 为什么图片没反应</p> <ul> <li>检查图片格式是否支持</li> <li>确认 URL 是否可访问</li> </ul> </li> <li> <p>❓ 变量不生效</p> <ul> <li>检查变量名大小写</li> <li>确认参数格式正确</li> </ul> </li> <li> <p>❓ 匹配模式问题</p> <ul> <li>默认为模糊匹配</li> <li>需要精确触发请设置 mode 为 1</li> </ul> </li> </ol> <h2>微群管</h2> <p>待更新...</p>

页面列表

ITEM_HTML