miao-plugin / 喵喵插件

源码仓库：https://github.com/AxiuCN/miao-plugin

miao-plugin 是 Yunzai-Bot 的升级插件，提供原神 / 星铁角色面板查询、伤害计算、圣遗物评分、抽卡统计、深渊统计等角色相关功能。本 fork 在保留上游全部能力的基础上，扩展了面板变换（换装 / 属性变换 / OCR 识别）、最高分 / 最强面板、指定面板图（面板图N）、圣遗物初始值 / 成长值等特色玩法。

更多上游功能与完整使用说明参见原版 README（yoimiya-kokomi）。

指令说明

以下指令说明供 bot 使用者（群友 / 管理员）参考，标「主人」的指令仅机器主人可用。

面板查询

查询角色面板数据，需先通过 #更新面板 获取游戏橱窗数据。

指令	权限	说明
`#雷神面板`	所有人	查询角色面板（默认随机面板图，可加 `面板图N` 指定）
`#更新面板`	所有人	刷新游戏橱窗详情数据
`#面板角色列表`	所有人	查看已获取面板数据的角色列表
`#面板帮助`	所有人	面板功能使用说明
`#喵喵设置面板服务332`	所有人	切换面板查询服务（如国服 & B 服切到 MiniGG-Api）

💡 面板服务默认由 Enka.Network 提供，支持 Enka / MiniGG-Api / 米游社等多种服务源，发送 #喵喵设置面板服务{编号} 切换。

伤害计算

指令	权限	说明
`#雷神伤害`	所有人	本地计算角色伤害，可指定伤害序号（如 `#雷神伤害3`）

伤害计算由喵喵本地完成。如结果有偏差，用 #雷神伤害 查看伤害加成信息；确认有误可提供伤害录屏截图及 uid 反馈。

圣遗物评分

指令	权限	说明
`#雷神圣遗物`	所有人	圣遗物模式（喵喵版评分规则）
`#雷神遗器`	所有人	星铁遗器模式
`#胡桃圣遗物初始值`	所有人	查看圣遗物词条初始值（fork 特色）
`#丝柯克圣遗物成长值`	所有人	查看圣遗物词条成长值（fork 特色）

圣遗物 / 遗器列表与统计（fork 特色）

对已获取面板数据的角色圣遗物按评分排序展示，支持按角色重算评分、全群收集、套装过滤。列表 / 统计 可互换，遗器 对应星铁，星铁 前缀可选。

指令	权限	说明
`#圣遗物列表`	所有人	本人全部角色圣遗物，按原权重排序
`#胡桃圣遗物列表`	所有人	本人全部圣遗物，按胡桃评分权重重算（支持角色别名）
`#胡桃圣遗物全局列表`	所有人	全群成员圣遗物（仅限群内），按胡桃权重重算
`#圣遗物全局列表`	所有人	全群成员圣遗物（仅限群内），按各自原权重排序
`#胡桃圣遗物列表魔女4`	所有人	末尾追加套装名，过滤指定套装

重算评分依赖角色评分规则（artis-mark 权重），便于跨角色比较单件圣遗物价值
展示数量由 #喵喵设置圣遗物数量 控制（默认 28）

面板变换（fork 增强）

通过 换 / 补 / 变 / 改 关键字对已查询的面板进行变换，支持换装、属性数值变换，并在伤害旁显示变化百分比（↑/↓）。

指令	权限	说明
`#胡桃面板换少女头`	所有人	面板换装
`#胡桃面板变+30暴击`	所有人	属性数值变换（必须带 `换`/`变`/`改`/`补` 触发；百分比仅对 atk/hp/def 按基础值计算）
`#胡桃面板换+30暴击换-10%大攻击`	所有人	多属性变换（各属性间用 `换` 分隔）
直接发送面板截图	所有人	触发 OCR 图片识别，自动解析并应用变换

支持换武器、换圣遗物、换命座、属性变换的组合叠加
面板变换构建"虚拟面板"，不修改已获取的真实面板数据
变换后面板可与原面板对比，伤害数字旁显示差异（绿色 ↑ / 红色 ↓）

指定面板图（fork 增强）

查询面板时可携带 面板图N 独立 token（空格分隔，可出现在命令任意位置），指定使用 ProfileImg-Plugin 图库中编号为 N 的面板图：

指令	权限	说明
`#胡桃面板面板图1`	所有人	使用图库编号 1 的面板图
`#胡桃面板面板图1 换少女头`	所有人	指定面板图 + 换装变换（顺序无关）
`#胡桃圣遗物面板图3`	所有人	圣遗物模式 + 指定面板图

编号 N 对应 ProfileImg-Plugin 主图库文件名中的序号（角色名_n_作者_来源.ext）
未指定时保持随机选图（向后兼容）；序号不存在时静默回退随机
面板图的上传 / 删除 / 列表等管理命令由 ProfileImg-Plugin 处理

最高分 / 最强面板（fork 增强）

指令	权限	说明
`#我的胡桃最高分面板魔女4`	所有人	回溯搜索圣遗物组合，评分最高的搭配
`#我的胡桃最强面板魔女4`	所有人	枚举散件位配置 × 坐标上升收敛，求伤害最高的搭配（需指定套装）

最高分面板：mark 评分最大化，纯评分搜索
最强面板：同时评估伤害，结果确定可复现（非随机）

角色查询

指令	权限	说明
`#喵喵角色`	所有人	查看角色信息、老婆系统、原图

抽卡统计

指令	权限	说明
`#喵喵抽卡记录`	所有人	原神 / 星铁抽卡记录分析
`#喵喵抽卡统计`	所有人	抽卡统计汇总

深渊统计

指令	权限	说明
`#喵喵深渊统计`	所有人	深境螺旋统计
`#喵喵幻想真境剧诗`	所有人	幻想真境剧诗统计、角色卡
`#喵喵幽境危战`	所有人	幽境危战统计

角色资料

指令	权限	说明
`#喵喵WIKI`	所有人	角色 Wiki 资料
`#今日素材` / `#天赋`	所有人	角色 / 天赋材料日历与今日素材

喵喵设置

指令	权限	说明
`#喵喵帮助`	所有人	功能帮助
`#喵喵设置`	所有人	可视化配置（面板服务、面板替换、练度统计等）
`#喵喵更新`	主人	更新插件到最新版本
`#喵喵更新日志`	主人	查看更新日志

配置

面板设置：#喵喵设置 命令可视化配置（面板服务、面板替换、原图、练度统计等）
锅巴后台：支持 Guoba-Plugin 可视化配置
自定义配置：编辑 config/profile.js、config/character_default.js（角色 / 别名）

指令列表

喵喵:角色查询

描述：角色查询
事件：message
优先级：50

正则表达式	处理函数
`/^#喵喵角色卡片$/`	character
`/^#\(喵喵)?(上传\|添加)(.+)(照片\|写真\|图片\|图像)\\s\$/`	uploadImg
`/^#\\s\(老婆\|媳妇\|妻子\|娘子\|宝贝\|老公\|丈夫\|夫君\|郎君\|死鬼\|女朋友\|女友\|女神\|女王\|女票\|男朋友\|男友\|男神\|男票\|女儿\|闺女\|小宝贝\|儿子\|犬子)\\s\(设置\|选择\|指定\|添加\|列表\|查询\|列表\|是\|是谁\|照片\|相片\|图片\|写真\|图像)?\\s\(\[^\\d\]\)\\s\(\\d\)$/`	wife
`/^#?(获取\|给我\|我要\|求\|发\|发下\|发个\|发一下)?原图(吧\|呗)?$/`	originalPic

喵喵:戳一戳

描述：戳一戳
事件：notice.*.poke
优先级：50

正则表达式	处理函数
`/.\*/`	pockWife

喵喵:角色面板

描述：角色面板
事件：message
优先级：50

正则表达式	处理函数
`/^#(星铁\|原神)?(面板角色\|角色面板\|面板)(列表)?\\s\*(\\d\{9,10\})?$/`	profileList
`/^#(?:星铁\|原神)?我的(.+?)(?:最高分\|最强)面板(\\d\)\\s\(.\*)$/`	profileMax
`/^#\(\[^#\]+)\\s\(详细\|详情\|面板\|面版\|圣遗物\|遗器\|武器\[1-7\]?\|伤害(\[1-9\]+\\d\)?)\\s\(\\d\{9,10\})\(.\(?:\[换变改\]\|面板图\\d+).\*)?$/`	profileDetail
`/^#.+\[换补\]/`	profileChange
`/^#(星铁\|原神)?(群\|群内)?(排名\|排行)?(最强\|最高\|最高分\|最牛\|第一\|极限)+.+/`	groupProfile
`/^#(星铁\|原神)?(重置\|重设)(.\*)(排名\|排行)$/`	resetRank
`/^#(星铁\|原神)?(刷新\|更新\|重新加载)(群内\|群\|全部)\*(排名\|排行)$/`	refreshRank
`/^#(开启\|打开\|启用\|关闭\|禁用)(群内\|群\|全部)\*(排名\|排行)$/`	manageRank
`/^#(星铁\|原神)?(群\|群内)?.+(排名\|排行)(榜)?$/`	rankList
`/^#(星铁\|原神)?(.\?)(圣遗物\|遗器)(全局)?(列表\|统计)\\s\(.\*)$/`	artisList
`/^#.+?(圣遗物\|遗器)(初始值\|成长值)$/`	profileAttr
`/^#(星铁\|原神)?(面板\|喵喵)?练度统计$/`	profileStat
`/^#\(我的)\(风\|岩\|雷\|草\|水\|火\|冰)\(武器\|角色\|练度\|五\|四\|5\|4\|星)+(汇总\|统计\|列表)(force\|五\|四\|5\|4\|星)\\[ \|0-9\]\*$/`	YzprofileStat
`/^#202\\d\{3\}(幻想\|真境\|剧诗\|幻想真境剧诗)练度统计$/`	profileRoleStat
`/^#202\\d\{3\}(幻想\|真境\|剧诗\|幻想真境剧诗)(角色\|练度)(汇总\|统计\|列表)\[ \|0-9\]\*$/`	YzprofileRoleStat
`/^#\(我的)?(今日\|今天\|明日\|明天\|周.\)?(\[五四54\]星)?(技能\|天赋)+(汇总\|统计\|列表)?\[ \|0-9\]\*$/`	talentStat
`/^#喵喵(角色\|查询)\[ \|0-9\]\*$/`	avatarList
`/^(#(五\|四\|5\|4\|星)\(角色\|查询\|查询角色\|角色查询\|人物)\[ \|0-9\]\$)\|(^(#\uid\|#\UID)\\+\(18\|\[1-9\])\[0-9\]\{8\}$)\|(^#\[\\+\|＋\]\(18\|\[1-9\])\[0-9\]\{8\})/`	YzavatarList
`/^#(星铁\|原神)?(强制)?(刷新\|更新)(所有\|角色)\*(天赋\|技能\|行迹)$/`	refreshTalent
`/^#(角色\|换\|更换)?面\[板版\]帮助$/`	profileHelp
`/^#(敌人\|怪物)等级\\s\\\d\{1,3\}\\s\$/`	enemyLv
`/^#(星铁\|原神)?(全部面板更新\|更新全部面板\|获取游戏角色详情\|更新面板\|面板更新)\\s\*(\\d\{9,10\})?$/`	profileRefresh
`/^#(星铁\|原神)?(米游社\|mys)(全部面板更新\|更新全部面板\|获取游戏角色详情\|更新面板\|面板更新)(\\d\{9,10\})?$/`	profileRefreshMys
`/^#?\\s\(?:上传\|添加)(.+)(?:面板图)\\s\$/`	uploadImg
`/^#?\\s\(?:移除\|清除\|删除)(.+)(?:面板图)(\\d)\{1,\}\\s\$/`	delProfile
`/^#?\\s\(.+)(?:面板图列表)\\s\$/`	profileImgList
`/^#(星铁\|原神)?(删除全部面板\|删除面板\|删除面板数据)\\s\*(\\d\{9,10\})?$/`	profileDel
`/^#(星铁\|原神)?(加载\|重新加载\|重载)面板\\s\*(\\d\{9,10\})?$/`	profileReload

喵喵:深渊统计

描述：深渊统计
事件：message
优先级：50

正则表达式	处理函数
`/^#(喵喵)?角色(持有\|持有率\|命座\|命之座\|.命)(分布\|统计\|持有\|持有率)?$/`	consStat
`/^#(喵喵)?(深渊\|幽境\|危战\|幽境危战)(第?.\{1,2\}层)?(角色)?(出场\|使用)(率\|统计)\*$/`	abyssPct
`/^#深渊(组队\|配队\|配对)$/`	abyssTeam
`/^#\(喵喵\|上传\|本期)\(深渊\|深境\|深境螺旋)\[ \|0-9\]\*(数据)?$/`	abyssSummary
`/^#\(喵喵)\(本期\|上期)?(幻想\|幻境\|剧诗\|幻想真境剧诗)\[ \|0-9\]\*(数据)?$/`	roleCombatSummary
`/^#\(喵喵)\(月谕\|越狱\|幻想\|幻境\|剧诗\|幻想真境剧诗)(圣牌\|卡片\|卡牌\|塔罗牌\|card\|tarot)(收藏\|收集)?\[ \|0-9\]\*(数据)?$/`	roleCard
`/^#\(喵喵)\(月谕\|越狱\|幻想\|幻境\|剧诗\|幻想真境剧诗)(圣牌\|卡片\|卡牌\|塔罗牌\|card\|tarot)(交换\|互换\|换牌)$/`	roleCardExchange
`/^#\(喵喵)\(本期\|上期)?(幽境\|危战\|幽境危战)(单人\|单挑\|组队\|多人\|合作\|最佳)?\[ \|0-9\]\*(数据)?$/`	hardChallengeSummary

喵喵:角色资料

描述：角色资料
事件：message
优先级：50

正则表达式	处理函数
`/^#喵喵WIKI$/`	wiki
`/^(#\|喵喵)+(日历\|日历列表)$/`	calendar
`/^#(星铁)+(日历\|日历列表)$/`	calendarSr
`/^#(绝区零)+(日历\|日历列表)$/`	calendarZzz
`/^#(今日\|今天\|每日\|我的\|明天\|明日\|周(\[1-7\]\|一\|二\|三\|四\|五\|六\|日))\(素材\|材料\|天赋)\[ \|0-9\]\$/`	today

喵喵:抽卡统计

描述：抽卡统计
事件：message
优先级：50

正则表达式	处理函数
`/^#\*(星铁)?喵喵(抽卡\|抽奖\|角色\|武器\|光锥\|常驻\|集录\|up)+池?(记录\|祈愿\|分析)$/`	detail
`/^#\*(星铁)?(抽卡\|抽奖\|角色\|武器\|光锥\|常驻\|集录\|up)+池?(记录\|祈愿\|分析)$/`	Yzdetail
`/^#\*(星铁)?喵喵(全部\|抽卡\|抽奖\|角色\|武器\|光锥\|常驻\|集录\|up\|版本)+池?统计$/`	stat
`/^#\*(星铁)?(全部\|抽卡\|抽奖\|角色\|武器\|光锥\|常驻\|集录\|up\|版本)+池?统计$/`	Yzstat

喵喵:喵喵设置

描述：喵喵设置
事件：message
优先级：50

正则表达式	处理函数
`/^#喵喵(强制)?(更新图像\|图像更新)$/`	updateRes
`/^#喵喵(强制)?更新$/`	update
`/^#?喵喵更新日志$/`	updatelog
`/^#喵喵设置\\s\(角色列表\|角色卡片\|深渊\|幻想真境剧诗\|月谕圣牌收藏\|幽境危战\|练度统计\|帮助\|抽卡\|戳一戳\|面板查询\|面板替换\|排名\|限制\|排行人数\|面板服务\|星铁面板服务\|面板图\|组队\|圣遗物数量\|图鉴\|天赋\|幻想数据库\|未实装\|图片\|卡通头像\|小清新\|渲染\|原图\|逗号)?\\s\(.\*)$/`	sysCfg
`/^#喵喵api$/`	miaoApiInfo

喵喵:喵喵帮助

描述：喵喵帮助
事件：message
优先级：50

正则表达式	处理函数
`/^(\\/\|#)?(喵喵)?(命令\|帮助\|菜单\|help\|说明\|功能\|指令\|使用说明)$/`	help
`/^(\\/\|#)?喵喵版本$/`	version

喵喵:喵喵别名

描述：喵喵自定义角色别名
事件：message
优先级：50

正则表达式	处理函数
`/^\[#\*\](?:星铁)?喵喵别名(帮助)?$/`	help
`/^\[#\*\](?:星铁)?喵喵别名原神设置\\s+\\S+\\s+\\S+$/`	setGs
`/^\[#\*\](?:星铁)?喵喵别名\[崩星\]铁设置\\s+\\S+\\s+\\S+$/`	setSr
`/^\[#\*\](?:星铁)?喵喵别名设置\\s+\\S+\\s+\\S+$/`	set
`/^\[#\*\](?:星铁)?喵喵别名原神删除\\s+\\S+$/`	delGs
`/^\[#\*\](?:星铁)?喵喵别名\[崩星\]铁删除\\s+\\S+$/`	delSr
`/^\[#\*\](?:星铁)?喵喵别名删除\\s+\\S+$/`	del
`/^\[#\*\](?:星铁)?喵喵别名列表$/`	list
`/^\[#\*\](?:星铁)?喵喵别名原神列表$/`	listGs
`/^\[#\*\](?:星铁)?喵喵别名\[崩星\]铁列表$/`	listSr

鸣谢

yoimiya-kokomi/miao-plugin — 上游原版，本 fork 的基础
Enka.Network — 感谢 Enka 提供的面板服务
ark-plugin — 面板变换伤害差异显示与 OCR 图片识别
ProfileImg-Plugin — 面板图图库管理器，面板图N 指定功能的依赖

← 返回插件列表

miao-plugin / 喵喵插件 ​

指令说明 ​

面板查询 ​

伤害计算 ​

圣遗物评分 ​

圣遗物 / 遗器列表与统计（fork 特色） ​

面板变换（fork 增强） ​

指定面板图（fork 增强） ​

最高分 / 最强面板（fork 增强） ​

角色查询 ​

抽卡统计 ​

深渊统计 ​

角色资料 ​

喵喵设置 ​

配置 ​

指令列表 ​

喵喵:角色查询 ​

喵喵:戳一戳 ​

喵喵:角色面板 ​

喵喵:深渊统计 ​

喵喵:角色资料 ​

喵喵:抽卡统计 ​

喵喵:喵喵设置 ​

喵喵:喵喵帮助 ​

喵喵:喵喵别名 ​

鸣谢 ​