From 9aa4b3ba26a4c8e89746dcd21dcabab3fe3cd0bc Mon Sep 17 00:00:00 2001
From: Youzini-afk <13153778771cx@gmail.com>
Date: Thu, 23 Apr 2026 12:54:56 +0800
Subject: [PATCH] feat: add master plugin toggle

---
 maintenance/extraction-controller.js | 23 ++++++++++++
 style.css                            | 16 ++++++++
 ui/panel.html                        | 15 +++++---
 ui/panel.js                          | 56 ++++++++++++++++++++++++++++
 4 files changed, 105 insertions(+), 5 deletions(-)

diff --git a/maintenance/extraction-controller.js b/maintenance/extraction-controller.js
index fab1242..ba83eb3 100644
--- a/maintenance/extraction-controller.js
+++ b/maintenance/extraction-controller.js
@@ -567,6 +567,29 @@ export function resolveAutoExtractionPlanController(
     1,
     50,
   );
+  if (resolvedSettings.enabled === false) {
+    return {
+      strategy,
+      chat: resolvedChat,
+      settings: resolvedSettings,
+      lastProcessedAssistantFloor: safeLastProcessedAssistantFloor,
+      lockedEndFloor: safeLockedEndFloor,
+      extractEvery,
+      pendingAssistantTurns: [],
+      candidateAssistantTurns: [],
+      eligibleAssistantTurns: [],
+      eligibleEndFloor: null,
+      waitingForNextAssistant: false,
+      smartTriggerDecision: { triggered: false, score: 0, reasons: [] },
+      meetsExtractEvery: false,
+      canRun: false,
+      batchAssistantTurns: [],
+      plannedBatchEndFloor: null,
+      startIdx: null,
+      endIdx: null,
+      reason: "plugin-disabled",
+    };
+  }
   const assistantTurns =
     typeof runtime?.getAssistantTurns === "function"
       ? runtime.getAssistantTurns(resolvedChat)
diff --git a/style.css b/style.css
index 32244f0..d2915f9 100644
--- a/style.css
+++ b/style.css
@@ -3371,6 +3371,10 @@
 
 /* --- CAPABILITY CARD GRID (Feature Toggles) --- */
 
+.bme-capability-master {
+  margin-bottom: 14px;
+}
+
 .bme-capability-grid {
   display: grid;
   grid-template-columns: repeat(3, 1fr);
@@ -3394,6 +3398,18 @@
   box-shadow: 0 0 0 1px var(--bme-primary), 0 4px 12px rgba(0, 0, 0, 0.15);
 }
 
+.bme-capability-card-master {
+  min-height: 0;
+}
+
+.bme-capability-card-master .bme-cap-desc {
+  max-width: 820px;
+}
+
+.bme-capability-card.is-disabled {
+  opacity: 0.56;
+}
+
 .bme-cap-header {
   display: flex;
   align-items: center;
diff --git a/ui/panel.html b/ui/panel.html
index d99622a..3d3a1cb 100644
--- a/ui/panel.html
+++ b/ui/panel.html
@@ -1132,15 +1132,20 @@
                 </p>
               </div>
 
-              <div class="bme-capability-grid">
-                <label class="bme-capability-card" for="bme-setting-enabled">
+              <div class="bme-capability-master">
+                <label class="bme-capability-card bme-capability-card-master" for="bme-setting-enabled">
                   <div class="bme-cap-header">
-                    <span class="bme-cap-icon"><i class="fa-solid fa-brain"></i></span>
+                    <span class="bme-cap-icon"><i class="fa-solid fa-power-off"></i></span>
                     <input id="bme-setting-enabled" type="checkbox" />
                   </div>
-                  <div class="bme-cap-title">自动记忆</div>
-                  <div class="bme-cap-desc">开启自动提取、图谱写入与维护。</div>
+                  <div class="bme-cap-title">插件总开关</div>
+                  <div class="bme-cap-desc">
+                    关闭后停用 ST-BME 的自动提取、召回、向量、维护与手动操作；配置面板仍可打开，方便你随时重新启用或调整设置。
+                  </div>
                 </label>
+              </div>
+
+              <div class="bme-capability-grid">
                 <label class="bme-capability-card" for="bme-setting-recall-enabled">
                   <div class="bme-cap-header">
                     <span class="bme-cap-icon"><i class="fa-solid fa-magnifying-glass"></i></span>
diff --git a/ui/panel.js b/ui/panel.js
index 3e6acbf..b68380d 100644
--- a/ui/panel.js
+++ b/ui/panel.js
@@ -350,6 +350,26 @@ let lastVisibleGraphRefreshToken = "";
 let lastVisibleGraphRefreshAt = 0;
 let graphRenderingEnabled = true;
 
+function _isPluginEnabled(settings = _getSettings?.() || {}) {
+  return settings?.enabled !== false;
+}
+
+function _notifyPluginDisabled(actionLabel = "该操作") {
+  toastr.info(
+    `ST-BME 已关闭，暂时不能执行${actionLabel}。请先在配置页顶部打开“插件总开关”。`,
+    "ST-BME",
+  );
+  _refreshRuntimeStatus();
+}
+
+function _ensurePluginEnabledForAction(actionLabel = "该操作") {
+  if (_isPluginEnabled()) {
+    return true;
+  }
+  _notifyPluginDisabled(actionLabel);
+  return false;
+}
+
 // 由 index.js 注入的引用
 let _getGraph = null;
 let _getSettings = null;
@@ -1139,6 +1159,7 @@ function _onFabSingleClick() {
 
 async function _onFabDoubleClick() {
   if (!_actionHandlers.extractTask) return;
+  if (!_ensurePluginEnabledForAction("重新提取")) return;
 
   try {
     _fabEl?.setAttribute("data-status", "running");
@@ -5488,6 +5509,9 @@ function _collectNodeDetailEditorUpdates(bodyEl, { idPrefix = "bme-detail" } = {
 
 function _persistNodeDetailEdits(nodeId, updates, { afterSuccess } = {}) {
   if (!nodeId) return false;
+  if (!_ensurePluginEnabledForAction("节点编辑")) {
+    return false;
+  }
   if (_isGraphWriteBlocked()) {
     toastr.error("当前图谱不可写入，请稍后再试", "ST-BME");
     return false;
@@ -5522,6 +5546,9 @@ function _persistNodeDetailEdits(nodeId, updates, { afterSuccess } = {}) {
 
 function _deleteGraphNodeById(nodeId, { afterSuccess } = {}) {
   if (!nodeId) return false;
+  if (!_ensurePluginEnabledForAction("节点删除")) {
+    return false;
+  }
   if (_isGraphWriteBlocked()) {
     toastr.error("当前图谱不可写入，请稍后再试", "ST-BME");
     return false;
@@ -5847,12 +5874,16 @@ async function _callAction(actionKey = "", payload = {}) {
   if (typeof handler !== "function") {
     return { ok: false, error: "missing-action-handler" };
   }
+  if (!_ensurePluginEnabledForAction("该操作")) {
+    return { ok: false, error: "plugin-disabled", handledToast: true };
+  }
   const result = await handler(payload);
   _refreshCognitionSurfaces();
   return result;
 }
 
 async function _runCognitionOwnerManagementAction(mode = "", triggerEl = null) {
+  if (!_ensurePluginEnabledForAction("认知管理")) return;
   const graph = _getGraph?.();
   const ownerEntries = _getCognitionOwnerCollection(graph);
   const ownerEntry =
@@ -5985,6 +6016,9 @@ async function _runCognitionOwnerManagementAction(mode = "", triggerEl = null) {
 }
 
 async function _applyManualActiveRegionFromDashboard(clear = false) {
+  if (!_ensurePluginEnabledForAction(clear ? "清除当前地区" : "设置当前地区")) {
+    return;
+  }
   const input = document.getElementById("bme-cognition-manual-region");
   const region = clear ? "" : String(input?.value || "").trim();
   const result = await _actionHandlers.setActiveRegion?.({ region });
@@ -6009,6 +6043,9 @@ async function _applyManualActiveRegionFromDashboard(clear = false) {
 }
 
 async function _saveRegionAdjacencyFromDashboard() {
+  if (!_ensurePluginEnabledForAction("保存地区邻接")) {
+    return;
+  }
   const graph = _getGraph?.();
   const regionInput = document.getElementById("bme-cognition-manual-region");
   const adjacencyInput = document.getElementById("bme-cognition-adjacency-input");
@@ -6189,6 +6226,9 @@ function _bindActions() {
     if (!btn) continue;
 
     btn.addEventListener("click", async () => {
+      if (!_ensurePluginEnabledForAction(actionLabels[actionKey] || actionKey)) {
+        return;
+      }
       const handler =
         actionKey === "manageServerBackups"
           ? _openServerBackupManagerModal
@@ -6261,6 +6301,7 @@ function _bindActions() {
     ?.addEventListener("click", async () => {
       const btn = document.getElementById("bme-act-extract");
       if (btn?.disabled) return;
+      if (!_ensurePluginEnabledForAction("重新提取")) return;
       const mode =
         String(
           document.getElementById("bme-extract-mode")?.value ||
@@ -6320,6 +6361,7 @@ function _bindActions() {
     ?.addEventListener("click", async () => {
       const btn = document.getElementById("bme-act-vector-range");
       if (btn?.disabled) return;
+      if (!_ensurePluginEnabledForAction("范围重建")) return;
       if (btn) {
         btn.disabled = true;
         btn.style.opacity = "0.5";
@@ -6360,6 +6402,7 @@ function _bindActions() {
     ?.addEventListener("click", async () => {
       const btn = document.getElementById("bme-act-summary-rebuild");
       if (btn?.disabled) return;
+      if (!_ensurePluginEnabledForAction("重建总结状态")) return;
       const startFloor = _parseOptionalInt(
         document.getElementById("bme-extract-start-floor")?.value,
       );
@@ -6402,6 +6445,7 @@ function _bindActions() {
     ?.addEventListener("click", async () => {
       const btn = document.getElementById("bme-act-clear-graph-range");
       if (btn?.disabled) return;
+      if (!_ensurePluginEnabledForAction("按楼层范围清理")) return;
 
       const startStr = document.getElementById("bme-cleanup-range-start")?.value;
       const endStr = document.getElementById("bme-cleanup-range-end")?.value;
@@ -6620,6 +6664,14 @@ function _bindActions() {
     const [, actionKey] = matched;
     const handler = _actionHandlers[actionKey];
     if (!handler) return;
+    const actionLabels = {
+      synopsis: "生成小总结",
+      summaryRollup: "执行总结折叠",
+      rebuildSummaryState: "重建总结状态",
+    };
+    if (!_ensurePluginEnabledForAction(actionLabels[actionKey] || "总结操作")) {
+      return;
+    }
 
     try {
       await handler();
@@ -7118,6 +7170,8 @@ function _bindConfigControls() {
   bindCheckbox("bme-setting-enabled", (checked) => {
     _patchSettings({ enabled: checked });
     _refreshGuardedConfigStates();
+    _refreshStageCardStates();
+    _refreshRuntimeStatus();
   });
   bindCheckbox("bme-setting-debug-logging-enabled", (checked) => {
     _patchSettings({ debugLoggingEnabled: checked });
@@ -7856,6 +7910,7 @@ function _bindConfigControls() {
   document
     .getElementById("bme-apply-hide-settings")
     ?.addEventListener("click", async () => {
+      if (!_ensurePluginEnabledForAction("应用消息隐藏")) return;
       const result = await _actionHandlers.applyCurrentHide?.();
       if (result?.error) {
         toastr.error(result.error, "ST-BME");
@@ -7866,6 +7921,7 @@ function _bindConfigControls() {
   document
     .getElementById("bme-clear-hide-settings")
     ?.addEventListener("click", async () => {
+      if (!_ensurePluginEnabledForAction("清除消息隐藏")) return;
       const result = await _actionHandlers.clearCurrentHide?.();
       if (result?.error) {
         toastr.error(result.error, "ST-BME");