Qiqi 机器人

如果你需要中文版新手指引,请点击此处

其他语言的文档:

简介


Qiqi是一个用discord.py编写的机器人,她有各式各样的功能,可以给您提供完美的discord体验 ~

关于 Qiqi

“Qiqi” 这个词来自于游戏《原神》。 在游戏中,根据她的经历,七七是一个非常有趣而且独特的的角色。所以,当程序猿决定写这个discord机器人的时候,七七这个名字就成功入选咯

直到目前,Qiqi 机器人项目并不开源,但是她完全免费 (不需要任何额外支付开销)

支持语言

Qiqi支持多语言!所有的翻译都会默认的根据你的Discord软件语言。语言是以用户为基准的,这代表着Qiqi可以对服务器里的不同成员回复不同的语言。而且,你可以通过settings指令来手动更改语言。Qiqi目前支持的语言有:

怎么邀请Qiqi呢?

你可以在一些discord机器人的网站(例如:top.gg,discordbotlist.com)搜索Qiqi。你也可以直接点击下方的邀请链接直接邀请Qiqi!

    Qiqi 的 邀约 邀请链接 ~

    Bubu Pharmacy - Qiqi支持服务器

指令


这一部分列举了Qiqi支持的所有指令/命令。指令一共分为五个部分:

处于演示目的, 在本文档里的所有指令都用/来演示.

    命令前缀/ 代表着斜线指令而且一直是可用的. 除了使用斜线指令作为指令前缀,你也可以使用服务器自定义指令前缀,默认是q!

使用/help指令去根据Qiqi的指令分类来查看各类指令

使用 /help <指令名称> 来查看某一个指令的具体使用说明与描述.

原神指令


Qiqi 的原神指令主要注重对于角色,武器,和天赋的成长计算功能(全等级支持)。当然,他也可以查看角色,武器,和相关材料的信息。

Warning

Qiqi的原神数据库目前已过时。开发者目前正在努力解决这个问题,但工作量着实巨大。

点击这里查看原神相关指令的具体文档

音乐指令


Qiqi非常喜欢放音乐给你听. 她支持通过URL网址/搜索关键字来播放Soundcloud, Bilibili, 网易云音乐, 和企鹅的歌曲。强烈建议给予Qiqi 管理消息 的权限来播放歌曲. 如果你通过搜索关键词来播放音乐,Qiqi还能提供5个可能的选项供你选择,这难道不酷吗?

    不仅如此,Qiqi还支持自定义DIY歌单。 你可以自选来自Soundcloud, Bilibili, 网易云音乐, 和企鹅的音乐来制作一个属于你的专属歌单 (具体操作指南在 自定义音乐歌单)

    除此之外,Qiqi提供你在discord(跨服务器的)个人音乐收藏夹。你可以添加你喜欢的歌曲到这个收藏夹里,而且你可以直接播放他们 (具体操作指南在 个人音乐收藏夹)

自定义音乐歌单

    只需要简单的5个步骤就可以自定义跨网站的歌单咯!

  1. 你需要到 mystb.in 这个网站来创建自定义歌单。

  2. 复制粘贴每个歌曲的url网址,一行对应一个网址。(强烈建议),你可以选择在歌曲的url的后面给这个歌曲加入一个简短的名字(32个字符上限),每一行除了url网址和简短的名字外不应含有其他信息。这四个来源 (Soundcloud, 网易云音乐, Bilibili, 和企鹅) 都支持并且你可以把他们的音乐放进这一个自定义歌单!

    单行示例(推荐): https://soundcloud.com/user-235352228/let-the-wind-blow-to-you 璃月云海

    单行示例(可用,但不推荐): https://soundcloud.com/user-235352228/let-the-wind-blow-to-you

    警告:歌曲的url和简短的名字之间需要有一个空格,其他任何符号都不可以(比如::,#!.-+^/;)

  3. 在完成创建自定义歌单后, 点击 "Save Paste" 按钮(有保存图标那个)。点击之后自定义歌单的url网址就会自动在你的剪贴板里了

  4. 检查一下你现在这个界面的url网址。在这个快速保存之后,mystb.in网站会给你这个自定义歌单一个永久的url网址。

  5. 使用 /playcp 指令来播放自定义歌单 或 /savecp 来让Qiqi替你保存自定义歌单.

(如果对于自定义歌单的创建播放等流程还是很困惑,可以看这个文档常见问题部分的第9个问题,或者加入Qiqi的支持服务器来答疑)

    重要事项

个人音乐收藏夹

    Qiqi可以帮你创建一个 个人音乐收藏夹,你可以跨服务器播放收藏夹里的音乐。(当然ta们服务器要有Qiqi)。每个用户的个人音乐收藏夹的上限是300首歌。而且,你可以让Qiqi把这个音乐收藏夹导出到mystb.in并转换成一个自定义歌单.

    个人音乐收藏夹的相关指令都是私人的 (你和Qiqi之间的对话只为你可见) 除了 playfavorite 这个播放功能。前提是使用斜线指令前缀 /,使用自定义前缀(默认q!)的话对话还是所有人可见

娱乐指令


娱乐指令在服务器里的所有人(除了被禁言用户)都可使用。他们对于使用者的权限没有限制,以后会有更多的好玩的小指令的。如果你有好的想法,可以来与我讨论哦。玩得开心!

管理指令


管理指令是为了帮助服务器的管理员们更好的管理服务器。但想要使用不同的指令需要不同程度的权限。但如果该用户为管理员权限,那么可以无视指令列举的所需权限,因为管理员权限可以绕开所有权限限制

实用指令


    实用指令指的是一些关于Qiqi机器人本身有用的指令。比如说,像查看机器人当前状态,给Qiqi投票,生成机器人邀请链接等。

常见问题

别称

政策声明


条款与服务


版本跟踪


Note

版本跟踪会显示Qiqi机器人的所有发布的版本更新,除了在Beta 0.3.0.0之前的小版本/错误修复的更新。

P.S: 版本跟踪不会包括所有在开发阶段的版本。它只记录稳定的发布版本。

版本编号No.更新时间 (MM/DD/YYYY)更新详细信息
2.0.0.010/18/2026点击查看详细信息
1.7.1.204/15/2025修复了B站用户收藏夹会加载第一首歌两次的bug
1.7.1.103/23/2025更新了求签新赛季S5
1.7.1.003/17/2025添加了播放或删除多首收藏夹歌曲的功能(通过正整数或范围,用逗号隔开)| 添加了对B站用户收藏夹的播放支持 | 优化了提取性能并修复了诸多提取Bug
1.7.0.102/17/2025修复了一些网易云歌单无法正常播放的bug
1.7.0.002/04/2025重写了内部音乐逻辑来改善性能 | 添加了对Soundcloud的音乐支持 | 添加了企鹅音源 | 添加了pengu, pengualbum, penguplaylist这些音乐指令
1.6.3.003/30/2024刷新了fortune-ranking排行榜,并开始了s1赛季制
1.6.2.603/14/2024修复了关于自定义语言的保存问题 | 修复了fortune-ranking中“第一次获得时间”的该交互失败问题
1.6.2.303/13/2024为fortune-ranking添加了不同的排行(包括个人最佳)并修复了其他小问题
1.6.2.002/29/2024添加了skip later的功能
1.6.1.002/07/2024添加了fortune指令使其更加具有趣味性
1.6.0.512/24/2023更改了网易云音乐url检查中#/与/home为可选
1.6.0.212/05/2023修正了Qiqi的zh-CN简体中文翻译文件的一些拼写错误
1.6.0.111/24/2023修复了Qiqi离开语音频道后保持播放队列时间的错误 | 修复了Qiqi的setlang指令不支持本应支持的语言选项 | 修复了一些小错误及拼写错误
1.6.0.011/19/2023重写了内部音乐逻辑,尤其是播放队列的逻辑,这极大的提升了性能 | 添加了对多语言的翻译,并添加了setlang来手动设置语言 | 添加了blacklist, nekogirl指令 | 重构了roll指令并移除了bmi, calcgpa, gpascale | playhistory指令现支持范围播放 | 修复了诸多Bug和拼写错误
1.5.4.209/30/2023修复了关于前缀和音乐的RuntimeError
1.5.4.108/15/2023修复了多个音源的403错误
1.5.4.007/31/2023更新了原神数据库以兼容3.8下半版本 (珊瑚宫心海 | 流浪者) | 修复了关于Bilibili的高发403错误 | 添加了开发者工具
1.5.3.007/08/2023添加了低概率展示角色时装的功能 | 更新了原神数据库以兼容3.8上半版本 (优菈 | 可莉) | 添加了开发者工具
1.5.2.206/22/2023修复了诸多关于clear与bilibili <关键词>的bug | 提升了 bilibili搜索关键词的速度
1.5.2.006/21/2023添加了武器指令用以查询武器基本信息 | 更新原神数据库以兼容3.7下半版本 (艾尔海森 | 枫原万叶) | 添加开发者工具 | 修正了拼写错误并修复bug
1.5.1.005/23/2023更新原神数据库以兼容3.7上半版本 (宵宫 | 八重神子) | 修复了诸多bug
1.5.0.805/22/2023优化提升Qiqi的性能 | 临时移除volume指令
1.5.0.605/20/2023修复了诸多bug | 优化了Qiqi的性能 | 增加了开发者工具
1.5.0.005/18/2023添加了Spotify音乐作为新的音乐来源。支持多个Spotify相关指令(音乐/歌单/专辑/歌手):spotify, spotifyplaylist, spotifyalbum, spotifyartist | 为所有音乐添加了volume功能来调整音量 | 更新原神数据库以兼容3.6下半版本 (白术 | 甘雨) | 增加了开发者工具,以更好地监控Qiqi的情况 | 优化了代码以提高性能 | 修复了错误和错别字
1.4.10.204/29/2023为exportfavorite指令添加时间排序选项 | 更新help指令
1.4.10.104/26/2023为playfavorite, addfavorite, deletefavorite指令添加时间排序选项
1.4.10.004/16/2023为viewfavorite指令添加时间排序选项 | 通过分隔queue和history歌单优化export指令 | 优化export和exportfavorite指令来导出不仅歌曲url还有名字 | 大幅优化使用自定义命令前缀来调用指令的性能 | 优化机器人自身数值的采集方式 | 优化一些指令的描述并更正拼写 | 更新原神数据库以兼容3.6上半版本 (纳西妲 | 妮露)
1.4.9.103/02/2023为queue(队列)里来自于自定义歌单的歌曲添加了编号方便查找
1.4.9.003/02/2023更新了自定义歌单的逻辑并且提升上限到100首歌曲,并且允许给每一个歌曲url加一个简短的名字(推荐) | 更新原神数据库以兼容3.5上半版本 (迪希雅 | 赛诺) | 提升了reset指令的功能性 | 修复了诸多bug
1.4.8.002/13/2023更新原神数据库以兼容3.4下半版本 (胡桃 | 夜兰) | 更新开发者工具
1.4.7.001/31/2023更新了机器人的逻辑去忽略“管理消息”的权限 | 转义了关于剧透信息的字符 | 更新了on_voice_state_update的逻辑并移除了提示消息 | 更新原神数据库以兼容3.4上半版本(艾尔海森 | 魈)| 修复了一些小错误
1.4.6.012/29/2022更新原神数据库以兼容游戏3.3下半版本(雷电将军 | 神里绫人)| 更正了拼写错误并添加了模糊词
1.4.5.412/22/2022修复了多个关于mynetease, votefavorite, 和help指令的bug
1.4.5.012/21/2022将个人音乐收藏夹从30首上限扩容至100首 | 更换了加载个人音乐收藏夹的逻辑 | 降低了playfavorite指令的冷却时间 | 修复了一些关于voteskip, favorite, auditlog等等相关的bugs,并且移除了阻塞代码 | 更新了原神数据库武器词条 | 改善了数据库安全性
1.4.4.012/12/2022添加了在指令queue和history的一个新的按钮选择 "jump to specific page?" (跳转到指定某页)
1.4.3.012/08/2022更新原神数据库以兼容游戏3.3上半版本(流浪者 | 荒泷一斗)
1.4.2.011/19/2022更新原神数据库以兼容游戏3.2下半版本(八重神子 | 达达利亚)| 修复自定义前缀错误 | 修复了原神数据库的错误和拼写错误 | 更新后台服务
1.4.1.011/09/2022添加了通过关键词在队列搜索指定歌曲的位置 | 添加了定时关闭指令的取消的功能 | 恢复了top.gg自动发布 | 修复错误 | 提升用户体验
1.4.0.011/03/2022添加了网易云音乐作为新的音乐来源。支持多个网易云的指令(音乐/歌单/用户): netease,  neteaseplaylist, neteaseuser, mynetease, playmynetease, newsongs | 添加对Bilibili视频的关键词搜索 | 添加了定时关闭sleep指令 | 更新原神数据库以兼容游戏3.2上半版本(纳西妲 | 宵宫) | 修复错误 | 提升用户体验
1.3.10.010/15/2022更新原神数据库以兼容游戏3.1下半版本(妮露 | 阿贝多) | 修复原神武器计算反向翻译问题
1.3.9.110/11/2022修复了流媒体式直播音乐的保持活动错误/不可用连接重用错误
1.3.9.010/10/2022添加在top.gg自动发布服务器数量的功能 | 修复音乐指令错误 | 修正拼写错误 | 添加别称
1.3.8.009/28/2022更新原神数据库以兼容游戏3.1上半版本(赛诺 | 温迪)
1.3.7.109/15/2022回滚 talent-calc 异常处理程序
1.3.7.009/09/2022更新原神数据库以兼容游戏3.0下半版本(甘雨 | 珊瑚宫心海) | 更新武器计算的图片显示 | 修正拼写错误
1.3.6.008/31/2022更新 savecp 的指令功能
1.3.5.008/29/2022更新 export | playcp | exportfavorite 的指令功能
1.3.2.008/28/2022更新原神数据库以兼容游戏3.0上半版本(提纳里 | 钟离) | 改进原神数据库里关于旅行者的返回结果 | 修正拼写错误
1.3.1.108/13/2022临时更新了 mystb.in python API包装器 (旧版)
1.3.1.008/03/2022更新原神数据库以兼容游戏2.8下半版本(宵宫) | 更新了原神数据库的模糊词
1.3.0.007/29/2022添加了跨服务器的用户音乐收藏夹和相关的指令 | 添加了音乐指令 restart, seek, forward, rewind | 改进了 voteskip 指令的投票通过逻辑 | 修复错误 | 提升用户体验
1.2.3.107/18/2022修复了stop指令对于新加入的服务器的错误
1.2.3.007/13/2022更新原神数据库以兼容游戏2.8上半版本(枫原万叶 | 可莉)
1.2.2.007/09/2022添加了reset指令用于音乐(管理) | 修复了因用户手动断开Qiqi连接导致语音频道加入引起的客户端异常(ClientException) 的错误 | 修复了语音状态更新消息如果机器人断开连接
1.2.1.507/01/2022改进了如果得到了403错误机器人重新获取过期音乐的机制
1.2.1.406/26/2022修复了斜线指令前缀使用playcp指令时只加载自定义歌单第一首歌的错误
1.2.1.306/25/2022修复了repeat single 对于新增歌曲的错误 | 改进了 play 在移动端的用户体验(该应用程序未响应) | 提升Qiqi机器人服务
1.2.1.006/24/2022更新原神数据库以兼容游戏2.7下半版本(荒泷一斗) | 提升用户体验
1.2.0.006/15/2022对所有现存指令支持斜线指令前缀(混合指令hybrid) |增加了对于按钮的用户界面 (改进于反应) | 自定义帮助 (help) 页面 |添加娱乐指令, 修复错误, 提升用户体验
1.1.3.106/02/2022添加了discord日志来监控机器人性能以及错误 | 修复自定义歌单错误
1.1.2.005/31/2022更新原神数据库以兼容游戏2.7上半版本(夜兰)
1.1.1.004/20/2022更新原神数据库以兼容游戏2.6下半版本(神里绫华)
1.1.0.004/10/2022添加了mystb.in的自定义歌单以及相关指令(playcp, savecp, viewcp, deletecp) | 添加一些关于gif的娱乐指令 (pat, hug, cry, cuddle) | 修复严重错误和提升用户体验
1.0.0.004/02/2022使用专业数据库来记录数据 | 添加了以下音乐指令 nowplaying, repeat all, history, playhistory, voteskip, export  | 添加了以下娱乐指令 weather, qiqi, time, wolfram, translate | 提升用户体验
0.6.11.004/01/2022更新原神数据库以兼容游戏2.6上半版本(神里绫人 | 温迪)
0.6.8.003/08/2022添加了 roll, rollrepeat 指令 | 更新原神数据库以兼容游戏2.5下半版本(雷电将军)
0.6.5.102/21/2022更新原神数据库以兼容游戏2.5上半版本(八重神子)
0.6.4.1201/26/2022优化了以下指令的用户体验: mute, unmute, tempmute | 修复较小的错误 (现在mute指令依然可以在没有管理员权限的情况下使用)
0.6.4.901/25/2022新增加的管理指令: deafen, undeafen, audit | 更新原神数据库以兼容游戏2.4下半版本(钟离 | 甘雨) | 修复了较小的错误 | 提升用户体验
0.6.0.001/24/2022新添加原神指令: char (查看角色基础信息), talents (查看角色天赋信息), cons (查看角色命之座信息) | 添加管理指令: mute (对指定用户在文字和语音频道里禁言), unmute, tempmute (设定时间对指定用户临时禁言)
0.5.4.301/06/2022更新原神数据库以兼容游戏2.4上半版本(申鹤) | 添加了新的指令 fortune 和 userinfo | 修复了较小的错误和数据库里数据缺失的错误
0.5.1.012/19/2021正在前往 直布罗陀 1.0.0.0。迁移到新的云服务器 | 添加 userinfo 功能
0.4.1.412/18/2021更新站点包信息 | 添加了循环(repeat)功能的回复信息 | 修复了jump功能回复信息里错误序号的问题
0.4.1.112/18/2021更新原神数据库以兼容游戏2.3下半版本(荒泷一斗) | 在错误处理上修复了@的错误
0.4.0.012/17/2021添加了音乐指令 repeat (只能单曲循环), policy, credits | 提升用户体验并且降低垃圾信息的可能性(spamming) | 修复较小的错误
0.3.3.212/16/2021修正机器人回复中的拼写错误
0.3.3.112/16/2021添加了开发者功能
0.3.3.012/16/2021添加了对Bilibili网站的播放音乐支持
0.3.2.712/15/2021更新前缀未找到为默认前缀
0.3.2.512/15/2021停止回复错误具体信息如果该指令没有找到
0.3.2.412/13/2021添加音乐指令 jump 和 shuffle
0.3.0.112/12/2021修复了超时的错误信息回复
0.3.0.012/11/2021原神/音乐指令发布
0.2.0.011/20/2021原神指令完成, 没有发布
0.1.6.009/27/2021组件重写完成,没有发布
0.1.0.005/13/2021最初的合并版本,没有发布

特别鸣谢

Qiqi永远不会忘记那些曾经帮助过她的人

联系方式