HarukiBot NEO

一款多功能QQ群机器人
Logo由小沢翼担当绘制

阅读前提示

• HarukiBot NEO具有配套功能网站Haruki工具箱。
• 如果你不知道有什么群可以加，也可以访问Haruki工具箱 的推荐群聊页面。
• 推荐群聊页面仅接受熟人申请。
• HarukiBot NEO目前处于公测状态，可能存在各种各样的Bug，如果你遇到了Bug或者有任何意见反馈，请联系HarukiBot分布式Bot主反馈，HarukiBot分布式Bot主会将问题反馈到Haruki Dev Team
• 该使用文档或许存在遗漏或者错误内容，如果发现请联系HarukiBot分布式Bot主反馈，HarukiBot分布式Bot主会将问题反馈到Haruki Dev Team

本文档将引导您使用 HarukiBot NEO

• HarukiBot NEO是一款功能型机器人, 目前主要提供《世界计划 多彩舞台》相关查询服务。
• 该Bot不提供私聊服务。
• 使用该Bot，即意味着你同意使用条款及隐私条款。
• 如果你在使用过程中遇到任何问题，你可以在该页面最下方的关于下面联系开发者进行反馈。
• 目前HarukiBot NEO仍然处于开发状态，有多种功能仍在开发中，如果没有你需要的功能，请不要着急，请耐心等待开发者开发完善。

写在前面的一些提醒

关于指令

• 从Haruki neo版本起，所有指令都需要带"/"（例"/绑定"），没有"/"的指令不会被响应。

服务器支持与切换

• HarukiBot NEO支持日服（jp）、台服（tw）、韩服（kr）、国际服（en）以及国服（cn）
• HarukiBot NEO现在支持全局默认绑定账号和区服默认绑定账号，区服相关指令(如sk、sk线、时速等)如果不带区服前缀，会* *默认采用您的全局默认绑定账号**的区服

如您的全局默认绑定为cn服账号，则使用sk等效以前的cnsk

• 部分功能不支持部分区服，会在功能内说明。

个人资料/账号

注意

账号验证功能仅支持Haruki工具箱快速验证
请确保您在工具箱中有已通过验证的绑定账号再使用此功能
上传个人信息背景需要验证账号，请确保你已验证账号再使用

指令	功能
/绑定 /pjsk bind /pjsk id /pjsk 绑定	通过游戏uid绑定你的游戏账号，如"/绑定 114514"。
/个人信息 /个人中心 /profile	生成个人信息图片，可以输入uid查询指定账号的个人信息，没有uid时会查询自己的默认账号。
/绑定列表 /pjsk bind list /pjsk绑定列表	列出所有当前qq号已绑定的账号
/设置主账号 /pjsk set main /pjsk主账号 /设置默认绑定	通过游戏uid设置默认查询的账号，如/设置主账号 114514。
/清除默认绑定 /取消默认绑定 /取消主账号 /清除主账号	无uid时会清除全局默认绑定，有uid时会清除对应账号的区服默认绑定。
/解绑 /pjsk unbind /取消绑定	通过游戏uid解绑你的账号，如/解绑 114514。
/隐藏抓包 /pjsk hide suite /pjsk隐藏抓包	隐藏suite抓包功能内的详细数据显示。
/展示抓包 /pjsk show suite	展示suite抓包功能内的详细数据显示。
/隐藏烤森抓包 /pjsk hide mysekai	隐藏烤森抓包功能内的详细数据显示。
/展示烤森抓包 /pjsk show mysekai	展示烤森抓包功能内的详细数据显示。
/隐藏ID /隐藏id /pjsk hide id	在查询中隐藏自己的uid。
/显示ID /pjsk show id /显示id	在查询中显示自己的uid。
/抓包数据 /pjsk check data /抓包状态 /抓包信息 /sud	查看自己的suite抓包数据上传时间。
/烤森抓包数据 /msd /pjsk check mysekai data /烤森抓包	查看自己的烤森抓包数据上传时间。
/pjsk验证 /pjsk verify	验证自己的游戏账号，部分功能需要验证后使用。
/pjsk验证列表 /pjsk verify list /pjsk验证状态	查看已验证的账号列表。
/上传个人信息背景 /pjsk upload profile bg /上传个人背景	上传自定义的个人信息背景图，需要消息内含有图片或回复上文中已有的某张图片。请注意，需要先进行游戏账号验证才能使用!!!
/清空个人信息背景	清除自定义的个人信息背景图
/设置个人信息 /pjsk adjust profile /调整个人信息背景	调整自定义个人信息背景图，可选横屏/竖屏、模糊以及透明度。模糊度范围为0~10，透明度范围为0~100。如：/调整个人信息 竖屏 模糊5 透明50
/查时间 /注册时间 /pjsk reg time	查询账号的注册时间

卡牌

指令	功能
/查卡 /card-detail /查牌 /查卡牌 /pjsk card	按指定属性、人物或id查卡
/卡牌列表 /cards /pjsk cards /card-list	按指定条件筛选卡牌列表
/卡牌一览 /查箱 /卡面一览 /卡一览 /box /card-box /pjsk box	按指定条件筛选卡牌，如果有抓包上传的suite数据，未拥有的卡牌会以灰色显示
/查卡面 /pjsk card img /卡面原图 /卡面 /card /卡图	按id查询指定卡的卡图

卡牌相关的可选参数以及示例可以点击这条展开查看

• 团名：ln vbs ws mmj 25
• 对应团oc/纯vs: mmjoc 25oc 纯v
• 对应团vs: mmjv 25v
• 角色昵称：miku mnr
• 卡牌稀有度：4 四星 生日 4星
• 卡牌属性: cool 蓝 蓝星
• 限定类型: 非限 限定 期间限定 fes限定
• 卡牌技能类型: 奶卡 奶 判 分 p分
• 年份: 2025年 今年 去年
• 活动id或者箱活缩写: event123 mnr1

以上参数可以混合使用，用空格分隔

查询单张卡牌的可用参数格式:

• 卡牌id: 123
• 角色昵称+负数索引，表示角色的倒数第几张卡: miku-1

音乐/乐曲

指令	功能
/查曲 /查歌 /查乐 /查音乐 /查询乐曲 /查歌曲 /歌曲 /乐曲 /song /music	查询单曲信息
/难度排行 /歌曲列表 /歌曲一览 /乐曲列表 /乐曲一览 /定数表 /歌曲定数 /查乐曲 /music-list /pjsk music list	查询指定难度等级下的歌曲列表，如果有抓包上传的suite数据会显示clear/fc/ap进度
/pjsk chart /谱面查询 /铺面查询 /谱面预览 /铺面预览 /谱面 /铺面 /查谱面 /查铺面 /查谱 /技能预览	查询指定歌曲的谱面预览
/打歌奖励 /曲目奖励 /歌曲奖励 /music rewards /music-rewards /pjsk music rewards /歌曲挖矿 /打歌挖矿	查询指定账号剩余的 打歌奖励/挖矿奖励（⚠️需要上传suite数据）
/pjsk进度 /打歌进度 /歌曲进度 /打歌信息 /progress /music-progress /pjsk music progress /pjsk progress	查询指定账号指定难度clear/fc/ap完成度（⚠️需要上传suite数据）
/查物量 /pjsk note num /pjsk note count /物量	查询指定歌曲谱面的物量 或查询指定物量下有哪些歌曲
/查bpm /pjsk bpm /查BPM	查询指定歌曲的 BPM
/查曲绘 /pjsk music cover /曲绘	查询指定歌曲的曲绘原图

乐曲相关的可选参数以及示例可以点击这条展开查看

难度：支持大部分写法和缩写，例如 easy ma APD，不指定则默认 MASTER 难度

歌曲别名：每个服务器单独一个别名库，但是在本服务器别名库未匹配到时会从其他服务器查找

查询单首歌曲的可用参数格式：

• 歌曲id，注意id和数字之间不能有空格: id123
• 负数索引，表示倒数第几首歌曲: -1
• 活动id 查活动曲：event123
• 箱活缩写，例如mnr一箱曲: mnr1
• 添加的歌曲别名：虾 龙
• 歌曲名，任意语言均可，会进行模糊匹配：六兆年零一夜物语

查询多首歌曲的可用参数格式：

• 不加参数，默认查询MASTER难度的全部歌曲
• 某个难度全部歌曲: expert
• 某个难度单个等级歌曲: expert 27
• 某个难度 闭区间等级范围 的歌曲: expert 25 37

活动

指令	功能
/活动列表 /pjsk events /events /活动一览 /event-list	活动列表
/查活动 /pjsk event /活动 /event	查询当前/指定活动信息
/冲榜记录 /pjsk event record /活动记录	查询指定账号的冲榜记录（⚠️需要上传suite数据）

活动相关的可选参数以及示例可以点击这条展开查看

查询单个活动的可用参数格式：

• 直接使用活动id: 123
• 负数索引，表示倒数第几个活动: -1
• 箱活缩写，例如mnr一箱: mnr1

查询多个活动的筛选方式：

• 团名英文缩写：mmj vs
• 查询某个角色有出场的活动，可以用空格分隔多个角色：miku miku ick
• 查询角色箱活 ick箱 ickban
• 查询混活：混活
• bonus属性: cool 蓝 蓝星
• 年份: 2025年 今年 去年
• 活动类型：普活 5v5 wl

以上参数可以混合使用，用空格分隔

榜线/SK

指令	功能
/sk线 /sk-line /榜线 /pjsk sk line /skl	查询榜线
/sk /sk-query /sk查询 /sk查分 /pjsk sk board /pjsk board	查指定分数榜位
/时速 /pjsk sk speed /sks /skv /sk时速 /sk-speed	查询当前榜线时速
/日速 /pjsk sk daily speed /skds /skdv /sk日速	查询榜线日均速度
/查房 /sk-check-room /sk查房 /cf /pjsk查房 /csb /冲水板	查询当前房间周回时速等信息
/ptr /sk-player-trace /玩家轨迹 /pjsk玩家追踪	查询账号在当前活动的冲榜统计数据
/档线轨迹 /sk-rank-trace /rtr /skt /sklt /pjsk追踪	查询档线历史轨迹
/sk预测 /pjsk sk predict /榜线预测 /skp	查询榜线预测（33kit/moesekai/sekarun，暂不支持WL单榜）
/5v5预测 /pjsk winrate predict /胜率预测 /胜率 /预测胜率	查询5v5 胜率

卡牌相关的可选参数以及示例可以点击这条展开查看

/时速、/半日速、/日速指令后面可以跟数字，将特定时间范围内的PT增长转换为对应速度
如/时速10 = 10分钟内PT增长量转换的时速
可输入数字单位为分钟，最大不超过1440分钟(即一天)

suite相关查询

• 这部分功能需要抓包上传suite后才能使用，如果使用中遇到问题请先用"/抓包数据"检查自己的suite上传是否成功。

组卡

指令	功能
/活动组卡 /活动组队 /活动卡组 /活动配队 /组卡 /组队 /配队 /指定属性组卡 /模拟组卡 /pjsk event card /pjsk event deck /pjsk deck	根据当前活动加成计算组队
/挑战组卡 /挑战组队 /挑战卡组 /挑战配队 /pjsk challenge card /pjsk challenge deck	根据对应角色计算每日挑战组队
/长草组卡 /长草组队 /最强卡组 /最强组卡 /pjsk no event deck /pjsk best deck	根据指定条件计算组队
/加成组卡 /加成组队 /控分组卡 /控分配队 /pjsk bonus deck /pjsk bonus card	根据指定加成计算组队
/烤森组卡 /烤森组队 /ms组卡 /ms组队 /mysekai deck /pjsk mysekai deck	根据当前活动计算最适合用于挖烤森获取pt的队伍

组卡部分的可用参数以及示例 可以点击这条展开查看

参数类型	可用参数	注意事项
歌曲名和难度	日服已实装的所有歌曲 所有难度
live类型	协力 单人 solo 自动 auto
组卡目标	综合力 实效
指定体力	1火 5火 10火 等	（默认0火）
指定活动	114 活动114 event114	在加成组卡中不要使用仅数字格式！
指定wl章节	140 wl1 140 miku
指定团名+颜色加成	任意团 任意颜色
指定最低实效要求	任意实效
指定区域道具配置	顶配 次顶配	使用与你卡组无关的顶配组卡，顶配区域道具为满级，次顶配为15级。
指定某个团或颜色的卡牌	仅任意团 仅任意颜色
移除指定卡牌	-任意卡牌的id
包含指定卡牌	任意卡牌的id	⚠️这一项必须放在所有参数的最后，且无法固定卡牌顺序。
指定强制包含角色	任意角色	⚠️这一项必须放在所有参数的最后，第一个角色固定为队长，无法与指定卡牌同时使用
不更换bfes卡牌的技能	bf不变	添加该参数后固定为抓包时设置的技能
指定卡牌养成状态	禁用 满破 满技能 已读 画布	直接加上会作用于全部卡牌,前面跟着卡牌id/稀有度则仅作用于指定卡牌/稀有度（例如四星满破满技能 114满破满技能 514禁用 注意这种用法不要用空格隔开）
指定区域道具能级	区域道具x级	将所有区域道具提升至指定等级
指定技能顺序	技能顺序	自动计算: 技能顺序平均 / 技能顺序最大 / 技能顺序最小 手动指定: 技能顺序12345 只能当卡组完全固定时使用
指定bfes花前吸取技能	技能吸取	可选：技能吸取平均 / 技能吸取最大 / 技能吸取最小

活动组卡示例

/组卡 当期活动组卡 /组卡 龙 hd 歌曲为龙hard /组卡 mmj 蓝 mmj+蓝色加成的模拟活动组卡 /组卡 140 wl1 实效200 140期WL第一章，实效至少为200 /组卡 160 auto #mnr 160期活动auto组卡，队长角色强制为mnr /组卡 歌曲比较 当前 使用当前主队比较所有歌曲的活动pt 挑战组卡示例

/挑战组卡 所有角色各组一队 /挑战组卡 miku 群青apd 指定角色和歌曲 /挑战组卡 mnr 歌曲比较 10th 群青apd 比较指定两首歌的mnr挑战分数 最强组卡示例

/最强组卡 和活动无关的分数最大组卡 /最强组卡 综合 综合力最大组卡 /最强组卡 实效 实效最大组卡(支援队) 加成组卡示例

/加成组卡 100 当期活动凑100加成 /加成组卡 120 130 凑120或130加成 /加成组卡 event123 100 指定活动 烤森组卡示例

/烤森组卡 当期活动烤森组卡 /烤森组卡 event123 指定活动 /烤森组卡 绿 mmj 模拟绿mmj加成活动

养成

指令	功能
/每日挑战 /pjsk challenge info /挑战信息 /挑战详情 /挑战进度	查询账号每日挑战的奖励获取进度。
/角色加成 /pjsk power bonus info /加成信息 /加成详情 /加成进度	查询账号的各角色加成信息。
/区域道具 /pjsk area item /area item /区域道具升级	查询对应区域道具升级所需要的素材
/羁绊 /pjsk bonds /羁绊等级 /角色羁绊 /牵绊	查询账号的羁绊等级
/队长统计 /领队统计 /角色领队 /pjsk leader count	查询队长次数

MySekai相关查询

INFO

Android 用户建议使用 Haruki工具箱-上传MySekai数据 的继承码上传
台服/韩服 Android用户教程参考Haruki工具箱-HarukiProxy使用教程
iOS / iPadOS 用户 建议使用代理工具MitM模块更新，教程参考Haruki工具箱-iOS模块上传数据教程

⚠️ 所有 MySekai 指令需用户绑定 Haruki工具箱 账号 ⚠️ 本功能不支持国服

指令	功能
/msa /pjsk mysekai res /mysekai-resource /mysekai资源 /烤森资源	查询烤森信息 （资源 天气 来访角色等）
/msm /pjsk mysekai map /mysekai-map /mysekai地图 /烤森地图 /msmap	查询烤森地图
/烤森对话列表 /mysekai-talk-list /mysekai对话列表	查询烤森角色对话列表
/烤森家具列表 /mysekai-fixture-list /mysekai家具列表	查询账号已获得家具列表
/家具列表 /pjsk mysekai furniture /pjsk mysekai fixture /msf /mysekai 家具	查询所有家具列表
/msg /pjsk mysekai gate /mysekai-door-upgrade /mysekai大门升级 /烤森大门升级 /msgate	查询烤森大门升级所需材料
/msr /pjsk mysekai musicrecord /mysekai-music-record /mysekai唱片 /烤森唱片 /mss /mssong	查询烤森音乐唱片收集
/msb /pjsk mysekai blueprint /mysekai blueprint /mysekai 蓝图	查询烤森蓝图列表
/msp /pjsk mysekai photo /pjsk mysekai picture /mysekai 照片	展示烤森内拍摄的照片

昵称设置

指令	功能
/歌曲别名 /pjsk alias /music alias /查歌曲别名	查询曲目别名
/添加歌曲别名 /music alias add /pjsk alias add	添加曲目别名至待审核列表
/删除歌曲别名 /music alias del /pjsk alias del	管理员删除曲目别名
/角色别名 /pjsk chara alias /chara alias /查角色别名	查询角色别名
/添加角色别名 /pjsk chara alias add /chara alias add	添加角色别名至待审核列表
/删除角色别名 /pjsk chara alias del /chara alias del	管理员删除角色别名
/待审核别名 /别名待审核 /歌曲别名待审核 /角色别名待审核	管理员查询待审核列表
/同意别名 /通过别名	管理员审核通过别名
/拒绝别名	管理员审核拒绝别名

INFO

所有歌曲昵称设置，角色昵称设置的日志内容将会在实时日志页面按日公示。
若违反相关条例将会视情况采取删除对应昵称至禁止使用Bot不等的措施。 审核别名需要对应权限，为管理员人工进行，请不要添加网络垃圾增加大家的工作量

杂项

指令	功能
/生日 /pjsk chara birthday /角色生日 /查生日	查询角色生日
/贴纸 /查贴纸 /pjsk贴纸 /pjsk表情 /pjsk stamp /stamp	查询贴纸
/pjsk live /虚拟live /pjsk vlive /vlive	查询虚拟 Live 信息
/逮捕 /pjsk逮捕 /pjsk arrest	查询指定账号乐曲clear/fc/ap进度，不指定uid会查询默认账号
/查卡池 /pjsk gacha /卡池列表 /卡池一览 /卡池	查询卡池列表

关于

• HarukiBot NEO画图与功能参考实现 - LunaBot: ルナ茶
• HarukiBot NEO开发者: 星云希凪、灵潜、Deseer、storyxy3
• 联系开发团队: haruki@seiunx.com
• wiki原作者：綿菓子ウニ
• 使用授权：点击查看
• wiki适配与编辑：岩崎阳子、Aposetles、星云希凪、storyxy3
• 联系我：admin@shiromiku.moe或QQ：57892198
• Logo画师：小沢翼

使用框架

• QQbot框架: Mrs4s/go-cqhttp
• SDK: nonebot/aiocqhttp

数据来源

• 预测线: 33Kit、Moesekai
• 谱面预览: ぷろせかもえ！ code --install-extension yzhang.markdown-all-in-one