使用說明
Zupu 使用說明
從安裝、保護家族資料到操作家族樹——所需的一切都在這裡。
安裝
從下載頁取得對應平台的安裝程式。需求：macOS 12 以上（Apple Silicon）或 Windows 10 以上（x64）。
安裝程式目前未簽章，首次啟動時作業系統會出現警告：
- macOS：若 Gatekeeper 封鎖應用程式，請在「應用程式」中的 Zupu.app 上按右鍵（或 Control+點按）並選擇打開，然後確認。只需要做一次。
- Windows：若 SmartScreen 顯示「Windows 已保護你的電腦」，請點選其他資訊 → 仍要執行。
首次啟動
首次啟動時，應用程式會詢問家族名稱與選填的側邊欄圖示（一個 emoji 或單一字元）。之後隨時可以點擊側邊欄頂端的家族名稱修改。
工作區
側邊欄可在四個檢視間切換：
- 族譜總覽——互動式家族樹加上所選成員的詳細資料面板，是主要的工作畫面。
- 族員名錄——資料庫中所有成員的可篩選名冊，無論是否已連結到家族樹。
- 補助管理——所有補助記錄，含總額與狀態篩選。
- 操作紀錄——應用程式內每一筆變更的時間軸。
在任何畫面按 ⌘K（macOS）或 Ctrl K（Windows）即可搜尋成員與補助。
資料儲存位置
所有資料都儲存在本機，位於名為 family.db 的單一
SQLite 資料庫，不會上傳到任何地方。
- macOS：
~/Library/Application Support/com.mason.family-manager/family.db - Windows：
C:\Users\<你>\AppData\Roaming\com.mason.family-manager\family.db
資料庫以 WAL 模式運作，因此旁邊可能還會有 family.db-wal 與
family.db-shm。若要手動複製資料庫，請在應用程式關閉時一併複製三個檔案——或直接使用下方的
JSON 匯出，這是官方支援的備份方式。
備份與還原
在側邊欄底部，匯出會將整個資料庫——成員、親屬關係、婚姻、補助、自訂欄位、應用程式設定與完整操作紀錄——寫入名為
zupu-YYYY-MM-DD.json 的 JSON 檔。
搬移到新電腦：在舊電腦匯出，在新電腦安裝 Zupu 後匯入該 JSON 檔。操作紀錄會隨備份一併帶走；只有舊版本建立的備份不含操作紀錄。
建立家族樹
- 新增人員會開啟精靈，一次設定父母、配偶、補助與自訂欄位（世代／排行／房支）。
- 親子連結會檢查重複與祖先循環；婚姻會檢查重複。無效輸入會被拒絕並顯示訊息，不會寫入。
- 點擊任一節點即可選取該成員，並在右側面板載入詳細資料。點擊空白畫布可取消選取。
- 右下角的控制項可縮放、置中所選成員、或讓整棵樹符合視窗。縮放最小停在 50%——樹非常大時，畫面會改為置中所選成員而非把文字縮到難以閱讀，再由此平移瀏覽。
- 未連結到目前家族樹的成員會出現在左上角的未連結標籤；點擊即可檢視該成員的樹。
- 在詳細資料面板可將某成員的後代名單匯出為 CSV 或可列印的 PDF。
補助
補助記錄屬於單一成員，包含類型、整數金額（NT$）、選填日期與狀態——待審核、已核准或已拒絕。補助管理檢視會顯示總額並可依狀態篩選；待審數量會以徽章顯示在側邊欄。
操作紀錄
每一次新增、編輯、刪除、匯入與匯出都會記錄時間戳記、摘要與欄位層級的修改前後值。此檢視一次載入 200 筆——使用載入更早的紀錄往前翻頁。匯出稽核報告永遠涵蓋符合目前篩選的完整歷史，與已載入頁數無關。
限制與常見問題
資料會同步或上傳嗎？
不會。Zupu 採本機優先：一台機器、一個資料庫。若多位家族成員共同維護記錄，建議指定一台編輯用電腦，並以 JSON 匯出檔分享唯讀副本。
刪除可以復原嗎？
可以。刪除成員會在確認後一併移除其親屬關係、婚姻與補助記錄，但成功提示會提供「復原」，可還原該成員與相關記錄。仍建議定期匯出 JSON 備份。
可以匯入其他軟體的 GEDCOM 檔案嗎？
還不行——JSON 備份是目前唯一的交換格式，GEDCOM 支援已列入規劃。
應用程式與這個網站提供哪些語言？
本網站提供英文與繁體中文，可隨時使用導覽列的語言按鈕切換。應用程式介面目前為繁體中文；應用程式本身的多語系仍在規劃中。
我發現了一個錯誤。
請來信 clan@masonhuang.com，附上重現步驟與應用程式版本（顯示於安裝檔名稱中）。