> 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.

# Forest 同步到 Notion

NotionHub 可以将 Forest 的种树专注记录整理到 Notion，按分类、树种和日期查看专注情况。

当前使用前需要先核对服务器地区：登录页提供「中国服务器」和「国际服务器」，但现有专注记录同步仍面向中国服务器。国际服务器账号能够登录，不代表已经支持完整同步；国际区用户请先联系 [技术支持](https://www.notionhub.app/docs/support.md) 确认适用情况。

## 可以同步什么

| 内容    | 在 Notion 中查看                 |
| ----- | ---------------------------- |
| 专注记录  | 开始与结束时间；有备注时以备注作为标题，否则使用分类名称 |
| 分类    | Forest 标签对应的分类，以及专注记录与分类的关联  |
| 树种    | 专注记录中涉及的树种、可用图标和对应关系         |
| 日期与统计 | 模板中的日期关系，以及基于已同步专注记录生成的热力图   |

同步以账号中可读取的种树记录为准，不包含金币、商店购买记录、好友榜单或完整树种商店备份。树种图标是否完整取决于可用素材。

## 使用前准备

- 安装最新版 [NotionHub 浏览器插件](https://www.notionhub.app/docs/install.md)，并登录 NotionHub。
- 准备 Forest App 使用的邮箱和密码，确认账号所属服务器。
- 先在 Forest App 中确认目标专注记录已保存并完成账号同步；仅保留在设备上的记录可能无法读取。
- 使用插件提供的 Forest Notion 模板，并允许 NotionHub 访问。
- 按提示连接 GitHub，并确认有可用体验次数或已激活服务，详见 [GitHub Action 同步](https://www.notionhub.app/docs/github-action.md) 和 [免费体验与激活](https://www.notionhub.app/docs/free-trial.md)。

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

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

请保留记录、分类、树种及日期相关数据库的字段和关系。可以调整视图，但不要随意修改同步用的字段类型或删除记录标识。详见 [Notion 模板与授权](https://www.notionhub.app/docs/notion-template.md)。

## 第二步：登录 Forest

1. 在 Forest 账号卡片点击「去登录」。
2. 在登录页选择账号所属的「中国服务器」或「国际服务器」。
3. 输入 Forest 账号的邮箱和密码，点击「登录」。
4. 返回服务页，确认账号卡片显示「已登录」。

服务器应与账号实际地区一致，不是按当前所在地或浏览器语言选择。选择中国服务器不能把国际区数据迁移过来。国际区同步还受本文开头所述限制。

当前登录表单使用邮箱和密码，没有扫码或读取浏览器 Cookie 的步骤。若平时使用第三方登录，请先在 Forest 官方账号设置中确认能否使用邮箱和密码登录。

## 第三步：检查设置与日期范围

打开「同步设置」，按需调整热力图颜色等选项。Forest 当前没有按「任务／习惯」划分的同步模块，也没有供用户选择任意起止日期的同步选项。

首次同步在模板没有记录时，会尝试读取账号中可获取的历史专注记录。免费体验只写入额度内的记录，数量以插件显示为准。

后续普通同步以 Notion 中已有记录的最新开始时间为分界，只新增更晚开始的记录。因此，在 Forest 中补录早期数据、修改旧备注或分类后，普通同步可能不会更新这些旧记录。

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

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

在插件运行记录或对应的 GitHub Action 中查看进度。运行完成后打开 Notion 模板，检查专注记录的时间、分类与树种关联。任务仍在运行时，避免重复启动。自动同步的条件与状态见 [同步设置](https://www.notionhub.app/docs/sync-settings.md)。

需要补齐早期记录或更新已有记录时，在权益允许的情况下点击「全量同步」，再确认「开始全量同步」。全量会重新检查当前可获取的历史，并根据 Forest 记录标识更新已有页面或新增缺失页面；不会通过清空模板来重建数据。本次任务结束后恢复普通同步。

全量仍受服务器地区、平台返回范围和账号状态限制，不能从手机本地恢复尚未同步到账号的数据。

## 在 Notion 中新建专注记录

已激活服务的同步还会检查模板中尚无 Forest 记录标识的新记录，尝试写回 Forest；免费体验不执行这一步。

如果要使用回写，请填写时间范围，并通过模板关联选择已有的树种和分类，让模板能够取得对应标识。缺少时间、树种或分类的记录会跳过。写回成功后会保存 Forest 记录标识，避免再次作为新记录创建。

这项能力用于新增专注记录，不会把你对已有 Notion 记录的任意修改同步回 Forest。请保留已有记录的标识，也不要将这个数据库当作完全独立于 Forest 的草稿区。

## 常见问题

### 邮箱密码正确，为什么仍不能登录？

先确认服务器地区是否与 Forest 账号一致，并在 Forest 官方端验证邮箱和密码。当前表单不提供第三方登录跳转。登录状态失效时，可从账号卡片点击「重新登录」；如未出现登录表单或仍然失败，保留错误提示联系技术支持。

### 国际服务器登录成功，为什么同步失败或没有记录？

当前登录支持选择国际服务器，但专注数据同步尚未完整适配国际区。反复切换服务器或执行全量同步不能解决这个限制。请保持账号实际地区，联系技术支持确认支持进度。

### 为什么没有补录的旧记录，或旧记录的备注没更新？

普通同步只处理晚于 Notion 最新开始时间的记录。确认 Forest 已保存这些变更后，在权益允许时运行一次全量同步。

### 为什么树种有记录，但图标缺失？

树种关联和图标是两部分。没有可用树种素材时可能使用默认图标，不代表专注时间没有同步。先检查记录本身和关联是否存在，再查看运行状态。

### 可以用全量同步突破体验条数或找回已删除记录吗？

不可以。全量功能受服务权益限制，只重新检查平台当前仍能返回的数据，无法恢复已不可读取的记录。体验范围请以插件显示为准。

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