Linear

連接

在 Exporter 主頁的「雲端」下，點按 Linear 旁的「連接」。使用 Apple 登入，瀏覽器會開啟 Linear 的頁面，在那裡點按「Authorize」。Exporter 只要求讀取 Linear。回到 Exporter，選擇檔案存放的位置，然後點按「使用這個資料夾」。

Linear 權杖封存在 Exporter 的伺服器上。Mac 只登入該伺服器，從不持有權杖。

選擇項目

選擇頁面列出所有議題、專案和文件，全部勾選，並有「議題」「專案」「文件」三個標籤頁。取消勾選你不需要的，它的檔案就會被移除。

檔案去哪裡

直接位於個人資料夾下的資料夾（如 ~/Documents）會在其中產生一個 linear-export 資料夾。更深的資料夾按原樣使用。

• 議題：每個團隊一個資料夾，每個議題一個以 ID 和標題命名的檔案：Northwind/NW-142 Invite flow.md
• 專案：Projects/Q4 launch.md
• 文件：Documents/<project or team>/<title>.md

檔案內容

議題的 front matter 包含 id、team、state、priority、assignee、creator、labels、project、cycle、parent、estimate、due 和日期，source_url 可在 Linear 中開啟它。接著是標題、描述和按時間由舊到新排列的每則留言。專案帶有狀態、負責人、團隊和日期，文件帶有專案、團隊和建立者。時間為 UTC。

同步

Linear 把每次修改告訴 Exporter 的伺服器。伺服器立即重寫檔案並通知 Mac，Mac 再下載，所以修改幾秒內送達，最多一分鐘。改名的議題會移動它的檔案，封存、丟棄或刪除的議題會失去它的檔案。「立即同步」會先詢問伺服器，「完全重新同步」會重寫每個檔案。

Exporter Cloud

從第一次連接起 7 天免費。之後 Exporter Cloud 是 App Store 中的訂閱：單獨的 Linear，或包含我們日後加入的所有雲端來源的 All Cloud，按月或按年。方案結束時同步停止，檔案保留。30 天後伺服器刪除副本和權杖。

帳號

「設定」›「帳號」顯示你登入所用的電子郵件。「登出」會保留連接以便下次登入。「刪除帳號…」會中斷所有工作空間，並刪除伺服器保存的一切。Mac 上的檔案保留。

命令列

exporter export --source linear --dest <folder> 會把工作空間的檔案寫入你在命令列卡片中允許的資料夾。參見命令列。

問題與排查

• 卡片顯示「重新連線…」：Linear 不再接受該連接，通常是因為 App 已在 Linear 設定中被移除。點按它再次授權。
• 卡片顯示「登入…」：工作階段已結束。用同一個 Apple 帳號登入，同步會繼續。
• 缺少議題：確認它已勾選，然後點按「立即同步」。封存的議題不會被匯出。