> 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 模板。模板中的数据库、字段和关系是同步脚本识别数据的基础。

## 新用户推荐流程

第一次使用某个服务时，推荐直接使用官方模板：

1. 在插件中点击「复制 Notion 模板」。
2. Notion 打开授权页面后，选择「使用开发人员提供的模板」。
3. 点击允许访问。
4. 回到插件继续登录第三方平台。

这种方式最省心，NotionHub 会自动识别模板里的数据库和字段。

苹果播客的模板复制与授权分开进行：先将官方模板复制到自己的工作区，再回插件授权 Notion 并提交复制后的页面链接，详见 [苹果播客使用指南](https://www.notionhub.app/docs/applepodcast.md)。

## 老用户继续使用原模板

如果你之前已经同步过数据，不想复制一份新模板，可以继续使用原模板：

1. 在 Notion 授权页面选择自己的已有模板页面。
2. 确认授权给 NotionHub。
3. 如果插件要求提交模板链接，打开原模板页面，点击右上角菜单，复制页面链接并提交。

只要新的 Notion 授权仍然能访问原模板，NotionHub 会继续写入原来的数据库，不会要求你重新同步到一份新模板。

## Token 过期怎么办

Notion 授权过期时，NotionHub 会优先尝试刷新 Token。

如果刷新成功，插件会继续使用原来的模板。你通常不需要重新复制模板。

如果刷新失败，插件会提示重新授权。重新授权时优先选择原来的模板页面；如果新 Token 没有权限访问原模板，再按提示提交模板链接或重新复制模板。

## 模板可以移动吗

可以。你可以把复制出来的模板页面移动到其它 Notion 页面下整理。

移动页面位置不会影响同步。同步依赖的是页面和数据库 ID，不依赖模板出现在侧边栏的哪个位置。

## 不建议修改什么

可以调整视图、排序、筛选、分组和页面图标。

不建议修改：

- 数据库名称。
- 字段名称。
- 字段类型。
- 关系字段。
- 用于去重的 ID、链接或平台原始 ID 字段。
- 模板里的核心数据库。

这些内容被同步脚本依赖，改动后可能导致同步失败、重复创建、关系丢失或热力图不更新。

## 想改造模板怎么办

建议先复制一份备份，再逐步调整视图和展示方式。

如果你想修改字段结构，建议先联系技术支持确认。深度改造模板可能需要同步脚本配合，否则后续更新时容易出问题。

## 常见错误

### 模板页面不存在或无访问权限

说明 NotionHub 访问不到你绑定的模板。请看 [模板页面不存在或无访问权限](https://www.notionhub.app/docs/template-page-no-access.md)。

### Notion API 404

这是 Notion 授权或模板复制过程中的常见异常。请看 [修复 404 问题](https://www.notionhub.app/docs/fix-404.md)。

### 授权成功但没有复制模板

通常是授权时选择了「自己的页面」，而不是「开发人员提供的模板」。如果你确实想使用自己的旧模板，请按插件提示提交模板页面链接。