From f50693a6746436452ff7113514c1d83be624b5ed Mon Sep 17 00:00:00 2001
From: CieanYau <ltd@crash.work>
Date: Fri, 6 Nov 2026 00:37:01 +0800
Subject: [PATCH] docs: explain dcim services and purchase flows

---
 app/components/HostList.vue                     | 2 +-
 app/components/instance/DcimBilling.vue         | 4 ++++
 app/components/instance/DcimDefence.vue         | 4 ++++
 app/components/instance/DcimDomains.vue         | 2 ++
 app/components/instance/DcimMonitor.vue         | 3 +++
 app/components/instance/FlowPacketPanel.vue     | 3 +++
 app/components/instance/ImagePurchaseDialog.vue | 3 +++
 7 files changed, 20 insertions(+), 1 deletion(-)

diff --git a/app/components/HostList.vue b/app/components/HostList.vue
index 4904371..9d0f984 100644
--- a/app/components/HostList.vue
+++ b/app/components/HostList.vue
@@ -690,7 +690,7 @@ var Ye = {
             wn = Cn.statusOf,
             Tn = T?.scrollY ?? null;
           function En() {
-            // 离开详情前保存筛选、分页及滚动位置；快照仅存在当前账号的内存中。
+            // 离开列表前保存筛选、分页及滚动位置；快照仅存在当前账号的内存中。
             Oe.save({
               tab: A.value,
               keywords: j.value,
diff --git a/app/components/instance/DcimBilling.vue b/app/components/instance/DcimBilling.vue
index 77d4b2f..de6c439 100644
--- a/app/components/instance/DcimBilling.vue
+++ b/app/components/instance/DcimBilling.vue
@@ -1,4 +1,5 @@
 <script>
+// DCIM 计费入口集中处理自动续费和停用申请，停用操作可进入安全验证后重试。
 import "~/assets/styles/InstanceRenewDialog.BHDAL6d3.css";
 import "~/assets/styles/GeetestField.DiieTibK.css";
 import "~/assets/styles/CaptchaField.BSN3ZbsD.css";
@@ -149,6 +150,7 @@ var he = {
             Y = !1,
             X = (e, t) =>
               !Y && e === C.hostId && String(C.host.id) === e && t === J;
+          // 三项信息独立加载，自动续费失败不遮蔽退款规则或现有停用记录的错误。
           async function Z() {
             let e = ++q,
               t = C.hostId;
@@ -210,6 +212,7 @@ var he = {
               !B.value &&
               ((I.value = null), (M.value = ``), (H.value = null));
           }
+          // 根据确认动作分派自动续费、撤销或提交停用；提交前校验实例及原因有效性。
           async function Me() {
             if (
               P.value ||
@@ -280,6 +283,7 @@ var he = {
               r() && (P.value = !1);
             }
           }
+          // 只给当前实例保留的申请补充验证字段；后台再次要求挑战时继续保留验证状态。
           async function Ne(e) {
             let t = H.value,
               n = C.hostId,
diff --git a/app/components/instance/DcimDefence.vue b/app/components/instance/DcimDefence.vue
index bd1ce6a..9310586 100644
--- a/app/components/instance/DcimDefence.vue
+++ b/app/components/instance/DcimDefence.vue
@@ -1,4 +1,5 @@
 <script>
+// 按实例 IP 管理防御升级：先获取可选规格，再询价下单，成功后进入订单详情。
 import "~/assets/styles/DcimDefence.BYaQccXZ.css";
 import { toDisplayString } from "vue";
 import { onMounted } from "vue";
@@ -104,6 +105,7 @@ var T = {
             X = computed(() =>
               L.value.filter((e) => String(e.value) !== String(R.value)),
             );
+          // 每个 IP 的当前防御和可升级档位独立加载，禁止升级时不请求配置。
           async function Z() {
             let e = ++q,
               t = F.value,
@@ -148,6 +150,7 @@ var T = {
           function Q() {
             H.value || ((V.value = !1), J++, (W.value = !1), (K.value = null));
           }
+          // 报价绑定所选档位、IP 与实例，且价格必须为有效非负数。
           async function $() {
             if (x.upgradeAllowed === !1) return;
             let e = ++J,
@@ -186,6 +189,7 @@ var T = {
               !Y && e === J && (W.value = !1);
             }
           }
+          // 只有活动实例、可选档位及已返回报价同时满足时才允许创建升级订单。
           async function se() {
             if (
               x.upgradeAllowed === !1 ||
diff --git a/app/components/instance/DcimDomains.vue b/app/components/instance/DcimDomains.vue
index 2e99dd1..24a6a0d 100644
--- a/app/components/instance/DcimDomains.vue
+++ b/app/components/instance/DcimDomains.vue
@@ -1,4 +1,5 @@
 <script>
+// DCIM 域名白名单只读面板，先识别实例是否开通白名单，再按页读取关联记录。
 import "~/assets/styles/DcimDomains.BT2s5hGW.css";
 import { toDisplayString } from "vue";
 import { onMounted } from "vue";
@@ -53,6 +54,7 @@ var E = {
             F = ref(0),
             I = 0,
             L = !1;
+          // 页码控件从 0 开始，接口从 1 开始；实例切换或卸载后丢弃旧页面结果。
           async function R() {
             let e = ++I,
               t = y.hostId;
diff --git a/app/components/instance/DcimMonitor.vue b/app/components/instance/DcimMonitor.vue
index e2f1b19..2633d63 100644
--- a/app/components/instance/DcimMonitor.vue
+++ b/app/components/instance/DcimMonitor.vue
@@ -1,4 +1,5 @@
 <script>
+// DCIM 带宽监控根据时间范围查询入/出站曲线，图表组件按需加载。
 import "~/assets/styles/DcimMonitor.CiStTCbZ.css";
 import { toDisplayString } from "vue";
 import { onMounted } from "vue";
@@ -97,6 +98,7 @@ var T = defineAsyncComponent(() =>
             L = 0,
             R = !1,
             z = ``;
+          // 时间以秒提交；实例、模块或范围变化时清空旧曲线，并用代次阻止旧请求覆盖。
           async function B() {
             let e = ++L,
               t = h.hostId,
@@ -123,6 +125,7 @@ var T = defineAsyncComponent(() =>
               !R && e === L && (N.value = !1);
             }
           }
+          // 缺失采样转为 null 而不是 0，配合 connectNulls:false 保留采集中断的空隙。
           function V(e) {
             return e != null && e !== `` && Number.isFinite(Number(e))
               ? Number(e)
diff --git a/app/components/instance/FlowPacketPanel.vue b/app/components/instance/FlowPacketPanel.vue
index 2758945..fad0bc1 100644
--- a/app/components/instance/FlowPacketPanel.vue
+++ b/app/components/instance/FlowPacketPanel.vue
@@ -1,4 +1,5 @@
 <script>
+// 实例流量包面板：展示可购规格与已购包，在弹窗模式中按需加载购买列表。
 import "~/assets/styles/FlowPacketPanel.-RJSx13z.css";
 import { toDisplayString } from "vue";
 import { renderList } from "vue";
@@ -142,6 +143,7 @@ var oe = {
           let K = 0,
             q = 0,
             J = !1;
+          // 可购规格与云模块已购流量包并行读取，各自保留错误，避免一项失败遮蔽另一项。
           async function Y() {
             if (J || !I.hostId) return;
             let e = ++K,
@@ -202,6 +204,7 @@ var oe = {
           async function $() {
             ((Q.value = ``), (X.value = !0), await Y());
           }
+          // 仅允许当前列表中未达月限购的单次规格下单，订单 ID 校验后交给父级支付。
           async function pe(e) {
             if (
               J ||
diff --git a/app/components/instance/ImagePurchaseDialog.vue b/app/components/instance/ImagePurchaseDialog.vue
index 8b49863..2bf4dea 100644
--- a/app/components/instance/ImagePurchaseDialog.vue
+++ b/app/components/instance/ImagePurchaseDialog.vue
@@ -1,4 +1,5 @@
 <script>
+// 付费镜像授权弹窗：复查实时价格、复用本组件已建订单，并在支付后重新检查授权。
 import "~/assets/styles/PaymentDialog.BNFKQF1U.css";
 import { toDisplayString } from "vue";
 import { onBeforeUnmount } from "vue";
@@ -58,6 +59,7 @@ var C = {
             throw Error(`镜像费用信息无效，请重试`);
           return Number(e).toFixed(2);
         }
+        // 免费或已授权镜像直接放行；价格变化需用户重新确认，不能沿用旧金额创建订单。
         async function I() {
           let e = w.value;
           if (!e || D.value || N) return;
@@ -100,6 +102,7 @@ var C = {
             t === M && (D.value = !1);
           }
         }
+        // 支付回调不等于授权已生效，只有检查接口费用变为 0 才通知调用方继续操作。
         async function L() {
           let e = w.value;
           if (!e || N) return;