# Linear

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>` 會把工作空間的檔案寫入你在命令列卡片中允許的資料夾。參見[命令列](https://exporter.dev/docs/cli)。

## 問題與排查

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

## Related

- [Linear](https://exporter.dev/zh-hant/linear): 議題、專案和文件成為檔案
- [Linear 指南](https://exporter.dev/zh-hant/guides/linear): Obsidian 和 Claude Code
- [價格](https://exporter.dev/zh-hant/pricing): 免費額度、一次性解鎖與 Exporter Cloud

---

human version: https://exporter.dev/zh-hant/docs/linear
every page: https://exporter.dev/llms.txt