GitHub Sync 設定
第 38 章:GitHub Sync 設定
GitHub Sync 將您的 SeaMeet 工作區轉換為一個私人、有版本控制的 Markdown 樹狀結構,存放於您自己的 GitHub 儲存庫中。每次您編輯筆記、重新命名錄音或調整 wiki 頁面時,SeaMeet 都會在背景悄悄地提交變更並推送到 GitHub。在另一台筆電上開啟 SeaMeet,您的筆記會在首次啟動時拉取下來 — 中間沒有 Dropbox,迴路中也沒有 Seasalt 伺服器。儲存庫是您的,資料是您的,如果您想要的話,可以隨時直接在 github.com 上瀏覽。
模型很簡單:您的 GitHub 儲存庫就是儲存空間。SeaMeet 不執行同步服務。它在您的帳號上安裝一個小型的 GitHub App,取得每位使用者的 OAuth 權杖,並使用該權杖直接推送和拉取 Git 提交。由於儲存空間使用 GitHub 的免費方案 — 提供無限數量的私人儲存庫 — 同步實際上是免費的。並且因為每個 SeaMeet 工作區都是它自己的儲存庫,您可以讓工作和個人工作區完全分開。
章節目標
閱讀本章後,您將能夠:
- 在您的帳號或組織上安裝 SeaMeet GitHub App
- 透過 OAuth 授權 SeaMeet 並讓它為您建立一個私人同步儲存庫
- 讀取同步狀態列並了解同步狀態機中的每個狀態
- 識別 OAuth 何時在背景自動重新整理,何時需要手動重新授權
- 當同一筆記在兩台裝置上編輯過時解決同步衝突
- 調整同步設定面板(自動同步、同步間隔、啟動時同步)
- 排除最常見的失敗模式
先決條件
開始之前,請確認您具備:
- GitHub 帳號 — 免費方案就夠了;不需要 GitHub Pro
- 有效的同步權益 — 包含在 BYOK Pro 和 Sync Pro 等級中。如果您的計費等級不包含同步,「同步設定」畫面會顯示「訂閱以啟用同步」橫幅。詳情請參閱第 35 章:訂閱與計費。
- 在 SeaMeet 中開啟的工作區 — 同步附加於活動工作區,而非整個應用程式。如果您有多個工作區,每一個都是它自己的 GitHub 儲存庫。
- 正常運作的網際網路連線 — 設定流程會在您的預設瀏覽器中開啟 GitHub
每個工作區一個儲存庫。 SeaMeet 會為您連接的每個工作區建立獨立的私人儲存庫。這樣可以將工作筆記和個人筆記乾淨地隔離開來,並且您可以在不影響另一個的情況下中斷其中一個的連線。
逐步設定
首次設定大約需要 90 秒:在 GitHub 上授權 SeaMeet,讓它建立您的儲存庫,等待初始上傳,然後就完成了。
步驟 1:開啟同步設定
- 點擊設定齒輪圖示
- 在左側欄中開啟 Sync 標籤
- 您會看到 "Sync with GitHub" 標題卡片
如果您看不到 Sync 標籤,您的訂閱等級不包含同步 — 請參閱第 35 章來升級。
如果您看到一個橫幅顯示*"Back up your notes to a private GitHub repo with BYOK Pro"*,表示您是免費帳號。點擊橫幅以開啟付費牆,或在訂閱前跳過本章其餘部分。
步驟 2:點擊 "Set Up GitHub Sync"
「同步設定」空狀態會顯示三個益處區塊("Free & private"、"Effectively unlimited"、"One repo per workspace"),以及底部的主要 Set Up GitHub Sync 按鈕。