关联 Todoist 和 Linear：把真实任务带进专注空间

关联 Todoist 或 Linear 以后，你真实的任务会出现在组件世界里：专注的时候不用来回切换，勾掉一件就在原来的应用里同步完成，想到新任务也能直接加进去。它只是「关联」：不能用 Todoist / Linear 登录或注册，登录方式不变。

关联 Todoist

1. 登录后打开「设置 → 连接」，在 Todoist 卡片里点「连接 Todoist」。
2. 在 Todoist 的授权页确认。组件世界申请读取、完成和添加任务的权限（data:read_write），这样才能在这里勾掉和添加任务。
3. 回到组件世界后，卡片上会显示你的名字和关联日期。

授权链接 10 分钟内有效，必须在发起连接的同一个浏览器、同一个组件世界账号里完成。一个 Todoist 账号只能关联一个组件世界账号；想换账号点「更换」。

以前用「只读连接」关联的，卡片上会提示「重新连接，开启完整权限」，点一下重新授权就能勾掉和添加任务。

关联 Linear（个人 API Key）

Linear 用你自己的个人 API Key 连接，不需要跳转授权：

1. 打开 Linear 的 Security & access 页面（Settings → Security & access；设置卡片里也有「打开 Linear」按钮）。
2. 在「Personal API keys」点「New API key」，起个名字（比如 WidgetStore），权限保持 Full access。
3. 复制生成的 Key（以 lin_api_ 开头），回到「设置 → 连接」的 Linear 卡片，粘贴后点「验证并连接」。

组件世界会先用这个 Key 向 Linear 确认是你本人，验证通过才加密保存；之后卡片上只显示最后 4 位（例如「API Key ••••a1b2」），Key 本身不会再出现在任何页面上。

• 想换 Key：点「更换 Key」，粘贴新的即可。
• 如果你在 Linear 里删除了这个 Key，卡片和专注空间会显示「Key 已失效」，粘贴一个新的就恢复。
• Linear 的任务列表最多缓存 90 秒；在 Linear 里刚改过的，点专注空间里的「刷新」就能看到。

显示哪些任务

• Todoist：默认显示今天 + 已逾期。可以改成「只看今天」、某个项目，或任意 Todoist 筛选语句（例如 today | overdue | #Work）。
• Linear：默认显示分配给你的、状态是 Todo 和 In Progress 的 Issue。可以多选状态（Triage / Backlog / Todo / In Progress）、只看某个团队、只看当前周期。

都在「设置 → 连接」对应的卡片里改，立刻生效。

关联后能做什么

地方	说明
专注空间 待办	在你自己的待办下面多一段「来自 Todoist / Linear」：优先级、预计用时、到期日；勾选 = 在原应用完成（Linear 移到团队的第一个「完成」状态），几秒内可以撤销；▶「专注做这件事」直接开始一轮专注；「今天一览」和「排一下今天」（规则或 AI）会把它们一起算进去
添加任务	专注空间、起始页待办格子、扩展弹窗的输入框左边有「添加到」按钮，点一下在「我的待办 → Todoist → Linear」之间切换。Todoist 的新任务默认排在今天（选了项目就加到那个项目），Linear 的新 Issue 建在你选的团队（没选就是第一个）、分配给你、状态是 Todo
把专注时间记到任务上	默认关闭。打开后，对某个任务专注完成时，会在任务上加一条评论，例如「⏱ 在组件世界专注了 25 分钟」；换一台设备、在浏览器扩展里计时或让 AI 记录的专注也会写（联动），可以撤销
起始页 待办格子	今天要做的任务跟在你的待办后面，也能直接勾掉
浏览器扩展 弹窗	「下一件」下面显示前 3 件，也能勾掉和添加（需要网站也处于登录状态）
组件	「Todoist 今日任务」「Linear 我的 Issue」「任务完成进度」，可以放进 Notion、个人主页、起始页（见下面的隐私说明）
AI（MCP）	你连接的 Claude / ChatGPT 等可以用 list_my_tasks 读你的任务，用 complete_task 帮你完成、add_task 帮你添加（需要「Todoist / Linear 任务」权限，完成可以撤销）
同步到「我的数据」	默认关闭。打开后每天把完成的任务数量（不含标题）写进一张只读的「完成的任务」表，可以做 Notion 图表、热力图

重复任务在 Todoist 里「完成」会排到下一次，所以不能撤销。

隐私：公开的组件只读、默认只显示数量

组件放在 Notion、个人主页上时，任何拿到链接的人都能看到，而任务标题常常是私事，所以：

• 任务组件默认只显示数量（今天要做、已逾期、今天完成、最近 7 天）。
• 想在组件里显示任务标题，要两个开关都打开：设置里的「允许在公开组件里显示任务标题」+ 组件编辑器里的「显示任务标题」。只开一个都不会显示。「任务完成进度」永远只有数量。
• 组件不能勾掉任务：嵌在 Notion 等第三方页面里时，没法确认看组件的人就是你，任何能看到组件的人都能点。组件右上角的「去勾掉」会打开专注空间，你登录后在那里勾掉。
• 在专注空间、起始页、扩展弹窗里，任务只在你自己登录时显示。
• 我们只做 90 秒到 5 分钟的短缓存，不长期保存任务内容；Todoist 的授权令牌和 Linear 的 API Key 都加密保存，只在我们的服务器上使用。详细说明见 隐私政策。

授权失效与断开

• Todoist 的授权会自动续期。如果你在 Todoist 里撤销了授权，设置和专注空间里会显示「需要重新连接」，点「重新连接」即可。
• 「断开」Todoist 会撤销组件世界的授权并删除关联。
• 「断开」Linear 会删除我们保存的 Key。这个 Key 还在你的 Linear 账号里，不用了可以到 Linear 的 Security & access 里删除。
• 同步到「我的数据」的「完成的任务」表会保留，可以在 我的数据 里整张删除。