docs: annotate remaining routes layouts and view boundaries

app/pages/recommend/index.vue

@@ -1,4 +1,7 @@
 <script>
+/**
+ * 推介计划：开通推广身份、推广链接、奖励记录、提现与受邀用户；永久关系模式才显示受邀用户，提现能力由服务端配置控制。
+ */
 import "~/assets/styles/WithdrawDialog.ks0wdKEK.css";
 import "~/assets/styles/recommend.C1KCHBPJ.css";
 import { toDisplayString } from "vue";
@@ -46,6 +49,7 @@ import tabpanels from "primevue/tabpanels";
 import tabpanel from "primevue/tabpanel";
 import tablist from "primevue/tablist";
 import tab from "primevue/tab";
+// 把本地日期范围转换为秒级查询边界；严格复核年月日并覆盖结束日全天，拒绝无效日期或反向区间。
 function C(e, t) {
   function n(e, t) {
     if (!e) return ``;
@@ -251,6 +255,7 @@ var Se = {
           Ct = ref(`links`),
           O = ref(!1),
           k = ref(``);
+        // 仅在有开通权限且尚无推广地址时创建推广身份，完成后重新加载资料。
         async function wt() {
           if (!(O.value || !xt.value || bt.value)) {
             ((O.value = !0), (k.value = ``));
@@ -263,6 +268,7 @@ var Se = {
             }
           }
         }
+        // 推广资料为核心查询，说明内容可独立缺失；已开通时再读取链接配置与当前标签数据。
         async function A() {
           ((vt.value = !0), (T.value = ``));
           try {
@@ -304,6 +310,7 @@ var Se = {
         onScopeDispose(() => {
           q !== void 0 && clearTimeout(q);
         });
+        // 奖励规则、推荐商品、系统链接和自定义链接分别处理成功/失败，单项失败不抹去其余成功内容。
         async function J() {
           if (!N.value) {
             ((N.value = !0),
@@ -353,6 +360,7 @@ var Se = {
             }
           }
         }
+        // 刷新自定义链接列表，与其他推广配置保持独立加载状态。
         async function Et() {
           ((Tt.value = !0), (z.value = ``));
           try {
@@ -365,6 +373,7 @@ var Se = {
             Tt.value = !1;
           }
         }
+        // 系统页面必须来自当前允许列表，自定义标识非空后才创建链接；成功后重读链接。
         async function Dt() {
           if (B.value || V.value !== null || N.value) return;
           let e = H.system_url.trim(),
@@ -392,6 +401,7 @@ var Se = {
             B.value = !1;
           }
         }
+        // 确认后按编码 ID 删除自定义链接，删除与生成操作相互锁定。
         async function Ot(e) {
           if (
             !(V.value !== null || B.value) &&
@@ -412,9 +422,11 @@ var Se = {
             }
           }
         }
+        // 选取服务端提供的完整链接或自定义链接，不自行拼接未知推广参数。
         function kt(e) {
           return e.url || e.custom_url || ``;
         }
+        // 复制推广链接并短暂显示反馈；失败提供可手动复制的原链接，计时器在离页时清除。
         async function At(e, t) {
           if (e) {
             (clearTimeout(q), (U.value = ``), (W.value = ``), (G.value = ``));
@@ -428,6 +440,7 @@ var Se = {
             }
           }
         }
+        // 先验证商品 ID，再向服务端获取带推广归属的链接，不直接用商品详情地址替代。
         async function jt(e) {
           if (K.value !== null) return;
           let t = Number(e.product_id);
@@ -569,6 +582,7 @@ var Se = {
               value: `renew`,
             },
           ];
+        // 提交搜索关键词后由公共列表工具应用完整筛选与日期范围。
         function Yt() {
           ((It.value = Ft.value.trim()), Q());
         }
@@ -637,11 +651,13 @@ var Se = {
               value: 0,
             },
           ];
+        // 仅在相应标签激活时加载奖励、提现或受邀用户列表，避免全部标签一起请求。
         function $(e) {
           (e === `records` && Q(),
             e === `withdraws` && rn(),
             e === `invitees` && mn());
         }
+        // 保存当前标签并触发对应数据加载。
         function gn(e) {
           ((Ct.value = e), $(e));
         }
@@ -657,6 +673,7 @@ var Se = {
             invitees: `受邀用户`,
           },
           yn = ref(!1);
+        // 提现完成后刷新推广余额资料与提现记录，金额以服务端结果为准。
         async function bn() {
           (await A(), rn());
         }
@@ -664,6 +681,7 @@ var Se = {
           onMounted(() => {
             (A(), w());
           }),
+          // 先区分未开通与已开通状态，再按标签显示链接/奖励/提现/受邀用户；各查询失败保持独立反馈。
           (n, i) => {
             let o = skeleton,
               l = message,