From 94c7a099d533273794dd41f0782838d9c7cb1e3d Mon Sep 17 00:00:00 2001
From: H3CoF6 <1707889225@qq.com>
Date: Tue, 28 Apr 2026 05:54:31 +0800
Subject: [PATCH] =?UTF-8?q?feat(image):=20=E5=A2=9E=E5=8A=A0=E5=8F=AF?=
 =?UTF-8?q?=E9=80=89=E7=9A=84=E8=87=AA=E5=8A=A8=E5=A4=A7=E5=9B=BE=E4=B8=8B?=
 =?UTF-8?q?=E8=BD=BD=E5=8A=9F=E8=83=BD?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 frontend/components/SidebarRail.vue           |  44 +++++++
 frontend/composables/useApi.js                |  13 ++
 frontend/stores/imgHelper.js                  |  71 +++++++++++
 src/wechat_decrypt_tool/api.py                |   8 ++
 src/wechat_decrypt_tool/img_helper.py         | 111 ++++++++++++++++++
 src/wechat_decrypt_tool/native/img_helper.dll | Bin 0 -> 19968 bytes
 src/wechat_decrypt_tool/routers/system.py     |  37 +++++-
 7 files changed, 282 insertions(+), 2 deletions(-)
 create mode 100644 frontend/stores/imgHelper.js
 create mode 100644 src/wechat_decrypt_tool/img_helper.py
 create mode 100644 src/wechat_decrypt_tool/native/img_helper.dll

diff --git a/frontend/components/SidebarRail.vue b/frontend/components/SidebarRail.vue
index 116b759..de156fc 100644
--- a/frontend/components/SidebarRail.vue
+++ b/frontend/components/SidebarRail.vue
@@ -195,6 +195,33 @@
         </div>
       </div>
 
+      <!-- ImgHelper (Auto download large images) -->
+      <div
+        class="sidebar-rail-action w-full h-[var(--sidebar-rail-step)] flex items-center justify-center group"
+        :class="imgHelperBusy ? 'opacity-60 cursor-not-allowed' : 'cursor-pointer'"
+        :title="imgHelperTitle"
+        @click="toggleImgHelper"
+      >
+        <div class="sidebar-rail-plate w-[var(--sidebar-rail-btn)] h-[var(--sidebar-rail-btn)] rounded-md flex items-center justify-center transition-colors bg-transparent">
+          <svg
+            class="sidebar-rail-icon w-[var(--sidebar-rail-icon)] h-[var(--sidebar-rail-icon)]"
+            :class="{ 'sidebar-rail-icon-active': imgHelperEnabled }"
+            viewBox="0 0 24 24"
+            fill="none"
+            stroke="currentColor"
+            stroke-width="1.8"
+            stroke-linecap="round"
+            stroke-linejoin="round"
+            aria-hidden="true"
+          >
+            <rect x="3" y="3" width="18" height="18" rx="2" ry="2" />
+            <circle cx="8.5" cy="8.5" r="1.5" />
+            <polyline points="21 15 16 10 5 21" />
+            <path d="M12 9v5m-2-2l2 2 2-2" />
+          </svg>
+        </div>
+      </div>
+
       <!-- Privacy -->
       <div
         class="sidebar-rail-action w-full h-[var(--sidebar-rail-step)] flex items-center justify-center cursor-pointer group"
@@ -368,6 +395,7 @@
 import { storeToRefs } from 'pinia'
 import { useChatAccountsStore } from '~/stores/chatAccounts'
 import { useChatRealtimeStore } from '~/stores/chatRealtime'
+import { useImgHelperStore } from '~/stores/imgHelper'
 import { usePrivacyStore } from '~/stores/privacy'
 import { useThemeStore } from '~/stores/theme'
 
@@ -384,6 +412,10 @@ themeStore.init()
 
 const realtimeStore = useChatRealtimeStore()
 const { enabled: realtimeEnabled, available: realtimeAvailable, checking: realtimeChecking, statusError: realtimeStatusError, toggling: realtimeToggling } = storeToRefs(realtimeStore)
+
+const imgHelperStore = useImgHelperStore()
+const { enabled: imgHelperEnabled, checking: imgHelperChecking, toggling: imgHelperToggling, error: imgHelperError } = storeToRefs(imgHelperStore)
+
 const { open: settingsDialogOpen, openDialog: openSettingsDialog } = useSettingsDialog()
 const { getChatAccountInfo, deleteChatAccount } = useApi()
 
@@ -620,6 +652,18 @@ const toggleRealtime = async () => {
   if (realtimeBusy.value) return
   await realtimeStore.toggle({ silent: false })
 }
+
+const imgHelperBusy = computed(() => !!imgHelperChecking.value || !!imgHelperToggling.value)
+
+const imgHelperTitle = computed(() => {
+  if (imgHelperEnabled.value) return '关闭自动下载大图'
+  return imgHelperError.value || '开启自动下载大图'
+})
+
+const toggleImgHelper = async () => {
+  if (imgHelperBusy.value) return
+  await imgHelperStore.toggle()
+}
 </script>
 
 <style scoped>
diff --git a/frontend/composables/useApi.js b/frontend/composables/useApi.js
index 07fae1f..754f84b 100644
--- a/frontend/composables/useApi.js
+++ b/frontend/composables/useApi.js
@@ -636,8 +636,21 @@ export const useApi = () => {
     return await request(url)
   }
 
+  const getImgHelperStatus = async () => {
+    return await request('/system/img_helper/status')
+  }
+
+  const toggleImgHelper = async (enabled) => {
+    return await request('/system/img_helper/toggle', {
+      method: 'POST',
+      body: { enabled: !!enabled }
+    })
+  }
+
   return {
     pickSystemDirectory,
+    getImgHelperStatus,
+    toggleImgHelper,
     detectWechat,
     detectCurrentAccount,
     decryptDatabase,
diff --git a/frontend/stores/imgHelper.js b/frontend/stores/imgHelper.js
new file mode 100644
index 0000000..a9e7be1
--- /dev/null
+++ b/frontend/stores/imgHelper.js
@@ -0,0 +1,71 @@
+import { defineStore } from 'pinia'
+
+export const useImgHelperStore = defineStore('imgHelper', () => {
+  const enabled = ref(false)
+  const checking = ref(false)
+  const toggling = ref(false)
+  const error = ref('')
+
+  const fetchStatus = async () => {
+    if (!process.client) return
+    const api = useApi()
+    checking.value = true
+    error.value = ''
+    try {
+      const resp = await api.getImgHelperStatus()
+      enabled.value = !!resp?.enabled
+    } catch (e) {
+      error.value = e?.message || '获取插件状态失败'
+    } finally {
+      checking.value = false
+    }
+  }
+
+  const toggle = async () => {
+    if (toggling.value) return
+    
+    const targetState = !enabled.value
+    
+    if (targetState) {
+        // Show warning for first time or every time? User said "首次开启提示hook可能存在风控风险"
+        // We can use localStorage to track if it's the first time.
+        const hasWarned = localStorage.getItem('img_helper_warned')
+        if (!hasWarned) {
+            const confirmed = window.confirm('【安全提示】\n开启“自动下载大图”功能将使用 Hook 技术修改微信内存逻辑。这可能存在一定的风控风险，建议仅在需要时开启。\n\n确认开启吗？')
+            if (!confirmed) return
+            localStorage.setItem('img_helper_warned', 'true')
+        }
+    }
+
+    toggling.value = true
+    error.value = ''
+    const api = useApi()
+    try {
+      const resp = await api.toggleImgHelper(targetState)
+      enabled.value = !!resp?.enabled
+      return true
+    } catch (e) {
+      error.value = e?.message || '操作失败'
+      if (process.client) {
+          window.alert(error.value)
+      }
+      return false
+    } finally {
+      toggling.value = false
+    }
+  }
+
+  // Initialize status
+  if (process.client) {
+    fetchStatus()
+  }
+
+  return {
+    enabled,
+    checking,
+    toggling,
+    error,
+    fetchStatus,
+    toggle
+  }
+})
diff --git a/src/wechat_decrypt_tool/api.py b/src/wechat_decrypt_tool/api.py
index b52fbc9..35f8c88 100644
--- a/src/wechat_decrypt_tool/api.py
+++ b/src/wechat_decrypt_tool/api.py
@@ -37,6 +37,7 @@ from .routers.wechat_detection import router as _wechat_detection_router
 from .routers.wrapped import router as _wrapped_router
 from .request_logging import log_server_errors_middleware
 from .wcdb_realtime import WCDB_REALTIME, shutdown as _wcdb_shutdown
+from .img_helper import IMG_HELPER
 from .routers.biz import router as _biz_router
 from .routers.system import router as _system_router
 
@@ -188,6 +189,13 @@ async def _shutdown_wcdb_realtime() -> None:
         CHAT_REALTIME_AUTOSYNC.stop()
     except Exception:
         pass
+    
+    # Uninstall img_helper hook if enabled
+    try:
+        IMG_HELPER.disable()
+    except Exception:
+        pass
+
     close_ok = False
     lock_timeout_s: float | None = 0.2
     try:
diff --git a/src/wechat_decrypt_tool/img_helper.py b/src/wechat_decrypt_tool/img_helper.py
new file mode 100644
index 0000000..2e59413
--- /dev/null
+++ b/src/wechat_decrypt_tool/img_helper.py
@@ -0,0 +1,111 @@
+import ctypes
+import os
+from pathlib import Path
+from typing import Optional
+from .logging_config import get_logger
+
+logger = get_logger(__name__)
+
+class ImgHelper:
+    def __init__(self):
+        self._lib: Optional[ctypes.CDLL] = None
+        self._enabled = False
+        self._lock = __import__("threading").Lock()
+
+    def _resolve_dll_path(self) -> Path:
+        # 1. Default (source code layout)
+        base = Path(__file__).resolve().parent
+        path = base / "native" / "img_helper.dll"
+        if path.exists():
+            return path
+        
+        # 2. Frozen (bundled exe)
+        import sys
+        if getattr(sys, "frozen", False):
+            exe_dir = Path(sys.executable).resolve().parent
+            # Try native subfolder or same folder as exe
+            for p in [exe_dir / "native" / "img_helper.dll", exe_dir / "img_helper.dll"]:
+                if p.exists():
+                    return p
+        
+        # 3. Current working directory
+        for p in [Path.cwd() / "native" / "img_helper.dll", Path.cwd() / "img_helper.dll"]:
+            if p.exists():
+                return p
+        
+        return path # Fallback to default for error message
+
+    def _load_lib(self):
+        if self._lib is not None:
+            return self._lib
+        
+        dll_path = self._resolve_dll_path()
+        if not dll_path.exists():
+            raise FileNotFoundError(f"Missing img_helper.dll at: {dll_path}")
+            
+        try:
+            # On Windows, ensure the DLL's directory is in the search path for dependencies
+            if hasattr(os, 'add_dll_directory'):
+                try:
+                    os.add_dll_directory(str(dll_path.parent))
+                except Exception:
+                    pass
+                    
+            lib = ctypes.CDLL(str(dll_path))
+            
+            lib.InitImgHelper.argtypes = [ctypes.c_uint32]
+            lib.InitImgHelper.restype = ctypes.c_bool
+            
+            lib.UninstallImgHelper.argtypes = []
+            lib.UninstallImgHelper.restype = None
+            
+            lib.GetImgHelperError.argtypes = []
+            lib.GetImgHelperError.restype = ctypes.c_char_p
+            
+            self._lib = lib
+            return lib
+        except Exception as e:
+            logger.error(f"Failed to load img_helper.dll: {e}")
+            raise
+
+    def enable(self, pid: int) -> tuple[bool, str]:
+        with self._lock:
+            try:
+                lib = self._load_lib()
+                if self._enabled:
+                    # If already enabled, we uninstall first to be safe as per DLL docs suggestion
+                    # about being designed to hook one process at a time.
+                    lib.UninstallImgHelper()
+                
+                if lib.InitImgHelper(pid):
+                    self._enabled = True
+                    logger.info(f"ImgHelper hook applied to PID {pid}")
+                    return True, "Success"
+                else:
+                    err_ptr = lib.GetImgHelperError()
+                    err_msg = err_ptr.decode('utf-8', errors='ignore') if err_ptr else "Unknown error"
+                    logger.error(f"ImgHelper hook failed: {err_msg}")
+                    return False, err_msg
+            except Exception as e:
+                logger.error(f"ImgHelper enable exception: {e}")
+                return False, str(e)
+
+    def disable(self) -> bool:
+        with self._lock:
+            if not self._enabled:
+                return True
+            try:
+                lib = self._load_lib()
+                lib.UninstallImgHelper()
+                self._enabled = False
+                logger.info("ImgHelper hook uninstalled")
+                return True
+            except Exception as e:
+                logger.error(f"Failed to uninstall img helper: {e}")
+                return False
+
+    @property
+    def is_enabled(self) -> bool:
+        return self._enabled
+
+IMG_HELPER = ImgHelper()
diff --git a/src/wechat_decrypt_tool/native/img_helper.dll b/src/wechat_decrypt_tool/native/img_helper.dll
new file mode 100644
index 0000000000000000000000000000000000000000..b4ca9e556897d068b91b11a6a67d00b30304d48f
GIT binary patch
literal 19968
zcmeHv4|r77weOxJlLW|k2FPGglmP~bMldAEA46mY64)aXjF2EIlEh>}Mw3Z8e;_E<
z;1FdzPCu&lUR&)gQ1Nnmy?wM#5om1_f+YM=1GE*z_e^cCo*1<V79*nP{nkF`B$Gg@
zeBbSR-}`P4-#%;Yz1LoQ?X}lld+mKP6y3R*B{Ig6kW`hi-GKBs#rqpxCdMuszxOis
z;;`2y>^6B`n^02Y3)&k3^{WFFb@s{%zrQ|YzsGA2g#C7(-(GO*GJ9Qpm3NxOGTfoF
zzI%dc)mUe}#YooK=Pe_VUwWuE?J5E9OVjfArVSH$f7*D!@>YM^6@X)%e#=zAO^2(~
zt`x97EknS~77f;k{8C?K4fQd2M8$=SRXvi--aPUbpHX*;O|*|lxGaZVhmwg}sb@N%
zRp3n+wuUD#mMn_;A=`oiQYM}RRt{3FkpV8uYbDlO8QX+5PXlhD#!Za%5^TVnpr5{H
zGh@Zbkld&m^05|R4uzmPiIcI-@%ce5r-i(YA(Xw4iI)|L#;%V8n0V}rl}`&)RfH-S
z>$IWBi8Kaj8dBWjM9nmfjB%2^9El)gihrDpwM=W!2*ns_K-A~Lcq-A2b6Ox6s6?^Q
zNfQv_cMDS7<D`BA-r9N)l8)GBB%<?BrvGs=Horgj-y7pG%N$I3_p?_qb_5TP<nM;=
zBpx&W5RglY%-;uWqdIz=rOTGz?kaJWx|X|c=dl+Y%KuW;-5HY@Q(CV9eO4Ej%^$#s
zdG3B5ZKmZ@Ah+fo+oP)EnQGg918Sn?@7)H_+!8J+%>A=;d&?d>CczV}auiD=3mi_u
zRwy};NV1x*%%K)2<?RKI;!z+ZWW{(O(nuz~Y#9!M>L|AsY$_kseUuo*igvhmGdn0_
zr4Xk>warAg=&HFT<dX|`xa4>EzxArBy5_FUT(+1<nAn3|yt2&`Yd!_eTuyK2vAON8
zJxN$Hs!fG~qwP2zvpoktz+*9@Qf;%csa)FlpXgOC+M%}b*6u{G;d!lr=P@oZq`twe
z5Q9_h94E#VBu0JXN(YDdamkiS)N7+kS8dB70FSJ9tdKl0sG>mbfG9`NyGL3?s?h{e
z9vayvoD!RiTDgVCen7G+FQNx7mpE4N$T>-R<X$Ufsj0e;Z#YLQUV6Al6!Ko4)ygAE
zDv$JzmmZx?g^_(zx^qPB<w5{x?J(xpwI>5|tF{lOQeU+WXHoOV(#Aw+R$l4gM49c8
z^S6>U#EM#kLcE>w@q$fNj_fniLxnBMR7kueHY3ZKqq^n47Ug{+MSgY}=CfKFzY(md
zi)_4!RXLac;FjM|ZMUH}7*A+DjR&PG9gRHkZJu}9BOivn{=t)XrbwFqx+m|@nxYL4
zHqqF^1#;oW9j0);w6`lYFv}wsLNSFqi?UwzM7=vbiTh|K?4GPcqJ!S+#dKRebG$ou
zlh1TYyHsgWFPG1_^ZvK=a193N+^9+$Rct4FXa|5r&c=#ZUJYdK?aP!kS3vUJRKsH>
zj@ht5E}u|7!z$r&De$5ekG#*5)#{N?yCc1$*B5)_w|MOSk9q9IYhbF?{p0t<EGCo`
z$;Y7*_|HOVSAt9Wjj157C2Vo4t)9HsLy}wF*Ymz7@7++UTW#w(QY4@8<eio_?jg-(
zeahv1MTvjKq`Kwvn9~$#;}%p%<D2ki(ypXA*Yh1;hSxQ%pJR%J1JbU7ISJRBcYF|D
z%_|G$B=Sg03QufzC%)>=I}l#xk>BLaYG|=BKU{8iXYJ$pES0g~jh@(D$!>YSC+lSB
zDox%3bdb0tmNv3*c9JQ48CP4}d2NC2#j*73dd9mWADY6iKt8UvYetvC^LnL+S3|*W
z`FA{Ot1F_pJ{d~iE0if8Rz{2^CE7|v#j)^hLoKs2Fip6RxwLZnmKoX(SZ0#d;sAj(
zk`IIX7~6e+8Zo#01sewJV>gfGpC?ophYWXs`G&clz}^VwRVbU2(fBlaIXe}LwZOrp
zUFOe$ZYpqiste%7mI$Xst;FJ%fSeXyfR;c}_Xw@KCiIbe%(aKX)L}q&+5+LgV7IF6
zDf9)0SqBn~lze7!pF@fFmPy)hA4Ko{!=*hs-m5@VOARO>1Giwnw(jT%ZE<B|9c;-x
zb^t537;AMit<KGgilqpHeVU3n&nw*$vK~m_R6=eeTKaU)D6z<?g>o#8c!NQ_VF=>w
zam42g;&Vd~H|oT~Z)n5?n<frHy!cXxuZ|PLWQbuJg7c@CN2>Z(V(iz6Np%5(b6^P0
z{~Sj=#vmRu1o6Fb#Iivw4?&zCNBpos{O}OO);Qu$gSc}D;y(%7{g&F;bt%NrOCesV
z6O*1JhRl&6WWFJexYr<tTfeA1C&Upa8pMf15dR+Qh^k18ut6Lif_O(9@o<B9_z=Vo
z#1Xd}#O*^6FNq`m#_66ANBoV`{n_wKF#h&SA^y>&5ZCF%q~`=f8wo>b!+9y3M_&r@
z`@=3l8+&wOl6i$8^NJy4eq1MZ%kPN&-V;m86KzJjq+M*&fT3E1-@Q|B!4ZB&zO;m2
z<MLHA7ec;Bn}xbmd2}U05Z!yLL-d;-C*)*<c=8a$A7Hbms&C~9_g)Hd>{5u!FNHW)
zCl+IqHeGSS&}Iv5rp1$`BN%eb8K`uz<INGYT`8Ix1WQ4C(?w`+60|Q~K$~|F+B`wK
z=>poh7onXiXjfi9n|~47d_kLi0qxBfp}kqqCS5=~Z&QLtE_#|`&S;Uo^Uo8sClH%a
z6~gMxB5aavuPi{!nuSQ$@>5_UfKqLp6GYs!Y^adUiTDV?)KQ1l!YP6$x?dO^!@L3t
zieWB83^S(tCkW9I5#B-_#R^ZL&l`ZcM3|(7QF{L?wEkE1^)HSVblB8RW-W*Y(7$g$
z|2Rfz{UZt&Cr+zn1qjf)l_I}8G*O&aL6phe=|U9qZ*jfg+T)~_vh8P-*^R9g8Osll
z!Lj%~I%LKQUl4*-w>Nho@7@dKLm)2oK=Vg{@2R%u?cyYYxWQIQEh#3IEyX}_Ql&;(
zNUD#o0n`O@(F=mJY?~h6@i@^jf=isAKn8}R;;X-MQLs4=HUHDp{U*cshB&=Gi-BO+
zb(3fu#;N>rG#ETbcY=cENP=Q6M;r@bFF3(U6ETnhC)igKK&GE&4`b@%POzuVs4`Bl
zYi0~Oy#}u2@}QIJTAB=;Tzjx-cPPiPo#&k7WTJFrw~3i5-NLgv_4DsVINUgZ!}q~K
zsKvWQgva8tVJJO?h}df0J^?cH>FFZ37f*q}xV=zq{;NskLFfE#%*sG5{WHm>YiT=z
z{5UNgNkUbhma+$H>GDBZT3gz$p<f^#5E`OmMralsWM`aq#t&|JCAC!6qmi_$t><de
zalM`yxd(H_Ub~jc?jo)&T#nII5YIiL>?O~#VLx3NxyoFtTz9)xmaV$$ZvBRdM?S&<
z!@ND8h;f62gEcIE)jVXI4~8Cu-QFqiW1;VGx?j*1fG1{NM#Uh9f!E;X2!zv7(zo!&
zA*0$>X*J_@76`E|iA1%BHPHo8i)t$n6qb)~7VCjB?dErop@+*JNP{7K4u{7h`#EG5
z_XB;mW4J$ymN={)$dTcRdK`9KmSIGghI2d?qRWc6l(%Vyq9I47M}7nDiKdbceOd>{
zxtyxn-ax<2Ex0mMRf*#+W`8y`q;=w4R*L(#<zQ;(@>njP=JIV;kBmb;?k*Ibb(rUU
zDm`+Fr2Q?m$MX=+`&@c-B0BQOt#n>Ls<^XScwWca5x2zV;@I;wm*#&>r|kJW>$tHR
zU@41n6Z963^x!7w%kgWM7?yHac@)8dyPZzt01L5W3W)P6dTmz2Nx3I`oP2{yC)mLC
zJa+38p7)0I$d6F1tfV*tr`Qz3L}DwZ@W`LKcyvK;&j>ERq1+@QkrVFd)jXD#=Z>yQ
zbw`(2rCp^E{{Y7gz^&qzE9q)?bRi_$Z+ERKTXpwcZEpFysi;PnWaU|3V$5qsdgOLx
z0;t{cs#Ko!dCy*OP^?<>+(FHi)0med%D6=B9#p&S#C<39jq6UKaF0Bl|4P#-lq$PY
zi{vhM7G(O6V*>Kpq>VFZHf6Wfo%K48uBZ7v>H)0r#2QWfD9GA4E=%${)?CB)Ttn)@
zJ-_0nkb`{EuaM=jM(E=M=wnfD4?>5ek#6~2cV0V}7M#EoLAPqpB);KGp<CS2E{1Lo
zOOLdoY0pcfoiD}4-OJ_IAcQA2V-6IO=5TGg47&Bm(3m{Nou`D&o~(U6V?FY#fXZD^
z3Dvn{OH7`uSGoLqg_D-#Wby<vxx5@I?emjZ>H|FO+GJrF!;KlmqOXP!?pWG99=+Kk
zWBhK+Ty#k)CKPUj^nw}Hrp~pJ=1$oT#T`-V2Pq$uK*6gWQ$Q1dWn_MQ4&>4t0~Wwk
z%S|-9r*Mzv$$NEe7LR--d7|dO5K-)^69lA1S9KDEYC^Eb14&o2?nIiV{+Y}>BRx7w
z%$%6DVjejtL91&QKoK-$m^hj>Wo-`T<2tNi%pjJ`2_9QuB3q_8DZmvNnfr7e<Cu~T
z>5&68CByliDS&vIlnU}1(C57a<`_2Lp)8~-xt9z)dgFA6>z4n(qgUM^1b;($34zgp
zq*?GeUrB57;k3S<4f<HA$yltI5*HS02aj}PNqjN>f+@ke?@&5v2aV>pQe(^lE_%!_
z2^@}!+?t&>UtFiwkjHVYT6K4uk`Kv`C~wm2Xb+|#6W<J)uO$C?dq!Wmv0lJ)E2Qr8
zh&sJj&`-H2{T-;|?JmuIL|w2F^ZR2-Qe4Ee_AxU0kC~%-Wu!HgtCO!B$dl|Pm3*!p
zY|4mI{sNrjw>ijF+s6o1&bFCCmc3|(x;K<xkvqnqVO;HGl4S#XbS@LTFz50<jN1Z^
z*z$R7St^f?z+9(FBNJ5H_rMnY-5?}GxPg<{e!KA4gWA7_ZZFb)iPpXywLChYJ={Af
zqzD(vy!jZH3itg@`RXpt{}Y5#@lqMHMc;d{-^O47O5kf%#aD%s4jKv-e2kr2C+xqE
z=6RN3GjXAA<*lvO>d#wMHEhCXkAv3ko3Z8vzf9##xNsQy1TUA9CT9yp^VA+QmPIH%
zx8)R<eql+Q1ty;$Fo^8WY};w-`5ZlwttiiEZBvx9SQ9;Cm1ppw2DTf3FkqRK)6$co
z+=t9glW0n9at|s~VWAsaq#tPf3|^0dZX?zw8jVu!*D@)}cYySK6xUuULy2-HUV0(5
zCp+TNT8EYP>I`8~ZutxN8kmyYt$YTjjio;(@}((^eda*!F?d{<kZQX{=o(*I5G@qz
zmQ_npObB0F$iTX{&{YGC^?wK^Au9|k4N9c}b#FzbattqUH!D98q)?GQ&X@Fj_X`5~
zD6{!sIOTx()f*WzDf_X$l_yc5k2zg=M9U0=h8_Ug^I_irHM?xee;h5D{8o5%<O|c<
zdzGs+i88U%I3U#;)GCQ+31LXe?^6DZHbc{()!b^S-h9wTqIakWip_-}z;*Q!0Ll_X
z_I7{+<_UP4gaB9?VzUsjpqTdzgeJR-?nEp+$Lu=}qiW=pmS=&$BJUuOcxb~M`sN)j
z+dTqqs(OwqBV2;LOM3aXbZkEvJn^XXvMU)oOp_;;c8EvQ9qzoNp$z$!G!MSU4VUMq
zCgNjBO91|HUuMs{n6Ktz!ZOk$_dD2wWFy02hsl5m!Ynh|G#x$mmXZR~&OHY68?o_Z
zIE6oITQWn;7RF)daREx$V{e6$HXaM7DVIS-j~!N00E_{{rgUEr$-f%JxQKZxoTBW8
z!h0kxABT2RQLH?J0_qC~Cj^80$YRKm2z#L|i+_IN%9hVhsPOeLizD6GGHI1|KY(`q
zeaLSS)5FSr+I)^C+zXucpAR&i2<p^Ova%Y>?1=K$FICl$FJ_j~K?#=^HJ#mO3Jn*&
zQh9<p@AGUVPxG<R9DKnEWzuU*<QzyvI4mSnww+hi9<vezkao3*GPm4Gu$#Vv6d~gI
z0mZhN-5Ip^YU?dT>utTmZbZ2FruQj~chpy^isikr0}YiQLe|Gl;2Vq6`LZdJzX#uc
znbiC$-tFdpLk8TK@@EijYzf_}`~>4umeT7xc)^@b;}iyE{|P`@g^7h}U#o1;$nB`#
zr`7*E)z3zKySXGs`!fQ3q{O7Y4_WZ_FFa3~OAO@`JTjYw9JIma3Nb@4<^y|Sq}at@
z=W?P)w#)=GmwHq+mx7hhQBOi{i|!mk<Q&#JICOznwrvmkWXcw7OPdWpB+d}d$G(uw
zHneYUdB~zQcA`mkS)1AsHJ_i3Mh~6SHDizDZ$m*sc&73sMyA|Dp5Z87?dC^OP7g*h
z4&vq>b3XQlG834z>xA-8AeP&DeyYhZj%0ukT*g6ch20Z%W<-lIKRi`Gf;h<?p2HMj
zDM@o|jbQyyN^VQ{e}aE(z8dK@t#u-1>lg_=kvog6F!f*)&O}~5feFuUJ}GVdIf$V!
z`Auj`*$zQag@YXh#81XoJ#pHoim0aWOz_JQewUi9K^<>C3xiS)(>5lXOSC>iml-sw
z?H7nJ@afVVQ4_;+`+B4~GkOf+!qa?3ytFu4X_Be70Gex3_ax_@B<Zmj#K-5zekYwl
z+WKu+-!6J-ulN)T1D<?57AnpoSm<OFBHo~h7aPJekQsBmhivAxYXu*uxz>?Edyk!%
zS#w)*4@%oMeCiK*Yd4(s`MvHDM`cBr(uOmOy#DZr<1wyE+vG38t0teChjU}Q`GslV
z*96^TT>zz%OMXkTiG?!r%aapWXhMDifh){Azc`P{vafaUJtiz4T0mU-X=^aOKsNs?
z?!8=*4pTwY{4CI(6qG#)q%ikjq5M|ltCaQga}T;=t`zirx<EcI?fuiR;0UxxK#O}p
z2rF1`*-b_r<L9Jp1@fWY2r*cmvR<Mg704%hk_+XdE;_@SEs&E(y1s5V)87=3AnoQq
z0wc{}Bl!fVwD*Jb;CK-IrQN)*zv?*9cJoVkV^tE-l~QCD7@!YRCvSbv&PR08;oOd@
zaZ-eM)8&ZWkvun9YW@^$Wb*@P{mZUMM{2v7K9iDbjhd^0xz6shhwh1V*xSvwB8!ED
ziXvcpK-CGkOMw?mItr=2f|!damv=ObI~4RVao<h*!em+5D2`Zccw^yqooqKJ0wrnD
zBpql^3W!Dkk@miSc`%Jjdr!dv%wJp&0i?Zu935QJ&ktu4TNhQp2wN4aOFkUwO5X5C
zl_fE5xfZI6T0R9Q{&^>#gmK$m1Z~q7rZppY<h|b_|D4X$7PJYb=&WmWa2UXin@|Nw
zRys1t%hXb2tXZlRv2kw89CITG5Nfr_2VtzR+kMzU5TlO04E+s^<Ih@Xa7G*tJJw^(
z*J&?_*?vOtvWPV|U^+z1l~Ky&k3fh{&0Dfi{i~d9?@s+8VR>!gwYYD#^7cY;R#0s(
zBV^-pA=XOaDb=<WIsC!Pbi)5b!(&AmTK+-G7iOUODc;(J(+=?5!c#oAm5XZ@`qM`~
z37Opf-mn9=Lj6}{Q70=A%R!e>^J2=v?c%};yU35B3LHXaf<63X%o0PsdoN9C%=~@e
zB5qSYAomnWbtv!CxFe|vV1T_FG_MF6+WUmdz@c?Cg^#iPG=QE_*ga^+PF8K7p$B}?
zN#%L(2D&x>L9RpdIY!$LY@%%!Kz!TXL$t-z9Z@I$65*XX`8o0ajd*Vs?;NyJCp*MD
zS-g8i`G?~Dj(Cp|<);L`O}sTe&kKB~c)yMJks~`zWIGr$;)WvGg&hy~RYw)rhqfPT
z8aZ;rgBuh1ZI_%H`D3r^EK3U6T(UE@sFEjreu7ta79}3?Oghw)SR^0fm94kP>8Wmc
zfmP-NQqLBc5~a{6e6%qo?m0!Op4942+}D%nMjVxkWqPPP|BUdoH1hZ-?tBAZ>p}47
zp*bnaJ?X*U?__wgI*X+F$GskT++;GnqP*k5G1aaO@3B)wv1b^%aveyd(lBl!&=%H$
zFmu1PO`TkY5Kx`GT)eG96Vz{ie`;5}90nd&KlvQmI<YEndt}NzxM4P&PmA<atK13;
zM7g*K{P3|NxRm|&ySw>cDUj<gwktDHvRPEd(QCy2O4<;_SZ>5$#!~V)GRaNi505g=
zsw%$eG{~hj_>-k_MS&R;C$fFxq4|U>YR)9{JSVN0gLPX@nZCa(3w(?FB9aliR4y9Q
z12h|`1oVJ;Bo(69%r>g}$MavSfsWfWekXMJp$@;+VcJry-l4;}I$W;98XbODhfnD6
zXFA-g!?~pzpIRM0tixw@xLk+E=>DL$Gx80~G^|*Mvvv4uz1=T$c&A>Tti!8yXz*z&
z(XdTAd`gE#{lDn>Vja%VVTKOR>ipK|`Jd_V9liXJ4r}ysgYVA=$+1n(9~d<5f*Gud
z!X5)Q&C>E)20?@GD!tsu;}TM|@5^5z0<SsX!QWyFereMN^6gxt<vTMqxaC?6t{9^H
zo{B1aMJ@g`yCUSP_cL}v=R3Il<e)vXFc7E@EWi&1Zn96V4I`MrQx*(W1VRP%YyGwL
z6;(yvDqn>tzqP^ZFAmgKdV@iGb%n3iTP2Fw?aa%3tP#nNKToe>wfINR?OtD_&p)lI
zw$@HRPN=RA`$dZ)Z(V(0oju@%obh~0Dgvv$pbPseN$`P<z;Av<<$d9X{wB+Pfl#=j
z)<r`tZ0s*zR^zR$t;Cq@YXiQJx35B{#}Go^$`G}v57>i!#C@V%NT&^U4O*c^sJ`A_
zTkl`Zf}w!Vzq&s!^d1OQth4*QYwfjO|LRZ;>7mqrpC8J!dmAgg4ce42+KioKe1C_>
zSw7Hyj4n32bo<evQQimtPV)5eAB23S+wY)a_OveF4jt~);cgwa=#bhOza^nV%RNX1
z90~V(^cZz%z|)a-pl-*YI+}+rH2yW}em$rTG4_Ay6R+NKEUC<eU{7g?hv=Pg^~G^G
zH6b3xLym-SCz9Yx8U5)h*A8`*ji+lF#IKR^i*R;9`dbg3)waa7jUN~FMSS6NE_kev
z*PxA;!#TLWZ;*lJIy0_~!IL_qK8PQD;|0%b)EQ5F|GNj#4mE!2XGa`ue80q-_`p{W
zc<9qdVpC#M8tlss{CYqtyZbu)4L4HmRK`BeVeCB8s$9l?j+8h9zo|jpPDK1Qu*s)E
z|2*#Se+0O6S;4Y<{yg@^#ieh$9!Vd0$CH!l&ZeS#!A&bmgWf=J<@8zEvu3Xh)`tU?
z-jxAwLw#^%T^(FjZE&TpZgm;FU4u8UvT^2&l}o*~-in|%t{6WMqBTShzJZ8Dx+ZxS
zEhzEOM>h(|#qXCKRX(81ih}YfMp+$p8~j!ZveHu0=<58A?Cd`IwX#O$oXx~8q2<?U
zJBbr_U{LBbAN@|raU=19&tf2D)3UQGt5-ADfjo_O+JdFH_FsS;bUv_5?D8iDmf^M=
z>wG|&TeMXMmI=C31Img8UGKm$K}WxA>X)TN(4`J66LeOTox-9qe$U0QHa;^Mc}IX`
zgD(`nqta*`YwBx5b)*#XXDj>KI_|&!{;GSR2DW9f-gh8W>2SM5-#Z4B-6{Is8DCbS
z(d`~krqQ*atQ?a)tx@}pn0*OkMn78K(Fl|oznh!p)oAGVbB_~^Heaw{#vH|(uhq+7
z&6q!w#my_M8}o>mH#MoRt>$^lF-NE~e$Pg}q{+xbP2}(F{rMnJ)`YSSD!V5r^2TrY
zjNiHugL0~;-?TZhrvqi>P1>5$%Y@ui{!NbwzfelTT#n5h&L)~FlPsr3bPelFX)!k>
zl_zE=6gSW)CZT>b=pM#8K%Q*ZG$x6SSvsm=WVtolG$NUe$VurEZHg1JO=-z2Ehn`r
zxdl9spI}L1md`BAj6Z6!PiE{6q;wBs6ToL+9?An98$>sDTr#uFurSNgVO=TZ$wDSO
z+D<Shfah?w<r<vzrr>v&I?sW57{DMJ)9@rVd`2=Go|D{Q!VP9}4rC@hV0<R<9Y**>
zAQ&s<<?9)vTQ~Ao1WgGhmVo&;rKhs=Dx{JWmJWXDIo5`ewp3;d4P&;d6lO!2EoWpG
z@qrZhu_9wP;70Q|;6u+7z<(T<*JUXlDdbCK!<QyEP+Mq)y$QN6kbbYXJp$a4&DbY;
zehlylNJc&7C&tweyCRugF+*Zk1jclwH;gVf#&!p2X2OCJFsTHE3`-M=O;R$GFa`-@
zka9*eXk*1VOEAtEW|lt6+F+u2oiQBql3YxBqNfj%4o7KaJ2N%t#QGcjkY1WlzT+Zw
zv{vXb_O%S)b}gJ2<@B;rs?f6WbmfESh{D(_<LO!k(ItXz1!NgYCgNj^r}H8*Q@z1|
z`K_8hh$p4l$QK|LBhem{jkFnd=0$!jQZo{@NMQZD8l5!QB5%lDx0;J>P8@ES+wbcy
zLNM<0<9t(F+ean*6LF)bV<}!v>?y^R)1F?GJ?(^ViYwc^4D*1po$zDEvm58oMi+c@
zT-n<wt3er$D?5iWE6OtC%En>WIt6|gd;W26Fi<Q1ukQ_F2{1BGMKGk<7rQE1KQZ1G
z_6F7!Vy}E5X(<l3`dL{!?y`AFapz}tC~<LaPN6?sXAsp_g=@V*_B$#E`y!E_kN9j!
zMV<F{_U3?cw;xB>I_-FGGkVw0!HoHmZ>Mvw!C9QP8N1S;>pTB4cF?r2HXN*RV?_kQ
z;?TXIqO!)zG7Q><0k0PW`Y~HjTOaiD3V&6tmn|+_x}?yPn<Lg6`(DDlvK884x6Dho
z3C>`s%IUnrwW7Fiet{EFNYS$83yP=D$kym5urgdQRF(CehRZ7J8`jZ}{|A>>c_CK)
zI>cCIWeduJ4c<y$wXd?QMo1B0>}FQytqXcX<Oj+YG&Yvh1nSoo_8+n*>l{Pt8oXsb
zsH{xqSXS!`qSf*ROG}rOxQhz=WV?lxt*s3DD(f2PMpVe-tA~7bb@l$THNgg)_e0fX
zK{gL}B;J~`YF};08z>{UlfgjdulB7D2fSte3g}^N8Ll(dAi`(p+ZXax)cWr4tMdBS
z_yYC*I<Fsc%ospX@Ao$PLS><fd!TAImz4#)t06A>(QAzR5z?5q(OVe~d5tQq(bbS8
z5Gt#{e>30<;Xe&1s}u-itj2Uw+*no#2Z&3G8a9^I0j;mZj;2Y0j_TN~e!R@fDjIxK
z>w;6)`utPDcdB;nF|~I3)ag_8IlX|Q%2yvxFsL5?M@7h2=lvTLHQtJb_-eKxNi42n
zZ$MbSztXz^*GUkT&8OA4ARGulm%7QjtJuQ0QrHDnBMR9SiJ)D!4%)0MfdH=HLfm2z
z#(tDY+k`er%RJCGM-ylt7FJ2tnNL_<{TeTm>D~wSKF}w9o1C%NeH+?~(HLLnE>`z#
z%3izMeysX;s%io;#S+>HLLeeb^3fwo@FKdu^+<y%Gv^PycbYcOwH$Y1SO>ThD}%X}
zX>LMu5ZM2Qq9=nih|tHy==!|JH_-L1eW!DfwEy?B6vI3=5ithNS`^FNJPCg(0=yXT
z-;sKO?*z0V=1)R=9v|=1Ip7h*?hcd_d>m;maDq=Dd4R{q@)YBrM_P|^f)2!$n}HL&
z4rvSUY{2<Q;_L?)&~e-ov(bq4UIY!rkar`s0H-+d$2v~2;29mK|G&hJ)ImG}mmqZl
zr#p-&67heWppFy#y^hoGyIGb-L(rz<8GwyQ^qX*kJM?mbzt(YrXLY<6Fmk;n=SIMB
zID7mKZ3#M&NPdDo9j^s^UdML;{+95?kQ)&9?}DD-EFGT>xQTGk5d4=L5W^KgkARc1
z8Kd9GI{-b?AuDi#QKS>Vp8~vL2Id-gE#Tuwq$`4XxaByH@^Zijkcj_Af=Hx)g6DOd
z&XX}DqOsyEgYOY6V+rDKz=x4if#chSID1)v(;1A;PoIGgK|1ev&=)~E3lUC`&NGA)
zoQ>28obG2{K%&0>@%%kBU=sIg8JNC--04h%b##&PVL04!)Rm*f_Xjo-xw-Qi>uT+5
za0`g9C;3yRPs^TS_xkZ61Yargr<9f~oH~1o9cLeZRRz9Zc=M;M^9HBPyV){)ZbdNY
zt-GgoogEDP!Tc%Vfd8f-0>Qe9;M6)_WuQJ-Umco?IOwK|VBNGe)2G<$D*V1`#AnOn
zdm~mi7`%|Vh>ZWOi=0?jP{8J`PjB6_b;s77TU)kvZnbaA+%|iga~t1Qylus{@@<XV
ynzn7)R`XobbDN&CZqMAFy?yp}=XSmw4a>3a0lKzWx6a;Lz7^;{p8t<D@P7aasDV=e

literal 0
HcmV?d00001

diff --git a/src/wechat_decrypt_tool/routers/system.py b/src/wechat_decrypt_tool/routers/system.py
index eabd9bd..10aca8e 100644
--- a/src/wechat_decrypt_tool/routers/system.py
+++ b/src/wechat_decrypt_tool/routers/system.py
@@ -1,7 +1,9 @@
-from fastapi import APIRouter
+from fastapi import APIRouter, HTTPException
 from pydantic import BaseModel
 import asyncio
 from concurrent.futures import ThreadPoolExecutor
+from ..img_helper import IMG_HELPER
+from .wechat_detection import check_wechat_status
 
 router = APIRouter()
 
@@ -32,4 +34,35 @@ async def pick_directory(title: str = "请选择目录", initial_dir: str = ""):
         # 在子线程中执行 GUI 操作
         folder_path = await loop.run_in_executor(pool, _open_folder_dialog, title, initial_dir)
 
-    return {"path": folder_path}
\ No newline at end of file
+    return {"path": folder_path}
+
+
+@router.get("/api/system/img_helper/status", summary="获取大图下载辅助插件状态")
+async def get_img_helper_status():
+    return {
+        "enabled": IMG_HELPER.is_enabled
+    }
+
+
+class ImgHelperToggleRequest(BaseModel):
+    enabled: bool
+
+
+@router.post("/api/system/img_helper/toggle", summary="开启/关闭大图下载辅助插件")
+async def toggle_img_helper(req: ImgHelperToggleRequest):
+    if not req.enabled:
+        IMG_HELPER.disable()
+        return {"status": "success", "enabled": False}
+    
+    # Attempt to enable
+    status_res = await check_wechat_status()
+    wx_status = status_res.get("wx_status", {})
+    if not wx_status.get("is_running") or not wx_status.get("pid"):
+        raise HTTPException(status_code=400, detail="未检测到微信正在运行，请先打开微信再尝试！")
+    
+    pid = wx_status["pid"]
+    ok, err = IMG_HELPER.enable(pid)
+    if not ok:
+        raise HTTPException(status_code=500, detail=f"开启失败: {err}")
+    
+    return {"status": "success", "enabled": True}
\ No newline at end of file