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