nonebot-plugin-hibank 0.3.1

查询 HiBank 城市银行分布与网点信息并提供标记关注渲染等功能的 NoneBot2 插件

✨城市银行查询与标记 ✨

📖 介绍

查询城市银行分布与网点信息并提供标记关注等功能的 NoneBot2 插件。集卡人的福音！

功能特色：

• 城市银行分布：查询指定城市的全国性、外资、区域性、民营、村镇银行列表。
• 银行网点列表：查询指定城市指定银行的网点名称、区县与地址。
• 本地缓存：使用 nonebot-plugin-localstore 缓存城市索引、城市银行列表与网点列表。
• 图片返回：查询结果渲染为图片，并通过 base64://... 发送。
• 快捷搜索：支持 /搜城市、/搜银行 快速查找名称。
• 个人标注：按 QQ 号保存已开户标记与关注银行，城市查询图中自动高亮。
• 卡包列表：标记/关注列表使用类似微信卡包的银行卡卡片展示，带银行主题色、图标、水印与初始卡号点位。

💿 安装

使用 nb-cli 安装

在 nonebot2 项目的根目录下打开命令行，输入以下指令：

nb plugin install nonebot-plugin-hibank

使用包管理器安装

在 nonebot2 项目的插件目录下，打开命令行，根据你使用的包管理器输入相应命令。

pdm

pdm add nonebot-plugin-hibank

poetry

poetry add nonebot-plugin-hibank

然后打开 nonebot2 项目根目录下的 pyproject.toml 文件，在 [tool.nonebot] 部分追加写入：

plugins = ["nonebot_plugin_hibank"]

⚙️ 配置

本插件默认无需配置，以下配置仅用于覆盖默认行为。

配置项	必填	默认值	说明
HIBANK_BASE_URL	否	https://hi.zzz.moe	HiBank 站点地址。
HIBANK_TIMEOUT	否	30	请求超时时间，单位秒。
HIBANK_VERIFY_SSL	否	false	是否校验 HTTPS 证书。当前站点在部分环境会出现 TLS EOF，默认关闭以保证可用。
HIBANK_BRANCH_PAGE_SIZE	否	30	网点查询每页显示数量。

🎉 使用

指令表

指令	说明
/bank 城市 <城市名>	查询某城市有哪些银行，支持 成都、成都市、四川 成都。
/bank 网点 <城市名> <银行名> [页码]	查询某城市某银行网点列表。
/银行 <城市名>	等价于 /bank 城市 <城市名>。
/网点 <城市名> <银行名> [页码]	等价于 /bank 网点 <城市名> <银行名> [页码]。
/bank 搜城市 <关键词>	搜索城市索引。
/bank 搜银行 <关键词>	搜索银行索引。
/bank 缓存	查看缓存统计。
/bank 清缓存	清除本插件所有缓存。
/bank 帮助	显示命令帮助。
/标记 <银行名...>	标记已开户银行；支持一次写入多个银行。
/mark <银行名...>	等价于 /标记 <银行名...>。
/取消标记 <银行名...>	取消已开户标记。
/unmark <银行名...>	等价于 /取消标记 <银行名...>。
/批量标记 <城市名> <分类>	将某城市分类下的全部银行加入标记列表，例如 /批量标记 成都 全国性。
/批量取消标记 <城市名> <分类>	从标记列表移除某城市分类下的全部银行。
/复制标记 <@用户/QQ号>	复制或合并对方的标记列表到当前 QQ。
/标记列表	查看当前 QQ 号的已标记银行，并按银行类别展示。
/关注 <银行名...>	关注银行；支持一次写入多个银行。
/follow <银行名...>	等价于 /关注 <银行名...>。
/取消关注 <银行名...>	取消关注。
/unfollow <银行名...>	等价于 /取消关注 <银行名...>。
/批量关注 <城市名> <分类>	将某城市分类下的全部银行加入关注列表。
/批量取消关注 <城市名> <分类>	从关注列表移除某城市分类下的全部银行。
/复制关注 <@用户/QQ号>	复制或合并对方的关注列表到当前 QQ。
/关注列表	查看当前 QQ 号的关注银行，并按银行类别展示。
/更新银行图标	重新下载并生成银行图标资产，仅超级用户可用。
/搜城市 <关键词>	等价于 /bank 搜城市 <关键词>。
/搜银行 <关键词>	等价于 /bank 搜银行 <关键词>。

使用示例

/bank 城市 成都
/bank 网点 成都 成都银行
/bank 网点 成都 成都银行 2
/银行 成都
/网点 成都 成都银行
/bank 搜城市 绵阳
/bank 搜银行 农商
/bank 缓存
/bank 清缓存
/标记 成都银行 南京银行 上海银行
/取消标记 成都银行
/批量标记 成都 全国性
/复制标记 123456
/标记列表
/关注 成都银行 南京银行
/取消关注 成都银行
/批量关注 成都 区域性
/复制关注 123456
/关注列表
/更新银行图标

🗂️ 缓存说明

插件使用 nonebot-plugin-localstore 分配的数据目录保存缓存：

• indexes.json：城市索引与银行索引。
• cities/*.json：城市银行分布缓存。
• branches/*.json：网点列表缓存。
• user_marks.json：按 QQ 号保存的标记与关注银行。

除非使用 /bank 清缓存，否则已抓取过的数据会优先使用本地缓存。

🏷️ 标记说明

• /标记 表示已开户成功，城市银行图中会显示为灰色删除线。
• /关注 表示关注中的银行，城市银行图中会显示为 #F780BE 粉色文字。
• /标记列表、/关注列表 会按银行类别分组，并以银行卡卡片展示；初始卡号为四组四个点。
• 香港、澳门括号后缀会保留独立银行身份，例如 中国银行 与 中国银行（香港） 不会互相去重；普通内地括号备注仍按无括号名称合并，例如 南洋商业银行 与 南洋商业银行（企）。
• 标记或关注会先匹配全局银行索引，再匹配已缓存城市银行；两边都找不到时，会提示回复“确认”，回复其他内容不会写入。
• /复制标记、/复制关注 会先展示对方列表图片；本方为空时回复“复制/取消”，本方已有数据时回复“合并/复制/取消”。

🖼️ 银行图标

插件内置银行图标与主题色资产。图标更新时会同时维护两套数据源：

• 优先使用公开图标库 icongo/bank-logos（MIT License），资产保存到 assets/bank_logos/icongo/。
• icongo 无法匹配时使用 HiBank 银行页图标，资产保存到 assets/bank_logos/hibank/。
• 村镇银行等名称带括号母行时，如果本行没有图标，会按括号内母行匹配图标。
• 两套数据源都不可用时生成本地兜底图标，资产保存到 assets/bank_logos/fallback/。

超级用户可使用 /更新银行图标 重新下载图标库、转换 PNG 并刷新 assets/bank_assets.json 与 assets/bank_logos/*/*.png。

🏷️ 指令示例

📄 License

GPL-3.0-or-later