docs: annotate account commerce finance and content pages

app/pages/messages/index.vue

@@ -1,4 +1,7 @@
 <script>
+/**
+ * 站内消息：分页筛选、批量已读/删除与详情弹窗；读状态变化同时刷新公共邮箱计数，详情请求用序号隔离快速切换。
+ */
 import "~/assets/styles/NotificationPreferences.DcH8Noxd.css";
 import "~/assets/styles/messages.asRdYcVu.css";
 definePageMeta({
@@ -163,12 +166,15 @@ var ge = {
               value: e.name,
             })),
           ]);
+        // 类型显示优先使用服务端本地化名称，未知类型保留原标识。
         function H(e) {
           return E.value.find((t) => t.name === e)?.name_lang || e || `—`;
         }
+        // 提交后才应用搜索词，避免输入每个字符都发请求。
         function Le() {
           ((j.value = A.value.trim()), R());
         }
+        // 清空阅读状态、类型与关键词，重新加载消息列表。
         function Re() {
           ((A.value = ``),
             (j.value = ``),
@@ -176,6 +182,7 @@ var ge = {
             (k.value = ``),
             R());
         }
+        // 将指定 ID 标为已读，完成后清除选择并刷新列表与全局未读计数。
         async function ze(e) {
           if (!(!e.length || B.value || G.value)) {
             ((B.value = !0), (U.value = ``));
@@ -193,6 +200,7 @@ var ge = {
             }
           }
         }
+        // 使用 all 标记请求服务端全部已读，不局限于当前可见页。
         async function Be() {
           if (!(B.value || G.value)) {
             ((B.value = !0), (U.value = ``));
@@ -213,12 +221,14 @@ var ge = {
         let U = ref(``),
           W = ref(!1),
           G = ref(!1);
+        // 删除前先打开确认弹窗，读状态更新和删除期间不重复触发。
         function Ve() {
           !z.value.length ||
             B.value ||
             G.value ||
             ((U.value = ``), (W.value = !0));
         }
+        // 仅提交选中消息的 ID；成功后同步列表与未读计数。
         async function He() {
           if (!z.value.length || G.value || B.value) return;
           let e = z.value.map((e) => e.id);
@@ -244,6 +254,7 @@ var ge = {
           Y = ref(``),
           X = ref(null),
           Z = 0;
+        // 详情打开时清除旧正文并递增请求序号；加载成功后尝试标读，标读失败不覆盖已加载的正文。
         async function Q(e) {
           let t = ++Z;
           ((X.value = e),