NyaZygisk WebUI 使用說明：每個功能是做什麼的、怎麼用

頂部：版本與重新整理#

標題下方的小字是 NyaZygisk 版本 · Root 方案與版本，例如 v2.5 · KernelSU …。右上角的圓形箭頭是重新整理，會重新讀取所有狀態並重新載入應用清單，成功後底部會彈出「已重新整理」。

狀態卡片：Zygisk 現在到底有沒有在運作#

最上面的大卡片用顏色和圖示直接告訴你結論，下面列出三個組件的狀態：

每個組件的狀態字樣分兩類：

• 正常（綠）：運行中、已注入、追蹤中
• 異常（紅）：已停止、已退出、已崩潰、未注入
• 其他（灰）：未知

大卡片的總結按下面的規則決定，這是前端 overallTone 的邏輯：

裝置與環境#

這張卡片列出：

• Root 方案：偵測 APatch / FolkPatch / KernelSU / Magisk，能取得版本時一併顯示。做法是檢查 apd、fpd、magiskd 進程與 /data/adb/ksu 目錄，SukiSU 這類會顯示為 KernelSU 或 SukiSU。
• 系統：只有偵測到廠商 ROM 才會出現。目前認得 ColorOS / OxygenOS、HyperOS、MIUI、One UI，版本取自各家的系統屬性。AOSP 類系統這格會隱藏。
• 內核、Android SDK、ABI：直接讀自守護進程回報的資料。

回報問題時，把這張卡片截圖附上最省事，維護者不用再追問你的環境。

已啟用模組#

列出目前啟用中、並且是 Zygisk 或 ZN 模組的項目，右上角的數字是總數。每個模組顯示名稱、版本、說明、作者，以及標籤：

• Zygisk：走 Magisk Zygisk API 的模組（例如 LSPosed 這一類）
• ZN：走 Zygisk Next API 的模組。若它的注入目標不是 zygote，會多顯示一行「目標：xxx」
• Companion：這個模組有使用 companion 進程

清單的來源是兩份資料合併：

1. 掃描 /data/adb/modules/*，跳過有 disable 或 remove 標記的目錄，只保留含有 zygisk/<abi>.so 或 zn_modules.txt 的模組，並讀它的 module.prop。
2. 守護進程回報的模組清單，補上類型（Zygisk / ZN）、目標和 companion 資訊。

所以如果某個模組沒出現在這裡，先檢查它是不是被停用了，或者它根本不是 Zygisk 模組（沒有 zygisk/ 目錄也沒有 zn_modules.txt）。反過來，剛啟用還沒重開機的模組，可能已經在清單裡但還沒真正載入，要以重開機後的狀態為準。

設定#

匿名記憶體（Anonymous memory）——「特化後隱藏模組的記憶體映射」，預設關閉。

打開後，App 進程完成特化（specialize）之後，NyaZygisk 會把 /proc/self/maps 裡由模組產生的映射（路徑名含 jit-cache-zygisk、zygisk-module、zn-module 的私有映射）改成匿名映射，同時把 rwx 的映射去掉寫入權限。目的是讓偵測 App 掃描 maps 時，看不到這些帶有模組特徵的名字。

• 適合：你的 App 會掃 maps 找 Zygisk 痕跡，且你已經確認需要這個功能。
• 不適合：沒有這種需求的情況不用開。它會改動進程的記憶體屬性，如果某個模組在開啟後行為異常，先關掉它確認是不是原因。
• 開關改動後即寫入設定，對之後啟動的 App 進程生效，已經在跑的 App 要重新啟動。

語言（Language）——EN / 繁中 / 简中，切換後立刻生效，選擇記在 WebUI 自己的本機儲存裡，不影響模組本身。

怎麼用#

1. 切到底部的應用排除分頁（分頁標籤上的數字是目前已排除的 App 數量）。
2. 在列表裡找到目標 App：
   • 搜尋框支援依名稱或套件名搜尋；
   • 上方有「全部 N / 已排除 N」兩個篩選，可以只看已排除的。
3. 打開該 App 右側的開關。每次切換都會立刻儲存，並彈出「已儲存」。
4. 重新啟動那個 App（建議從最近任務裡徹底滑掉再開）。排除只在 App 下次啟動時生效，已經在跑的進程不受影響。尚未生效的項目旁邊會顯示「待重啟」標籤。

列表中已排除的項目會排在最前面，其餘依名稱排序。切換時列的位置不會跳走，所以連續勾選多個不會點錯。

「同時卸載模組掛載」#

分頁上方的這個開關（Unmount for excluded apps），預設開啟。

• 開：被排除的 App 除了不載入模組之外，還會像 DenyList 一樣，把 Root 與模組的掛載從它的 mount namespace 裡卸掉。
• 關：只是不載入模組，掛載痕跡不處理。

也就是說，開著這個開關時，勾選一個 App 的效果等於「既不讓模組進去，又讓它看不到掛載」。如果你本來就用 Root 管理器的「卸載模組」功能（APatch / KernelSU）或 Magisk 的 DenyList 處理過這個 App，這個開關和它們是並行的，不衝突。

它的限制#

介面頂部的提示已經寫了，這裡再展開：

• 只列出使用者安裝的 App（pm list packages -3）。系統 App 不會出現，也不能排除，這是刻意的：system_server 和系統 UID 永遠不受影響，避免把系統搞壞。
• 共用 UID 的 App 會一起切換。 如果多個套件共用同一個 UID，排除其中一個等於排除全部，列表裡會標出「與另外 N 個套件共用 UID，會一起切換」。
• 與系統套件共用 UID 的 App 無法排除。 這類項目開關是灰的，並註明「與系統套件共用 UID，無法排除」。原因是守護進程只有在同一 UID 下所有套件都在排除清單裡才會排除，而系統套件不允許被列進去。
• 已解除安裝的套件會被自動清掉，不會留下看不見的殘留項目。
• 顯示 App 名稱需要管理器提供套件資訊介面（KernelSU 系的 WebUI 有）；沒有時只顯示套件名，功能不受影響。