Skip to content

Latest commit

 

History

History
92 lines (46 loc) · 4.16 KB

README.Chinese.md

File metadata and controls

92 lines (46 loc) · 4.16 KB

CEACStatusBot🤖

自动从CEAC查询您的美国签证申请状态,并立即通知您!

使用

您可以将其部署到您自己的机器上,但强烈建议使用Github Actions。

环境变量

  • LOCATION: 您申请签证的使领馆的地点代码。要查找使领馆对应的代码,请参考此表。中国内地的部分使领馆代码如下表:

    代码 位置
    BEJ CHINA, BEIJING
    CHE CHINA, CHENGDU
    GUZ CHINA, GUANGZHOU
    SHG CHINA, SHANGHAI
    SNY CHINA, SHENYANG
  • NUMBER: 您在CEAC网站中的Application ID or Case Number(例如AA0020AKAX2012118 345 0001)。具体信息请查看CEAC网站的说明。注意: 请先在CEAC网站确认你能够正确获取你的签证状态。这一项目的目的是简化从CEAC网站获取签证信息的过程,并不能比人工方式获得更多的信息。

  • PASSPORT_NUMBER: 护照号码

  • SURNAME: 姓的前5个英文字母

  • TIMEZONE: 可选,设置自己的时区,以免打扰睡眠。例如: Asia/ShanghaiAmerica/New_York。如果你设置了时区,程序默认不会在你的时区的晚上10点到第二天早上8点发送。注意: 这里使用的是IANA时区数据库的时区表示法,并不是简单的地理位置的组合。例如,如果你希望使用北京时间,你的时区应该是Asia/Shanghai不是 Asia/Beijing

邮件通知

如果你想收到邮件通知,需要设置如下环境变量:

  • FROM: 发送通知的电子邮件地址。注意: 本项目并不提供任何电子邮件服务,需要使用你提供的第三方电子邮件服务通过SMTP协议发送电子邮件,因此需要你提供用于发送通知的电子邮件地址。一个小技巧是,如果你希望如果你希望通过邮件提醒自己签证状态,你可以在此处填写和收取通知相同的电子邮件地址,即可以使用同一个邮箱收发邮件,换句话说你可以自己给自己发邮件。

  • TO: 接收通知的电子邮件地址。您可以发送到多个电子邮件地址,用“|”分割多个电子邮件地址(“|”这个符号通常在退格键Backspace的下方,回车Enter的上方,你通常需要使用上档Shift键打出这个符号),不用且不可添加任何空格。下面是几个例子:

  • PASSWORD: 在FROM填写的邮箱的密码。注意: 对于一些电子邮箱(如QQ邮箱),你应该在这里使用“授权码”而不是邮箱的密码,因为这个项目使用SMTP协议发送电子邮件。有关详细信息,请查看邮箱服务提供商的SMTP使用方法。

  • SMTP: 可选,设置SMTP服务器 (e.g. smtp.example.com, smtp.example.com:587)

Telegram机器人通知

如果你想通过Telegram Bot发送通知,需要设置如下环境变量。

Telegram Bot 创建教程

  • TG_BOT_TOKEN: Bot 密钥

  • TG_CHAT_ID: 聊天 ID,获取方法见教程

在 Github Actions 的使用方法

  1. folk这个仓库

  2. Github -> Settings -> Secrets and variables -> Actions -> New repository secret中设置环境变量。 image

  3. 查看 Github Actions 中的 workflows 是否正常运行并检查邮箱是否收到邮件。

待办事项

  • 向多个邮箱发送邮件。

  • 增加更多第三方通知服务。

  • 更人性化的界面。

特别感谢

开发者

h4x3rotab : Telegram bot, 适配新版CEAC接口

相关项目

这个repo中的部分代码引用了下面的项目。谢谢你们的工作。