> For AI agents: the complete documentation index is available at https://www.notionhub.app/llms.txt, the full documentation bundle is available at https://www.notionhub.app/llms-full.txt.

# 滴答清单同步到 Notion

NotionHub 可以把滴答清单中的任务、番茄专注、习惯打卡和倒数日整理到 Notion。你可以只同步需要的模块，在模板中按清单、标签和日期查看记录。

## 可以同步什么

| 模块  | 在 Notion 中查看                            |
| --- | --------------------------------------- |
| 任务  | 未完成及已完成任务、清单、标签、状态、起止时间、完成时间，以及可读取的任务笔记 |
| 番茄  | 专注开始与结束时间、笔记，以及可匹配的任务关联                 |
| 习惯  | 习惯名称、目标、单位，以及打卡日期、完成值和完成时间              |
| 倒数日 | 名称、原始日期和按支持的重复规则计算的下一次日期                |

同步范围取决于当前账号可读取的数据和你选择的模块。它不等同于完整备份滴答清单的全部设置、提醒或附件。

## 使用前准备

- 安装最新版 [NotionHub 浏览器插件](https://www.notionhub.app/docs/install.md)，并登录 NotionHub。
- 确认能在安装插件的同一个浏览器中登录 [滴答清单网页版](https://dida365.com/signin)。
- 准备自己的 Notion 工作区，使用插件提供的滴答清单模板。
- 按插件提示连接 GitHub，用于执行同步，参见 [GitHub Action 同步](https://www.notionhub.app/docs/github-action.md)。
- 确认服务有可用的体验次数或已激活，具体以插件显示为准，参见 [免费体验与激活](https://www.notionhub.app/docs/free-trial.md)。

当前入口连接的是滴答清单国内站账号。请不要把国际版 TickTick 的网页登录状态当作滴答清单登录状态。

## 第一步：复制并授权 Notion 模板

1. 打开插件，在服务列表中选择「滴答清单」。
2. 在「Notion 模板」卡片点击「去复制」。
3. 在授权页面选择开发者提供的模板，确认目标工作区并允许访问。
4. 返回插件，等待模板显示已配置。如果提示提交模板链接，打开自己工作区中的模板，复制页面链接后提交。

请保留所选模块对应的数据库、字段类型和关系。即使只同步番茄，也需要保留任务库及相关日期结构；习惯模块需要同时保留习惯和打卡记录。不要用空白页面代替模板。详见 [Notion 模板与授权](https://www.notionhub.app/docs/notion-template.md)。

## 第二步：连接滴答清单账号

1. 在滴答清单账号卡片点击「去登录」。
2. 如浏览器请求访问滴答清单网站，允许该权限。
3. 在打开的滴答清单官网中完成登录，确认能看到自己的任务。
4. 返回插件，等待账号卡片显示账号信息和「已登录」。未识别成功时，在网页确认登录完成后再重试。

插件读取并保存浏览器中的 Cookie 登录状态，无需手动复制 Cookie，也不是在插件中填写滴答账号密码。只在手机 App 中登录不能完成这一步。切换账号后，请返回插件重新连接并核对账号名称。

## 第三步：选择同步内容

打开「同步设置」，在「同步内容」中选择「任务」「番茄」「习惯」「倒数日」，至少保留一项。执行顺序由服务自动安排。

希望在番茄记录中看到对应任务时，建议同时选择「任务」和「番茄」。番茄只会关联已经写入任务库且能匹配到的任务，不是每条专注记录都有任务关联。

热力图颜色等选项按需调整。首次使用可保持其余默认设置，先确认所选模块的数据能够写入。

## 第四步：开始同步并查看结果

完成模板与账号连接后，点击「开始同步」。如提示连接 GitHub 或配置服务权益，按提示完成后继续。

在插件运行记录或对应的 GitHub Action 中查看进度。任务结束后，打开 Notion 模板中的任务、番茄、习惯打卡或倒数日视图核对结果。运行尚未结束时，避免重复发起同步。自动同步的条件与状态见 [同步设置](https://www.notionhub.app/docs/sync-settings.md)。

普通同步会读取所选模块的可用数据，依据记录标识、修改时间或内容判断是否新增、更新；并不只是导入当天记录。任务包含可读取的已完成历史，番茄会向前读取可用历史分页。

习惯打卡的普通同步以 **2024-03-20** 为查询起点。要尝试补齐更早记录，或重新检查已有数据，可在权益允许时点击「全量同步」，再确认「开始全量同步」。全量会重新检查所选模块，并扩大习惯历史查询范围；仍只能导入滴答当前返回的数据。本次任务结束后恢复普通同步。

## 在 Notion 中编辑时要注意什么

已激活服务的同步包含部分回写能力，免费体验不执行回写：

- **新任务**：在模板任务库中新建、尚无滴答记录标识的任务，可以创建到滴答清单；有可识别的清单关联时使用该清单，否则使用收集箱。修改已有任务不等于能把所有字段回写滴答。
- **习惯打卡**：关联到已同步习惯、填写了日期和值的新记录，可以参与回写。同一习惯同一天的多条记录会被合并处理，重复的 Notion 新建记录可能被清理，不适合用多行保存该日的逐次打卡明细。
- **任务笔记**：同步生成的笔记提示块会在后续任务更新时替换。自己的补充内容请放在提示块之外。

请保留记录标识，不要清空它来强制刷新数据，否则已有记录可能被当作新建记录处理。番茄和倒数日不提供对应的反向编辑能力。

## 常见问题

### 已在滴答登录，插件为什么仍提示登录失败？

确认登录的是同一浏览器中的滴答清单国内站，并允许插件访问该网站。刷新网页，确认任务列表能正常加载，再回到插件重试。登录失效时，先在官网重新登录，再点击账号卡片的「重新登录」。

### 为什么缺少某个模块，或只同步了部分数据？

先检查「同步内容」是否选中该模块、模板是否保留对应数据库，以及本次运行是否成功。免费体验还会限制各模块的同步条数。习惯的早期记录需结合上述日期范围检查，不能只通过再次普通同步补齐。

### 番茄记录为什么没有关联任务？

专注记录可能没有绑定任务，或对应任务尚未同步到 Notion。同时选择任务模块后再同步；如果该任务已不可读取，仍可能无法补上关联。

### 倒数日的日期为什么与预期不同？

模板分别保存原始日期和下一次发生日期，后者会随同步更新。公历重复和农历按年重复可按支持的规则计算；未支持的农历重复规则会保留原始日期，请对特殊规则核对滴答中的原记录。

### 全量同步会恢复所有删除过的数据吗？

不会。全量重新检查的是当前可读取的数据，不能找回滴答已不再提供的历史。它也不是清空模板后重建；习惯回写中的同日重复记录整理仍可能发生。

仍有问题时，查看 [运行状态与排错](https://www.notionhub.app/docs/sync-status.md) 或联系 [技术支持](https://www.notionhub.app/docs/support.md)。