feat: 增加渠道重试优先级模式和避开已用渠道功能

[zhang2023san-oss]

功能1：重试时避开已尝试渠道

• 新增配置选项 RetryAvoidUsedChannelEnabled
• 重试时自动排除已经尝试过的渠道
• 前端新增开关按钮支持动态配置

功能2：渠道重试优先级模式

实现两种渠道重试的优先级模式：

• Sequential（顺序模式）：同一优先级内尝试所有渠道后才降级到下一优先级
• Round-robin（轮询模式）：每个优先级轮流尝试，实现负载均衡

代码质量改进

• 添加 validateOptionValue 函数在保存前验证配置值
• 修复 RetryPriorityMode 验证逻辑，防止无效值保存到数据库
• 修复自动分组模式下可能跳过较低优先级的问题
• 为 RetryParam 及其所有方法添加完整的英文文档注释
• 使用中文错误消息，符合项目代码风格

修改的文件

• common/constants.go - 新增配置常量
• model/option.go - 添加配置项的加载、验证和更新逻辑
• controller/relay.go - 在重试循环中记录已使用的渠道ID
• service/channel_select.go - 新增 UsedChannelIds 字段和优先级处理逻辑
• model/ability.go & model/channel_cache.go - 在渠道查询时应用排除逻辑
• web/* - 前端UI控件和国际化文本

Summary by CodeRabbit

• New Features
  • Added option to avoid reusing channels during retries, reducing redundant failures with the same channel
  • Introduced two retry priority modes: Sequential (exhaust current priority level before downgrading) and Round-robin (cycle through priorities)
  • New retry configuration settings available in the monitoring panel

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[coderabbitai]

Walkthrough

This PR introduces two new configuration flags for channel retry behavior: RetryAvoidUsedChannelEnabled to skip previously failed channels during retries, and RetryPriorityMode to support sequential (priority-downgrade) and round-robin retry strategies. Changes span backend configuration, channel selection logic, service-layer enhancements, and corresponding frontend UI with localization.

Changes

Cohort / File(s)	Summary
Configuration Management common/constants.go, model/option.go	Added two new global flags with runtime validation: RetryAvoidUsedChannelEnabled (bool, default false) and RetryPriorityMode (string, default "sequential"). Option validation enforces "sequential" or "round-robin" values for RetryPriorityMode.
Channel Selection Core model/ability.go, model/channel_cache.go	Updated GetChannel and GetRandomSatisfiedChannel to accept excludeIds parameter for filtering out previously used channels. Added round-robin priority selection logic when RetryPriorityMode == "round-robin". Returns nil for exhausted priorities instead of errors to signal retry escalation.
Relay and Controller controller/relay.go	Enhanced retry loop to advance to next priority when current priority yields no channels. Constructs exclusion set from used channels when RetryAvoidUsedChannelEnabled is on. Logs channel selection details and returns API error when all channels exhausted.
Service Layer Retry Tracking service/channel_select.go	Introduced new RetryParam struct with methods to track used channels (UsedChannelIds), manage retry count, and advance priority index (CurrentPriorityIndex). Updated CacheGetRandomSatisfiedChannel to pass exclusion set and handle priority escalation for auto-group retries.
Frontend Settings UI web/src/pages/Setting/Operation/SettingsMonitoring.jsx, web/src/components/settings/OperationSetting.jsx	Added toggle switch for RetryAvoidUsedChannelEnabled and dropdown selector for RetryPriorityMode ("sequential"/"round-robin") in monitoring settings panel.
Localization web/src/i18n/locales/en.json, web/src/i18n/locales/zh.json	Added seven new translation keys covering retry avoidance feature label/description and retry mode options.

Sequence Diagram

sequenceDiagram
    participant Client
    participant Relay as controller/relay
    participant ChannelCache as model/channel_cache
    participant Ability as model/ability
    participant DB as Database

    Client->>Relay: Request (initial retry=0)
    loop Retry Loop (sequential priorities)
        Relay->>ChannelCache: GetRandomSatisfiedChannel(group, model, retry, excludeIds)
        ChannelCache->>Ability: GetChannel(group, model, retry, excludeIds)
        Ability->>DB: Query channels (priority-based, exclude used)
        DB-->>Ability: Filtered channels
        Ability-->>ChannelCache: Channel or nil
        
        alt Channel Found
            ChannelCache-->>Relay: Channel + weight data
            Relay->>Relay: Log selection, return channel
            Relay-->>Client: Success
        else No Channel (priority exhausted)
            ChannelCache-->>Relay: nil, nil
            Relay->>Relay: Add used channel to excludeIds
            Relay->>Relay: Increase priority index
            Note over Relay: Continue loop with next priority
        end
    end
    
    alt All Priorities Exhausted
        Relay-->>Client: API Error (all channels excluded/unavailable)
    end

Loading

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~50 minutes

Possibly related PRs

• fix(channel_select): adjust priority retry logic for cross-group #2430: Modifies channel selection retry logic in service/channel_select.go and priority-specific retry parameter passing to GetRandomSatisfiedChannel, directly aligned with this PR's retry enhancements.
• feat(token): add cross-group retry option for token processing #2426: Updates auto-group retry flow in service/channel_select.go and the CacheGetRandomSatisfiedChannel method, sharing core service-layer changes with this PR.

Suggested reviewers

• creamlike1024
• xyfacai

Poem

🐰 A clever rabbit hops through channels bright,
Remembering which ones failed last night,
Sequential or round-robin, take your pick—
Retry smarter, not just retry quick!
Smart exclusions make the magic click! ✨

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 21.43% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly summarizes the main additions: retry priority modes for channels and a feature to avoid already-used channels during retries.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing touches

• 📝 Generate docstrings

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[StageDog]

any progress?