docs: annotate cloud network and upgrade components

app/components/mfcloud/MfCloudIps.vue

@@ -1,4 +1,8 @@
 <script>
+/**
+ * 云实例 IPv4/IPv6 列表及附加地址购买；addresses 事件供父级更新可选 IP，pay 事件交接订单。
+ * 仅支持的云模块开放附加地址操作，upgradeAllowed 来自父级业务状态而非本地授权。
+ */
 import "~/assets/styles/MfCloudIps.jhFnuvcs.css";
 import { toDisplayString } from "vue";
 import { onMounted } from "vue";
@@ -117,10 +121,12 @@ var ce = {
             R = 0,
             z = 0,
             B = !1;
+          /** 两类地址并行加载、分别显示错误；每类以 100 条分页完整拉取，实例变化使旧结果失效。 */
           async function V() {
             let e = ++L,
               t = `/${O.module}/${O.hostId}`;
             ((P.value = !0), (F.value = ``), (I.value = ``));
+            // count 缺失时不足一页结束；有 count 却提前返回空页时不能当作完整列表。
             async function n(n) {
               let r = [],
                 i = 1;
@@ -182,6 +188,7 @@ var ce = {
             K = ref(``),
             q = ref(!1),
             J = ref(``),
+            // 数量、权限、实例和弹窗共同构成取价快照，任何一项变化都必须重新报价。
             Y = computed(() =>
               JSON.stringify([
                 O.hostId,
@@ -191,6 +198,7 @@ var ce = {
                 G,
               ]),
             ),
+            // IPv4/IPv6 可分别为 0，但总数必须大于 0；不能提交负数或非整数数量。
             X = computed(
               () =>
                 Number.isInteger(G.ip_num) &&
@@ -209,12 +217,14 @@ var ce = {
                 !q.value &&
                 !U.value,
             );
+          // 清除报价并递增序号，使较早的取价响应无法恢复过期的可提交状态。
           function Q() {
             (R++, (K.value = ``), (J.value = ``), (q.value = !1));
           }
           watch(Y, Q, {
             flush: `sync`,
           });
+          // 每次打开恢复为一枚 IPv4，并立即获取对应价格。
           async function xe() {
             O.upgradeAllowed !== !1 &&
               !U.value &&
@@ -225,6 +235,7 @@ var ce = {
               (H.value = !0),
               await $());
           }
+          /** 询价只更新与当前数量快照一致的响应，合法的零价格也能通过金额适配器。 */
           async function $() {
             if ((Q(), O.upgradeAllowed === !1 || !H.value || !X.value)) return;
             let e = ++R,
@@ -245,6 +256,7 @@ var ce = {
               !B && e === R && (q.value = !1);
             }
           }
+          /** 有有效报价才创建 ip_num/order，校验订单号后关闭弹窗并发 pay；不自动重复下单。 */
           async function Se() {
             if (!Z.value || B) return;
             let e = Y.value,
@@ -284,9 +296,11 @@ var ce = {
                   V());
               },
             ),
+            // 离开面板后作废地址请求和报价请求，防止回填已销毁界面。
             onBeforeUnmount(() => {
               ((B = !0), L++, Q());
             }),
+            // 两张地址表共享加载态但分别呈现错误；购买弹窗展示当前数量、报价和重报价入口。
             (t, n) => {
               let r = OperationNotice,
                 a = button,