diff --git a/docs/technical/【技术设计】泥点三池与会员计费后端设计-2026-10-02.md b/docs/technical/【技术设计】泥点三池与会员计费后端设计-2026-10-02.md
index d837d45b2..20e29c7ad 100644
--- a/docs/technical/【技术设计】泥点三池与会员计费后端设计-2026-10-02.md
+++ b/docs/technical/【技术设计】泥点三池与会员计费后端设计-2026-10-02.md
@@ -133,7 +133,7 @@ pub struct ProfileMembershipPlan {
 | `membership_cycle_kind_after` | `Option<RuntimeProfileMembershipCycleKind>` | `None` | 变更后周期 |
 | `membership_period_points_before` | `Option<u64>` | `None` | 变更前每期额度 |
 | `membership_period_points_after` | `Option<u64>` | `None` | 变更后每期额度 |
-| `membership_granted_points_delta` | `i64` | `0` | 本次补点（进月度池的点数） |
+| `membership_granted_points_delta` | `u64` | `0` | 本次补点（进月度池的点数）；与报价侧 `ProfileMembershipUpgradeQuoteResponse.granted_points_delta` 一致 |
 | `membership_cycle_index` | `Option<u32>` | `None` | 变更时所在期数 |
 | `membership_expires_at_before` | `Option<Timestamp>` | `None` | 变更前到期 |
 | `membership_expires_at_after` | `Option<Timestamp>` | `None` | 变更后到期 |
@@ -150,6 +150,10 @@ pub struct ProfileMembershipPlan {
 - 新增 `RuntimeProfileMembershipCycleKind { Monthly, Yearly }`（全新，无历史数据）。
 - 新增 `RuntimeProfileMembershipModelAccess { Basic, Full }`（仅新增字段，本期不执行）。
 - 新增 `RuntimeProfileMembershipChangeKind { Purchase, Upgrade }`（订单快照用，替代字符串）。
+- `shared-contracts` 新增 wire 侧 `ProfileMembershipPlanToken` / `ProfileMembershipCycleKindToken` /
+  `ProfileMembershipModelAccessToken` / `ProfileMembershipChangeKindToken`，把 DTO 里原来的裸
+  `String`（后台 upsert 请求、订单变更快照、会员 / 档位 / 报价响应）收口为 typed enum；
+  与模块枚举通过 `From` 双向映射，JSON wire 值仍是小写 token，未知 token 在反序列化阶段被拒。
 - **删除** `RuntimeProfileMembershipTier { Normal, Month, Season, Year, Starter, Basic, Pro, Ultimate }`
   及其 `as_str()`（会员侧零存量，用户已授权破坏性变更）。
 - `RuntimeProfileWalletLedgerSourceType` **末尾追加** `MembershipUpgradeGrant`