nonebot-plugin-miao
原神 / 崩坏：星穹铁道的 NoneBot2 抽卡记录、模拟抽卡与角色面板插件，移植自 miao-plugin（MIT）。支持 OneBot V11。
功能
- Authkey 抽卡记录更新、分析、按版本统计、UIGF / SRGF 导入导出
- 原神与星铁模拟抽卡、保底、武器定轨和每日次数限制
- Enka（原神）、Mihomo（星铁）、米游社 Cookie 面板更新
- 属性计算、圣遗物 / 遗器评分、面板列表 / 详情 / 伤害图片
安装
nb plugin install nonebot-plugin-miao-genshin
pip install nonebot-plugin-miao-genshin
poetry add nonebot-plugin-miao-genshin
注意：PyPI 上的
nonebot-plugin-miao是他人发布的无关项目，请勿安装；本插件的 PyPI 包名为nonebot-plugin-miao-genshin（导入模块名仍为nonebot_plugin_miao）。
配置
均有默认值；在 NoneBot .env 中按需覆盖。
| 配置项 | 默认值 | 说明 |
|---|---|---|
MIAO_RES_MIRROR |
jsDelivr miao-plugin resources | 角色图片与静态资源镜像 |
MIAO_PROFILE_INTERVAL |
3 |
面板更新冷却（分钟） |
MIAO_MYS_COOKIE |
空 | 全局米游社 Cookie（可选） |
MIAO_GACHA_DAILY_LIMIT |
1 |
每日模拟十连次数 |
MIAO_RES_AUTO_UPDATE |
True |
每日自动更新面板资源（凌晨 4:20，需 nonebot-plugin-apscheduler） |
指令
| 指令 | 范围 | 说明 |
|---|---|---|
/绑定uid <UID> / /星铁绑定uid <UID> |
群聊、私聊 | 绑定游戏 UID |
/绑定cookie <cookie> |
仅私聊 | 绑定米游社 Cookie |
/更新抽卡记录 / /抽卡分析 / /全部池统计 |
群聊、私聊 | 抽卡记录与统计；星铁命令前加“星铁” |
十连 / 武器十连 / 单抽 |
群聊、私聊 | 模拟抽卡；唯一无需 / 前缀的功能 |
/定轨 |
群聊、私聊 | 模拟武器池定轨 |
/导入记录 / /导出记录 |
群聊、私聊 | UIGF / SRGF 记录交换 |
/更新面板 / /米游社更新面板 |
群聊、私聊 | 更新角色面板 |
/面板列表 / /角色名面板 / /角色名伤害2 |
群聊、私聊 | 查看面板与指定伤害条目 |
/圣遗物列表 / /面板帮助 / /抽卡帮助 |
群聊、私聊 | 列表与帮助 |
除模拟抽卡外，所有功能均要求以 / 开头。发送 Authkey 抽卡链接时，也需要在完整链接前添加 /。
移植对照
| miao-plugin 功能 | 本插件位置 | 状态 |
|---|---|---|
| 抽卡记录、分析、模拟 | gacha/、datasource/gacha_log.py |
已实现 |
| Enka / Mihomo / 米游社面板 | datasource/ |
已实现 |
| 属性、评分与伤害规则 | core/、dmg/ |
已实现 |
| 面板和抽卡卡片 | render/ |
已实现 |
未移植：群内排名、练度统计、面板图上传、私有 API、备选面板源与 Yunzai 按钮交互。
开发
poetry install
poetry run python -m compileall nonebot_plugin_miao
poetry run pytest -v
poetry run ruff check .
致谢与许可
本项目使用 MIT License。
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file nonebot_plugin_miao_genshin-0.1.9.tar.gz.
File metadata
- Download URL: nonebot_plugin_miao_genshin-0.1.9.tar.gz
- Upload date:
- Size: 7.4 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
poetry/2.4.1 CPython/3.11.15 Darwin/25.5.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5c9508897628b1d304e98581fca7cae65f371f402b7fd8e790ab459648b4de4b
|
|
| MD5 |
e2484b37ceabf931d169ac716063a9f6
|
|
| BLAKE2b-256 |
c3291c12c00f7cc1fc095fa2ad81ac30e8b3e3bb566ed9ff89d1db9be996a2aa
|
File details
Details for the file nonebot_plugin_miao_genshin-0.1.9-py3-none-any.whl.
File metadata
- Download URL: nonebot_plugin_miao_genshin-0.1.9-py3-none-any.whl
- Upload date:
- Size: 8.2 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
poetry/2.4.1 CPython/3.11.15 Darwin/25.5.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
12a3c2c551c7311c8c794a590815c410ad04b0a8a3c670abc012ed04ebf21a42
|
|
| MD5 |
f4be5d536cbd06a4d4e052c3bff674e5
|
|
| BLAKE2b-256 |
c7997e04aaa4f73c546f0b1a10e8fb41a939c127da1566148a82d28a88ab861b
|
