中文
数据连接
Notion

Notion

从 Notion 导入页面和数据库到 PuppyOne。


支持的内容

类型支持说明
页面 (Page)包括子页面
数据库 (Database)自动转换为 JSON 数组
嵌入内容⚠️部分支持(图片、视频链接)
评论暂不支持

设置步骤

Step 1: 开始导入

  1. 进入你的 Project
  2. 点击 ImportNotion

Step 2: 授权 Notion

首次使用需要 OAuth 授权:

  1. 点击 Connect Notion
  2. 在 Notion 弹窗中选择你要授权的 Workspace
  3. 选择要分享给 PuppyOne 的页面(可以选择全部或部分)
  4. 点击 Allow access

💡 提示:你可以只授权特定页面,PuppyOne 只能访问你授权的内容。

Step 3: 选择要导入的内容

授权成功后,你会看到可导入的页面列表:

  1. 勾选要导入的页面或数据库
  2. 点击 Import

Step 4: 等待处理

导入会在后台执行,你可以在 Tasks 面板查看进度。

处理完成后,Notion 内容会转换为 Content Node,写入你的项目文件树中。


数据结构示例

Notion 页面 → JSON

{
  "title": "产品需求文档",
  "content": "## 背景\n\n这是一个...",
  "created_at": "2024-01-15",
  "last_edited": "2024-01-20",
  "properties": {
    "状态": "进行中",
    "负责人": "张三"
  }
}

Notion 数据库 → JSON 数组

{
  "database_title": "产品列表",
  "items": [
    {
      "name": "Widget Pro",
      "price": 99.99,
      "category": "电子产品"
    },
    {
      "name": "Gadget X",
      "price": 149.99,
      "category": "配件"
    }
  ]
}

同步设置

手动同步

在 Project 的连接列表中找到对应的 Notion 连接,点击 Sync 按钮手动拉取最新内容。

自动同步(即将推出)

未来将支持定时自动同步。


常见问题

我看不到某些页面?

确保你在 Notion OAuth 授权时选择了这些页面。你可以在 SettingsConnections 中重新授权。

导入很慢?

大型 Notion 数据库可能需要几分钟。你可以在 Tasks 面板查看进度。

图片没有导入?

目前图片会保留为链接。如果 Notion 图片是私有的,Agent 可能无法直接访问。


下一步