From af419e82c783ccc235a3406585eb2e0842b48b17 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E7=8E=8B=E5=BE=B7=E5=AE=87?= <kvtodev@outlook.com>
Date: Mon, 5 Oct 2026 12:14:53 +0800
Subject: [PATCH] =?UTF-8?q?=E6=96=87=E6=A1=A3(=E6=B3=A5=E7=82=B9=E9=92=B1?=
 =?UTF-8?q?=E5=8C=85):=20=E7=BB=9F=E4=B8=80=E4=B8=89=E6=B1=A0=E5=90=88?=
 =?UTF-8?q?=E8=AE=A1=E7=9A=84=E5=B1=95=E7=A4=BA=E5=8F=A3=E5=BE=84=E4=B8=BA?=
 =?UTF-8?q?=E5=8F=AF=E7=94=A8=E6=80=BB=E9=A2=9D?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- mudPoints 文档不再声明合计「不代表可用额度」，与钱包入口/充值弹层的「可用总额」文案对齐
---
 packages/shared/src/utils/mudPoints.ts | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/shared/src/utils/mudPoints.ts b/packages/shared/src/utils/mudPoints.ts
index 080bdfbd8..5e78425b0 100644
--- a/packages/shared/src/utils/mudPoints.ts
+++ b/packages/shared/src/utils/mudPoints.ts
@@ -3,12 +3,12 @@ import type { ProfileMudPointBalance } from '../contracts/runtime';
 /**
  * 泥点余额的展示视图。
  *
- * 后端只并列暴露三个池子（每日免费 / 月度 / 永久），**不**提供「可用总额」字段，
- * 以「合计」与「可用」的口径散回后端或各自相加都会分叉。需要合计展示时统一走
- * {@link resolveProfileMudPointBalanceView}。
+ * 后端只并列暴露三个池子（每日免费 / 月度 / 永久），不直接下发合计字段；前端统一把三池
+ * 相加后的值以「可用总额」展示。需要合计展示时统一走
+ * {@link resolveProfileMudPointBalanceView}，避免各调用点各自相加分叉。
  */
 export type ProfileMudPointBalanceView = ProfileMudPointBalance & {
-  /** 每日免费 + 月度 + 永久；只用于展示，不代表「可用额度」。 */
+  /** 每日免费 + 月度 + 永久；前端统一以「可用总额」展示。 */
   totalPoints: number;
 };