一、 核心功能與權限 (Mac 必讀)
本軟體專為配合「引得市」網站使用，能自動開啟 PDF 並跳轉至指定頁碼。
由於 Mac 系統安全性較高，首次使用時請務必配合授權：

1. 自動化權限：
   當您第一次點擊開書時，系統會詢問是否允許控制 "Skim"，請點選【好 (OK)】。
   若不小心點錯，請至「系統設定 > 隱私權與安全性 > 自動化」中，將本軟體下方的 Skim 勾選即可。

2. 推薦閱讀器：
   強烈建議使用 "Skim" 閱讀器，因為 Mac 內建的預覽程式不支援外部指令翻頁。
   安裝後，請點選本軟體上方的「設定 Skim (Mac)」按鈕來指定程式路徑。å

二、 路徑與資料庫 (重要！)
若您發現開書時顯示「檔案不存在 ./PDF/…」，代表您的資料庫是舊的。
請務必執行以下步驟：

1. 點選右側「🔥 清空」按鈕。
2. 點選「📂 匯入 RMP」重新載入資料。
   程式會自動將路徑轉換為正確的絕對路徑 (如 /Volumes/…)。

三、 常見問題排除
Q1：點擊網頁上的「開卷」按鈕後，軟體沒反應？
A1：請確認軟體是否處於開啟狀態。若剛更新軟體，請嘗試重新開機或執行強制註冊指令。

Q2：軟體有收到指令，但 PDF 沒有打開？
A2：請確認該書籍的檔案路徑是否正確（應為 /Volumes/… 開頭）。

做為「引得市」的創辦人，處理大量古文字圖版與數位摹本是我的日常。為了提升工作效率，這週花了一個下午的時間，從構思到實作，開發了這款「新開卷助理」。以下是關於這款工具的開發歷程、技術細節與使用說明。

1. 從無到有的開發歷程：為何捨棄「剪貼簿」？

開發「新開卷助理」的契機，來自於對舊版工具的深刻反思。原先的助理是透過「監聽剪貼簿」來運作，意即當我複製特定內容時，程式便會捕捉並執行後續動作。

針對這種「複製即讀取」的技術，在實際應用上有著顯著的優缺點：

• 優點： 進入門檻極低，使用者無須學習新介面，利用最熟悉的 Ctrl+C 即可觸發功能，直覺且快速。

• 缺點： 它霸佔了系統的剪貼簿通道。在多工處理時，我常面臨「真假複製」的衝突——當我只是想單純複製一段文字到筆記，卻意外觸發了助理的自動化流程。這種對日常操作的干擾，成為了必須解決的痛點。

為了還給使用者一個乾淨的剪貼簿空間，新版開發轉向了全自動化的滑鼠鍵盤模擬。這個過程中最核心的挑戰在於「模擬人類的直覺」。電腦不懂什麼是「順手」，所有的動作（點擊、移動、輸入）都必須量化為座標與邏輯判斷。

在短短數小時內，最大的困難在於處理「例外狀況」—例如檔案讀取延遲或視窗未即時彈出，這會導致程式空轉或報錯。解決方案是引入動態偵測機制（Wait-until），讓程式學會「等待」直到目標出現才繼續執行，這才讓整個流程順暢運行。

2. 跨平台支援：PC 與 Mac 的差異

本工具基於 Python 環境開發，旨在同時支援 Windows 與 macOS 雙系統，但兩者在權限管理上有顯著差異：

Windows (PC)： 相對直觀，通常只需以系統管理員身分執行即可順利運作。唯一的痛點在於檔案路徑的分隔符號處理。

macOS (Mac)： 蘋果系統對安全性要求極高。在執行自動化控制時，系統會跳出「安全性與隱私權」的警示，使用者必須手動在「輔助使用」權限中核准終端機或程式的控制權，否則程式會因權限不足而無法點擊或輸入。此外，Mac 的 Cmd 鍵與 Windows 的 Ctrl 鍵差異，也在程式碼中做了相應的適配。

3. 操作上的必要叮嚀

為了讓「新開卷助理」穩定工作，請務必遵守以下鐵律：

不可關閉黑色視窗： 程式執行時會伴隨一個終端機視窗（黑底白字），那是它的「大腦」。一旦關閉，所有自動化程序會瞬間終止。

保持視窗最上層： 在執行過程中，盡量不要隨意切換或是將目標視窗最小化，以免程式抓不到座標而點擊到錯誤的位置。

環境單純化： 建議執行前關閉不必要的背景應用程式，釋放記憶體，確保執行速度不受干擾。

4. 技術特性與資訊安全

本工具採用的是「本地端自動化腳本」技術。

特殊性： 它不像傳統軟體需要安裝龐大的安裝包，而是輕量級的腳本執行。它直接調用系統底層的 API 來模擬鍵盤與滑鼠動作。

資安影響： 對於注重學術資料保密的使用者來說，這是最安全的選擇。因為所有運算與操作完全在您的本機電腦上完成，沒有任何數據會上傳至雲端伺服器，完全杜絕了資料外洩的風險，請安心使用。

5. 未來改善空間

目前的版本雖然解決了當下的燃眉之急，但在技術架構與功能擴充上，還有許多可以精進的地方：

參數設定外部化： 目前滑鼠點擊的座標與等待秒數多半寫死在程式碼中。未來應將這些變數抽離成獨立的設定檔（config.ini），讓使用者換了不同解析度的螢幕或電腦時，不必修改程式碼，只需調整設定檔即可適配。

科技始終來自於對效率的渴望，希望這款小工具能成為整理文獻路上的得力助手。