GiteeAI余额提醒

余额提醒功能可以在 GiteeAI 账户余额较低时，自动向指定邮箱发送提醒邮件，方便及时充值，避免翻译服务因余额不足受到影响。

一、功能说明

当前功能规则如下：

• 当 GiteeAI 余额低于 10 元时触发提醒。
• 系统每天凌晨 02:00自动检查一次余额。
• 邮件会发送到后台“余额提示”中保存的收件邮箱。
• 发信邮箱需要通过 SMTP 配置文件设置。
• 修改配置文件后，需要重启翻译服务才能生效。

余额提醒任务只负责低余额提醒，不会自动充值。

二、使用前准备

使用余额提醒前，请确认以下条件已经满足：

1. 服务已经配置并使用 GiteeAI 翻译通道。
2. 服务启用了数据库功能，用于保存余额提醒邮箱。
3. 已准备一个可以通过 SMTP 发信的邮箱。
4. 已获取该邮箱的 SMTP 授权码或 SMTP 密码。
5. 服务器可以访问 GiteeAI 接口和邮箱 SMTP 服务器。

关于 SMTP 授权码

部分邮箱不能直接使用网页登录密码发送邮件，需要在邮箱设置中开启 SMTP 服务，并生成“授权码”。配置时应优先填写授权码。

不同邮箱服务商的 SMTP 地址和授权码获取方式不同，请以邮箱服务商的官方说明为准。

这里以网易邮箱举例可参考： https://gitee.com/mail_osc/email.java

三、在后台保存收件邮箱

1. 打开余额管理

登录管理后台，在左侧菜单中点击 余额管理。

如果没有看到“余额管理”菜单，请先确认当前服务是否使用了 GiteeAI 通道。

2. 打开余额提示

在余额管理页面点击 余额提示按钮。

弹窗中会显示余额提醒规则：余额低于 10 元时，系统每天凌晨 02:00 检查并发送邮件。

3. 填写收件邮箱

在“邮箱地址”输入框中填写接收余额提醒的邮箱地址，例如：

admin@example.com

该邮箱可以与发信邮箱相同，也可以使用其他邮箱。

点击 保存提醒。

系统会校验邮箱格式。邮箱为空或格式不正确时，不会保存。

4. 确认保存结果

保存成功后，页面会显示操作成功提示，并显示已经设置的提醒邮箱。

再次点击 余额提示打开弹窗时，之前保存的邮箱会自动回显。

四、配置发信邮箱

1. 找到配置文件

找到服务器配置文件，路径如下

/mnt/service/config.properties

2. 添加三个 SMTP 参数

在配置文件中填写以下三个参数：

balance.reminder.email.host=smtp.example.com
balance.reminder.email.username=sender@example.com
balance.reminder.email.password=SMTP授权码或SMTP密码

三个参数的含义如下：

例如，使用 163 邮箱时，配置形式可以是：

balance.reminder.email.host=smtp.163.com
balance.reminder.email.username=your-email@163.com
balance.reminder.email.password=your-smtp-authorization-code

请将示例值替换为自己的邮箱信息，不要直接照抄示例配置。

3. 检查配置要求

以下三个参数必须同时配置，并且值不能为空：

• balance.reminder.email.host
• balance.reminder.email.username
• balance.reminder.email.password

如果缺少任意一个参数，余额提醒定时任务不会启用，也不会发送邮件。

请注意：配置文件中的 # 表示注释。下面的配置不会生效：

#balance.reminder.email.host=smtp.example.com

需要删除参数前面的 #，并填写真实值。

4. 重启服务

保存配置文件后，重启翻译服务 (执行命令脚本 /mnt/service/start.sh )。

配置是在服务启动时读取的，只修改文件但不重启服务，新的 SMTP 配置不会生效。

配置了 SMTP，但没有收到邮件

请按以下顺序检查：

1. 三个 balance.reminder.email.* 配置项是否都已取消注释。
2. 发信邮箱的 SMTP 地址是否正确。
3. password 是否填写了 SMTP 授权码，而不是网页登录密码。
4. 修改配置后是否重启服务。
5. 后台是否保存了收件邮箱。
6. 当前 GiteeAI 余额是否确实低于 10 元。
7. 收件邮箱的垃圾邮件或广告邮件目录中是否有提醒邮件。
8. 服务日志中是否有 SMTP 连接或认证失败信息。