# 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 不再接受该连接，通常是因为应用已在 Linear 设置中被移除。点按它再次授权。
- 卡片显示「登录…」：会话已结束。用同一个 Apple 账户登录，同步会继续。
- 缺少议题：确认它已勾选，然后点按「立即同步」。归档的议题不会被导出。

## Related

- [Linear](https://exporter.dev/zh-hans/linear): 议题、项目和文档成为文件
- [Linear 指南](https://exporter.dev/zh-hans/guides/linear): Obsidian 和 Claude Code
- [价格](https://exporter.dev/zh-hans/pricing): 免费额度、一次性解锁和 Exporter Cloud

---

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