本工具可自动查询您宿舍的电费，并在电费低于设定值时发送邮件提醒。解决没及时充电费，导致突然停电的痛点。
🔍 自动化查询电费。
📩 当电费低于一定额度时发送邮件来提醒您该充值电费了。
👍 跨平台支持（Windows、Linux、macOS）。
⏰ 自动设置定时任务，每天检查一次电费余额。
🔑 密码和邮箱授权码加密保存在本地，无需担心安全问题。
| 操作系统 | 支持架构 |
|---|---|
| Windows 10 及以上 | x86_64 |
| Ubuntu 22.04 及以上 | x86_64、x86、arm64、arm32v7 |
| macOS 12 及以上 | x86_64(Intel)、arm64(Apple Silicon) |
⚠ 其他 Linux 发行版未经验证，不保证能正常使用，计划未来支持非 Debian 系的发行版。
目前支持 QQ邮箱、 163邮箱 和 天大邮箱（SMTP）。
- 网络连接到天津大学的校园网。
- 能够发送邮件。
-
Windows 用户：点击『此处』下载压缩包，解压后，包含
TJUEcard.exe和TJUEcardSetup.exe两个文件。请将这两个可执行文件放在你想安装的文件夹下，日后不再移动。 -
Linux 或 macOS 用户打开命令行（终端），输入以下命令一键安装即可：
curl -fsSLO https://gitee.com/ibenzene/TJUEcard/raw/master/install_TJUEcard.sh && sudo bash install_TJUEcard.sh && rm -f install_TJUEcard.sh
💡 提醒 Windows 用户 如需配置定时任务，请右键点击以 管理员身份 运行
TJUEcardSetup.exe，请放心，这并不会带来安全问题，使用管理员权限的唯一目的在于让定时任务在锁屏时也能正常运行。❓ 如果你不确定一卡通的账号密码，请『验证或找回』。
运行 TJUEcardSetup 时，程序会引导您进行配置，包括设置 一卡通用户名、一卡通密码，以及用于接收邮件的邮箱和授权码。
在配置成功后，会在程序同目录下生成 TJUEcard_user_config.json 配置文件。配置成功后，程序会询问您是否自动设置系统定时任务。即在每天的固定时间运行 TJUEcard
程序来查询电费余额，并发送邮件。设置的固定时间将是您最后一次运行 TJUEcardSetup 程序完成配置的时间。
- 本项目需要提供您的天津大学一卡通账号密码，登录才能查询电费。这些信息保存在您的计算机上，不会上传到任何服务器，请您放心使用。
- 同一个账号只能同时在一个计算机上保持登录状态，请勿在多个计算机上运行
TJUEcardSetup程序时使用相同账号。 - 重复运行
TJUEcardSetup时，先前的配置会被自动覆盖。如需重新配置用户密码、邮箱、查询房间号，请重新运行TJUEcardSetup进行配置。
- 定时任务的执行时间是根据您运行
TJUEcardSetup程序的时间确定的，每天在您设置的时间运行一次。 - 如果您移动了程序的位置或更改了文件名，定时任务可能会失效，需要重新运行
TJUEcardSetup进行配置，或者手动修改定时任务的配置文件。
Q：定时任务被安装到哪里了？如何管理定时任务？
A：请您查看文档『定时任务管理』，按照说明来进行高级操作。
Q：程序会一直在后台运行吗？
A：不会。程序只会在定时任务触发时自动运行，平时不会常驻后台或持续占用系统资源。
Q：定时任务不执行怎么办？
A：如果你是 Windows 或 Linux 用户，请检查『定时任务管理』以及 TJUEcard.log 日志文件。如果你是 macOS 用户，请使用 mail 命令查看 cron 投递的日志。
Q：为什么我没收到邮件？
A：请检查您的邮箱配置是否正确，或者看看邮件是否被投递到了垃圾邮件，以及可以查看 TJUEcard.log 日志文件，了解详细信息。
Q：程序运行有问题怎么办？
A：请您新建 GitHub Issues 描述您的问题，并附上详细的错误信息。
我们欢迎任何形式的贡献！如果您有好的想法或需求，欢迎通过以下方式参与项目：
- 提交 Pull Request：如果您修复了 bug 或实现了新功能，欢迎提交 PR。
- 创建 Issue：如果您有任何建议或发现了问题，请在 GitHub Issue 页面进行讨论。
- 参与开发：如果您对项目的开发感兴趣，欢迎通过邮件联系我们：headfirstbug@gmail.com。
- macOS 的定时任务存在问题，修复时间待定。
- 考虑支持多房间的查询。
- 为方便用户，下个大版本上线中心化查询服务，用户只需提供查询房间号和邮箱即可实现每天查询。
本项目之著作权归 TJUEcard 开发小组所有。用户可以自由选择是否使用本项目。如果用户下载、安装、使用本项目，即表明用户信任该项目作者，作者提供开放源代码项目并根据许可证提供资助，其中包括为保护贡献者而明确规定「按原样」提供项目的条款，没有任何保证，并且对因使用项目而造成的损失不承担任何责任。
除非另有说明，本仓库的内容采用 CC BY-SA 4.0 许可协议。在遵守许可协议的前提下，您可以自由地分享、修改本仓库的内容。
如果您认为仓库的部分内容侵犯了您的合法权益，请联系项目维护者，我们会尽快删除相关内容。
使用时请合理获取个人数据，请勿进行高频率调用，请勿将本项目的脚本用于大规模爬取网站数据。本项目仅供个人学习和交流之用，因他人利用本项目代码对网站或其他数据进行攻击而导致的任何后果，与本项目无关。在任何情况下，作者或版权持有人均不对因软件或软件的使用或其他交易而产生的或与之相关的任何索赔、损害或其他责任负责。