docs: annotate cloud network and upgrade components

app/components/mfcloud/MfCloudUpgrade.vue

@@ -1,4 +1,8 @@
 <script>
+/**
+ * 云实例推荐套餐升降级；与自选资源面板不同，这里提交 recommend_config_id。
+ * 父级控制 upgradeAllowed 并消费 pay 事件；费用和续费差价均来自后端报价，不本地估算。
+ */
 import "~/assets/styles/MfCloudUpgrade.N7TNG8F1.css";
 import { toDisplayString } from "vue";
 import { renderList } from "vue";
@@ -116,6 +120,7 @@ var w = {
             Y = 0,
             X = 0,
             Z = null;
+          /** 刷新可升级套餐同时清空选择和报价，过滤隐藏项及明确禁止升级的套餐。 */
           async function Q() {
             if (L.upgradeAllowed === !1) return;
             let e = ++X;
@@ -139,6 +144,7 @@ var w = {
               e === X && (U.value = !1);
             }
           }
+          /** 选套餐后先清旧报价；请求序号 Y 与套餐 id 一起阻止较早的询价覆盖新选择。 */
           async function ae(e) {
             if (L.upgradeAllowed === !1 || J.value) return;
             let t = ++Y;
@@ -169,6 +175,7 @@ var w = {
               t === Y && (q.value = !1);
             }
           }
+          /** 只有当前套餐已有对应有效报价才下单，提交锁阻止重复点击；返回订单后交接支付。 */
           async function oe() {
             if (
               L.upgradeAllowed === !1 ||
@@ -205,6 +212,7 @@ var w = {
               J.value = !1;
             }
           }
+          // 将套餐已有规格组合为文本，缺失项不编造默认值；GPU 数量缺失按现有约定显示 1。
           function se(e) {
             return [
               e.cpu ? `${e.cpu} 核` : ``,
@@ -217,6 +225,7 @@ var w = {
               e.gpu_name ? `${e.gpu_num ?? 1}× ${e.gpu_name}` : ``,
             ].filter(Boolean);
           }
+          // 当前规格摘要来自父级实例信息，仅作对照，不作为目标套餐请求体。
           let $ = computed(() =>
             [
               L.current.cpu ? `${L.current.cpu} 核` : ``,
@@ -232,9 +241,11 @@ var w = {
           return (
             onMounted(Q),
             watch(() => [L.hostId, L.module], Q),
+            // 作废列表与报价在途序号，避免离开后仍接受这些异步结果。
             onBeforeUnmount(() => {
               (Y++, X++);
             }),
+            // 套餐列表、无可升级提示和取价/下单栏分层展示；提交期间锁定套餐选择。
             (n, i) => {
               let a = OperationNotice,
                 s = message,