docs: annotate account commerce finance and content pages

app/pages/finance/index.vue

@@ -1,4 +1,7 @@
 <script>
+/**
+ * 财务中心：账单、交易、余额、提现与冻结记录分开加载；钱包入口为本页别名，充值/提现能力由站点配置决定。
+ */
 import "~/assets/styles/orders.BflDlvVz.css";
 import "~/assets/styles/WithdrawDialog.ks0wdKEK.css";
 import "~/assets/styles/PaymentDialog.BNFKQF1U.css";
@@ -147,6 +150,7 @@ var je = {
           et = ref(!1),
           M = ref(null),
           N = ref(``);
+        // 账户总览变化时同步余额提醒设置，仅回填本地草稿。
         function tt() {
           let e = S.overview;
           e &&
@@ -156,6 +160,7 @@ var je = {
         watch(() => S.overview, tt, {
           immediate: !0,
         });
+        // 开启余额提醒必须填写正的有限阈值；关闭时发送零阈值，成功后同步账户总览。
         async function nt() {
           ((j.value = ``), (et.value = !1));
           let e = Number(k.value ?? 0);
@@ -182,6 +187,7 @@ var je = {
             A.value = !1;
           }
         }
+        // 读取待审核退款总额；接口未开放的 403/404 不作为普通页面错误展示。
         async function rt() {
           N.value = ``;
           try {
@@ -200,6 +206,7 @@ var je = {
                   : `待审核退款金额加载失败`;
           }
         }
+        // 只允许已知财务标签值，其他查询参数回落到账单。
         function P(e) {
           return typeof e == `string` &&
             [`bills`, `transaction`, `credit`, `withdraw`, `freeze`].includes(e)
@@ -207,6 +214,7 @@ var je = {
             : `bills`;
         }
         let F = ref(P(x.query.tab));
+        // 切换标签时更新 URL 并保留其他查询参数，使刷新后仍能恢复位置。
         function it(e) {
           return navigateTo(
             {
@@ -278,6 +286,7 @@ var je = {
               value: `Artificial`,
             },
           ];
+        // 搜索词在提交后才应用；按当前标签重置对应页码并加载。
         function V() {
           ((B.value = z.value.trim()),
             F.value === `transaction`
@@ -306,6 +315,7 @@ var je = {
           G = ref(``),
           K = ref(`0.00`),
           q = 0;
+        // 交易流水使用独立请求序号，快速筛选时忽略更早的结果。
         async function J() {
           let e = ++q;
           ((ut.value = !0), (U.value = ``));
@@ -328,6 +338,7 @@ var je = {
           }
         }
         let Y = 0;
+        // 余额流水与累计金额同步更新；失败时不保留旧金额冒充新结果。
         async function X() {
           let e = ++Y;
           ((pt.value = !0), (G.value = ``));
@@ -358,6 +369,7 @@ var je = {
         function ht(e) {
           ((W.value = e.page + 1), (T.value = e.rows), X());
         }
+        // 充值完成后刷新账户余额与相关流水，不在本地直接累加金额。
         function gt() {
           (S.refreshOverview(), X(), J());
         }
@@ -397,6 +409,7 @@ var je = {
               : Z.value;
           }),
           Ct = 0;
+        // 按服务端状态分页查询提现记录；本地关键词筛选仅作用于当前返回页。
         async function Q() {
           let e = ++Ct;
           ((bt.value = !0), (xt.value = ``));
@@ -420,6 +433,7 @@ var je = {
         function wt(e) {
           ((yt.value = e.page + 1), (T.value = e.rows), Q());
         }
+        // 提现完成后刷新账户总览、提现列表及余额明细。
         function Tt() {
           (S.refreshOverview(), Q(), X());
         }
@@ -428,6 +442,7 @@ var je = {
           Ot = ref(1),
           kt = ref(!1),
           $ = ref(``);
+        // 冻结余额独立分页读取；异常时清空旧列表并显示错误。
         async function At() {
           ((kt.value = !0), ($.value = ``));
           try {