2026/9/3大约 18 分钟
鸣潮
功能描述
鸣潮数据查询：支持库街区登录、角色面板、深塔查询、抽卡记录、排行、图鉴与日历等。
本页功能由 GsCore（早柚核心） 的 XutheringWavesUID 插件提供，共 98 条指令。
使用前提
- 群聊需已开启 GsCore 相关功能（部分指令需 @机器人 或加前缀触发）。
- 大部分查询需要先完成账号绑定，绑定方式见下方「账号绑定」分类。
- 指令中标注
需CK的表示需要先向 GsCore 提供对应平台的 Cookie/CK。 - 发送
面板替换帮助可让机器人在群内直接渲染帮助图。
指令前缀
本插件支持的触发前缀：
| 前缀 | 说明 |
|---|---|
ww | 该插件注册的触发前缀 |
触发方式以「指令列表」中的 示例 列为准：示例里带了前缀的，实际发送时就需要带上。
指令列表
绑定账号（5 条）
在执行查询之前请绑定账号
| 指令 | 说明 | 示例 |
|---|---|---|
绑定特征码 | 绑定鸣潮 UID（特征码 = UID，9 位数字）。首次使用本插件需要先绑定。 | 绑定123456 |
切换特征码 | 在已绑定的多个 UID 间切换默认账号。 · 需CK | 切换123456 |
删除特征码 | 删除单个已绑定的 UID。 | 删除123456 |
查看或刷新特征码列表 | 查看自己当前绑定的所有 UID 列表。查看 仅查看；刷新绑定 会从米游社/库街区刷新角色头像和昵称缓存。 | 查看 or 刷新绑定 |
删除全部特征码 | 一键解绑当前用户全部 UID（破坏性）。 | 删除全部特征码 |
库街区登录（5 条）
在执行查询之前请库街区登录
| 指令 | 说明 | 示例 |
|---|---|---|
推荐->登录页登录 | 进入库街区登录页流程绑定 cookie。Bot 会回复登录链接，用户在浏览器完成登录后回填。这是国服推荐方式。 | 登录 |
国际服登录 | 国际服账号通过邮箱+密码登录绑定。Bot 会引导用户在私聊中分步输入邮箱、密码。 | 邮箱登录 |
添加token | 高级用户用：手动绑定库街区 token + device id（格式 添加token <token>,<did>）。普通用户用 登录 即可，不需要 token。 | 添加token tk,did |
删除token | 删除当前 UID 绑定的库街区 cookie/token。 | 删除token 123456 |
获取绑定的token | 查看自己当前绑定的 token（仅自己可见，私聊回复，用于排查或迁移）。 · 需CK | 获取token |
信息查询（22 条）
在执行查询之前请绑定账号
| 指令 | 说明 | 示例 |
|---|---|---|
鸣潮面板更新 | 从米游社/库街区拉取最新角色面板数据。刷新面板 全员；刷新<角色名>面板 只刷某角色。这是有 API 调用副作用的写操作。 · 需CK | 刷新(椿)面板 |
练度统计 | 查询账号下全部角色的练度排行（按角色等级/共鸣链/武器精炼/声骸主词条评分排序）。可加 刷新 前缀（如 刷新练度统计）从米游社拉新数据后再统计。 · 需CK | 练度统计 |
基本信息卡片 | 查询账号总览卡片（等级/活跃天数/已激活角色数/已开启探索点等）。 · 需CK | 卡片 |
查询声骸列表 | 查询自己拥有的声骸列表，按 cost 和评分排序。可加页码（如 声骸列表2 第 2 页）。 · 需CK | 声骸列表1 |
查询角色面板 | 查询某个角色的完整面板（属性 / 装备的武器 / 声骸 / 共鸣链 / 实战伤害评分）。命令格式：<角色名>面板 或 角色面板<角色名> 或 查询<角色名>。例：长离面板、椿面板、角色面板凌阳。 · 需CK | 椿面板 |
查询角色伤害 | 查询某角色按 N 号档位面板配置算出的伤害分析（包含技能倍率、暴击期望、配队 buff 推算）。格式：<角色名>伤害<N>，N 是档位（1/2/3 等，对应不同模拟环境）。例：长离伤害3。 · 需CK | 椿伤害3 |
查询角色权重 | 查询某角色的声骸主/副词条权重配置（即评分公式所用的权重表）。格式：<角色名>权重。 · 需CK | 椿权重 |
查看优化建议 | 给出某角色提升综合评分的方向：推荐的最优声骸主/副词条配置，以及当前面板各词条的提升收益排序。格式：<角色名>优化（同义：优化建议 / 提升 / 提升建议 / yh）。例：椿优化。 · 需CK | 椿提升建议 |
窥视(: | 查别人的角色面板（不需要对方绑定）。格式：<对方9位UID><角色名>面板，例 123456789长离面板。 · 需CK | 123456789椿面板 |
面板PK | 两人同角色面板对比图。格式：(可选 uid)<角色名>面板pk(@群友)。需要 @ 群友功能配合，AI 路径下不可用。 · 需CK | (uid)椿面板pk(@群友) |
体力 | 查询自己的鸣潮每日实时状态：结晶波片体力数值 / 满体力剩余时间 / 每日任务进度 / 周本完成情况 / 训练塔进度。命令字：体力 / 每日 / mr / 便笺 / 便签 / 实时便笺。 · 需CK | mr/每日 |
查询探索度 | 查询世界探索度图（按地区列出探索进度、声笺收集、宝箱、视界等）。 · 需CK | 探索度 |
库洛币 | 查询当前库洛币余额及月卡/每日签到状态。 · 需CK | 库洛币 |
日历 | 鸣潮当期/下期活动 + 当前/下期卡池倒计时一览图。 | 日历 |
面板替换帮助 | 面板图自定义替换说明：如何上传/查看/删除自己的角色背景图。 | 替换帮助 |
兑换码 | 列出当前所有可用的鸣潮兑换码 + 各码奖励内容 + 过期时间。 | 兑换码 |
角色养成 | 查询某角色的养成材料一览（突破/天赋升级所需周本素材/小怪掉落/技能书等）。格式：<角色名>养成。例：菲比养成。 · 需CK | 菲比养成 |
星声统计 | 查询账号星声（鸣潮原石）收入支出统计。可选时间范围：版本号 / 本月 / 上周。格式：星声<范围>，例 星声2.3版本、星声本月、星声上周。无参数则统计全部。 · 需CK | 星声(2.3版本/本月/上周) |
打牌 | 群内多人卡牌小游戏。命令 poker 启动。这是多轮交互游戏，AI 路径下不可用。 · 需CK | poker |
卡池倒计时 | 查询当前/下期卡池倒计时图。可指定类型：未复刻角色 / 未复刻武器；可附带星级：5 / 4。例：未复刻角色5 看 5 星未复刻角色倒计时。 | 未复刻角色/武器(5/4) |
角色持有率 | 查询角色持有率统计（按 plugin 范围 / 群范围 / 全局范围）。格式：(群)角色持有率(up/all)。up = 仅 UP 池角色；all = 全角色。加 群 = 本群范围。例：群角色持有率up。 | (群)角色持有率(up/all) |
周年庆 | 鸣潮 2 周年限定回顾报告（个人统计 + 主题彩蛋）。 · 需CK / 需SK | 周年回顾 |
深塔查询（7 条）
深塔数据查询
| 指令 | 说明 | 示例 |
|---|---|---|
深塔 | 查询自己本期逆境深塔（深境区/超载/稳定/实验）的挑战记录与通关层数、用时、上阵角色。需绑定 cookie。命令字：深塔 / st / 逆境深塔 / 超载 / 稳定 / 实验。 · 需CK | st/深塔 |
全息战略 | 查询自己的全息战略（同步挑战，boss 单挑模拟玩法，如朔雷之鳞等）通关情况。 · 需CK | qx/全息 |
深塔出场率 | 本期逆境深塔本群/全体角色出场率统计（哪些角色被用得多）。 | 深塔出场率 |
冥歌海墟 | 查询自己冥歌海墟（海墟/无尽深渊/禁忌海域/再生海域）的挑战记录。命令字：hx / 冥海 / 海墟 / 冥歌海墟 / 无尽 / wj / 禁忌 等。 · 需CK | hx/冥歌海墟 |
冥歌海墟出场率 | 本期冥歌海墟角色出场率统计。 | 冥海出场率 |
终焉矩阵 | 查询自己全息矩阵（终焉矩阵 / 矩阵叠兵）的挑战记录：稳态协议(简单关)和奇点扩张(难关，玩家口中的「矩阵」一般特指这关)的通关状态、积分、队伍配置。命令字：矩阵 / jz / 终焉矩阵 / 矩阵叠兵 / 奇点扩张 / 稳态协议。 · 需CK | 矩阵/jz |
矩阵出场率 | 本期奇点扩张队伍出场率统计：热门配队（按出现次数）+ 高分配队（按平均分），各取前8。可选传角色名只看含该角色的队伍。命令字：矩阵热门队 / 矩阵高分队 / 矩阵配队 / 矩阵出场率。 | 矩阵出场率 椿 |
排行查询（10 条）
排行查询
| 指令 | 说明 | 示例 |
|---|---|---|
群伤害排行 | 本群某角色的伤害排行（按角色伤害数值从高到低）。格式：<角色名>排行。例：长离排行、椿排行。 | 长离排行 |
群评分排行 | 本群某角色的声骸评分排行（按总评分排序）。格式：<角色名>评分排行。例：长离评分排行。 | 长离评分排行 |
全体伤害排行 | 全体某角色的伤害排行（跨群）。格式：<角色名>总排行<页码>。N 是页码（1/2/3...）。例：长离总排行1。 | 长离总排行1 |
全体评分排行 | 全体某角色的声骸评分排行。格式：<角色名>评分总排行<页码>。例：长离评分总排行1。 | 长离评分总排行1 |
练度排行 | 本群按练度评级筛选的排行。评级 a / s / ss 三档（a 一般、s 较好、ss 顶级）。格式：练度排行<评级>。例：练度排行s、练度排行ss。 | 练度排行a/s/ss |
练度总排行 | 全体练度总排行（按账号综合练度评分）。格式：练度总排行<页码>。例：练度总排行1。 | 练度总排行1 |
海墟无尽排行 | 本群冥歌海墟无尽层（最深层）排行。 | 无尽排行 |
海墟无尽总排行 | 全体冥歌海墟无尽层排行。格式：无尽总排行<页码>。 | 无尽总排行1 |
矩阵群排行 | 本群终焉矩阵积分排行。 | 矩阵排行 |
矩阵总排行 | 全体终焉矩阵积分排行。格式：矩阵总排行<页码>。例：矩阵总排行1。 | 矩阵总排行1 |
抽卡记录（9 条）
抽卡记录
| 指令 | 说明 | 示例 |
|---|---|---|
抽卡帮助 | 查看抽卡记录功能的导入说明 + 命令一览图。 | 抽卡帮助 |
抽卡登录 | 云·鸣潮（国服云游戏）手机号+验证码登录，登录信息入库后用于自动获取抽卡 recordId，无需再贴链接。登录后会在主插件登录有效时自动更新一次。命令字：抽卡登录/云鸣潮登录/云登录。 | 抽卡登录 |
更新抽卡记录 | 用已入库的云·鸣潮登录信息自动获取 recordId 并更新抽卡记录。需先 抽卡登录，且主插件登录（ck）有效。命令字：更新抽卡记录/刷新抽卡记录。 · 需CK | 更新抽卡记录 |
导入抽卡链接 | 通过抽卡链接 URL 导入抽卡记录。格式：导入抽卡链接 <url>。url 形如 https://...record_id=xxx，用户应先查看 抽卡帮助 获取链接。 · 需CK | 导入抽卡链接 https://...record_id=5e4d436ea1 |
导入工坊抽卡记录 | 通过工坊导出格式批量导入抽卡记录。格式：导入抽卡记录 <uid>。 · 需CK | 导入抽卡记录 uid |
抽卡记录 | 查询自己已导入的抽卡记录统计：各卡池总抽数 / 当前距离保底 / 出 5 星历史平均抽数 / 欧非指数等。命令字：抽卡记录 / 抽卡页面。需要先导入。 · 需CK | 抽卡页面/抽卡记录 |
导出抽卡记录 | 把自己的抽卡记录导出为 JSON 文件回传，方便换 bot 迁移。 · 需CK | 导出抽卡记录 |
抽卡排行 | 本群抽卡排行。支持三种模式：抽卡排行欧 看 5 星出货数最多；抽卡排行非 看歪 4 星最惨；抽卡排行抽数 看总抽数。无参数默认按抽数。 | 抽卡排行(欧/非/抽数) |
删除抽卡记录 | 删除指定 UID 的全部抽卡记录（破坏性）。格式：删除抽卡记录<uid>。 · 需CK | 删除抽卡记录uid |
面板图帮助（5 条）
面板图帮助
| 指令 | 说明 | 示例 |
|---|---|---|
上传角色面板图 | 上传自定义角色面板背景图。格式：上传<角色名>面板 或 上传<角色名>背景图，发完命令后跟着发图片。 · 需管理员 | 上传椿面板/背景图 |
查看角色面板/背景图 | 查看已上传的某角色面板/背景图。格式：提取面板图<面板图编号>。 | 提取面板图+[面板图] |
面板图列表 | 查看某角色已上传的面板/背景/体力/卡片图列表。格式：<角色名><面板|面包|🍞|card|体力|每日|mr|背景|bg>图列表。 · 需管理员 | 椿面板图列表 |
删除面板图 | 删除某角色的指定编号面板图。格式：删除<角色名>面板图<编号>。 · 需管理员 | 删除椿面板图123 |
删除全部面板图 | 删除某角色的全部面板图（破坏性，按类型）。格式：删除全部<角色名><面板|背景|体力|...>图。 · 需管理员 | 删除全部椿面板图 |
WIKI（13 条）
获取游戏信息&攻略
| 指令 | 说明 | 示例 |
|---|---|---|
角色攻略 | 查询某角色的攻略图（社区作者贡献的配装/共鸣链优先级/技能加点等）。格式：<角色名>攻略，例 长离攻略、椿攻略、忌炎攻略。 | 椿攻略 |
角色共鸣链 | 查询某角色的共鸣链详情图，含每条共鸣链的效果文本。格式：<角色名>共鸣链。 | 安可共鸣链 |
角色技能 | 查询某角色的全套技能（常态攻击/共鸣技能/共鸣解放/变奏/延奏/固有/特殊）描述与倍率。格式：<角色名>技能。 | 维里奈技能 |
角色机制 | 查询某角色的玩法机制说明图（特殊能量条 / 招式系统 / 共鸣链交互机制等）。格式：<角色名>机制。 | 维里奈机制 |
角色别名 | 查询某角色已注册的全部别名（俗称、外号、英文名）。格式：<角色名>别名。直接发 别名 则查看全部角色别名。 | 维里奈别名 |
武器介绍 | 查询某武器的详细介绍（基础属性 / 突破素材 / 满级面板 / 效果描述 / 各精炼数值）。格式：<武器名>介绍。例：椿专武介绍、不屈命定之冠介绍。 | 椿专武介绍 |
声骸介绍 | 查询某声骸的详细介绍（cost / 所属合鸣套装 / 技能效果 / 各等级倍率）。格式：<声骸名>介绍。例：角介绍、无冠者介绍。 | 角介绍 |
武器列表 | 查询武器一览表，可按武器类型过滤。格式：<武器类型?>武器<列表?>。武器类型可选：长刃 / 迅刀 / 佩枪 / 臂铠 / 音感仪。例：音感仪武器列表、迅刀武器。 | (武器类型)武器(列表) |
套装效果 | 查询全部合鸣套装一览图，含 2/5 件套效果。可附带版本号筛选最新版本套装。格式：套装列表 或 套装列表<版本>。例：套装列表3.0、套装列表。 | 套装列表3.0 |
深塔海墟信息 | 查询深塔/海墟某期的关卡 + Buff + 怪物分布配置图。格式：深塔信息<期数> 或 海墟信息<期数>。例：深塔信息11。 | 深塔/海墟信息11 |
游戏公告列表 | 查询当前游戏内活动 / 系统 / 更新公告的列表索引。 | 公告 |
游戏公告明细 | 查看指定公告 ID 的全文。格式：公告#<id>，id 是公告列表里的编号。例：公告#1456。 | 公告#1456 |
综合评分说明 | 查看综合评分的计算规则与评分细则说明图（计分基准、共鸣效率乘区、收益得分等）。 | 综合评分说明 |
个人服务（4 条）
该配置项仅针对个人使用
| 指令 | 说明 | 示例 |
|---|---|---|
设置体力背景 | 设置体力图的自定义背景，可选角色立绘或自定义图。格式：设置体力背景<角色名> 或 设置体力背景<图片hash>。 | 设置体力背景长离/a1b2c3d4 |
设置角色面板图 | 把某角色面板背景设置为指定的自定义图。格式：设置<角色名>面板图<hash>。先用 上传<角色>面板 上传，再用本命令绑定。 | 设置长离面板图a1b2c3d4 |
设置语言 | 设置面板/体力/卡片等渲染图的显示语言。格式：设置语言<语言代码>。语言代码：chs / cht / en / jp /kr。 | 设置语言en |
设置(取消)隐藏UID | 开启或关闭自己 UID 在所有渲染卡片中的脱敏显示（前 2 位 + **** + 后 2 位）。未设置时跟随全局 HideUid 开关。命令：设置隐藏uid / 取消隐藏uid。 · 需CK | 设置(取消)隐藏uid |
群管理员功能（8 条）
群管理员功能
| 指令 | 说明 | 示例 |
|---|---|---|
订阅鸣潮公告 | 本群订阅鸣潮游戏官方公告推送（新公告会自动转发到本群）。 · 需管理员 | 订阅公告 |
取消订阅鸣潮公告 | 取消本群公告订阅。 · 需管理员 | 取消订阅公告 |
排行条件-无限制 | 设置本群排行计入条件为「无限制」（任何绑定 UID 即可上榜，不要求登录 cookie）。 · 需管理员 | 设置群排行1 |
排行条件-登录 | 设置本群排行计入条件为「需登录」（必须有 cookie 才能上榜，过滤纯绑定 UID 的用户）。 · 需管理员 | 设置群排行2 |
排除攻略提供方 | 本群屏蔽指定攻略作者，攻略图不再出现这些作者。多个用中文逗号分隔。格式：设置排除攻略 作者1，作者2。 · 需管理员 | 设置排除攻略 作者1，作者2 |
设置抽卡条件 | 设置本群抽卡排行最低抽数门槛，低于这个数不参与群排行。格式：设置抽卡条件 <数字>。 · 需管理员 | 设置抽卡条件 1200 |
删除单个群成员 | 强制解绑本群某 UID（破坏性，群管理员操作）。格式：删除群成员uid<UID>。 · 需管理员 | 删除群成员uid123456789 |
删除不活跃群成员 | 一键清理本群超过 30 天未活跃的绑定（破坏性）。 · 需管理员 | 删除不活跃群成员 |
bot主人功能（10 条）
bot主人功能
| 指令 | 说明 | 示例 |
|---|---|---|
git更新记录 | 查看插件最近的 git 提交记录。 · 需管理员 | 更新记录 |
下载全部资源 | 从小维服务器补充下载鸣潮插件所需的角色/武器/声骸/攻略图等资源（首次安装或资源损坏时用）。耗时较长。使用强制下载全部资源 可清除旧的构建、评分资源完全重新下载。 · 需管理员 | 下载全部资源 |
删除无效token | 扫描全部已绑定 cookie，清理失效的 token。 · 需管理员 | 删除无效token |
清理缓存 | 清理过期的公告和日历图片缓存以释放磁盘。 · 需管理员 | 清理缓存 |
压缩面板图 | 把上传的面板/背景/体力/卡片图批量压缩存储以节省磁盘。 · 需管理员 | 压缩面板图 |
重新计算特征 | 重新计算所有面板/背景/体力图的 ORB 特征缓存，并自动清理无对应图片的孤儿缓存。 · 需管理员 | 重新计算特征 |
查看重复面板图 | 扫描已上传的面板图，按 ORB 相似度阈值找出疑似重复的图。格式：查看重复面板图<阈值>，阈值 0~1 之间（越接近 1 越严格）。 · 需管理员 | 查看重复面板图0.8 |
联系主人 | 通过 bot 给主人发消息（请求出问题时发，同时作为用户上传面板图审核用）。 · 需管理员 | 联系主人 |
添加/删除角色别名 | 为某角色添加/删除自定义别名。格式：添加<角色>别名<新别名> / 删除<角色>别名<别名>。例：添加椿别名花女。 · 需管理员 | 添加油壶别名杂鱼 |
删除导入记录 | 删除全部抽卡导入历史（清理 bot 端记录用）。 · 需管理员 | 删除导入记录 |
使用示例
（示例待补充）
通用游戏信息检索
除上述游戏内数据查询外，机器人还支持检索游戏基础信息（折扣、简介、评分等）。
| 指令 | 说明 | 示例 |
|---|---|---|
查询 <游戏名> | 检索游戏名称，返回游戏的基础信息 | 查询 鸣潮 |
id <appid> | 通过 AppID 反查游戏 | id 570 |
打折游戏 | 查询当前打折的游戏 | 打折游戏 |