Yunzai 插件：四游戏实时体力（原神 / 星铁 / 绝区零 / 鸣潮）、体力阈值推送、米游社签到与米游币、 原神与星铁的成绩汇总与配队、星铁抽卡记录。出图统一走毛玻璃模板。
体力模块基于 xhh 改造，其余功能自建。
| 模块 | 代表指令 | 需要 |
|---|---|---|
| 体力查询 | #体力 #原神体力 #鸣潮体力 |
CK / stoken（鸣潮借 gsuid_core） |
| 体力推送 | #原神体力推送 130（星铁/绝区零/鸣潮同理） |
同上，需在群里设 |
| 原神成绩 | #全部深渊 #小剧诗 #幻想角色 |
完整 CK |
| 配队 / 持有率 | #深渊配队 #危战配队 #持有率 |
无 CK 也能出通用榜 |
| 原神 · 队伍伤害 | #队伍伤害 钟离,班尼特,香菱,行秋 |
miao 面板缓存 |
| 星铁成绩 | *全部深渊（=*深渊总览=*深渊汇总） |
完整 CK |
| 星铁抽卡记录 | *更新抽卡记录（=*xhh更新抽卡记录） *抽卡记录 *导入记录 |
stoken，不用抽卡链接 |
| 米游社签到 | #原神签到 #原神自动签到（星铁 / 绝区零同理） |
cookie_token |
| 米游币任务 | #米游币签到 #开启自动米游币 |
stoken |
| 版本配置 | #版本深渊 *版本混沌 |
无需绑定 |
| 帮助 | #小火花帮助 |
— |
每个模块在锅巴面板里都有独立开关。关掉之后该模块的指令不再响应，
#小火花帮助 里对应的板块与条目也一并消失（整块都关掉就不渲染那一块），
底部会列出当前关掉了哪些。开关明细见「模块开关」。
#体力 / #tl 原神 + 星铁 + 绝区零总览（鸣潮默认不含）
#原神体力 #星铁体力 #绝区零体力 #鸣潮体力 单查，支持 @他人
别名 #ystl / #xttl / #zzztl / #mctl，*体力 = #星铁体力
#开启体力uid / #关闭体力uid 卡片是否显示 UID（一次管四个游戏）
#开启原神体力 / #关闭原神体力 控制总览是否含该游戏（四游戏各自独立）
#关闭原神123456789 屏蔽单个号（四游戏各自独立，换游戏名即可）
#体力屏蔽列表
屏蔽与显示开关是两回事：#关闭原神体力 是把整个游戏从总览里摘掉；
#关闭原神123456789 是只屏蔽那一个 UID（不解绑、不影响体力推送）。
屏蔽时写 #屏蔽星铁体力123456789 / #隐藏鸣潮123456789 也认，恢复用
#开启星铁123456789 / #恢复原神123456789。
三种卡片样式（tl_card_style）：classic 经典多合一 / portrait 大立绘 / widget 桌面小组件。
大立绘与小组件随角色图片自动搭配渐变色；横版立绘占七成，保留原信息宽度，不再叠加底图。小组件自动裁去立绘外缘的透明、黑白留边并铺满顶部。无需另选配色。
小组件卡底部还能显示当前限时活动（活动名 + 进度 + 倒计时），条数由
tl_widget_activity_limit 控制，填 0 就不显示。
多账号合并出图，张数超 tl_cards_per_msg 自动转合并转发。数据取米游社实时便笺（优先 stoken）。
绝区零体力只认 stoken：米游社的 zzz 接口不接受普通 Cookie，只有 CK 的号查不了，
单查时会提示先【#扫码登录】，总览里该行静默跳过。
原神卡片额外带一行参量质变仪状态（今日可使用 / N天后可再次使用 / 尚未获得），数据来自
game_record 实时便笺接口，纯 stoken 凭证拉不到时该行自动隐藏。
鸣潮需要同机的 gsuid_core + 鸣潮插件（只读借它的 UID 绑定与登录凭证），并在锅巴打开
waves_tl_enable、用户自己发 #开启鸣潮体力；Windows 必须手填 GsData.db 路径。
立绘图库体积大未随仓库分发，可指向鸣潮插件已下载好的目录。
群内每人各自设阈值，恢复到阈值以上时在该群 @你并发图。四游戏独立。
#原神体力推送 130 上限 200；星铁 300、绝区零 240、鸣潮 240
#原神体力全推送 130 监控名下所有 UID
#原神体力推送关闭
#体力推送列表
把「原神」换成星铁 / 绝区零 / 鸣潮即可设对应游戏，四游戏独立、互不影响；
「开启 / 打开」前缀可省，关闭词写前面（#关闭原神体力推送）或后面（#原神体力推送关闭）都认。
达标只 @ 一次，回落后自动重新武装；主号推送与全推送互斥；只能在群里设，默认 10 分钟一轮
（resin_push_cron）。
对已开启原神体力推送的人，在这两样东西「能用了」时于其订阅群 @ 提醒一次（配一张提醒卡）：
- 参量质变仪：冷却结束、可再次使用时
- 洞天宝钱：攒满（达到上限）时
数据复用你查询体力时的那份快照，不额外请求米游社；到点时刻会落盘，云崽重启后自动恢复定时。
需要你至少查询过一次体力才会有数据（resin_timer_enable，默认开）。
两回事：签到领原石走游戏 UID + cookie_token；米游币是在社区做任务，走米游社账号 + stoken。 米游币规则已变：各版块共享进度，任一版块签到即拿满当日奖励，浏览 / 点赞 / 分享不再计入。
#原神签到 / #星铁签到 / #绝区零签到 立即签，多账号逐个签
#原神自动签到 / #原神自动签到关闭 订阅每日自动签
#签到列表
#米游币签到 #米游币余额
#开启自动米游币 / #关闭自动米游币 #自动米游币列表
签到用稳定 device_id + 真设备指纹，撞码概率低。米游币任一版块签到即拿满当日奖励。
米游社的奖励是延迟入账的，签到成功后余额要过一会儿才更新，所以收益一律按米游社给的 「今日已获得」统计；偶尔赶在入账前出图，会写一句「收益稍后到账」，不用重跑任务。
撞码自动处理：本插件（含 genshin、miao-plugin 等走米游社的指令）一撞验证码，就会自动过码 并重试原请求 —— 你看到的直接是正常结果，不用做任何事、也不会收到打扰。
自动过码开箱即用：默认走插件自带的公共过码服务 https://geetest.lyln114514.com/solve，
不用部署、不用配置。公共服务连不上时只提示「稍后再试」，不影响其它功能。
想把过码放在自己机器上（不依赖公共服务），一键装好：
#过码部署 拉服务、装依赖、起进程、写配置，一步到位；服务有新版本时也发这条
#过码服务状态 看服务在不在、文件全不全、配置有没有生效
装好后配置会自动指向本机 http://127.0.0.1:8766/solve。想切回公共服务或换别的远程服务，
把配置 auto_verify_addr 填成对应地址（公共：https://geetest.lyln114514.com/solve；
别人部署的：http://服务器IP:8766/solve）即可；手动装法见仓库 solver 分支的
service/geetest/README.md。
#全部深渊 深境螺旋 + 幽境危战 + 小剧诗关键关，三列合一（原神专属，星铁见下）
#小剧诗 / #小幻想 幻想真境剧诗关键关（加「上期」看上期）
#幻想角色 / #幻想剧诗 当期限制元素与可用角色；#下期幻想角色、#幻想202607
#深渊配队 / #危战配队 高频满星队，绑 CK 后按练度排序、灰显未持有
#持有率 深渊样本里各角色持有比例
#全部深渊 只有原神这一个：星铁同名功能必须带 *（*全部深渊 / *深渊总览 / *深渊汇总）。
幻想角色数据来自 Alioth.wiki，按指定月份查询，未收录月份直接提示暂无数据。 角色资料沿用喵喵数据；绑定 CK 后按持有角色、限制元素/特邀名单及等级 ≥70 筛选，开幕试用角色按 80 级补入；未读取到 CK 时展示全部可用角色。
剧诗主题：锅巴面板 → 小火花 → 幻想真境剧诗 →「幻想角色 / 小剧诗主题」，可选浅色、深色或跟随全部深渊，两张图共用。默认跟随全部深渊；全部深渊设为浅色时，幻想角色也使用浅色。
随机风景背景：内置 50 张原神观景点原图，统一平铺在 resources/bg/。锅巴面板 → 小火花，将「深渊/剧诗/配队背景」填为 plugins/xhh-TL/resources/bg，即可每次随机使用风景图；也可指定其中一张图片。体力立绘卡改用自动取色，不再使用独立底图，旧 tl_portrait_bg 配置不再生效。
| 配置项 | 作用 | 默认值 |
|---|---|---|
role_combat_bg_folder |
深渊、剧诗、配队等背景；支持单图及多层分类目录 | plugins/xhh-TL/resources/bg/bg1.png |
role_combat_theme |
幻想角色与小剧诗主题；light 浅色、dark 深色，留空跟随全部深渊 |
空 |
内置目录保留 bg1.png、bg2.png 供单图指定和兜底，随机背景只抽 50 张风景。自定义图库仍支持分类子目录，角色立绘仍按原有角色名筛选；旧版内置背景路径自动兼容。素材来源记录见 观景点来源。
配队与持有率数据源是提瓦特小助手，无 CK 也能出通用榜。
#队伍伤害 钟离,班尼特,香菱,行秋
面板取 miao 的缓存，队里每人都得先 #更新面板。队伍后面可接手法
（班尼特e,希诺宁e,a1,q，不写角色名沿用上一个），角色名后可接换装（换六命 换精5
换护摩之杖 换4千岩 换天赋101313）。换装是估算，圣遗物词条沿用原面板。
完整写法见 #队伍伤害帮助。小助手只收录了部分套路，功能位太多的队会直接算不了。
*全部深渊 / *深渊总览 / *深渊汇总 混沌 + 虚构 + 末日 + 异相一张图（加「上期」）
混沌/虚构/末日只展示最高那一层难度，异相仲裁完整展示
必须带 * 或「星铁」前缀，避免与原神 #全部深渊 冲突。
*更新抽卡记录 从官方小程序同源接口拉五星与垫抽，合并进本地记录后先回一条变动池明细，再出总览图
别名 *xhh更新抽卡记录 / *小火花更新抽卡记录（跟别的插件同名时用它点名本插件）
六个池全拉：角色 / 光锥 / 联动角色 / 联动光锥 / 新手 / 常驻
没有变动的池不进明细，一个池都没变动就只出图
*抽卡记录 仿小程序「跃迁记录统计」出图；*武器记录 / *常驻记录 等同理
*全部记录 总览版：每池一块，统计 + 五星头像墙
*导入记录 发完指令再把文件丢过来（三分钟内）
直接把游戏内抽卡链接发过来也行——那条路能拿到完整逐抽记录，默认增量、加「全量」可强拉， 拉完同样直接出总览图。
- 走 stoken 换
e_hkrpg_token，不需要抽卡链接、也不需要 authkey - 常驻池（群星跃迁）走
GachaType_Standard，和其它池一样能免链接更新 - 小程序接口只给五星和垫抽数。为了让总抽数与保底成立，五星之间用三星占位补足 （每次更新重建，所以幂等）；代价是「未出四星」偏大，四星统计得靠链接或导入
- 真实记录只增不删，按「item_id + id 前 10 位时间戳」判重，反复更新不会重复计数
- 单个卡池拉取失败不影响其它池，失败的池会跳过，下次更新自动补上
- 导入支持 SRGF v1.0 / UIGF v4.x / UIGF v2.x / Excel
.xlsx/ csv，认不出结构时会兜底 在 JSON 里找带gacha_type的记录数组 - 这几条指令的优先级压在 genshin / xiaoyao-cvs 之前，避免被抢；原神的抽卡链接照旧交回 genshin
#版本深渊 #版本剧诗 #版本危战 原神当期配置，支持「列表 / 上期 / 第N期 / 9月」
*版本混沌 *版本虚构 *版本末日 *版本异相 星铁挑战库
「当期」按网站标注的时间期限自动定位（今天落在哪期就是哪期）；
#下期X 看下一期，#版本深渊列表 看最近期数，#版本深渊9月 / #版本深渊202609 按月回看。
数据来自 Alioth.wiki，无需绑定。
在云崽根目录执行。三个源任选一个（内容完全一样，推荐国内的 gitcode 或 gitee）：
gitcode（国内直连最快）
git clone --depth=1 https://gitcode.com/ccxhan/xhh-TL.git ./plugins/xhh-TLgitee（国内）
git clone --depth=1 https://gitee.com/longhengmu/xhh-TL.git ./plugins/xhh-TLGitHub
git clone --depth=1 https://github.com/cchanlan/xhh-TL.git ./plugins/xhh-TL装依赖：
pnpm install --filter=xhh-TL
# 没用 pnpm 的话：npm install --no-save --prefix ./plugins/xhh-TL重启生效。首次启动会从 config/default_config.yaml 生成 config/config.yaml。
必需：miao-plugin（角色数据与渲染框架）。
可选：genshin（没有则自动走内置兼容层）、Guoba-Plugin（图形化配置）、
gsuid_core + 鸣潮插件（鸣潮体力）、Node ≥ 22.5（鸣潮读库更省事）。
两层：config/default_config.yaml（随版本更新）+ config/config.yaml（本地保留），
更新只补缺失键、不覆盖你改过的值。改后者，或直接用锅巴面板。常用项：
reply_quote: true # 出图和提示是否引用你发的那条消息
img_type: jpeg # 出图格式 jpeg / png / webp（详见下表）
render_scale: 1.0 # 全局出图清晰度倍率（上限 2.5）
role_combat_theme: "" # 幻想角色/小剧诗：空串跟随全部深渊 / light 浅色 / dark 深色
tl_card_style: classic # 体力卡样式 classic / portrait / widget
tl_render_mode: merge # 体力渲染模式 merge=合并 / single=独立（三种样式均生效）
tl_merge_uids_per_image: 0 # 合并模式下每图 UID 数，0=全部（立绘/小组件卡并排直接出图）
tl_cards_per_msg: 3 # 超过这个张数改用合并转发
tl_widget_activity_limit: 4 # 小组件卡底部限时活动条数，填 0 不显示
waves_tl_enable: false # 鸣潮体力总开关
waves_tl_gsuid_db: "" # GsData.db 路径，Windows 必填
resin_push_cron: "*/10 * * * *" # 体力推送轮询
resin_timer_enable: true # 质变仪/洞天宝钱到期提醒（复用查询快照，不额外请求）
auto_sign_cron: "0 30 8 * * *" # 自动签到时间
team_damage: true # 队伍伤害（与 FanSky_Qs 同名指令冲突时可关）锅巴面板 → 小火花 →「出图 → 输出图片类型」，或改 img_type。插件所有出图指令
（体力卡 / 立绘卡 / 桌面小组件 / 全部深渊 / 抽卡记录 / 帮助面板…）统一用它，改完下次出图生效。
| 取值 | 说明 |
|---|---|
jpeg |
默认。体积小、全平台通用 |
png |
无损，体积最大 |
webp |
体积最小。 |
选 jpeg 时，质变仪 / 洞天宝钱到期提醒卡的圆角会自动改成直角 ——
JPEG 装不下透明通道，硬裁会让四角变黑。
每个功能模块都有独立开关，关掉后该模块的指令一律不再响应，
#小火花帮助 里对应的条目也随之消失；某个板块的条目全被关掉时整块不再渲染。
所有开关默认 true，老用户升级后不会被改动。
在锅巴面板（http://<你的IP>:2536/guoba/#/plugin/@/xhh-TL）勾选，或直接改 config/config.yaml：
| 开关 | 默认 | 关掉后 |
|---|---|---|
Tl |
开 | #体力 等体力查询与体力显示开关全部停用 |
waves_tl_enable |
关 | #鸣潮体力、鸣潮推送不可用 |
resin_push_enable |
开 | 体力阈值推送的设定指令全部停用，定时推送也不再发 |
resin_timer_enable |
开 | 质变仪 / 洞天宝钱到期提醒不再发 |
auto_sign_enable |
开 | #原神签到、#原神自动签到 等全部停用，定时签到不再跑 |
bbs_coin_enable |
开 | #米游币签到、#开启自动米游币 等全部停用，定时任务不再跑 |
solver_deploy_enable |
开 | #过码部署、#过码服务状态 不再响应（已装好的过码服务不受影响） |
captcha_notice_enable |
开 | 撞码不再自动过码重试，只提示「稍后再试」 |
gs_all_abyss |
开 | #全部深渊 停用 |
abyss_team |
开 | #深渊配队 #深渊组队 停用 |
hard_team |
开 | #危战配队 #危战组队 停用 |
hold_rate |
开 | #角色持有率 #持有率 停用 |
team_damage |
开 | #队伍伤害 及其帮助指令停用 |
role_combat |
开 | #小剧诗 与 #幻想角色 #幻想剧诗 全部停用 |
all_abyss |
开 | *全部深渊 *深渊总览 停用 |
sr_gacha_enable |
开 | 星铁抽卡记录指令停用；发来的抽卡链接也不再被本插件接管 |
nanoka_abyss_enable |
开 | #版本深渊 等原神、星铁版本配置查询全部停用 |
tmp_clean_enable |
开 | #清理临时文件 停用，定时清理也不再跑 |
del_ck_hook_enable |
开 | #删除ck 不再记录残留 stoken（指令本身仍由 genshin 执行） |
改完要重载插件才生效：指令响应是即时生效的，但定时任务（签到、米游币、体力推送、
临时清理）在插件加载时就注册好了，开关改动后需要发 #重载 xhh-TL 或重启一次。
凭证只从本机既有来源读取（云崽绑定库、xiaoyao-cvs-plugin 等的 stoken yaml、gsuid_core 的
GsData.db 只读借用），插件自己不落盘任何账号密码，也不外传。抽卡记录写进云崽的
data/srJson/<QQ>/<UID>/，与 genshin 共用同一份库。出图缓存在 temp/，可用 #小火花清理缓存 / #清理缓存 清掉。
- xhh —— 原项目，体力模块与经典卡片模板
- miao-plugin —— 角色数据、练度模型、渲染框架、立绘图库；配队打分算法
- xiaoyao-cvs-plugin —— 米游币任务移植来源，CK / stoken 路径兼容
- XutheringWavesUID / WutheringWavesUID —— 鸣潮接口口径与图标资源，卡片设计出自 Wuyi无疑
- gsuid_core —— 鸣潮 / 米游币凭证来源库，签到设备指纹思路
- StarRail-plugin —— 星铁深渊 API 参考
- ZZZeroUID —— 绝区零立绘
- Yunzai-Bot / TRSS-Yunzai / Guoba-Plugin —— 宿主与配置面板
过码功能（solver 分支的 service/geetest/）不是从零发明的，参考与依赖了这些项目，
在此一并致谢：
- Amorter/biliTicker_gt（AGPL-3.0）——
本服务直接依赖它发布的 Python 包
bili-ticket-gt-python（见requirements.txt）， 用它取 c/s 参数、拿图片地址、算缺口距离 - Hobr/python-geetest3（GPL-3.0）——
w.py里 w 参数的生成算法参考了它的实现思路（本仓库为独立重写） - ravizhan/geetest-v3-click-crack（AGPL-3.0）—— 纯协议过码链路的思路参考
- luguoyixiazi/test_nine —— 点选 / 九宫格题型的解法调研（当前未采用）
- GT-Manual —— 过码流程参考（本插件早期实现参考它，现已改为自建全自动方案）
⚠️ 注意bili-ticket-gt-python是 AGPL-3.0 协议。AGPL 要求：若你把它作为网络服务 提供给他人使用，需要向使用者提供完整源码。通过#过码部署装出来的本机服务默认自用； 如部署成多人共用的远程服务，请向使用者提供该服务源码（见solver分支），并自行评估安全与合规风险。
插件默认使用的公共过码服务（
https://geetest.lyln114514.com/solve）是外部第三方服务， 不在本仓库内、也不由本仓库部署或维护，只保证接口与solver分支一致。 过码时该地址会收到账号的 ck（不含 stoken）。不想把 ck 交给第三方时， 发#过码部署在本机装一套，或把配置auto_verify_addr换成自己的服务地址。
数据接口：米游社 / HoYoLAB 官方、库街区、提瓦特小助手、 Alioth.wiki、 Project Amber 与 Enka.Network（图源兜底）。
本项目仅供学习交流与技术研究，请勿用于任何商业用途。
- 使用本插件及配套过码服务产生的一切账号风险由使用者自负，作者不承担任何责任
- 本插件通过非官方接口获取游戏数据，与米哈游 / 库街区官方无关，也未获其授权或认可
- 过码服务绕过了验证码这一安全机制，请仅在你自己的账号上使用， 不要用于批量注册、爬取、代练等违反服务条款的场景
- 请遵守各平台的服务条款与当地法律法规；因使用不当造成的后果与作者无关
- 若相关权利方认为本项目侵犯了其权益，请联系删除
MIT © 2026 cchanlan