From 5ba081550ca9a8305d87112627957a8acc2eadf9 Mon Sep 17 00:00:00 2001
From: CieanYau <ltd@crash.work>
Date: Fri, 6 Nov 2026 00:37:50 +0800
Subject: [PATCH] docs: annotate instance controls and legacy upgrades

---
 app/components/HostList.vue                      | 2 +-
 app/components/PaymentDialog.vue                 | 2 +-
 app/components/instance/DcimActions.vue          | 4 ++++
 app/components/instance/LegacyDcimActions.vue    | 5 +++++
 app/components/instance/LegacyProductUpgrade.vue | 4 ++++
 app/components/instance/RemfUpgrade.vue          | 5 +++++
 6 files changed, 20 insertions(+), 2 deletions(-)

diff --git a/app/components/HostList.vue b/app/components/HostList.vue
index 9d0f984..fda5456 100644
--- a/app/components/HostList.vue
+++ b/app/components/HostList.vue
@@ -982,7 +982,7 @@ var Ye = {
             }
           }
           async function Vn(e) {
-            // 附加数据按三路工作队列加载；翻页或卸载推进代次，不再继续启动旧队列任务。
+            // 两类附加数据各以最多三路队列加载；翻页或卸载推进代次，不再启动旧队列任务。
             let t = ++Ln;
             if (dn.value) return;
             async function n(n) {
diff --git a/app/components/PaymentDialog.vue b/app/components/PaymentDialog.vue
index 0b88e8a..ec8ba37 100644
--- a/app/components/PaymentDialog.vue
+++ b/app/components/PaymentDialog.vue
@@ -301,7 +301,7 @@ var ue = {
         ),
         emits: mergeModels([`success`, `updated`], [`update:modelValue`]),
         setup(i, { emit: _ }) {
-          // C 为支付步骤，O 为已支付标记；余额和订单金额在内部统一使用整数分。
+          // C 为支付步骤，O 为已支付标记；余额及抵扣计算使用整数分，z 保留订单金额的元文本。
           let b = useModel(i, `modelValue`),
             x = i,
             Et = _,
diff --git a/app/components/instance/DcimActions.vue b/app/components/instance/DcimActions.vue
index 1371414..aefef36 100644
--- a/app/components/instance/DcimActions.vue
+++ b/app/components/instance/DcimActions.vue
@@ -1,4 +1,5 @@
 <script>
+// DCIM 实例控制：集中确认电源、密码、重装与救援操作，VNC 交给独立远控页面。
 import "~/assets/styles/GeetestField.DiieTibK.css";
 import "~/assets/styles/CaptchaField.BSN3ZbsD.css";
 import "~/assets/styles/InstanceSmsCode.CsITfIEU.css";
@@ -144,6 +145,7 @@ var fe = {
               ? !!C.detail.remote?.value && !C.detail.remoteLoading?.value
               : !0;
           }
+          // 操作必须仍对应打开弹窗时的模块和实例，并且当前详情仍允许控制。
           function Q() {
             return (
               !K &&
@@ -161,6 +163,7 @@ var fe = {
               (A.value = ``),
               (W.value = null));
           }
+          // 只接受已知操作；重装时按商品与模块重新获取镜像，清空上次操作的敏感输入。
           async function $(e) {
             if (!Z.value || k.value || K || !(e in q) || !Ee(e)) return;
             if (e === `vnc`) {
@@ -200,6 +203,7 @@ var fe = {
               }
             }
           }
+          // 提交前校验短信、密码、镜像、端口及备份确认，付费镜像先进入授权购买流程。
           async function Oe() {
             if (!D.value || k.value || !Q() || !Ee(D.value)) return;
             let e = D.value,
diff --git a/app/components/instance/LegacyDcimActions.vue b/app/components/instance/LegacyDcimActions.vue
index 6c20bc9..1f971bb 100644
--- a/app/components/instance/LegacyDcimActions.vue
+++ b/app/components/instance/LegacyDcimActions.vue
@@ -1,4 +1,5 @@
 <script>
+// 旧财务 DCIM 控制适配：从模块按钮与 dcim.auth 解析权限，不凭缺省字段开放危险操作。
 import "~/assets/styles/LegacyDcimActions.DcIrQby6.css";
 import { toDisplayString } from "vue";
 import { renderList } from "vue";
@@ -117,6 +118,7 @@ var de = {
                 !!A.value &&
                 !!j.value,
             );
+          // 兼容单项及 console/control 分组按钮，后台显式禁用的动作优先拒绝。
           function Oe(e) {
             let t = A.value?.module_button,
               n = Array.isArray(t) ? t : [t];
@@ -144,6 +146,7 @@ var de = {
             }
             return !1;
           }
+          // 旧功能名映射到统一动作；BMC 必须单独授权，其他动作遵循布尔或逐项授权。
           function N(e) {
             if (!Object.hasOwn(O, e) || !j.value || Oe(e)) return !1;
             let t = j.value.auth,
@@ -242,6 +245,7 @@ var de = {
             X = 0,
             Z = !1,
             Q = null;
+          // 绑定原始详情对象和实例编号，后台详情换新后原确认表单不再具有提交资格。
           function Ne(e) {
             return (
               !Z && M.value && N(e) && I.value === C.hostId && Q === C.data
@@ -284,6 +288,7 @@ var de = {
                 (W.value = !1));
             }
           }
+          // 重装必须确认数据影响；Linux 固定整盘分区，Windows 才允许选择第一分区方式。
           async function Ie() {
             let e = F.value;
             if (!e || e === `vnc` || L.value || !Ne(e)) return;
diff --git a/app/components/instance/LegacyProductUpgrade.vue b/app/components/instance/LegacyProductUpgrade.vue
index eec1b60..1777604 100644
--- a/app/components/instance/LegacyProductUpgrade.vue
+++ b/app/components/instance/LegacyProductUpgrade.vue
@@ -1,4 +1,5 @@
 <script>
+// 旧财务模块跨商品升级：读取目标商品与周期，再使用当前选择的同步报价创建订单。
 import "~/assets/styles/LegacyProductUpgrade.dzWGwGgY.css";
 import { toDisplayString } from "vue";
 import { onMounted } from "vue";
@@ -71,6 +72,7 @@ var C = {
           function W() {
             (B++, (L.value = ``), (U = ``), (P.value = !1), (I.value = ``));
           }
+          // 仅保留有合法商品 ID 和周期数组的升级目标，禁止升级时不加载选项。
           async function G() {
             if (D.upgradeAllowed === !1 || H) return;
             let e = ++V;
@@ -94,6 +96,7 @@ var C = {
               e === V && (N.value = !1);
             }
           }
+          // 报价绑定实例、模块、目标商品与周期，切换任一条件都会使旧报价失效。
           async function K() {
             if (
               D.upgradeAllowed === !1 ||
@@ -129,6 +132,7 @@ var C = {
               e === B && (P.value = !1);
             }
           }
+          // 必须持有与当前选择一致的报价才能下单，返回订单编号有效后再发出 pay 事件。
           async function q() {
             if (
               D.upgradeAllowed === !1 ||
diff --git a/app/components/instance/RemfUpgrade.vue b/app/components/instance/RemfUpgrade.vue
index 9361fc0..c1f5fd1 100644
--- a/app/components/instance/RemfUpgrade.vue
+++ b/app/components/instance/RemfUpgrade.vue
@@ -1,4 +1,5 @@
 <script>
+// 旧财务模块配置升降级：适配数量、选项、镜像及区域类型，并对当前配置快照询价。
 import "~/assets/styles/RemfUpgrade.4stQ5ASH.css";
 import { nextTick } from "vue";
 import { toDisplayString } from "vue";
@@ -122,6 +123,7 @@ var se = {
             q = 0,
             J = ``,
             Y = computed(() => JSON.stringify([D.hostId, O.value, F.value]));
+          // 将镜像分组和区域嵌套列表展开为统一选项，便于同一控件和校验逻辑使用。
           function X(e) {
             return e.option_type === 5 && e.sub && !Array.isArray(e.sub)
               ? Object.entries(e.sub).flatMap(([e, t]) =>
@@ -182,6 +184,7 @@ var se = {
               t === q && (I.value = !1);
             }
           }
+          // 初始化配置不触发报价；用户改动后立即废弃旧报价，防抖 400ms 再请求。
           function ye() {
             D.upgradeAllowed === !1 ||
               U ||
@@ -194,6 +197,7 @@ var se = {
               (L.value = ``),
               (W = setTimeout(be, 400)));
           }
+          // 数量先校验范围，选项先校验成员关系；只接收仍属于当前配置快照的价格。
           async function be() {
             if (
               D.upgradeAllowed === !1 ||
@@ -246,6 +250,7 @@ var se = {
               e === G && (B.value = !1);
             }
           }
+          // 下单再次比对报价快照，避免用上一个配置的金额提交新的配置。
           async function xe() {
             if (
               D.upgradeAllowed === !1 ||