chore: comments

internal/pkg/core/notifier/providers/bark/bark.go

@@ -11,7 +11,10 @@ import (
 )
 
 type BarkNotifierConfig struct {
+	// Bark 服务地址。
+	// 零值时默认使用官方服务器。
 	ServerUrl string `json:"serverUrl"`
+	// Bark 设备密钥。
 	DeviceKey string `json:"deviceKey"`
 }
 

internal/pkg/core/notifier/providers/dingtalk/dingtalk.go

@@ -10,8 +10,10 @@ import (
 )
 
 type DingTalkNotifierConfig struct {
+	// 钉钉机器人的 Token。
 	AccessToken string `json:"accessToken"`
-	Secret      string `json:"secret"`
+	// 钉钉机器人的 Secret。
+	Secret string `json:"secret"`
 }
 
 type DingTalkNotifier struct {

internal/pkg/core/notifier/providers/email/email.go

@@ -13,12 +13,20 @@ import (
 )
 
 type EmailNotifierConfig struct {
-	SmtpHost        string `json:"smtpHost"`
-	SmtpPort        int32  `json:"smtpPort"`
-	SmtpTLS         bool   `json:"smtpTLS"`
-	Username        string `json:"username"`
-	Password        string `json:"password"`
-	SenderAddress   string `json:"senderAddress"`
+	// SMTP 服务器地址。
+	SmtpHost string `json:"smtpHost"`
+	// SMTP 服务器端口。
+	// 零值时根据是否启用 TLS 决定。
+	SmtpPort int32 `json:"smtpPort"`
+	// 是否启用 TLS。
+	SmtpTLS bool `json:"smtpTLS"`
+	// 用户名。
+	Username string `json:"username"`
+	// 密码。
+	Password string `json:"password"`
+	// 发件人邮箱。
+	SenderAddress string `json:"senderAddress"`
+	// 收件人邮箱。
 	ReceiverAddress string `json:"receiverAddress"`
 }
 

internal/pkg/core/notifier/providers/lark/lark.go

@@ -10,6 +10,7 @@ import (
 )
 
 type LarkNotifierConfig struct {
+	// 飞书 Webhook 地址。
 	WebhookUrl string `json:"webhookUrl"`
 }
 

internal/pkg/core/notifier/providers/serverchan/serverchan.go

@@ -11,6 +11,7 @@ import (
 )
 
 type ServerChanNotifierConfig struct {
+	// ServerChan 服务地址。
 	Url string `json:"url"`
 }
 

internal/pkg/core/notifier/providers/telegram/telegram.go

@@ -10,8 +10,10 @@ import (
 )
 
 type TelegramNotifierConfig struct {
+	// Telegram API Token。
 	ApiToken string `json:"apiToken"`
-	ChatId   int64  `json:"chatId"`
+	// Telegram Chat ID。
+	ChatId int64 `json:"chatId"`
 }
 
 type TelegramNotifier struct {

internal/pkg/core/notifier/providers/webhook/webhook.go

@@ -10,6 +10,7 @@ import (
 )
 
 type WebhookNotifierConfig struct {
+	// Webhook URL。
 	Url string `json:"url"`
 }