> 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 使用指南

![多邻国同步到 Notion](/duolingo-cover.png)

## 功能介绍

NotionHub 可以把多邻国学习记录同步到 Notion，帮助你在 Notion 中长期保存每日经验、学习时长、连续学习天数和错题记录。适合把语言学习进度和日记、复盘、年度总结放在同一个 Notion 系统里管理。

当前支持：

- 同步每天的多邻国经验值。
- 同步每天的学习时长。
- 同步每天学习过的课程和单元信息。
- 同步连续学习天数，并写入统计页面。
- 同步错题记录，保存问题、答案、课程和时间。
- 自动维护年、月、周、日和全部等时间维度关系。
- 生成多邻国学习热力图，用来查看全年学习分布。
- 按年份统计学习天数、学习时长和最长连续学习天数。

只支持使用 NotionHub 开发者提供的多邻国 Notion 模板，不支持自己的模板或自行改造的模板。同步依赖模板中的数据库和字段结构，请不要删除数据库、修改字段名称或修改字段类型。

多邻国同步依赖浏览器中的登录状态。登录状态过期后，需要重新登录多邻国网页，再回到插件中更新登录状态。

## 预览效果

同步完成后，Notion 模板中会包含每日学习记录、错题记录、时间维度页面和学习热力图。

常见查看方式包括：

- 在每日记录中查看某一天获得了多少经验、学习了多久。
- 按年、月、周、日查看不同时间段的学习情况。
- 在全部页面查看当前连续学习天数等统计信息。
- 在错题库中复盘多邻国返回的错题。
- 在热力图中查看全年学习是否稳定。

如果你习惯在 Notion 中写日记，可以把当天的多邻国学习记录和日记放在一起，方便复盘哪一天学了什么、哪一段时间中断过、哪些错题需要重新练习。

## 使用指南

### 使用前准备

开始前请先确认：

- 已安装 NotionHub 浏览器插件。如果还没有安装，可以先查看插件安装教程：[https://www.notionhub.app/docs/install.html](https://www.notionhub.app/docs/install.html)
- 已获取多邻国同步服务的激活码。
- 已复制 NotionHub 提供的多邻国 Notion 模板。
- 已完成 Notion 授权，并授权到复制出来的模板页面。
- 浏览器可以正常打开并登录多邻国网页版：[https://www.duolingo.com/](https://www.duolingo.com/)

### 第一步：打开多邻国同步

打开 NotionHub 插件，在服务列表中选择「多邻国」。

第一次使用时，需要按顺序完成激活服务、复制模板、授权 Notion、登录多邻国，然后再开始同步。

如果插件中没有看到多邻国服务，请先确认插件已经升级到支持多邻国同步的版本。

### 第二步：输入激活码

在「激活服务」步骤中输入多邻国同步服务的激活码，然后点击激活。

激活成功后，插件会进入 Notion 模板复制和授权步骤。激活码只用于绑定当前同步服务，请不要把激活码分享给其他人。

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

点击插件中的「复制 Notion 模板」按钮，按页面提示复制 NotionHub 提供的多邻国模板，并完成 Notion 授权。

授权时需要注意：

- 只支持使用 NotionHub 提供的模板。
- 不要自己新建空页面替代模板。
- 不要删除模板中的数据库。
- 不要修改数据库字段名称和字段类型。
- 模板复制完成后，可以把整个模板页面移动到其他 Notion 页面下面整理位置。

只移动模板页面的位置不会影响同步。同步绑定依赖的是模板中的数据库 ID 和 Notion 授权，不依赖模板位于 Notion 侧边栏的哪个位置。

### 第四步：登录多邻国

点击插件中的「登录多邻国」按钮，浏览器会打开多邻国网页版。

如果你还没有登录，请先在网页中完成登录；如果已经登录，插件会读取当前浏览器里的多邻国登录状态。登录完成后回到插件页面继续下一步。

如果插件提示「请先登录多邻国」或登录超时，可以重新打开 [https://www.duolingo.com/](https://www.duolingo.com/) 完成登录，再回到插件中重新点击登录。

### 第五步：开始同步

完成前面的步骤后，点击「开始同步」。

第一次同步会读取多邻国历史学习记录和错题记录，数据较多时需要等待一段时间。后续再次同步时，NotionHub 会更新已有日期的学习记录，并补充新产生的学习数据。

同步过程中请不要重复点击开始同步。如果插件提示任务正在运行，说明上一次同步还没有结束，等待任务完成后再查看 Notion 数据。

### 第六步：查看 Notion 数据

同步完成后，打开复制出来的 Notion 模板，可以看到：

- 日记录库：保存每天的经验、学习时长、课程、单元和日期。
- 错题库：保存问题、答案、课程、时间和对应日期关系。
- 时间维度库：按年、月、周、日整理学习记录。
- 全部页面：汇总连续学习天数等统计信息。
- 热力图：按日期展示全年学习活跃情况。

如果你发现最近几天的数据没有更新，可以先确认多邻国网页仍然处于登录状态，然后重新触发一次同步。

### 常见问题

#### 为什么同步不到最近的数据？

常见原因是多邻国登录状态过期、浏览器没有授权插件读取多邻国站点 Cookie，或多邻国接口返回数据有延迟。

可以重新打开 [https://www.duolingo.com/](https://www.duolingo.com/) 登录账号，再回到 NotionHub 插件中重新点击登录并触发同步。

#### 错题为什么没有全部同步？

错题数据取决于多邻国接口当前能返回的内容。部分课程、题型或历史错题可能不会完整返回，因此 Notion 中看到的错题数量可能和多邻国客户端展示不完全一致。

#### 可以移动 Notion 模板页面吗？

可以。你可以把复制出来的多邻国模板页面移动到其他页面下面作为子页面整理。

只移动页面位置不会影响同步。不要删除模板里的数据库，不要修改字段结构，也不要移除 NotionHub 的授权访问权限。

#### 可以用自己的 Notion 模板吗？

不支持。多邻国同步只支持开发者提供的模板。自己的模板或自行改造的模板可能缺少必要数据库、字段或关系，容易导致同步失败或数据写入不完整。
