docs: annotate remaining routes layouts and view boundaries

app/pages/transfer/index.vue

@@ -1,4 +1,7 @@
 <script>
+/**
+ * 实例转移：可转移、待接收和记录各自走服务端列表；发起前验证接收人转移码，敏感请求可由安全挑战续接，手续费订单独立支付。
+ */
 import "~/assets/styles/GeetestField.DiieTibK.css";
 import "~/assets/styles/CaptchaField.BSN3ZbsD.css";
 import "~/assets/styles/SecurityVerificationDialog.skYFo4v7.css";
@@ -215,6 +218,7 @@ var xe = {
         onBeforeUnmount(() => {
           ((I = !0), F++, Y(), (q.value = null));
         });
+        // 并行读取转移规则与本账户转移码；失败时不继续假定规则已就绪。
         async function it() {
           N.value = ``;
           try {
@@ -229,6 +233,7 @@ var xe = {
               (N.value = e instanceof Error ? e.message : `加载转移设置失败`);
           }
         }
+        // 按当前标签、分页和关键词读取列表，类型筛选只用于历史记录；旧代次不回写。
         async function L() {
           let e = ++F,
             t = x.value,
@@ -258,6 +263,7 @@ var xe = {
             e === F && (E.value = !1);
           }
         }
+        // 切换标签时重置页码与筛选，避免将记录条件带入可转移列表。
         function at(e) {
           e !== void 0 &&
             ((x.value = e),
@@ -266,12 +272,15 @@ var xe = {
             (C.value = null),
             L());
         }
+        // 筛选变化时回到第一页再加载。
         function R() {
           ((D.value = 1), L());
         }
+        // 将分页器零基页码转换为服务端一基页码。
         function ot(e) {
           ((D.value = e.page + 1), (O.value = e.rows), L());
         }
+        // 复制本账户接收转移码，反馈仅用于界面，不改变转移状态。
         async function st() {
           try {
             (await navigator.clipboard.writeText(A.value),
@@ -279,6 +288,7 @@ var xe = {
               setTimeout(() => (j.value = !1), 2e3));
           } catch {}
         }
+        // 把秒级限制时长转换为小时或天，不把它当作绝对到期时间。
         function ct(e) {
           if (!e || e <= 0) return `—`;
           let t = 86400;
@@ -301,6 +311,7 @@ var xe = {
           lt = ref({}),
           q = ref(null),
           J = 0;
+        // 转移码或确认码变化时立即废弃旧的接收人验证；非提交期间同时清除待续交安全请求。
         function Y() {
           (J++,
             (U.value = null),
@@ -332,6 +343,7 @@ var xe = {
               !W.value &&
               !G.value),
         );
+        // 新发起转移前清空上一次接收码、免责声明与校验结果。
         function dt(e) {
           G.value ||
             K.value ||
@@ -345,9 +357,11 @@ var xe = {
             (M.value = ``),
             (z.value = !0));
         }
+        // 打开待接收记录的处理模式，与发起转移草稿区分。
         function ft(e) {
           ((V.value = e), (B.value = `handle`), (M.value = ``), (z.value = !0));
         }
+        // 只有两次转移码一致才查找用户；结果绑定提交时的码及请求代次，修改后不能复用。
         async function pt() {
           if (
             W.value ||
@@ -389,6 +403,7 @@ var xe = {
         let X = ref(!1),
           mt = ref(null),
           Z = ref(``);
+        // 通过规则、免责声明与接收人校验后冻结 host_id/transfer_code，再提交敏感操作。
         async function ht() {
           V.value &&
             B.value === `start` &&
@@ -401,6 +416,7 @@ var xe = {
             }),
             await gt());
         }
+        // 携带冻结的转移请求和安全验证结果续交；确认安全流程完成后刷新列表，返回手续费订单时打开支付。
         async function gt(e) {
           if (!q.value || G.value || I) return;
           let t = {
@@ -435,6 +451,7 @@ var xe = {
             G.value = !1;
           }
         }
+        // 对待接收记录执行接受或退回，成功后关闭弹窗并从服务端刷新。
         async function _t(e) {
           if (V.value && !G.value) {
             ((G.value = !0), (M.value = ``));
@@ -453,9 +470,11 @@ var xe = {
         }
         let Q = ref(!1),
           $ = ref(null);
+        // 取消前保存目标记录并打开确认，尚未发起取消请求。
         function vt(e) {
           (($.value = e), (M.value = ``), (Q.value = !0));
         }
+        // 确认取消当前记录，成功后刷新列表，不直接在本地改成完成状态。
         async function yt() {
           if ($.value && !G.value) {
             G.value = !0;
@@ -472,6 +491,7 @@ var xe = {
             }
           }
         }
+        // 只有有效正整数手续费订单 ID 才能继续支付，缺少订单时提示刷新核实。
         function bt(e) {
           if (
             !Number.isSafeInteger(Number(e.order_id)) ||
@@ -488,6 +508,7 @@ var xe = {
           onMounted(() => {
             (it(), L());
           }),
+          // 三类列表共用分页但操作目标分开保存；转移码校验、安全验证与手续费支付为不同阶段。
           (t, r) => {
             let i = ListSegments,
               o = button,