🎙️ Lecture 22: 【進階實戰專案】螢幕簾幕自動恢復：進程持久化與猴子補丁 (Screen Curtain Restore)

🎧 錄音室開場：保護視障隱私的最後一道防線！

• Ray：「各位大導演，歡迎來到實戰工坊的終極加碼關！今天我們要介紹的專案，解決了一個非常關鍵的『視障者隱私痛點』——『螢幕簾幕自動恢復 (Screen Curtain Restore)』！」
• 小咪：「螢幕簾幕？就是那種能把螢幕變黑，讓旁人看不到我們操作，但語音依然能正常運作的功能嗎？」
• Ray：「沒錯！但有一個很大的漏洞：當你開著簾幕時，如果因為安裝新外掛重啟 NVDA、或者系統發生錯誤重啟，這段重啟的『空白時間』，螢幕會短暫暴露出來！而且重啟完成後，簾幕不會自動恢復，隱私直接看光光！」
• Ray：「今天，我們要教大家如何透過 Vibe Coding 提示詞，指揮 AI 幫我們實現 『進程持久化標記（跨重啟記憶）』 與 『猴子補丁（Monkeypatching）』 技術，為隱私蓋上鋼鐵防護罩！」

🎯 專案五目標：螢幕簾幕自動恢復 (Screen Curtain Restore)

當使用者開啟暫時性螢幕簾幕後，如果重開 NVDA（或系統錯誤重啟），外掛會自動在重啟前記錄狀態；並在 NVDA 啟動時自動恢復簾幕，且在恢復後自動清理標記。

🧠 大導演的思維課：跨進程狀態傳遞的 Prompt 設計

當我們重啟 NVDA 時，Python 的整個虛擬機進程會被銷毀並重新建立。這意味著，所有的記憶體變數都會歸零！我們不能用簡單的 self.curtainEnabled = True 來記錄。

我們必須設計一個「跨進程持久化（存入硬碟）」的提示詞架構：

📋 步驟一：拆解你的「跨進程記憶需求」

1. 觸發時機（重啟前）：當 NVDA 準備要關閉重啟時。
   • 行話翻譯：必須接管 NVDA 核心負責關閉的 core.triggerNVDAExit 與崩潰重啟的 core.restartUnsafely 函數。由於這是核心系統，我們不能直接改程式，必須指示 AI 採用 Monkeypatching（動態修改/猴子補丁） 技術！
2. 狀態儲存：如果重啟時簾幕是開啟的，在硬碟寫入一個暫存檔。
   • 行話翻譯：在 NVDAState.ReadPaths.configDir（使用者設定路徑）下，寫入一個名為 screen_curtain_restart_active 的空檔案作為標記。
3. 啟動恢復與自我清理（重啟後）：當 NVDA 重新載入外掛時。
   • 行話翻譯：在全域外掛的 __init__ 中，檢查該檔案是否存在。若存在，立刻刪除該檔案以確保安全，並呼叫 screenCurtain.screenCurtain.enable(persist=False) 自動重新開啟簾幕。

📝 實戰演練：大導演的 Prompt 派工單

請將以下 Prompt 貼給你的 AI：

「你現在是精通 NVDA 核心生命週期與跨進程狀態設計的頂級工程師。請幫我開發一個全域外掛（GlobalPlugin），檔案名為 screen_curtain_restore.py。

1. 開發需求描述： - 重啟前攔截 (Monkeypatching)：請動態替換（接管） core.triggerNVDAExit 與 core.restartUnsafely。在這兩個函數執行前，檢查 screenCurtain.screenCurtain.enabled 是否為 True。若是，請在 globalvars.appArgs.configDir（設定目錄）下建立一個名為 screen_curtain_restart_active 的暫存標記檔案。 - 重啟後恢復與清理：在 GlobalPlugin.__init__ 中，檢查該標記檔案是否存在。如果存在： - 請立刻刪除該檔案，以防異常殘留。 - 呼叫 screenCurtain.screenCurtain.enable(persist=False) 開啟簾幕。 - 開發者 Scratchpad 相容性防護（重要）：為防止在 Scratchpad 模式下測試拋出找不到附加元件元數據的錯誤，請對 addonHandler.initTranslation() 加上 try-except 保護，防止 AddonError 導致外掛無法載入。

2. 規範限制： - 程式碼必須有非常詳細且給一般人看得懂的中文註釋，逐行解釋猴子補丁與標記檔讀寫的邏輯，讓不懂程式碼的人也能了解。

請直接輸出完整程式碼。」

🛠️ 看懂 AI 寫的代碼：逐行白話拆解

AI 產出的 screen_curtain_restore.py 結構如下，我們來讀懂這段高級魔法：

import globalPluginHandler
import addonHandler
import core
import screenCurtain
import os
import globalvars

# 1. 開發者 Scratchpad 相容性防禦
# 如果在未打包的暫存區測試，這行會拋錯，所以必須用 try-except 包裹起來保護
try:
    addonHandler.initTranslation()
except Exception:
    pass

# 定義我們在硬碟中存放「隱私便條紙」的實體路徑
RESTART_MARKER_FILE = os.path.join(globalvars.appArgs.configDir, "screen_curtain_restart_active")

# 2. 備份 NVDA 核心原本的重啟函數
original_triggerNVDAExit = core.triggerNVDAExit
original_restartUnsafely = core.restartUnsafely

# 3. 寫一個我們自己的「攔截版」重啟函數
def patched_triggerNVDAExit(newNVDA=None):
    # 如果偵測到使用者是要「重新啟動」而非關機 (newNVDA 不為 None)
    # 且當前螢幕簾幕是「開啟的」
    if newNVDA and screenCurtain.screenCurtain.enabled:
        # 在硬碟中寫下一張「隱私便條紙」（建立暫存標記檔）
        try:
            with open(RESTART_MARKER_FILE, "w") as f:
                f.write("active")
        except Exception:
            pass
    # 最後，把控制權交還給原本的重啟函數，讓 NVDA 正常重啟
    original_triggerNVDAExit(newNVDA)

# 4. 猴子補丁：用我們寫的攔截版，替換掉官方原本的函數
core.triggerNVDAExit = patched_triggerNVDAExit


class GlobalPlugin(globalPluginHandler.GlobalPlugin):

    def __init__(self):
        super().__init__()
        # 5. 重啟完成！外掛被載入，立刻去硬碟檢查有沒有「隱私便條紙」
        if os.path.exists(RESTART_MARKER_FILE):
            # 發現便條紙！為維護安全，立刻刪除檔案（撕毀便條紙），避免下次開機誤判
            try:
                os.remove(RESTART_MARKER_FILE)
            except Exception:
                pass

            # 6. 安全插隊：啟用螢幕簾幕（暫時性模式）
            screenCurtain.screenCurtain.enable(persist=False)

💡 核心代碼導讀：

• core.triggerNVDAExit = new_triggerNVDAExit：這就是 Monkeypatching（猴子補丁）。我們在程式執行時，偷偷把 NVDA 原裝的重啟按鈕換成我們自己改裝的按鈕。當使用者按下重啟，會先執行我們的標記檔寫入，隨後再執行原裝的重啟。
• os.remove(MARKER_PATH)：這叫 「檢索即刪除」。如果重啟後不立刻刪除檔案，萬一未來哪天電腦意外斷電，下次開機時 NVDA 就會誤以為是重啟而強行把螢幕關掉，造成困擾。所以必須用完就撕毀！

🔍 零基礎讀碼指南：白話拆解 screen_curtain_restore.py 原始碼

如果你是完全沒有寫過程式的新手，這段代碼展示了如何優雅地使用「保險箱標記」與「動態改裝（猴子補丁）」來解決跨重啟的記憶問題。

📦 1. 備料與安全防線 (第 5 至 18 行：import 與 try-except)

• import core：引進 NVDA 的核心控制台。
• import screenCurtain：引進負責螢幕簾幕（把螢幕變黑）的控制官。
• Scratchpad 相容性防禦：

  try:
      addonHandler.initTranslation()
  except Exception:
      pass

  這段程式碼的意思是：「嘗試啟動外掛的語言翻譯機制，但如果因為我們在開發測試區（Scratchpad）執行而失敗了，請**假裝沒事並直接跳過**（pass），不要讓整個程式當掉。」這是極為實用的代碼安全氣囊。

📝 2. 秘密便條紙的藏匿處 (第 25 行：MARKER_PATH)

• MARKER_PATH 定義了硬碟中一個名為 screen_curtain_restart_active 檔案的存放路徑（放在 NVDA 的使用者設定目錄中）。
• 當 NVDA 即將重啟時，如果檢測到簾幕是開著的，我們就會在這個路徑建立一個檔案。這就像是在重開機前，悄悄在硬碟裡藏一張「重啟前簾幕是開著的！」秘密便條紙。

🐒 3. 貍貓換太子：接管核心重啟函數 (第 27 至 61 行)

這是著名的 猴子補丁 (Monkeypatching) 技術，像是給原廠車改裝零件：

• 備份原廠零件：我們把原本負責關機/重啟的 core.triggerNVDAExit 先存到 original_triggerNVDAExit" 變數裡。
• 改裝自訂按鈕 (new_triggerNVDAExit)：
  1. 當重啟指令被觸發且是「重新啟動」時，檢查簾幕是否開著 (screenCurtain.screenCurtain.enabled)。
  2. 如果開著，在硬碟寫入便條紙（記錄值為 "1"）。
  3. 最後呼叫原廠按鈕 original_triggerNVDAExit(newNVDA)，完成正常的重啟流程。
• 同理改裝不安全重啟 (new_restartUnsafely)：應對 NVDA 崩潰重啟的情況，同樣在崩潰前寫入便條紙。
• 裝回車上：core.triggerNVDAExit = new_triggerNVDAExit。用我們改裝好的新按鈕，覆蓋掉 NVDA 內建的按鈕。

🧹 4. 重開機後的自動記憶恢復與銷毀 (第 64 至 89 行：GlobalPlugin)

當 NVDA 重新啟動，會初始化我們的外掛類別 GlobalPlugin：

• 檢查便條紙：一開機，程式立刻去 MARKER_PATH 看看那張秘密便條紙在不在 (os.path.exists)。
• 用完即銷毀：如果便條紙在，代表重啟前簾幕是開著的。我們立刻**刪除這個檔案** (os.remove)！這是為了防止下一次正常關機後，重新開機時被誤判開啟。
• 自動遮蔽螢幕：最後，呼叫 screenCurtain.screenCurtain.enable(persist=False) 把螢幕變黑。設定 persist=False 表示這只是「暫時性的遮蔽」，不會把這個狀態寫入使用者的永久設定中。

🧪 測試與驗收

1. 將檔案存為 screen_curtain_restore.py 放入 globalPlugins。
2. 啟動螢幕簾幕。接著按下 NVDA+Q 開啟重啟對話框，選擇「重新啟動」。
3. NVDA 重啟後，檢查螢幕是否立刻自動變黑，隱私防護罩完美運作。大功告成！

👉 回課程大綱：學習地圖