starrailroleinfo
September 4, 2026 · View on GitHub
真寻机器人的星铁角色面板插件
展示漫游签证中角色的面板和伤害数据
安装与更新
在真寻仓库的 zhenxun/plugins 目录下执行：
git clone https://github.com/CRAZYShimakaze/zhenxun_plugin_starrail_role_info.git starrail_role_info
更新时在 zhenxun/plugins/starrail_role_info 目录执行 git pull --ff-only。
使用
- 星铁绑定uidXXXX / 绑定星铁uidXXXX / 崩铁绑定uidXXXX / 绑定崩铁uidXXXX
- 星铁解绑 (别名: 崩铁解绑)
- XX面板 (例:希儿面板、希儿面板@CRAZYShimakaze、希儿面板104442596)
- 更新星铁面板 / 刷新星铁面板 / 更新崩铁面板 / 刷新崩铁面板 (可在末尾附 UID；不附 UID 时使用已绑定 UID)
- XX(头手身脚球绳)推荐 (例:希儿头推荐)
- 我的星铁角色 (别名: 我的崩铁角色)
- 他的星铁角色@CRAZYShimakaze (别名: 他的崩铁角色)
- 最强XX / 群最强XX (例:最强希儿；群聊使用)
- 最菜XX / 群最菜XX (群聊使用)
- XX评分排行 / XX评分榜单 (仅群聊，不带序号)
- XX伤害排行N / XX伤害榜单N (仅群聊，N 为从 1 开始的伤害项目序号)
- 遗器榜单 (别名: 遗器排行)
- 群遗器榜单 (别名: 群遗器排行)
- 重置最强XX (仅超级用户群聊可用，例:重置最强希儿)
- 检查星铁面板更新 (仅超级用户可用)
绑定 UID 必须是首位为 1-9 的 9 位数字；已有绑定时需先解绑再更换。更新同一 UID 有 60 秒冷却，检查星铁面板更新 会读取远程版本和更新说明。
评分、毕业与排行
- 角色卡中的总评分是角色遗器总分，按本地
res/json_data/score.json的角色有效词条权重计算；光锥不计入遗器评分。数据不完整时面板返回的评分会带*，不会参与群内最强/最菜记录。 - 单件遗器评级由本地遗器主词条、副词条和强化数据计算。
ACE、ACE*计入大毕业遗器，SSS计入小毕业遗器；个人遗器榜单会显示这两个计数，最多保留评分最高的 20 件遗器。 XX评分排行读取群成员实时昵称、qq2uid.json的 UID 映射和本地{uid}.json角色缓存中的已保存评分；按评分降序（同分按 QQ 升序）取前 16 名，不调用外部面板接口，也不保存独立榜单。- 伤害排行命令中的 N 对应角色伤害表从上到下的第 N 个伤害项目，不计
额外说明行；伤害榜单按该项目的期望伤害排序。伤害结果在命令执行时由当前角色缓存重新计算，缓存中的规则或属性不完整时该成员会被跳过。
伤害计算与数据
- 首次查询或显式更新时按
mihomo.me、enka.network顺序获取漫游签证数据，并写入插件目录下的 UID 缓存；普通角色面板查询优先读取已有缓存，更新/刷新...面板才会强制重新获取。 - 面板伤害计算使用插件内置的固定 Miao-Plugin 星铁规则快照及 Python runtime（revision:
afff386eb6b31bc70a98144c3bbfa884eaf5e621），读取角色、行迹、星魂、光锥和遗器等缓存字段；不依赖运行时 Node 或外部 Miao-Plugin checkout。 - 伤害表列顺序为“暴击伤害”“期望伤害”，
Buff列表展示当前默认伤害项目的触发说明。快照没有对应角色规则、缓存字段缺失或规则执行失败时不生成伤害表，也不会进入伤害排行；该规则集不宣称覆盖所有角色和配置。 - 遗器位置推荐只遍历当前 UID 缓存的对应位置遗器，并按遗器评分取结果；不会从外部实时扫描账号背包。
效果图
致谢
- StarRailRes的数据资源
更新
2026/9/4[v1.3.12]
- 增加伤害排行缺少项目序号时的动态项目提示
2026/9/1[v1.3.11]
- 移除金币扣费依赖，并内置资源下载校验工具
2026/8/28[v1.3.10]
- 遗器强化词条数按 Miao-Plugin 的原始次数识别，扣除初始词条后最高显示 5 次，并兼容旧缓存反推
- 更新角色、光锥、技能、晋阶、别名及遗器评分数据
- 正确保留并渲染文本型伤害结果，兼容部分角色天赋表字段差异
- 修复更新图角色头像下载失败时整张图片生成中断的问题
- 修复部分新角色名称零宽字形及底部权重文本过长的显示问题
2026/8/24[v1.3.9]
- 新增群聊角色评分排行和伤害排行，评分使用缓存数据，伤害按指定项目在命令时重算
- 伤害计算改用插件内置的固定 Miao-Plugin 星铁规则快照及 Python runtime，并补充 Buff 列表
ACE*遗器与ACE一并计入大毕业遗器
2026/6/8[v1.3.8]
- 支持千治·刃
2026/4/30[v1.3.7]
- 支持银狼999、不死途、绯英
2026/2/26[v1.3.6]
- 支持爻光
2025/12/23[v1.3.5]
- 支持大丽花
2025/11/19[v1.3.4]
- 切换enka api进行数据获取
2025/10/8[v1.3.3]
- 适配新版真寻插件架构
2025/8/3[v1.3.2]
- 更新支持Saber、Archer
2025/7/9[v1.3.1]
- 更新支持白厄
2025/5/30[v1.3.0]
- 更新支持风堇、那刻夏、貘泽
2025/4/11[v1.2.9]
- 更新支持万敌、遐蝶
2025/3/10[v1.2.8]
- 更新支持阿格莱雅,缇宝
- 优化遗器评分计算,排除光锥影响
2024/12/5[v1.2.7]
- 更新支持星期日、貘泽
2024/9/21[v1.2.6]
- 迁移缓存数据至插件目录(请手动从真寻data目录下迁移缓存文件)
2024/9/10[v1.2.5]
- 更新支持飞霄
2024/9/7[v1.2.4]
- 更新支持新角色
2024/8/3[v1.2.3]
- 更新云璃、三月七巡猎
2024/6/20[v1.2.2]
- 更新适配流萤
2024/5/21[v1.2.1]
- 更新适配虚数主角
2024/5/8[v1.2.0]
- 更新适配知更鸟
2024/4/11[v1.1]
- 修复开拓者无法查询的问题
2024/4/3[v1.0]
- 更新适配黄泉
2024/3/21[v0.9]
- 更新适配黑天鹅、花火
2024/1/3[v0.8]
- 更新适配阮梅
2023/11/16[v0.7]
- 更新适配藿藿
2023/10/27[v0.6]
- 更新适配托帕
2023/10/17[v0.5]
- 更新适配镜流
2023/8/31[v0.4]
- 更新适配饮月君
2023/8/9[v0.3]
- 更新适配卡芙卡和卢卡
2023/7/20[v0.2]
- 更新1.2角色
2023/6/15[v0.1]
- 初版