Skip to content
RayleaBotPublic

About

原神独立查询、离线图鉴、公开展柜与抽卡档案

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

原神插件

独立的 RayleaBot Go/Vue 插件,要求包含通用插件服务能力的 Core。游戏增强直接在本插件内实现;账号使用独立的米游社账号插件。

当前能力

  • 通过 accounts v1 共用一次米游社登录,读取已授权角色并选择默认 UID;游戏插件不持有 CK。
  • 基础信息、实时便笺、角色列表、已装备武器列表与基础角色详情;当前主要挑战的摘要和已适配队伍记录。
  • Yunzai 与 miao 写法重叠的命令按 Miao-Yunzai 处理:miao 的“Yunzai 功能使用喵喵版”开关视为全部开启,miao 的规则先于 Yunzai,Yunzai 抽卡记录在匹配前把 #角色统计、#武器统计 改写为 #角色池统计、#武器池统计。#角色(#五星角色、#喵喵查询、#uid<UID> 等)按 miao 的角色列表出图,合并该 UID 已保存的面板;#练度统计 与 miao 接管的 #五星列表、#武器汇总、#火角色统计 等按 miao 的练度统计出图,同样合并该 UID 已保存的面板,写星级或元素时只列这些角色。#深渊(#喵喵深渊、#上传深渊、#深渊数据 等)按 miao 的深渊页出本期战绩,#上期深渊、#往期深渊、#深渊上期、#深渊本期 与 #深渊12层(#深渊上期第12层 等)仍按 Yunzai 的页面;#剧诗(#上期剧诗、#幻想、#喵喵剧诗 等)全部由 miao 接管,按 miao 的剧诗页出图。
  • 按固定参考版本提供 376 条离线角色、装备等资料,支持查询和自定义别名。
  • 没有 CK 也可 #绑定uid<UID> 绑定 UID,#uid 列出、#uid<序号> 切换、#删除uid<序号> 删除。
  • 命令中 @ 他人时读取对方当前使用的 UID,如 #抽卡分析@某人、#胡桃面板@某人;只读取已保存的记录、面板与展柜,不使用对方账号。
  • 面板按 UID 保存在本地:#更新面板 [UID] 读取 Enka 展柜,#米游社更新面板 读取本人账号的全部角色,#面板列表 按 miao profile-list 出图,#删除面板<UID> 删除本人 UID 的面板,#圣遗物列表 按 miao artis-list 列出评分最高的 28 件,#雷神换90级5精护摩换绝缘4 等按 miao 的写法换装后重新计算面板,#今日素材 [UID](或明天、周三,也可按 miao 写作 #每日天赋 等)按 miao today-material 列出当天可升天赋的角色与可突破的武器;#胡桃面板 等先读保存的面板,没有时读取本人账号或展柜。
  • 私聊或群聊发送游戏内祈愿历史记录的链接,按 Yunzai 读取全部卡池的记录并出抽卡记录图,无需账号;链接的 UID 成为当前使用的 UID,群聊中提示撤回。收到链接后转入宿主的后台事件,在同一事件中依次读取全部卡池再回复,后台事件已满时回复稍后再试;链接只在读取期间保存在内存中。#抽卡帮助 与 #安卓帮助、#苹果帮助、#电脑帮助 发送 Yunzai 的获取教程。#设置全量更新抽卡记录 后十分钟内发送的链接重新读取全部记录(读完后自动关闭),#设置全量更新抽卡记录关 取消。
  • #抽卡记录(#角色记录、#武器记录、#常驻分析 等,可带“喵喵”)与 #抽卡统计(#角色统计、#武器统计、#全部统计、#版本统计 等)按 miao 的抽卡分析与抽卡统计页出图。miao 不接的写法仍按 Yunzai:#全部记录、#新手记录、#角色联动记录 等出 Yunzai 的抽卡记录页,#新手统计、#原神角色统计 等出 Yunzai 的抽卡统计页,列出每期卡池的抽数与所得四星、五星及次数,群聊中只列约十二行。
  • 私聊发送米游社客服页面(自助查询)的链接,按 Yunzai 读取创世结晶与纪行记录并出充值统计图,结果按发送者保存:#充值记录(#消费统计 等)查看,#更新充值记录 在一天内用同一链接重新读取,没有链接时按逍遥插件用当前账号读取(由账号插件以 SToken 换取客服授权,授权不离开账号插件);#刷新充值记录(#刷新氪金记录)按逍遥插件总是用当前账号读取。两种读取都先转入宿主的后台事件,在同一事件中读完两份记录再回复,后台事件已满时回复稍后再试。链接的 authkey 只保存在内存中,群聊中的链接与上游一样不处理。
  • 按 Yunzai 的写法在聊天中导入导出抽卡记录:#导入记录 后两分钟内发送 UIGF v4 或旧版 UIGF 文件(或文件的 https 链接),按记录 ID 去重合并;#导出记录 发送当前 UID 的 UIGF v4 文件,#导出记录v2 发送 UIGF v2.3 文件。群聊中需写作 #强制导入记录、#强制导出记录,收到文件后提示撤回。大整数记录 ID 保持原样,原始本地时间不转换;文件缺少的名称、类型与星级按固定资料补全,导入失败不改变已有档案。
  • 独立的游戏查询、资料图鉴、抽卡档案、体力提醒与面板历史管理页,聊天结果优先渲染图片,渲染不可用时回退文本。游戏查询、提醒与收集、面板历史、养成计算、群设置与排行、游戏签到、云排名与面板、社区与云游戏、兑换码与资产、活动与收藏按机器人账号分页,由宿主在页面上方切换账号,只显示所选机器人账号下的角色、任务与群;其余页面为全局,其中抽卡档案按 UID 与区服保存,不属于任何机器人账号。

命令以 info.json 的实际声明为准,使用宿主的通用前缀;下文以 # 代表通用前缀,例如 #体力。上游允许 UID 紧跟在命令后的写法(如 #探索100000001)同样可用,与用空格分开相同;上游以 [ |0-9]* 读到末尾的命令(如 #深渊、#武器、#探索、#练度统计),后面的数字不是 UID 时按上游忽略、读取当前 UID,写了上游不接受的文字时不回应。公开资料、公开 UID 展柜和管理页中的历史抽卡档案可在未安装账号插件时使用。聊天中的抽卡记录与 Yunzai 相同,读取所指定 UID 或当前使用的 UID(含未绑定账号的 UID)的档案。

  • 管理页的“提醒与收集”可复用已绑定账号同步官方抽卡记录,支持增量/全量、取消和失败继续;读完所有卡池后才保存,避免半途失败改变原档案。

官方查询扩展

剧诗、幽境危战、旅行札记和七圣召唤(概况、牌库、牌组)。

可在游戏查询页选择对应业务,或使用 info.json 中声明的命令。月份省略时读取官方默认月份,可填 1–12。

实际账号已验证可用只读端点及相关期次参数,未参与玩法的丰富历史记录仍需继续验收。受限功能保留在完整目标中。

详细面板与评分

角色面板展示官方属性、装备词条、技能及命座;管理页可展开效果说明。

使用 #胡桃圣遗物 [UID](也可写 #评分 胡桃),管理页也可计算。评分与伤害先读本地保存的面板,没有时读取本人账号的官方面板并保存;权重按上游规则随角色当前属性、命座与配装自动选择。缺少必要数据的装备不评分。评分不是完整伤害计算。

角色自动计算与武器换装

发送 #胡桃伤害 [UID],或在角色面板下点击“读取并自动计算”,查看固定参考情境中的角色、武器和套装增益。管理页可选择候选武器、等级、突破和精炼,比较期望或暴击值。基准与候选均重新读取当前授权面板;试算不改变游戏装备。#胡桃伤害(或 #胡桃武器,可带序号如 #胡桃伤害3)按 miao 的伤害页出图:伤害表带序号,另附所选伤害的词条伤害计算(副词条两两置换后的平均伤害变化)与 Buff 列表。按 miao 发送 #敌人等级 90 可指定自己的面板与伤害计算所用的敌人等级,默认 103;群排名始终按 103 计算。

半血、满层、击杀等条件来自每条参考规则,展开情境可查看增益和适用技能。支持明确未装备状态;缺失必要数据时拒绝计算。可从同账号另一角色调入整套装备,与候选武器一起试算。可编辑队伍与条件并保存预设;完整实战对照仍需按具体账号验收。

记录与体力提醒

  • 抽卡档案的“查看统计”提供按池、稀有度、日期和物品筛选的分页明细,以及月份、物品分布和完整间隔均值;未知稀有度不输出确定保底,档案变化后重新从第一页读取。
  • “面板历史”页面主动读取并保存官方角色面板,每个角色最多 20 份,可查看、比较属性/配装/技能、导出或移除。保存时间与资料版本一并展示;撤销账号授权后不能继续访问历史。
  • “体力提醒”页面选择账号、阈值和期限,确认后开启每十分钟检查。只私聊账号所属用户,持续高于阈值只通知一次,低于阈值后重新待发。
  • 群聊按逍遥插件使用 #开启体力推送、#关闭体力推送 加入或退出本群的体力推送,#体力设置群推送开启/关闭、#体力设置群阈值120(20–160)设置本群;管理页“逍遥插件设置”的群体力推送总开关(与上游一样默认关闭)打开后,每十分钟检查一次,树脂达到本群阈值时在群里 @ 本人并附体力图,十二小时一次。设置本群默认仅超级管理员可操作,可改为群管理员。开启时为当前使用的角色建立 90 天的只读体力委托,再次开启即续期;上游在本人不在名单时“关闭体力推送”会误删名单最后一人,这里只移除本人。
  • 提醒状态跨重启保存,验证失败退避一天,账号移除/授权撤销/到期后暂停。发送结果不明确时不自动重复发送;进程恰在发送前崩溃可能漏一次通知。现有账号默认不启用提醒。
  • 定时任务按宿主触发时给出的任务 ID 分派;插件不再保存的任务(包括此前版本留下的临时任务)在下一次触发时删除自己。

养成、材料与模拟

  • “养成计算”读取官方当前等级,可选择角色、装备及技能目标,查询材料需求;聊天 #角色名养成 [UID](#角色名计算 等价)计算升至上限。不会升级或扣除材料。当前支持等级 1–90。
  • “材料与卡池”查询固定参考材料来源、相关角色/装备和历史期次,支持版本和国服日期筛选。原神另有轮换副本日与固定生日资料。聊天使用 #名称材料,名称是角色时按 Yunzai 发送米游社合集(友人A 等)中的角色培养素材图(#更新胡桃素材 重新读取,主角回复暂无主角素材);卡池按 miao-plugin 出图:#3.2卡池、#3.2上半卡池 列出该版本的卡池,#角色或武器名卡池 列出其出现过的卡池(详情 显示整个卡池),#卡池 为卡池帮助;固定快照未在线校准,不代表当前活动。
  • “模拟抽卡”提供独立参考娱乐模型和模拟库存/历史,支持 #十连、#十连2、#武器十连、#常驻十连(#抽卡、#单抽 同为十连,按 Yunzai 的十连图出图)、#模拟记录、#重置模拟 确认。管理页可选择参考卡池、目标及每日额度。#定轨 依次切换本期五星武器,最后一把之后取消;也可用“#定轨武器名称”或“#定轨取消”,或在页面选择 1/2 点模型。
  • 模拟不使用 CK、不消耗真实货币、不写入 UIGF;不代表官方概率或保底规则。管理页和聊天档案分开,国服 04:00 重置额度,清空历史不返还当天已用次数;未知响应可重试同一请求避免重复模拟。

群内设置与主动参评

“群内设置”页面可编辑本游戏的群启停、图片/文本回复和群别名,并确认清空本地排行。群设置优先于全局,保存时校验版本;不同协议、机器人和群分别保存。聊天 #群设置 由群管理员、群主或超级管理员使用。

群成员在群内查看单个角色面板时,面板、圣遗物评分与默认伤害按 miao 的群排名自动记入本群(公开 UID 与昵称)。#胡桃排名 按伤害排行,#胡桃圣遗物排名 按评分排行,#群排名 列出各角色第一,#最强胡桃、#最高分胡桃 显示第一名的面板;超级管理员可 #重置排名,群管理员可 #刷新排名、#关闭排名、#开启排名。此功能不是全服排名,再次查看面板时更新;管理员也可在管理页清空本群排行。同 ark-plugin,页面宽 850,单个角色的伤害或圣遗物排行另加一栏 ark 给出的全服排名(默认把本群记录的面板发给 ark 计算),管理页“ark 扩展设置”可关闭或改查 ark 保存的各 UID 面板。

游戏签到与公共资料

“游戏签到”支持状态、当月奖励、单次领取和显式开启每日任务。聊天使用 #签到 [UID]、#签到状态 [UID]、#自动签到 开启/关闭 [UID]。自动任务默认北京时间 08:00、30 天、不主动通知;管理页可改时间、期限与私聊结果选项。验证码或首次绑定在官方应用处理;未确认的上游写入不反复重试。

“游戏查询”中的公共查询池入口只查询目标公开基础资料,使用本人主动加入公共池且仍授权本游戏的账号,不会借用私人账号。#uid<UID>、#+<UID>、#<UID> 与 #角色<UID> 按 miao 出该 UID 的角色列表:UID 不在本人账号上时经公共查询池读取官方首页与角色列表,与该 UID 已保存的面板合并,并注明信息可能不完全。#练度统计、#天赋统计 与 #202507剧诗练度统计 对不在本人账号上的 UID(写出、@ 对方或当前使用的)同样经公共查询池读取,天赋与圣遗物取自该 UID 已保存的面板。账号所有者在账号插件本人私聊中设置用途与预算;没有可用账号/额度时明确提示。

云排名、面板与 UID 验证

“云排名与面板”使用 ark.ivny.cn 的匿名额度,支持额度、玩家角色排名、角色分布和自定义排名。自定义排名可按伤害/装备评分排序、组合两项命座条件,前二十项可在五分钟内查看其公开云面板。服务匿名化 UID 时保持匿名,未知装备词条不补零。

查询前确认发送所填 UID、角色和筛选条件,不发送 CK 或 QQ。任务可取消;切换参数清除旧结果。“接收云端面板”要求先在原机器人主动上传,并在服务十分钟期限内接收,仅查看而不覆盖本地资料。

同 ark-plugin 的 UID 验证:#ark绑定原神uid 向 ark 获取当前使用(或被 @ 的)UID 的验证码,按回复把它设为游戏签名,审核通过后发送 #ark验证原神uid,ark 核对签名后把该 UID 与发送者的 QQ 绑定,在其他装有 ark-plugin 的机器人上无需再次验证。绑定只发送 UID,验证还发送 QQ,因此只有 OneBot11 的 QQ 用户可以验证;群聊与私聊均可使用,回复与失败说明同 ark-plugin。验证不授予本地账号权限。

聊天沿用 ark-plugin 的自定义排行:#ark胡桃排行 [筛选] [数量:N](#ark胡桃伤害排行 同义,#ark胡桃圣遗物排行 按圣遗物评分)列出 ark 收录的该角色面板全服前 N 名(1–50,默认 20),按 miao 的排行图出图,排名说明中写明全服数据、排序与筛选。所有人可按命座筛选(如 命=6、命座<=2、cons>0);等级、突破、天赋、武器、伤害、评分与套装等其余列需超级管理员,且账号插件已配置 ark 令牌。#ark自定义排行帮助 按同样条件给出普通或高级说明。ark 返回的 UID 部分隐藏。五分钟内引用排行图片(或发起排行的那条命令)发送 #ark获取面板N(1–20)即按面板命令的样式查看第 N 名的面板,不记入群排名。超级管理员发送 #arktoken用量 查看 ark 令牌(未配置时为匿名请求)的剩余额度。

同 ark-plugin 的幽境危战排名:在群里 #更新面板 本人绑定的 UID 时,展柜显示的本期幽境危战难度与用时登记到本群;#幽境危战排名 在群内列出本群本期的登记,附 ark 与 akasha.cv 的全服排名,按用时与难度排序出图,写版本号(如 #幽境危战排名6.7,5.7 起)查看该版本并合并本期登记。期次与统计周期按卡池资料推算。管理页“ark 扩展设置”可关闭登记、选择全服排名的数据源(ark、akasha.cv 或二者)。

同 ark-plugin 的面板排名,面板与伤害图在伤害表后加上 ark 的全服总伤害排名与圣遗物排名:默认按“图表排名”显示“排名统计”,画出 ark 的伤害与圣遗物评分分布曲线并标出本面板的位置,下方写“位次 / 总数 (百分比%)”。管理页“ark 扩展设置”可关闭,或改为在伤害表中加一行伤害排名、圣遗物排名或两者,排名写法可选位次、百分比或两者;默认把本地面板发给 ark 计算名次(UID 以 ark 的 999999999 代替),关闭“按本地面板计算”后改查 ark 保存的该 UID 面板;“注明本地数据”在排名后注明(本地)或换装面板的(面板变换)。#胡桃排名统计 同样按这一块出图,画 ark 的伤害与圣遗物评分分布及各自的样本数,标题旁写伤害分布的计算名,没有本面板可标。

同 ark-plugin,面板换装与 ark 重塑识别的面板在每个伤害后标出相对该 UID 已保存面板同名伤害的变化(↑ 绿、↓ 红),伤害标题超过 20 字宽时截断;管理页可关闭变化或改为不处理、换行。

同 ark-plugin,#更新面板 在读取展柜之前先请 ark 更新发送者当前 UID 的云端面板(上游不等待回应,这里最多等五秒,因为账号插件只在事件进行中代发)。管理页开启“首次更新面板时自动从 ark 获取面板”后,当前 UID 还没有保存的面板时,先向 ark 请求该 UID 的面板(发送 QQ 与 UID,需先在 ark 验证过 UID,仅限 OneBot11),按导入面板数据的方式存入并回复“[ark-plugin]已自动从API获取N个数据”,随后照常读取展柜。聊天中的 ark 请求在账号插件配置了令牌时由其携带令牌代发,否则匿名发送。

同 ark-plugin,#角色排名雷电将军123456789 请 ark 更新该 UID 的角色后以文字回复其全服伤害排名与伤害评分(须写明角色与 UID),#总排名 [UID] 以文字列出该 UID 已保存面板的各角色全服排名。这些 ark 命令与导入导出面板数据、ark 验证在 ark 拒绝或请求失败时按 ark-plugin 的错误说明回复;ark 重塑识别与面板换装识别截图失败时同上游不回复或略过该截图。

#导出面板数据、#导入面板数据<UID> 与 #原神导出面板 的使用者按 ark 的设置限制,管理页“ark 扩展设置”可调整:导出面板数据默认允许绑定 CK 的用户与超级管理员,导入面板数据默认只允许超级管理员,导出面板文件默认允许绑定 CK 或已在 ark 验证 UID 的用户;均可改为任何人或禁用。面板换装识别截图(OCR)也可在此关闭。

ark 的 UID 验证和交换接收已有合成验证,尚未替真人账号操作或验收。

抽卡后台与每日同步

“抽卡档案”中的“后台与每日同步”可为已授权国服角色开始单次后台同步,或开启每日同步(1–90 天授权、北京时间执行时刻),支持增量/全量和可选完成通知,默认不发送通知;关闭页面后继续。页面列出插件本次运行以来各角色最近一轮的进度与结果,可取消正在读取的一轮;每日同步任务可重新运行或停止。即时同步入口仍需保持页面打开。

聊天按逍遥插件发送 #更新抽卡记录 [UID] 用账号读取记录,先回复“抽卡记录获取中请稍等...”,读完后在同一聊天按 Yunzai 回复各卡池新增条数;#设置全量更新抽卡记录 后十分钟内的这一轮全量读取。

每一轮都在宿主的后台事件中一次读完,相邻两页至少相隔一秒,以免触发米游社的频率限制;全部池成功后合并。单次同步与更新抽卡记录以发起者的身份读取,后台事件已满时回复稍后再试;每日同步每分钟调度一次,到设定时刻后以只读委托读取当天这一轮,后台事件已满时由下一次调度再读。超过后台时限(默认 15 分钟)、取消或插件重启时本轮作废,已有档案保留。删除档案会停止正在读取的一轮并暂停每日同步。设备验证、授权撤销或记录冲突会暂停每日同步;解决后可明确重新运行,过期委托需移除后重建。

开发与打包

工具链沿用 RayleaBot:Go 1.26.6、Node 26.7.0、pnpm 11.22.0。

node scripts/prepare-ui.mjs
corepack pnpm --dir ui install --frozen-lockfile
go test ./...
corepack pnpm --dir ui test
corepack pnpm --dir ui run build
$env:RAYLEA_PLUGIN_BUILD_USE_WORKSPACE='1'
go run github.com/RayleaBot/RayleaBot/sdk/go/cmd/raylea-plugin build-go --backend ./cmd/genshin --target windows-x64 --include DATA_SOURCES.md=DATA_SOURCES.md --include .rayleabot/source.zip=ui/source.zip

打包前运行 python scripts/bundle-artwork.py --references <参考项目/2026-09-15>,把模板用到的上游图片、字体与资料文件从固定提交复制到 assets/(不纳入版本库,构建时随包分发),再运行 python scripts/source-bundle.py 生成管理页提供下载的源码包。源码包含本插件与相邻 RayleaBot 的 SDK 源码及 go.work,可按上述命令构建;SDK v0.7.0 发布前,独立检出仍需相邻的 RayleaBot 仓库。

另支持 linux-x64 和 macos-arm64。数据文件位于宿主提供的本插件数据目录内;抽卡记录属于非凭据业务数据,使用原子文件替换保存。

当前验证与未完成项

Go 测试、Vue 类型检查、UIGF 导入导出测试和生产构建已通过。四进程开发 smoke 验证共用账号、授权撤销、默认角色、资料与抽卡档案,使用合成账号和模拟上游;主仓库另外验证真实 Registry 生命周期。浏览器使用模拟管理 API 验证查询、角色选择、资料查找、文件导入导出及删除确认。

体力聊天查询已通过真人验收。尚未完成其余真实业务查询、全角色伤害/装备评分、全部挑战详情与历史功能、社区/云游戏任务与其余提醒、云排名/OCR、海外认证及完整升级恢复验收。这是基础版本,不能视为参考插件的全部功能已经复刻。全量范围保留在 RayleaBot docs/plans/game-plugins/。

本项目采用 AGPL-3.0;管理页提供本版本对应源码下载。资料来源与上游许可保留固定快照信息。

查询、历史与群榜

查询结果下可展开完整分组和记录,切换期次/月份后重新查询。月报查询页可保存指定月份、依次保存官方可用月份、累计已保存收入及删除月份。明细和本地历史每次读取重新检查角色授权。

群内“游戏提交挑战 玩法 [本期/上期] [UID]”主动公开本人成绩;“游戏挑战排行 玩法 [期次] [指标] [页码]”分区查看,“游戏退出挑战 [玩法]”删除本人参评。群管理页提供玩法筛选、重新排序和按期清理。“游戏挑战提醒 玩法 指标 阈值 [时间] [UID]”开启每日或每周(如“每周一20时”)的挑战目标检查,未达目标才私聊;“游戏挑战提醒状态”查看,“游戏关闭挑战提醒 [UID]”取消,不影响体力提醒。

卡池资料页支持角色/装备历史、版本和日期筛选及出现次数;抽卡明细页可按版本统计本地档案。资料来自固定快照,推定日期及未覆盖记录明确标记。

提醒页的“每日月报收集”可为所选角色开启有期限的每日保存,通知默认关闭。停止任务不删除已保存月报。超级管理员发送“#原石任务”按 Yunzai 为所有已绑定账号保存本月及官方仍提供月份的札记:任务转入宿主的后台事件,逐个账号保存、间隔半秒,全部完成后回复“原石任务完成”。

云功能与交换档案

云页面可选择匿名或授权额度及高级条件;授权查询使用账号插件管理页“ark 授权令牌”中配置的令牌,由账号插件代发请求。OCR 只接收明确选择的 HTTPS 装备图片,随后可选本人角色进行换装模拟。

“面板交换档案”支持读取本人官方面板、导入旧 miao PlayerData、导出、十分钟上传/接收、导入面板排名及更新请求。官方显示值转换的强化档位属于近似还原。每次传输重新验证角色,导入来源单独保存。

#原神导出面板 同 ark-plugin,把当前 UID 保存的全部面板(不论来自米游社、展柜还是导入)作为 miao 面板数据文件发送,#导出面板数据 同样上传全部面板。

社区、兑换码与公开资料

聊天发送 #兑换码 查询官方前瞻兑换码,始终以可复制的文字回复,包含奖励及可用的有效期信息;开启图片回复时也使用文字。

“社区与云游戏”页提供账号级米游币和明确的社区操作,一次/每日任务可分别选择浏览、点赞和分享。云原神另需在账号插件配置加密云授权,钱包查询可能领取当日时长,操作前须确认。所有定时任务默认关闭。

“兑换码与资产”页匿名读取官方前瞻代码;国服在游戏内兑换,已授权海外角色提供固定官方兑换接口。可分批保存官方当前可读的资产变化记录,按月与来源统计;这些数值不代表实际付款金额。

“公告与活动”页支持官方新闻分页、米游社搜索、文章全文分段及原图链接、国服活动日期。缺失活动时间保留原文,不把公告展示期限当作活动期限。聊天中发送原神的米游社帖子链接时,与 Yunzai 一样按 mysNews 出图。群推送按 Yunzai 的米游社推送:群管理员发送“#开启公告推送”“#开启资讯推送”“#原神开启到期活动推送”开启(“开启”换成“关闭”停止),每五分钟向每个群推送两小时内的一条新帖(按上游屏蔽词过滤,同一帖十小时内不重复),按 mysNews 出图;每天十点后推送一天内结束的活动。超级管理员发送“#推送公告”“#推送资讯”立即在后台检查全部群。

“攻略与工具”页可选择并保存默认攻略来源、浏览合集和官方原图;原神另提供地图服务链接、尘歌壶摹本材料和固定 Atlas 原魔计算。生日沿用材料与卡池页的日期查询。未明确许可的外部攻略和图鉴素材不预装。

聊天按 Atlas 计算原魔属性:#原魔90级丘丘人生命值、#原魔12-3魔偶剑鬼攻击力、#原魔4人无相之水生命值 等,消息中写原魔名或别名(取最长的一个)、可选的“N级”与深渊层间、秘境、联机人数等修饰因子,未写等级时用因子的预设等级或 90 级,按上游格式回复计算式与所用修饰因子。

管理员发送 #素材更新 genshin-atlas 下载 Atlas 原神图鉴后,每条消息先按 Atlas 查找图鉴,与 Miao-Yunzai 上 Atlas 的优先级 10 一样先于 miao 与 Yunzai 的命令(miao 先接走的角色卡片与角色图鉴写法除外,如 #雷神、#雷神图鉴):各模块按 Atlas 的规则接收消息并去掉规则词——多数模块接收带前缀或含“图鉴”的写法(如 #护摩之杖、护摩之杖图鉴、#丘丘人),食物另收“食物”,材料表另收“表格”“素材”“表”(如 #天赋),区域特产只收带前缀的写法,角色培养材料收含“突破”“材料”“素材”“培养”的写法(前缀可省,如 胡桃突破、#堂主材料),七圣召唤卡牌只收不带前缀、含“七圣”或“牌”的写法(如 砂糖牌)。名称按图鉴库或 Atlas 自带的别名换算,角色培养材料另按角色名与别名查找;找到图片即发送,其余消息照常交给后续命令。图鉴库 index/ 中的写法(如 #武器索引、#五星武器、#原魔、#圣遗物、七圣召唤)回复 Atlas 的编号列表,之后本人直接发送序号即按该项查找;列表按 Atlas 的计数失效:本人之后每条消息计一次,选中的一项再计一次,选到结果时清零,计满四次时列表失效。Atlas 本意把列表合并转发、转发失败时出图,但 Miao-Yunzai 的 makeForwardMsg 只生成转发消息而不发送,上游因此总是出图;这里按本意合并转发,无法转发时按 Atlas 的列表页出图。#图鉴帮助(图鉴、wiki、百科或 Atlas 后接帮助、菜单、功能或 help,中间可有空格)按 Atlas 发送其帮助图(随插件包附带),不需要下载图鉴库,之后消息照常交给后续处理。

管理员发送 #素材更新 xiaoyao-plus 下载逍遥图鉴后(相当于开启逍遥插件的图鉴目录开关;库中含卡牌动态视频,约 2.5 GB),带前缀、含“七圣”“七圣召唤”或“原牌”的消息按逍遥插件发送七圣召唤卡牌图:角色名或别名(如 #七圣胡桃、#堂主原牌)发送角色牌,逍遥原魔别名中的名称发送原魔牌,只写旅行者时请选择元素;其余按逍遥的事件牌与武器别名发送行动牌(如 #层岩七圣)。写有“动态”或“幻影”时(行动牌与武器也可只写这两个词,如 #护摩动态)发送卡牌旁的动态视频,没有视频时发送卡牌图(上游此时发送不存在的视频而失败)。回复卡牌图后三小时内,引用这张图并发送含“动态”或“幻影”的消息即发送其视频;引用机器人发出的其他图片时,一小时内回复 miao 的 what.jpg,更早的回复“消息太过久远了,俺也忘了动态是啥了,下次早点来吧~”。上游按消息 ID 记住视频时写了三小时,但其 Redis 调用没有设上过期时间,这里按三小时过期;逍遥在没有找到卡牌时也会结束消息,这里只在发送后结束,其余消息照常交给后续命令。

本地图库与角色互动

“图库与互动”页支持角色照片的图片/目录批量导入、角色关联、修改信息、预览、原图下载与删除。使用者须有对应素材许可。图片不做二次转换;上限为每张4 MiB、2400万像素,全库2000项、512 MiB。WebP按公开容器规范读取尺寸,浏览器验证能否显示。

超级管理员可按 miao 发送 #上传胡桃照片(图片随消息发送或引用图片消息)加入角色照片,#上传胡桃面板图 加入面板图(面板随机使用,没有时用默认立绘),#删除胡桃面板图1 按 #胡桃面板图列表 的序号删除;面板后发送“原图”取回面板所用的立绘。按 miao 直接发送角色名(如 #雷神、#雷神卡片,可带 UID)出角色卡片:照片与“照片”命令同一来源,附当前 UID 该角色的等级、命座、武器、天赋与圣遗物,其他命令都不匹配时才生效;“原图”发送卡片所用的照片。按 miao 发送 #胡桃照片(或写真、图片、图像)从下载的 miao 角色图与上传的照片中随机发一张,没有时回复“暂无图片”,“原神原图”重取当前聊天内十分钟内由本人查询的图片。

按 miao 发送 #老婆(老公、女友、男友、女儿、儿子及其别称同理)从自己的角色中按类型随机出角色卡片,#老婆设置胡桃,雷神 指定角色(全部 表示随机),#老婆是谁 查看,#老婆照片 只发照片;类型取自 miao 的 wifeCfg。戳一戳按 miao 展示自己任意角色的卡片,可在查询设置中关闭,同一主体十秒冷却。

帮助与冲突设置

“帮助与版本”页及帮助/版本命令使用安装包同版本的命令声明。自定义别名优先于内置名称,群别名优先于全局别名;管理页会列出覆盖了内置名称的别名。聊天中设置或删除全局别名的权限按 Yunzai 的别名设置权限,在查询设置中选择所有群员(默认)、群管理员或仅超级管理员,私聊中只有超级管理员可以设置。

国服与海外授权由账号插件区分,游戏侧仍使用同一服务。

聊天 #留影叙佳期(或 #留影、#领生日 等)按 Yunzai 对当天每个生日角色发送官方图片并领取;“活动与收藏”页另提供生日留影查询/明确领取和圣牌收藏。#月谕圣牌 与 #月谕圣牌交换 按 miao 的圣牌收藏与交换页出图;群内查看 #月谕圣牌 时按上游做法自动加入本群交换匹配,#月谕圣牌交换 只在群聊中查双方互补;记录保留 30 天,再次查看时刷新,不自动赠送。

按 miao 发送 #202507剧诗练度统计(或 #202507幻想角色列表 等)读取 nanoka.cc 当月的限制元素、开幕与特邀角色和各幕怪物,与只含可参战角色的练度统计图合并转发(开幕角色按 90 级、天赋 8 补入)。聊天中按 miao 发送 #角色持有率、#角色命座(可写 #角色六命统计 按该命座排序)、#深渊使用率、#幽境使用率 与 #深渊配队 出图,统计读取 Lelaer/Yshelper 的公开样本并缓存一小时;深渊配队需绑定账号,按 miao 以角色等级与原始天赋加权。“公开统计与配队”页读取同一来源,本人配队匹配与聊天相同。数据为来源样本,不代表所有玩家;缺失字段不填零。公告页的“版本资源预估与盘点”保留参考作者原文和发布时间。

About

原神独立查询、离线图鉴、公开展柜与抽卡档案

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages