docs: annotate account commerce finance and content pages

app/pages/account/api-keys.vue

@@ -1,4 +1,7 @@
 <script>
+/**
+ * API 密钥管理：列表分页、创建、IP 白名单编辑及删除。私钥仅在创建响应中保留，关闭弹窗或离开页面即清空，不能视为可再次查询的资料。
+ */
 import "~/assets/styles/api-keys.Bq3Csr53.css";
 import { toDisplayString } from "vue";
 import { onMounted } from "vue";
@@ -33,6 +36,7 @@ import paginator from "primevue/paginator";
 import checkbox from "primevue/checkbox";
 import column from "primevue/column";
 import textarea from "primevue/textarea";
+// 集中管理列表权限、写操作忙碌态和仅本次可见的私钥；请求代次与存活标记防止旧响应更新已离开的页面。
 function D() {
   let e = useApi(),
     t = ref([]),
@@ -60,6 +64,7 @@ function D() {
   onBeforeUnmount(() => {
     ((v = !1), y++, b());
   });
+  // 刷新当前页并读取服务端 create_api 权限；响应结构无效时不开放创建入口。
   async function x() {
     if (!v) return;
     let n = ++y;
@@ -86,6 +91,7 @@ function D() {
       v && n === y && (o.value = !1);
     }
   }
+  // 只在权限已加载且允许创建时提交。创建响应不完整时提示先刷新核实，避免误以为失败而重复生成密钥。
   async function C() {
     if (!(!v || s.value || m.value)) {
       if (((d.value = ``), (f.value = ``), !l.value || o.value)) {
@@ -123,6 +129,7 @@ function D() {
       }
     }
   }
+  // 打开白名单编辑器时复制行数据，未保存的输入不直接修改列表。
   function w(e) {
     s.value ||
       ((d.value = ``),
@@ -131,6 +138,7 @@ function D() {
       (g.enabled = Number(e.status) === 1),
       (g.ip = e.ip || ``));
   }
+  // 开启白名单必须提供 IP；保存成功后关闭编辑器并重新读取服务端数据。
   async function T() {
     if (!v || s.value || !h.value) return;
     if (((d.value = ``), (f.value = ``), g.enabled && !g.ip.trim())) {
@@ -155,6 +163,7 @@ function D() {
       v && (s.value = !1);
     }
   }
+  // 删除成功后，若当前页只剩这一条则回退一页，再刷新列表。
   async function E() {
     if (v && !s.value && _.value?.id) {
       ((d.value = ``), (f.value = ``), (s.value = !0));
@@ -271,6 +280,7 @@ var O = {
               !e && !N.value && (U.value = null);
             },
           });
+        // 复制创建时返回的私钥；剪贴板不可用时保留手动复制提示，不把私钥写入持久存储。
         async function he() {
           if (z.value) {
             J.value = ``;
@@ -282,9 +292,11 @@ var O = {
             }
           }
         }
+        // 关闭私钥展示同时清空密钥与复制反馈，避免之后再次暴露。
         function Z() {
           (B(), (q.value = !1), (J.value = ``));
         }
+        // 分页器为零基页码，接口页码从 1 开始。
         function ge(e) {
           ((S.value = e.page + 1), W());
         }