KisuniHiyami 使用指南
本指南为 KisuniHiyami 的使用帮助,随当前后端实时状态修订。
正常情况下,当您向机器人发送 .help 指令时,您会得到导向这里的地址。
状态页面
您可以在 这里 观测机器人两端的实时状态,尽管他们实际上是在检测同一个服务器的不同接口。
如果您发现机器人无法正常工作,您可以在这里查看是否有相关的信息,一般来讲,Client 异常说明服务器与机器人客户端失去了连接,如果两个状态都正常但是机器人仍然无法工作,那么就可能是机器人端受到了风控,您可以等待一段时间后再次尝试。
加好友与审核
机器人当前的 QQ:2684831639,您可以通过搜索这个 QQ 号来添加机器人为好友。
移动端用户亦可扫描下方二维码。
加好友二维码

目前机器人的加好友操作与拉群操作为自动审批,您需要在 这个表单 按提示进行自助报备,如操作无误的话机器人应能自助审批入群。
自有插件
本插件由作者编写并维护,您可以在这些插件出问题时第一时间联系作者,提供可复现的问题描述。
由于机器人所在群组的多样性,机器人使用 nonebot-plugin-rauthman 进行基于群组的权限控制,自有插件的权限在新群组默认都为关闭状态,以防发生计划外的问题(这确实发生过)。如有需要,您可以找作者进行授权。未来也将考虑搭建自助授权流程。
但请您放心,插件权限控制在私聊状态下不生效,您在私聊状态下可以自由使用所有插件。
联系作者
您可以直接通过 .message 指令向作者发送消息,格式为:
1 | .message [消息内容] |
您可以就机器人提供反馈与建议,或者是许愿,又或者是请求如下插件的使用授权。
Maimai 排卡
当前版本:V3.0.0.20260202
本功能受服务开关「Maimai排卡」控制,仅在被启用的群组内响应。
思路借鉴了喜闻乐见的查机厅卡数功能,对接了华立 API 里的 ID 以实现跨群信息共享。
触发指令集:.maiarc
使用例:
查询全部可用机厅
.maiarc.search
1 | 返回的机厅如下: |
.maiarc.search 支持用空格分词进行搜索,关键词建议至少 2 个字符;当搜索结果过多(超过 20 条)时会进入翻页模式:n 下一页、p 上一页、q 退出、数字跳页。
刷新华立数据(用于修复 search 结果过旧/缺失)
.maiarc.refreshwahlap
1 | 将从华立公开 API 刷新机厅原始库数据。 |
将机厅绑定为别名(仅群主管理员可用)
.maiarc.add 3000 家
1 | :) 机厅添加成功 |
机厅卡数操作
支持的正则集:r'^(.+)?\s?(设置|设定|🟰|=|=|加|➕|+|\+|减|➖|-|-)\s?([0-9]+|+|\+|-|-)(人|卡)?$'
对应的映射:
1 | opRepList = { |
例如,如果你在上文中将 3000 设置为「家」,那么:家加1 家+1 家++ 都会将「家」的卡数增加 1。家减1 家-1 家-- 都会将「家」的卡数减少 1。家=1 家设定1 家=1 都会将「家」的卡数设定为 1。
另请注意:为避免含数字的别名与匹配打架,暂不支持 「家1」 这样的设卡操作,设卡请显式使用「=」等符号。
为避免刷屏与误操作,短时间高频设卡会触发限流并自动封禁一小段时间;单次变动幅度也存在上限。
查询机厅卡数
本操作采用后缀匹配,支持的后缀有: ['有多少人', '有几人', '有几卡', '多少人', '多少卡', '几人', 'jr', '几卡', '几', 'j']
例如,使用 家有几人 家几 均可以查询「家」的卡数。
1 | 天空之城泰安泰山吾悦广场店 当前人数为 1 人 |
查询本群所有绑定机厅
本操作可使用关键词 jtj 机厅几人 机厅几 几卡 ,或是命令 .maiarc.lookup 查询,将返回本群所有绑定机厅的卡数与别名。
1 | 本群目前绑定的机厅: |
删除机厅别名(仅群主管理员可用)
.maiarc.del 家
1 | :) 删除别名成功! |
封禁用户(仅群主管理员可用)
.maiarc.banuser [QQ号] [封禁时长(小时为单位)] [封禁理由]
.maiarc.banuser 114514 3 test
1 | 已封禁用户 114514 |
封禁时长支持小数(单位:小时)。.maiarc.banlookup 不带 QQ 号时默认查询自己。如需更高层级的封禁/解封(例如全局范围等),仅限 superuser 的高级用法,此处不展开。
解封封禁用户(仅群主管理员可用)
.maiarc.unbanuser [QQ号]
.maiarc.unbanuser 114514
1 | :p 已在该环境下解封用户 114514,如果用户仍然无法操作,那么可能有更高层级的封禁状态! |
查询封禁状态
.maiarc.banlookup [QQ号]
1 | 未查询到封禁状态 |
添加自定义别名(用于添加华立列表里不存在的机厅)
.maiarc.addcustom [机厅名称] [机厅地址] <机厅省份> <机台数(纯数字)>
使用方括号包裹的内容必填,使用尖括号包裹的内容可选。仅可使用下方系统给出的机厅ID添加新别名,新添加的机厅不会进入 .maiarc.search 的列表中。
.maiarc.addcustom 淄博万象汇卡奇 淄博万象汇四楼 山东 1
1 | :) 添加自定义机厅成功!以下是你的信息: |
回滚机厅信息(仅群主管理员可用)
.maiarc.rollback 机厅别名 或 机厅别名回滚
回滚功能会将机厅数据恢复到上一次修改前的状态,回滚操作执行后备份状态会被清除,不能重复回滚。
.maiarc.rollback 家
1 | :) 数据回滚成功! |
家回滚
1 | :) 数据回滚成功! |
年度报告
触发词:我的年度报告 / 我的排卡年度报告 / 群年度报告 / 群组排卡年度报告
1 | 将查询上一年度的排卡年度报告。 |
年度报告里的全部成就(非 LLM 酱随机生成)的触发机制如下:
1. 肝度类
基于年度总操作次数的评级。- 👑 传说肝帝:年操作数超过500次
- 🌟 史诗肝帝:年操作数超过300次
- ⭐ 稀有肝帝:年操作数超过150次
- ✨ 优秀肝帝:年操作数超过80次
2. 贡献类
基于年度更新数据的次数评级。- 🏆 传说贡献者:年更新超过400次
- 🥇 史诗贡献者:年更新超过200次
- 🥈 稀有贡献者:年更新超过100次
- 🥉 优秀贡献者:年更新超过50次
3. 查卡类
基于年度查询功能的次数评级。- 📡 传说雷达:年查询超过200次
- 📶 史诗雷达:年查询超过100次
- 📱 稀有雷达:年查询超过50次
4. 潜水类
针对查询多但贡献少的用户。- 👻 深水潜水员:查询超过50次但更新少于5次
- 🕵️ 机厅观察员:查询超过20次但更新少于2次
5. 时间类
基于操作发生的时间段。- 🧛 传说修仙者:凌晨操作超过100次
- 🦉 史诗修仙者:凌晨操作超过50次
- 🌙 稀有修仙者:凌晨操作超过20次
- 🌅 早八战神:早8时段操作超过30次
- 🌃 通宵王者:连续7天有凌晨操作
- 🦉 凌晨战神:凌晨操作占比超过60%
- ☀️ 白天战神:白天(6-18点)操作占比超过70%
- 🎉 周末战士:周末操作占比超过50%
- 💼 工作日战士:工作日操作占比超过70%
6. 地理类
基于涉及的机厅(店铺)数量及分布。- 🌍 传说旅行者:去过8个以上机厅
- 🚀 史诗旅行者:去过5个以上机厅
- 🚄 稀有旅行者:去过3个以上机厅
- 💍 单推人:90%以上操作在同一机厅
- 💕 双推人:主要操作集中在两个机厅
- 🗺️ 机厅巡查员:去过5个以上机厅且每个都查过
- 🛡️ 机厅守护者:同一机厅更新超过100次
7. 社交类
基于群组互动的活跃度。- 🤝 社交达人:在3个以上群组活跃
- 💖 群宠:在单个群组操作超过100次
8. 技术类
基于高级指令(回滚、别名、批量)的使用。- 🛡️ 回滚大师:执行回滚超过5次
- ↩️ 回滚学徒:执行回滚超过2次
- 🏷️ 别名大师:添加别名超过10次
- 🔖 别名学徒:添加别名超过3次
- 📚 别名收藏家:使用过的别名超过5个
- 📊 批量查询专家:批量查询超过50次
9. 手滑类
基于操作失败的记录。- 💥 手滑大帝:失败超过10次
- 🤲 手滑学徒:失败超过3次
- 🔢 数字敏感:因差值过大(diff_too_large)失败超过3次
- 💪 百折不挠:失败超过5次但仍在坚持
10. 活跃类
基于活跃的连续性与时长。- 📅 全勤奖:活跃天数超过30天
- 📆 周周乐:活跃周数超过10周
- 🔥 传说签到王:最长连续活跃超过14天
- 💪 史诗签到王:最长连续活跃超过7天
- 💎 忠诚用户:连续活跃超过30天
11. 操作风格类
基于更新指令的偏好(Set vs Add/Sub)及数值幅度。- ⚙️ 设置流:set操作超过总更新的80%
- 🧹 数据洁癖:set操作占比超过90%
- ➕ 增量流:add/subtract操作超过总更新的50%
- 🎯 精准更新:单次更新幅度平均<3人
- 🎚️ 微调大师:平均更新幅度在2人以内
- 📈 大幅调整:单次更新幅度平均>10人
- 💥 爆改达人:单次更新幅度曾超过50人
12. 特殊与趣味类
边缘情况或特定的行为模式。- 🌱 舞萌萌新:总操作少于10次
- 🔄 回归玩家:有操作记录但近期不活跃(超过30天)
- ⚡ 高频操作:1分钟内连续操作超过10次
- 🔍 查询狂魔:查询次数是更新次数的5倍以上
- 🔨 更新狂魔:更新次数超过查询次数
- 🍀 一帆风顺:操作超过50次且从未失败
我的积分(更多玩法敬请期待)
.maiarc.mypoints
1 | 查看我的排卡积分与相关统计信息。 |
本功能具体的设计思想是,机厅之间通过华立公开 API 返回的 ID 共享唯一标识,而群组内则通过别名进行区分,这样可以在不同群组内使用不同的别名,而不会影响到其他群组的使用。
在这样的设计下,一个群发起添加机厅操作时,将首先检查数据库中是否存在该机厅,不存在时则会从华立服务器进行同步。删除别名时仅会删除该群的标识,并不会删除机厅本身的信息。
同时对于查卡设卡操作,为了避免误伤正常消息,机器人只会识别本群注册别名的特定消息,对于不识别或是识别出错的将会忽略不回复,从而避免影响群内正常聊天环境。
部分机厅可能会被设置为「只读」以用于外部同步,此时无法设卡与回滚。
由于服务器维护的时间为北京时间凌晨4点,在这时会有一个定时任务将所有注册机厅的排卡信息删除。(这时应该也没人在机厅上机了吧)
IP 查询
触发指令:.ip <IP 地址>/<域名>
通过调用两个公用 API 进行简易查询操作,并对域名提供有限限度的递归查询。
使用例:
查询 IPV4
.ip 114.5.1.4
1 | IP Lookup v0.1 |
查询 IPV6
.ip 2403:4a00:4001:13:1145:1419::0
1 | IP Lookup v0.1 |
查询域名
.ip s1.hdslb.com
1 | IP Lookup v0.1 |
天气查询
触发指令:.weather
本指令调用彩云 API,在使用前请先通过指令 .weather.bind 绑定您的精确位置。
如果您没有手机端发送「位置」卡片能力的话,您也可以通过 .weather.bind <经度> <纬度> 来绑定城市。
使用例:
绑定位置
.weather.bind 100.2696 29.9960
1 | 已绑定您的位置:四川省甘孜藏族自治州理塘县 |
查询天气
.weather
1 | 将通过合并消息方式发送 四川省甘孜藏族自治州理塘县 的天气信息,请稍等。 |
Arcaea 抽歌
触发指令:.arcai
在受启用的群组亦有关键词:源神启动 。
喜闻乐见的 Arcaea 愚人节菜单移植。
使用例:
抽歌
.arcai
1 | 当然可以,让我为你推荐另一首歌。这次我推荐的是「Another Medusa」,这是一首通感性很强的曲子,需要你放下思维根据音乐的情感走向打击不同类型的音符。曲子富有活力,音符与声音的距离处理得非常合理,让整首曲子听起来很自然,旋律流畅又具有张力。打起来非常有乐趣! |
强智教务系统
触发指令头:.qjw
本插件使用了强智最新最热的 API,目前写死在某学校教务。
如果您碰巧发现您的教务存在 教务系统域名/ydjw/#/login 这个地址,也可以尝试进行适配。
该部分的最新帮助请在被启用的地方通过 .qjw.help 查看。
查看文字类型帮助
.qjw.help
1 | .qjw.bind 学号 教务密码:绑定教务账号(仅私聊可用!) |
Quotly 入典
当前版本:V1.0
类似 Quotly Bot,将群聊消息渲染为精美的引用图片,支持多种显示主题,内置去重与搜索功能。
触发指令集:.q 或是 入典(回复消息)
使用时请先回复一条消息,再发送指令。
| 指令 | 说明 | 示例 |
|---|---|---|
.q |
渲染被回复的单条消息 | 回复后发送 .q |
.q N |
渲染被回复消息及其前 N-1 条上下文 | .q 5 |
.q N --title 0|1 |
覆盖头衔显示 | .q 3 --title 0 |
.q N --time 0|1 |
覆盖时间显示 | .q 3 --time 1 |
.q N --date 0|1 |
覆盖日期分隔符 | .q 3 --date 1 |
.q.search <关键词> |
在本群搜索已保存的语录 | .q.search 你好 |
.q.random |
随机获取一条语录 | .q.random |
.q.stats |
查看统计信息 | .q.stats |
.q.del |
回复语录图片删除记录(需管理员) | 回复后发送 .q.del |
支持的消息类型:文字、图片、QQ 表情、商城表情、@ 提及、回复引用、合并转发消息。
合并转发消息会以内嵌卡片形式展示,包含最多 4 条预览消息摘要与转发总条数。
第三方插件
除了自有插件,机器人还按需引入了一些第三方插件用于改善体验,对于这些插件作者通常无法提供协助,遇到问题请直接移步原仓库。
Bilibili 链接解析
原仓库:https://github.com/mengshouer/nonebot_plugin_analysis_bilibili
该插件没有触发指令,只要您在群内发送了 Bilibili 的链接,机器人会自动解析出视频的标题、UP 主、播放量等信息。
本插件的引入严重影响了机器人的行为。
它会拦截掉所有与 Bilibili 相关的消息,包括但不限于链接与视频号。被拦截的消息会直接在该插件处阻断,即使有些消息并不应该由这个插件解析。举个例子,您将无法在上面的 IP 查询里查询 bilibili.com 结尾的域名。
另一方面,引入该机器人将导致他和群里其他潜在的可解析 Bilibili 链接的机器人产生冲突,并最终导致反复发送消息。如果您需要在特定群屏蔽该插件功能,请联系作者。
保存表情
原仓库:https://github.com/colasama/nonebot-plugin-sticker-saver
触发指令:.save
用于解决新版手机 QQ 把表情包中「保存到本地」功能砍掉的问题。
该插件支持动态和静态表情的保存,对他们回复 .save 即可。
文字转图片
原仓库:https://github.com/mobyw/nonebot-plugin-txt2img
触发指令:.txt2img
将文字转换为图片,支持自定义背景、字体、字号等。请直接在私聊中发送 .txt2img 然后查看向导。
发送指令后根据提示输入标题、内容与字体大小,即可完成图片生成。
- 标题:以
1.5倍字体大小排版在首行居中位置。 - 内容:以
1倍字体大小左对齐排版。 - 字体大小:位于
20~120之间的数字。
啤酒烧烤表情包制作
原作者已弃用,现替换为如下原作者续作:https://github.com/lgc-NB2Dev/nonebot-plugin-meme-stickers
触发指令:.stickers
对于单组表情包,也有类似 .pjsk 和 .arc 的触发指令。原仓库:https://github.com/lgc-NB2Dev/nonebot-plugin-pjsk
触发指令:.pjsk
啤酒烧烤表情包制作,可以直接发送 .pjsk 进入交互模式,也可以发送 .pjsk -h 查看高级用法。
联系作者
请在任意一个能找到 QQ 号 1817532680 的地方联系作者,或者发送邮件到 i#hanlin.press 。