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;
 };