docs(cache): 说准多源路由凭据门禁的触发条件

门禁拦的是「落库后仍是多源且路由级 key 非空」,不是「本次提交是否形成多源」
⇒ 已经是多源的老路由连改 name/desc 也会 400。注释改成事实。

Co-Authored-By: Claude Code <[email protected]>
This commit is contained in:
adminandClaude Code committed 2026-10-31 02:03:09 +08:00
1 parent dc49c758fc
commit 85f64f2f1c
1 file changed
+7 -1
+7 -1
View File
@@ -780,7 +780,13 @@ pub fn upsert(
// ⚠️ 判据必须用**落库后**的值(`item.sources` / `item.key`):
// 否则「路由级 key 是上一次留下的、这次只提交了 sources」会漏判。
//
// ⚠️ 只在**本次写入会形成多源**时拦;单源路由的老配置**不受影响**(向后兼容)。
// ⚠️ 拦的是**落库后的状态**,不是「本次提交是否形成了多源」:
// ⇒ 一条**已经是**多源、且路由级 key 非空的老路由,
// **连改 name/desc/enabled 也会被 400**
// (必须先清掉路由级 key,或把源池减到 1 个)。
// 这是**故意的 fail-closed**:这种配置一旦存在,
// 运行期(M1)就已经不下发路由级凭据了 ⇒ 让管理员在保存时看见它。
// 单源路由的老配置**不受影响**(向后兼容)。
{
// 有效源数:`item.sources` 为空 ⇒ 单 base 模式(有效源数 = 1,**不得误伤**)。
let source_count = if item.sources.is_empty() {