文档(计费): 澄清档位排序以目录 rank 为准

RuntimeProfileMembershipPlan 文档改为说明排序由目录 rank 决定、枚举不实现 Ord，避免误以为变体顺序是排序契约 Co-authored-by: Junie <junie@jetbrains.com>
2026-10-02 19:13:10 +08:00
parent 8b8213f0c8
commit f810064657
1 changed files with 4 additions and 1 deletions
@@ -1233,7 +1233,10 @@ impl RuntimeProfileMembershipStatus {

 /// 会员档位身份。取代旧的 `RuntimeProfileMembershipTier`，作为唯一权威档位标识。
 ///
-/// 变体顺序即排序基准（`Normal < Starter < Plus < Pro < Max`）。对外 wire 只用
+/// 档位高低由目录表的 `rank` 决定（见
+/// [`runtime_profile_membership_plan_rank`](crate::runtime_profile_membership_plan_rank)）；
+/// 本枚举不实现 `PartialOrd` / `Ord`，变体声明顺序不构成排序契约（当前恰与 `rank` 一致），
+/// 升级比较一律以目录 `rank` 为唯一来源。对外 wire 只用
 /// [`RuntimeProfileMembershipPlan::as_str`] 产出的枚举 token。
 #[cfg_attr(feature = "spacetime-types", derive(SpacetimeType))]
 #[derive(Clone, Copy, Debug, PartialEq, Eq, Serialize, Deserialize)]