{"id":22047155,"url":"https://github.com/monsterxcn/nonebot-plugin-gspanel","last_synced_at":"2025-08-24T22:18:13.145Z","repository":{"id":41092184,"uuid":"507505422","full_name":"monsterxcn/nonebot-plugin-gspanel","owner":"monsterxcn","description":"🤖 NoneBot2 原神游戏内角色展柜数据展示插件，参考 @yoimiya-kokomi/miao-plugin","archived":false,"fork":false,"pushed_at":"2024-08-30T06:19:35.000Z","size":130350,"stargazers_count":98,"open_issues_count":9,"forks_count":9,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-04-27T23:06:42.646Z","etag":null,"topics":["genshin","nonebot2","panel","qq"],"latest_commit_sha":null,"homepage":"https://pypi.python.org/pypi/nonebot-plugin-gspanel","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/monsterxcn.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2022-06-26T07:22:54.000Z","updated_at":"2025-03-28T10:10:08.000Z","dependencies_parsed_at":"2024-01-31T05:23:37.949Z","dependency_job_id":"951680d0-f7d8-43c2-bf73-346afe71f93c","html_url":"https://github.com/monsterxcn/nonebot-plugin-gspanel","commit_stats":{"total_commits":111,"total_committers":2,"mean_commits":55.5,"dds":0.04504504504504503,"last_synced_commit":"78ddc48741210d4b23fb3430473cc49b29ada899"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/monsterxcn%2Fnonebot-plugin-gspanel","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/monsterxcn%2Fnonebot-plugin-gspanel/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/monsterxcn%2Fnonebot-plugin-gspanel/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/monsterxcn%2Fnonebot-plugin-gspanel/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/monsterxcn","download_url":"https://codeload.github.com/monsterxcn/nonebot-plugin-gspanel/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252823910,"owners_count":21809711,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["genshin","nonebot2","panel","qq"],"created_at":"2024-11-30T13:25:30.807Z","updated_at":"2025-05-07T06:02:09.085Z","avatar_url":"https://github.com/monsterxcn.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003eNoneBot Plugin GsPanel\u003c/h1\u003e\u003c/br\u003e\n\n\n\u003cp align=\"center\"\u003e🤖 用于展示原神游戏内角色展柜数据的 NoneBot2 插件\u003c/p\u003e\u003c/br\u003e\n\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://raw.githubusercontent.com/monsterxcn/nonebot-plugin-gspanel/master/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/github/license/monsterxcn/nonebot-plugin-gspanel\" alt=\"license\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://pypi.python.org/pypi/nonebot-plugin-gspanel\"\u003e\u003cimg src=\"https://img.shields.io/pypi/v/nonebot-plugin-gspanel\" alt=\"pypi\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.python.org/\"\u003e\u003cimg src=\"https://img.shields.io/badge/python-3.8+-blue\" alt=\"python\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://jq.qq.com/?_wv=1027\u0026k=GF2vqPgf\"\u003e\u003cimg src=\"https://img.shields.io/badge/QQ%E7%BE%A4-662597191-orange\" alt=\"QQ Chat Group\" /\u003e\u003c/a\u003e\u003cbr /\u003e\n  \u003ca href=\"https://github.com/psf/black\"\u003e\u003cimg src=\"https://img.shields.io/badge/code%20style-black-000000.svg\" alt=\"Code style: black\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://pycqa.github.io/isort\"\u003e\u003cimg src=\"https://img.shields.io/badge/%20imports-isort-%231674b1?\u0026labelColor=ef8336\" alt=\"Imports: isort\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://flake8.pycqa.org/\"\u003e\u003cimg src=\"https://img.shields.io/badge/lint-flake8-\u0026labelColor=4c9c39\" alt=\"Lint: flake8\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://results.pre-commit.ci/latest/github/monsterxcn/nonebot-plugin-gspanel/main\"\u003e\u003cimg src=\"https://results.pre-commit.ci/badge/github/monsterxcn/nonebot-plugin-gspanel/main.svg\" alt=\"pre-commit\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\u003c/br\u003e\n\n\n| ![琴](https://user-images.githubusercontent.com/22407052/201662130-2b3bdcd3-acaa-4b59-9c88-3e50fa1887f3.PNG) | ![刻晴](https://user-images.githubusercontent.com/22407052/201661930-f9ecdfe0-e278-4641-a012-cf090da6b6c7.PNG) | ![妮露](https://user-images.githubusercontent.com/22407052/201667744-decfdf25-c889-4a65-bbe0-94e194fe8d82.PNG) |\n|:--:|:--:|:--:|\n\n\n## 安装方法\n\n\n如果你正在使用 2.0.0.beta1 以上版本 NoneBot2，推荐使用以下命令安装：\n\n\n```bash\n# 从 nb_cli 安装\nnb plugin install nonebot-plugin-gspanel\n```\n\n\n\u003e Yunzai [@realhuhu/py-plugin](https://github.com/realhuhu/py-plugin) 插件用户安装方法请查看 [#38](https://github.com/monsterxcn/nonebot-plugin-gspanel/discussions/38)，插件不保证完全可用，请尽量自行解决相关问题。\n\n\n## 使用须知\n\n\n - 插件的圣遗物评分计算规则、卡片样式均来自 [@yoimiya-kokomi/miao-plugin](https://github.com/yoimiya-kokomi/miao-plugin)。插件移植时对 **评分规则** 主要做了以下修改：\n   \n   + 以角色生命值、攻击力、防御力的实际基础值进行词条得分计算，导致固定值的生命值、攻击力、防御力词条评分相较原版有小幅度波动\n   + 于面板数据区域展示圣遗物评分使用的词条权重规则，插件尚未自定义词条权重规则的角色使用默认规则（攻击力 `75`、暴击率 `100`、暴击伤害 `100`）\n   + 于面板数据区域展示角色最高的伤害加成数据，该属性与角色实际伤害属性不一致时区别显示词条权重规则\n   + 对元素属性异常的空之杯进行评分惩罚，扣除该圣遗物总分的 50%（最大扣除比例）\n   \n - 插件返回「暂时无法访问面板数据接口..」可能的原因有：Bot 与 [Enka.Network](https://enka.network/) 的连接不稳定；[Enka.Network](https://enka.network/) 服务器暂时故障等。\n   \n - 插件首次生成某个角色的面板图片时，会尝试从 [Enka.Network](https://enka.network/) 下载该角色的抽卡大图、命座图片、技能图片、圣遗物及武器图片等素材图片，生成面板图片的时间由 Bot 与 [Enka.Network](https://enka.network/) 的连接质量决定。素材图片下载至本地后将不再从远程下载，生成面板图片的时间将大幅缩短。\n   \n - 一般来说，插件安装完成后无需设置环境变量，只需重启 Bot 即可开始使用。你也可以在 NoneBot2 当前使用的 `.env` 文件中添加下表给出的环境变量，对插件进行更多配置。环境变量修改后需要重启 Bot 才能生效。\n   \n   | 环境变量 | 必需 | 默认 | 说明 |\n   |:-------|:----:|:-----|:----|\n   | `gspanel_alias` | 否 | `[\"面板\"]` | 插件响应词别名，多个别名按 `[\"面面\", \"板板\"]` 格式填写 |\n   | `gspanel_scale` | 否 | `1.5` | 浏览器缩放比例，此值越大返回图片的分辨率越高 |\n   | `resources_dir` | 否 | `/path/to/bot/data/` | 插件数据缓存目录的父文件夹，包含 `gspanel` 文件夹的上级文件夹路径 |\n   | `resources_mirror` | 否 | `https://enka.network/ui/` | 素材图片下载镜像，需提供 `UI_Talent_S_Nilou_01.png` 形式的图片地址，可选镜像：\u003cbr\u003e`https://api.ambr.top/assets/UI/`（安柏计划）\u003cbr\u003e`https://cdn.monsterx.cn/genshin/`（插件作者） |\n   \n - 插件图片生成采用 [@kexue-z/nonebot-plugin-htmlrender](https://github.com/kexue-z/nonebot-plugin-htmlrender)，若插件自动安装运行 Chromium 所需的额外依赖失败，请参考 [@SK-415/HarukaBot](https://haruka-bot.sk415.icu/faq.html#playwright-%E4%BE%9D%E8%B5%96%E4%B8%8D%E5%85%A8) 给出的以下解决方案：\n   \n   + Ubuntu：`python3 -m playwright install-deps`\n   + CentOS（仅供参考）：`yum install -y atk at-spi2-atk cups-libs libxkbcommon libXcomposite libXdamage libXrandr mesa-libgbm gtk3`\n   + 其他非 Ubuntu 系统：[@microsoft/playwright/issues](https://github.com/microsoft/playwright/issues)\n   \n   其他 Playwright 相关问题也请尽量自行解决，或者前往 [@kexue-z/nonebot-plugin-htmlrender/issues](https://github.com/kexue-z/nonebot-plugin-htmlrender) / [@microsoft/playwright/issues](https://github.com/microsoft/playwright/issues) 搜索提问。~~你硬要问我的话，大概也只能得到一句「哇嘎拉乃哟」~~\n\n\n## 命令说明\n\n\n### 角色面板\n\n\n插件响应以 `panel` / `面板` 开头的消息，下面仅以 `面板` 为例：\n\n\n*\\* 如果定义了环境变量 `gspanel_alias` 则以环境变量定义的命令别名为准，默认情况下该环境变量会使插件响应 `面板` 开头的消息。*\n\n\n - `面板绑定100123456` / `面板绑定100123456 @某人` / `面板绑定2334556789 100123456`\n   \n   绑定 UID `100123456` 至发送此指令的 QQ，QQ 已被绑定过则会更新绑定的 UID。\n   \n   Bot 管理员可以通过在此指令后紧跟 `2334556789` 或附带 `@某人` 的方式将 UID `100123456` 绑定至指定的 QQ。\n   \n - `面板` / `面板@某人` / `面板100123456`\n   \n   查找 QQ 绑定的 UID / UID `100123456` 角色展柜中展示的所有角色（图片）。\n   \n - `面板夜兰` / `面板夜兰@某人` / `面板夜兰100123456` / `面板100123456夜兰`\n   \n   查找 QQ 绑定的 UID / UID `100123456` 的夜兰面板（图片）。\n\n\n*\\* 所有指令都可以用空格将关键词分割开来，如果你喜欢的话。*\n\n\n### 队伍伤害\n\n\n插件响应以 `teamdmg` / `队伍伤害` 开头的消息，下面仅以 `队伍伤害` 为例：\n\n\n - `队伍伤害` / `队伍伤害100123456` / `队伍伤害@某人`\n   \n   查找指定 UID 角色展柜中前四个角色组成的队伍伤害。\n   \n   默认隐藏了伤害过程表格，如需查看具体伤害过程可以使用 `队伍伤害详情` / `队伍伤害过程` / `队伍伤害全图` 来强制显示全部数据（并不是单独返回伤害过程表格）。\n   \n   当仅发送 `队伍伤害` 时将尝试使用发送此指令的 QQ 绑定的 UID；附带 9 位数字时尝试使用该 UID；附带 `@某人` 时将尝试使用指定 QQ 绑定的 UID。\n   \n - `队伍伤害雷九万班` / `队伍伤害 雷神 九条 万叶 班尼特` / `队伍伤害雷神 九条 万叶 班尼特@某人`\n   \n   查找雷电将军、九条裟罗、枫原万叶、班尼特组成的队伍伤害。注意角色名之间必须使用空格分开。含有 **旅行者** 的配队暂时无法查询。队伍角色只要使用 `面板` 指令查询过或者正在展柜中摆放即可配队（即所有查询过的角色都有缓存，使用 `面板` 指令查看所有可用的角色）。\n   \n   为此形式的命令指定 UID 方式与上面相同。\n   \n   队伍别名支持可能不全请见谅，如果有十分流行的配队未能支持请前往 [discussions](https://github.com/monsterxcn/nonebot-plugin-gspanel/discussions) 提出。\n\n\n*\\* 队伍伤害为 **实验性功能**，计算结果可能存在问题。欢迎附带详细日志提交 issue 帮助改进此功能。*\n\n\n## 特别鸣谢\n\n\n[@nonebot/nonebot2](https://github.com/nonebot/nonebot2/) | [@Mrs4s/go-cqhttp](https://github.com/Mrs4s/go-cqhttp) | [@yoimiya-kokomi/miao-plugin](https://github.com/yoimiya-kokomi/miao-plugin) | [@kexue-z/nonebot-plugin-htmlrender](https://github.com/kexue-z/nonebot-plugin-htmlrender) | [@UIGF-org/UIGF-API](https://github.com/UIGF-org/UIGF-API) | [@DGP-Studio/Snap.Metadata](https://github.com/DGP-Studio/Snap.Metadata) | [Enka.Network](https://enka.network/) | [Miniprogram Teyvat Helper](#) | [@MiniGrayGay](https://github.com/MiniGrayGay)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmonsterxcn%2Fnonebot-plugin-gspanel","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmonsterxcn%2Fnonebot-plugin-gspanel","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmonsterxcn%2Fnonebot-plugin-gspanel/lists"}