nonebot-plugin-sues-bill 1.2.0

✨ nonebot-plugin-sues-bill ✨

📖 介绍

SUES 校园服务插件，支持查询上海工程技术大学电费和校园卡余额。

主要功能：

• 🔌 电费查询 — 查询宿舍剩余电量，定时宿舍可独立设置
• 💳 电费充值 — 从校园卡余额直接为宿舍充值电费
• 📊 耗电历史 — 自动结算昨日耗电量，支持最近 N 天统计与缴费流水校正
• 💳 校园卡查询 — 查询校园卡账户余额和冻结余额

💿 安装

nb plugin install nonebot-plugin-sues-bill --upgrade

nb plugin install nonebot-plugin-sues-bill --upgrade -i "https://pypi.org/simple"

nb plugin install nonebot-plugin-sues-bill --upgrade -i "https://pypi.tuna.tsinghua.edu.cn/simple"

uv add nonebot-plugin-sues-bill

uv add git+https://github.com/noel-psc/nonebot-plugin-sues-bill@main

pdm add nonebot-plugin-sues-bill

pdm add git+https://github.com/noel-psc/nonebot-plugin-sues-bill@main

poetry add nonebot-plugin-sues-bill

poetry add git+https://github.com/noel-psc/nonebot-plugin-sues-bill@main

plugins = ["nonebot_plugin_sues_bill"]

nbr plugin install nonebot-plugin-sues-bill

nbr plugin install nonebot-plugin-sues-bill -i "https://pypi.org/simple"

nbr plugin install nonebot-plugin-sues-bill -i "https://pypi.tuna.tsinghua.edu.cn/simple"

⚙️ 配置

在 nonebot2 项目的.env文件中添加下表中的配置项（可选）

🎉 使用

指令表

电费查询

#电费 三期 21 1001
#电费 四期 28 1021

昨日耗电

先使用 #电费 记录 三期 21 1001 设置宿舍。每天会在上海时区 00:00 查询一次剩余电量，并结算前一自然日的耗电量和电费。同一宿舍被多个用户设置时仍只会查询一次。

每次成功执行 #电费 查询都会记录查询时间、宿舍和当前余额，但不会覆盖日界快照。

• 已设置校园卡账号后，发送 #电费 记录 绑定 才会读取当天成功的“电费缴费”流水，按 昨日 00:00 余额 + 缴费购电量 - 今日 00:00 余额 校正耗电量。一个校园卡账户只能绑定一个宿舍，一个宿舍也只能绑定一个校园卡账户。
• 未绑定账户时，按两次余额差显示估算值；若发现余额增加，会提示当天可能发生缴费，且该日不计入统计。
• 首次记录需要等待两个日界快照后才能得到昨日耗电。
• 为降低对学校系统的集中访问，日界采样会有最多十分钟的边界误差。

发送 #电费 统计 0 可按今日首次和最新查询余额查看截至当前的耗电估算；至少需要两次成功查询，若余额增加则会提示当天可能已缴费。该估算不会写入日结数据。

发送 #电费 统计 [天数] 可查看指定数量已结束自然日的总耗电、日均、最高耗电日及准确性统计；省略时默认为 30，回复会按实际已记录天数显示。例如：#电费 统计7天。

机器人回复会遮蔽房间号，避免在群聊中泄露宿舍隐私。管理员可使用 #电费 管理 读数/缴费 区域 楼栋 房间号 日期 [时间] 数值 手动补录；时间可省略，默认 00:00。手动读数会作为该日期的日界快照并重算前一日，手动缴费会参与该日结算。

电费充值

先私聊设置校园卡账号（#设置校园卡账号 学号 密码），再发送 #电费 缴费 区域 楼栋 房间号 金额 发起缴费，机器人会返回待确认提示；回复 #电费 缴费 确认 才从校园卡余额扣除，#电费 缴费 取消 放弃（5 分钟内有效）。无需额外密码，例如：

#电费 缴费 三期 21 1001 50
→ 即将为三期2*栋1001 充值 50.00 元，将从校园卡余额中扣除。
   回复 #电费 缴费 确认 完成支付，或 #电费 缴费 取消 放弃。（5 分钟内有效）
#电费 缴费 确认
→ 缴费成功：三期2*栋1001 充值 50.00 元，已从校园卡余额扣除。

单次缴费金额不超过 999 元（与学校充值页一致，仅整数）。缴费成功后，该笔订单号（billno）会记录归属宿舍：即使你的校园卡给其他宿舍缴费，日结同步流水时也会按订单号归入对应宿舍，不会虚增你自己绑定宿舍的耗电；仅在机器人内完成的缴费有此归属记录，网页等其他渠道的缴费仍按「一卡一房」假设归入绑定宿舍。

数据保存在 nonebot-plugin-localstore 的插件专属目录中的 SQLite 数据库。旧版本若曾将数据保存到全局 data/，升级后会先迁移用户配置及加密密钥，再一次性导入旧 JSON 历史；原 JSON 会保留，不存储 cookie。

校园卡查询

⚠️ 安全提示：校园卡账号仅限私聊设置（#设置校园卡账号），密码使用 Fernet 加密后存储在本地。

🎨 效果图

电费查询：

剩余电量: 128.5 度

昨日耗电：

昨日耗电：2.5 度
昨日电费：1.54 元

校园卡查询：

💳 校园卡余额
━━━━━━━━━━━━
账户余额: ￥128.50
冻结余额: ￥0.00