retry

type Config struct {
	// Attempts 总尝试次数（含首次）；<=1 视为 1。
	Attempts int
	// Delay 退避基数。Linear=false 固定间隔；Linear=true 第 i 次失败后等待 Delay*i。
	// Exponential=true 时第 i 次失败后等待 Delay*2^(i-1)（见 Exponential）。
	Delay time.Duration
	// MaxDelay 单次退避上限（<=0 不限）。
	MaxDelay time.Duration
	// Linear true=线性递增退避（Delay*i），false=固定间隔。
	// 与 Exponential 同时为 true 时 Exponential 优先。
	Linear bool
	// Exponential true=指数退避 Delay*2^(attempt-1)，受 MaxDelay 封顶。
	// 外部频控（429/5xx）的标准应对姿势。
	Exponential bool
	// Jitter 可选抖动：每次退避在计算结果上叠加 [0, Jitter) 随机量。
	// 0 = 关闭。用于打散同时失败的重试风暴。
	// JitterRatio > 0 时本字段不生效（比例抖动优先，见 JitterRatio）。
	Jitter time.Duration
	// JitterRatio 按当次退避幅度的比例抖动（单边向上）：最终退避 ∈ [d, d*(1+ratio))。
	// 固定 Jitter 在高 attempt 档占比趋零（指数退避下 32s 档 500ms 只占 1.5%），
	// 打散重试风暴失效——比例抖动让占比恒定。>0 时优先于固定 Jitter；0 = 关闭。
	JitterRatio float64
	// DelayHint 从本次错误提取服务端退避建议（如 429/503 的 Retry-After）；
	// ok=true 时建议值取代计算退避，仍受 MaxDelay 封顶（避免服务端小时级建议
	// 把调用方钉死）；ok=false 或 nil 走计算退避。
	// 「仅限流失败采信建议」等门控放在实现里（配合 retry/httpx 的
	// RetryAfterHint 一行接入）。
	DelayHint func(err error) (d time.Duration, ok bool)
	// Retryable 判定错误是否可重试；nil = 所有错误都重试。
	Retryable func(error) bool
}