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

# 生成日记（Daily Journal）使用指南

「生成日记」会按日期汇总已经同步到 Notion 的记录，整理成一篇日记。你可以先同步当天的阅读、笔记、任务和运动等数据，再生成日记，也可以选择过去的日期补写。

生成日记不会代替各平台的数据同步。例如，希望日记包含当天的 Toggl 时间记录，需要先让 Toggl 服务把这些记录同步到 Notion。

## 可以汇总什么

| 日记模块      | 数据来源                |
| --------- | ------------------- |
| 每日音乐      | 网易云音乐模板中的当日音乐记录     |
| Flomo 日记  | Flomo 模板中的当日笔记与可用图片 |
| 时间统计      | Toggl 时间记录          |
| 已完成任务     | 滴答清单中当天完成的任务        |
| 体重、睡眠     | Keep 模板中的对应健康记录     |
| 运动        | Keep、Strava 运动记录    |
| 微信读书      | 微信读书阅读记录            |
| 豆瓣图书、豆瓣影视 | 豆瓣模板中的对应记录          |
| B 站视频     | B 站模板中的视频记录         |
| 播客        | 小宇宙播客模板中的记录         |
| 历史上的今天    | 日记库里往年同月同日的日记链接     |

只会展示已配置、已授权且目标日期有数据的模块。栏目为空时会跳过，不会为了填满栏目虚构内容。这里的「每日音乐」和「播客」分别使用网易云音乐和小宇宙数据，不会自动汇总所有音乐或播客服务。

## 使用前准备

- 安装最新版 [NotionHub 浏览器插件](https://www.notionhub.app/docs/install.md)，并登录自己的 NotionHub 账号。
- 配置需要汇总的同步服务，确认对应日期的数据已经写入各自的 Notion 模板。无需为了生成日记配置全部服务。
- 准备日记模板，并保持来源模板和日记模板的 Notion 授权有效。
- 按提示连接 GitHub，并确认日记服务有可用的体验次数或已激活，参见 [GitHub Action 同步](https://www.notionhub.app/docs/github-action.md) 和 [免费体验与激活](https://www.notionhub.app/docs/free-trial.md)。

日记服务本身没有额外的第三方账号登录步骤。各平台账号在对应的同步服务中配置。

## 第一步：配置日记模板

1. 打开插件，在服务列表中选择「生成日记」。
2. 在「Notion 模板」卡片点击「去复制」。
3. 在 Notion 授权页面选择开发者提供的模板，确认工作区并允许访问。
4. 返回插件，等待模板显示已配置，再点击「打开模板」确认日记数据库。

如果已经有兼容的 NotionHub 日记模板，可以使用「已有日记模板？直接粘贴模板链接」入口，并确保 NotionHub 已获授权。不要用一个空白页面代替日记模板。

模板中的日记数据库、日期字段和关系用于查找和组织日记。可以调整视图，但请保留原有数据库和字段结构，参见 [Notion 模板与授权](https://www.notionhub.app/docs/notion-template.md)。

## 第二步：设置日记布局

打开「同步设置」，找到「日记布局」。可以先使用默认布局，也可以按自己的习惯调整：

- 修改栏目标题；标题留空时只展示模块内容。
- 拖动栏目改变顺序，或把模块移动到其他栏目。
- 将不需要的模块移到「暂不展示」。
- 点击「添加栏目」增加分组，最多保留 12 个栏目。
- 完成后点击「保存布局」。

每个栏目至少需要一个模块，非空栏目标题不能重复，同一个模块只能出现在一个栏目中。布局变更会在之后生成日记时生效。

## 第三步：选择日期并生成

1. 先在相关服务中完成目标日期的数据同步。
2. 回到「生成日记」，在「日记日期」中选择日期。页面默认选择北京时间当天。
3. 点击「生成日记」。如果提示连接 GitHub 或激活服务，按提示完成配置。
4. 通过插件的运行记录或对应 GitHub Action 查看结果。
5. 打开 Notion 日记模板，找到该日期的日记。

默认每天北京时间 10:00 自动生成前一天的日记；也可以选择日期手动生成。自动运行需要 GitHub 配置、授权和服务权益保持有效，当前计划以插件显示为准。

::: warning 重新生成前先保留手写内容
对已有同日期日记重新生成时，会清空并重建匹配日记页面的正文，手动追加的文字和图片也可能被移除。重新生成前，请先复制或备份需要保留的内容。免费体验不会覆盖已有日记页面。
:::

## 第四步：补齐数据或从手机触发

如果日记缺少某个平台的记录，先检查并同步该平台，再回到日记服务选择同一天重新生成。重新生成前请按上面的说明保留手写内容。

日记服务没有用于拉取第三方历史的「全量同步」。补某一天的日记，应选择具体日期，并确保来源模板中已经有那一天的数据。

Android 用户也可以按照 [HTTP Shortcuts 指南](https://www.notionhub.app/docs/http-shortcuts.md) 配置「生成日记」快捷指令。手机触发前仍需完成模板、GitHub 和数据来源配置。

## 常见问题

### 为什么日记没有某个栏目？

先确认该模块没有被移到「暂不展示」，然后检查来源服务是否配置完成、对应日期是否已有 Notion 数据，以及授权是否有效。没有数据的栏目会自动省略。

「生成日记」不会先替你运行所有同步服务。刚新增的阅读或运动记录，需要先完成来源服务同步。

### 日期为什么和我预期不同？

手动生成默认选择北京时间当天，自动任务默认处理前一天。检查页面里的「日记日期」，并核对来源记录的日期和时区；有些模块按完成日期或收听日期归入日记，而不是按你打开页面的时间。

### 为什么没有“历史上的今天”？

需要日记库中已经存在往年同月同日的日记，且保留了可识别的日期字段。没有对应旧日记时，该模块会跳过。2 月 29 日只会匹配往年的闰日。

### 保存布局失败怎么办？

检查是否存在空栏目、重复标题，或同一模块被安排到多个栏目。删除空栏目或补入模块，再点击「保存布局」。

### 生成失败或模板没有权限怎么办？

先检查运行记录中的具体错误，再确认日记模板和来源模板都仍向 NotionHub 授权。模板问题可参考 [Notion 模板与授权](https://www.notionhub.app/docs/notion-template.md)，其它错误见 [运行状态与排错](https://www.notionhub.app/docs/sync-status.md)。