Back to Details

notion-automation

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Notion 自动化管理

Notion Automation Management

功能说明

Function Description

此技能专门用于自动化 Notion 平台的各种操作，包括：
  • 页面创建、内容编辑和管理
  • 数据库创建、配置和查询
  • 块（Block）操作和内容更新
  • 页面搜索和内容检索
  • 项目和任务跟踪管理
  • 团队协作和评论管理
  • 页面移动和组织结构管理
This skill is specifically designed to automate various operations on the Notion platform, including:
  • Page creation, content editing and management
  • Database creation, configuration and query
  • Block operation and content update
  • Page search and content retrieval
  • Project and task tracking management
  • Team collaboration and comment management
  • Page movement and organization structure management

使用场景

Usage Scenarios

  • "创建一个新的项目页面"
  • "更新 Notion 数据库中的记录"
  • "搜索包含特定关键词的页面"
  • "批量管理页面内容"
  • "设置项目跟踪看板"
  • "管理团队协作和评论"
  • "整理和组织 Notion 工作空间"
  • "Create a new project page"
  • "Update records in the Notion database"
  • "Search for pages containing specific keywords"
  • "Batch manage page content"
  • "Set up project tracking Kanban"
  • "Manage team collaboration and comments"
  • "Organize and sort out Notion workspace"

核心功能模块

Core Function Modules

1. 页面管理

1. Page Management

  • 创建页面：创建新页面并添加初始内容
  • 更新页面：修改页面属性、标题和封面
  • 获取页面：检索页面详细信息
  • 移动页面：在不同数据库或父页面间移动
  • 删除页面：归档或删除页面
  • 页面搜索：按关键词搜索页面和数据库
  • Create Page: Create a new page and add initial content
  • Update Page: Modify page properties, titles and covers
  • Get Page: Retrieve detailed page information
  • Move Page: Move between different databases or parent pages
  • Delete Page: Archive or delete pages
  • Page Search: Search pages and databases by keywords

2. 数据库管理

2. Database Management

  • 创建数据库：创建新的数据库并配置字段
  • 查询数据库：筛选和检索数据库记录
  • 更新数据库：修改数据库结构和属性
  • 获取数据库详情：查看数据库元数据
  • 数据库模板：应用预设模板创建数据库
  • Create Database: Create a new database and configure fields
  • Query Database: Filter and retrieve database records
  • Update Database: Modify database structure and properties
  • Get Database Details: View database metadata
  • Database Template: Apply preset templates to create databases

3. 块（Block）操作

3. Block Operation

  • 获取块内容：读取页面下的所有块
  • 更新块内容：修改块的文本、样式
  • 添加子块：在块中添加子元素
  • 删除块：移除不需要的块
  • 批量操作：一次性更新多个块
  • Get Block Content: Read all blocks under the page
  • Update Block Content: Modify the text and style of the block
  • Add Sub-block: Add sub-elements to the block
  • Delete Block: Remove unwanted blocks
  • Batch Operation: Update multiple blocks at once

4. 内容搜索

4. Content Search

  • 全文搜索：搜索页面标题和内容
  • 数据库搜索：在特定数据库中查找
  • 筛选搜索：按对象类型筛选结果
  • 排序结果：按编辑时间排序
  • Full-text Search: Search page titles and content
  • Database Search: Search in specific databases
  • Filtered Search: Filter results by object type
  • Sort Results: Sort by edit time

5. 协作管理

5. Collaboration Management

  • 获取用户：列出工作空间用户
  • 创建评论：在页面或块中添加评论
  • 获取评论：查看页面讨论
  • 页面权限：管理页面访问权限
  • Get Users: List workspace users
  • Create Comment: Add comments to pages or blocks
  • Get Comments: View page discussions
  • Page Permissions: Manage page access permissions

6. 项目管理

6. Project Management

  • 项目页面：创建项目概览页面
  • 任务看板：设置 Kanban 风格任务管理
  • 进度跟踪：更新任务状态和进度
  • 里程碑管理：设置项目里程碑
  • 依赖关系：管理任务间依赖
  • Project Page: Create a project overview page
  • Task Kanban: Set up Kanban-style task management
  • Progress Tracking: Update task status and progress
  • Milestone Management: Set project milestones
  • Dependency Relationship: Manage dependencies between tasks

工作流程

Workflow

标准页面创建流程

Standard Page Creation Process

  1. 创建页面：创建新页面并设置标题
  2. 添加封面：设置页面封面图片
  3. 添加图标：设置页面图标
  4. 填充内容：使用块添加初始内容
  5. 关联数据库：如需要，关联到数据库
  6. 添加协作人：设置页面协作者
  1. Create Page: Create a new page and set the title
  2. Add Cover: Set the page cover image
  3. Add Icon: Set the page icon
  4. Fill Content: Add initial content using blocks
  5. Associate Database: Associate with the database if needed
  6. Add Collaborators: Set page collaborators

数据库设置流程

Database Setup Process

  1. 创建数据库：创建新数据库
  2. 定义字段：配置属性类型（文本、数字、日期等）
  3. 设置视图：创建不同视图（表格、看板、日历）
  4. 添加记录：批量添加初始记录
  5. 配置筛选：设置常用筛选条件
  6. 设置模板：创建页面模板
  1. Create Database: Create a new database
  2. Define Fields: Configure attribute types (text, number, date, etc.)
  3. Set Views: Create different views (table, Kanban, calendar)
  4. Add Records: Add initial records in batches
  5. Configure Filters: Set common filter conditions
  6. Set Templates: Create page templates

内容更新流程

Content Update Process

  1. 获取当前内容：读取页面块结构
  2. 定位目标块：找到需要更新的块
  3. 更新块内容：修改块文本或属性
  4. 添加新块：如需要，插入新内容块
  5. 验证更新：确认更改正确应用
  1. Get Current Content: Read the page block structure
  2. Locate Target Block: Find the block that needs to be updated
  3. Update Block Content: Modify block text or attributes
  4. Add New Block: Insert new content blocks if needed
  5. Verify Update: Confirm that the changes are applied correctly

项目跟踪流程

Project Tracking Process

  1. 创建项目数据库：建立项目看板
  2. 定义任务状态：设置状态字段（待办、进行中、已完成）
  3. 添加任务：创建任务记录
  4. 分配负责人：设置任务负责人
  5. 设置截止日期：添加日期字段
  6. 更新进度：随进度更新状态
  1. Create Project Database: Build a project Kanban
  2. Define Task Status: Set status fields (To Do, In Progress, Completed)
  3. Add Tasks: Create task records
  4. Assign Assignees: Set task assignees
  5. Set Deadline: Add date field
  6. Update Progress: Update status as progress proceeds

最佳实践

Best Practices

页面组织

Page Organization

  • 使用层级结构组织页面
  • 合理使用数据库代替普通页面
  • 定期清理归档不需要的页面
  • 使用图标和封面区分不同页面
  • 建立统一的命名规范
  • Use a hierarchical structure to organize pages
  • Reasonably use databases instead of ordinary pages
  • Regularly clean up and archive unnecessary pages
  • Use icons and covers to distinguish different pages
  • Establish a unified naming convention

数据库设计

Database Design

  • 字段类型选择要准确
  • 合理使用关系字段连接数据库
  • 设置默认视图提高使用效率
  • 使用筛选条件减少噪音
  • 定期维护数据库结构
  • Select the field type accurately
  • Reasonably use relationship fields to connect databases
  • Set default views to improve usage efficiency
  • Use filter conditions to reduce noise
  • Regularly maintain the database structure

内容编辑

Content Editing

  • 使用块组织内容结构
  • 合理使用标题层级
  • 保持内容简洁明了
  • 及时保存重要修改
  • 使用评论进行讨论
  • Use blocks to organize content structure
  • Reasonably use heading levels
  • Keep the content concise and clear
  • Save important modifications in time
  • Use comments for discussion

协作规范

Collaboration Specifications

  • 明确页面负责人
  • 使用 @提及通知协作者
  • 及时回复评论
  • 定期同步更新状态
  • 尊重页面权限设置
  • Clarify the person in charge of the page
  • Use @mentions to notify collaborators
  • Reply to comments in time
  • Synchronize update status regularly
  • Respect page permission settings

常用代码示例

Common Code Examples

1. 创建页面并添加内容

1. Create Page and Add Content

javascript
// 创建新页面
const page = await createPage({
  parent: {
    type: "page_id",
    page_id: "parent_page_id"
  },
  properties: {
    title: {
      type: "title",
      title: [
        {
          type: "text",
          text: {
            content: "项目文档"
          }
        }
      ]
    }
  },
  children: [
    {
      object: "block",
      type: "paragraph",
      paragraph: {
        rich_text: [
          {
            type: "text",
            text: {
              content: "这是项目文档的概述内容。"
            }
          }
        ]
      }
    }
  ],
  icon: {
    type: "emoji",
    emoji: "📝"
  },
  cover: {
    type: "external",
    external: {
      url: "https://example.com/cover.jpg"
    }
  }
});
javascript
// 创建新页面
const page = await createPage({
  parent: {
    type: "page_id",
    page_id: "parent_page_id"
  },
  properties: {
    title: {
      type: "title",
      title: [
        {
          type: "text",
          text: {
            content: "项目文档"
          }
        }
      ]
    }
  },
  children: [
    {
      object: "block",
      type: "paragraph",
      paragraph: {
        rich_text: [
          {
            type: "text",
            text: {
              content: "这是项目文档的概述内容。"
            }
          }
        ]
      }
    }
  ],
  icon: {
    type: "emoji",
    emoji: "📝"
  },
  cover: {
    type: "external",
    external: {
      url: "https://example.com/cover.jpg"
    }
  }
});

2. 数据库操作

2. Database Operations

javascript
// 创建数据库
const database = await createDatabase({
  parent: {
    type: "page_id",
    page_id: "parent_page_id"
  },
  title: [
    {
      type: "text",
      text: {
        content: "项目管理数据库"
      }
    }
  ],
  properties: {
    "任务名称": {
      title: {}
    },
    "状态": {
      select: {
        options: [
          { name: "待办", color: "gray" },
          { name: "进行中", color: "blue" },
          { name: "已完成", color: "green" }
        ]
      }
    },
    "负责人": {
      people: {}
    },
    "截止日期": {
      date: {}
    }
  }
});

// 查询数据库记录
const records = await queryDatabase({
  database_id: "database_id",
  filter: {
    property: "状态",
    select: {
      equals: "进行中"
    }
  },
  sorts: [
    {
      property: "截止日期",
      direction: "ascending"
    }
  ]
});
javascript
// 创建数据库
const database = await createDatabase({
  parent: {
    type: "page_id",
    page_id: "parent_page_id"
  },
  title: [
    {
      type: "text",
      text: {
        content: "项目管理数据库"
      }
    }
  ],
  properties: {
    "任务名称": {
      title: {}
    },
    "状态": {
      select: {
        options: [
          { name: "待办", color: "gray" },
          { name: "进行中", color: "blue" },
          { name: "已完成", color: "green" }
        ]
      }
    },
    "负责人": {
      people: {}
    },
    "截止日期": {
      date: {}
    }
  }
});

// 查询数据库记录
const records = await queryDatabase({
  database_id: "database_id",
  filter: {
    property: "状态",
    select: {
      equals: "进行中"
    }
  },
  sorts: [
    {
      property: "截止日期",
      direction: "ascending"
    }
  ]
});

3. 页面搜索

3. Page Search

javascript
// 搜索页面
const searchResults = await search({
  query: "项目计划",
  filter: {
    property: "object",
    value: "page"
  },
  sort: {
    direction: "descending",
    timestamp: "last_edited_time"
  }
});

// 搜索数据库
const dbResults = await search({
  query: "任务",
  filter: {
    property: "object",
    value: "database"
  }
});
javascript
// 搜索页面
const searchResults = await search({
  query: "项目计划",
  filter: {
    property: "object",
    value: "page"
  },
  sort: {
    direction: "descending",
    timestamp: "last_edited_time"
  }
});

// 搜索数据库
const dbResults = await search({
  query: "任务",
  filter: {
    property: "object",
    value: "database"
  }
});

4. 块内容更新

4. Block Content Update

javascript
// 获取页面块
const blocks = await getBlockChildren({
  block_id: "page_id"
});

// 更新块内容
await updateBlock({
  block_id: "block_id",
  paragraph: {
    rich_text: [
      {
        type: "text",
        text: {
          content: "更新后的内容"
        }
      }
    ]
  }
});

// 添加新块
await appendBlockChildren({
  block_id: "parent_block_id",
  children: [
    {
      object: "block",
      type: "heading_2",
      heading_2: {
        rich_text: [
          {
            type: "text",
            text: {
              content: "新的章节标题"
            }
          }
        ]
      }
    }
  ]
});
javascript
// 获取页面块
const blocks = await getBlockChildren({
  block_id: "page_id"
});

// 更新块内容
await updateBlock({
  block_id: "block_id",
  paragraph: {
    rich_text: [
      {
        type: "text",
        text: {
          content: "更新后的内容"
        }
      }
    ]
  }
});

// 添加新块
await appendBlockChildren({
  block_id: "parent_block_id",
  children: [
    {
      object: "block",
      type: "heading_2",
      heading_2: {
        rich_text: [
          {
            type: "text",
            text: {
              content: "新的章节标题"
            }
          }
        ]
      }
    }
  ]
});

5. 评论管理

5. Comment Management

javascript
// 创建评论
await createComment({
  parent: {
    page_id: "page_id"
  },
  rich_text: [
    {
      type: "text",
      text: {
        content: "建议在这里添加更多细节描述。"
      }
    }
  ]
});

// 获取评论
const comments = await retrieveComments({
  block_id: "page_id"
});
javascript
// 创建评论
await createComment({
  parent: {
    page_id: "page_id"
  },
  rich_text: [
    {
      type: "text",
      text: {
        content: "建议在这里添加更多细节描述。"
      }
    }
  ]
});

// 获取评论
const comments = await retrieveComments({
  block_id: "page_id"
});

6. 页面移动

6. Page Movement

javascript
// 移动页面到其他父页面
await movePage({
  page_id: "page_id",
  parent: {
    type: "page_id",
    page_id: "new_parent_id"
  }
});

// 或移动到数据库
await movePage({
  page_id: "page_id",
  parent: {
    type: "database_id",
    database_id: "database_id"
  }
});
javascript
// 移动页面到其他父页面
await movePage({
  page_id: "page_id",
  parent: {
    type: "page_id",
    page_id: "new_parent_id"
  }
});

// 或移动到数据库
await movePage({
  page_id: "page_id",
  parent: {
    type: "database_id",
    database_id: "database_id"
  }
});

7. 批量操作

7. Batch Operations

javascript
// 批量创建页面记录
const batchCreate = async (databaseId, records) => {
  for (const record of records) {
    await createPage({
      parent: {
        type: "database_id",
        database_id: databaseId
      },
      properties: {
        "任务名称": {
          title: [{ text: { content: record.title } }]
        },
        "状态": {
          select: { name: record.status }
        }
      }
    });
  }
};

// 批量更新块
const batchUpdate = async (updates) => {
  for (const update of updates) {
    await updateBlock({
      block_id: update.blockId,
      ...update.content
    });
  }
};
javascript
// 批量创建页面记录
const batchCreate = async (databaseId, records) => {
  for (const record of records) {
    await createPage({
      parent: {
        type: "database_id",
        database_id: databaseId
      },
      properties: {
        "任务名称": {
          title: [{ text: { content: record.title } }]
        },
        "状态": {
          select: { name: record.status }
        }
      }
    });
  }
};

// 批量更新块
const batchUpdate = async (updates) => {
  for (const update of updates) {
    await updateBlock({
      block_id: update.blockId,
      ...update.content
    });
  }
};

8. 用户和权限

8. Users and Permissions

javascript
// 获取用户信息
const users = await listUsers();

// 获取特定用户
const user = await getUser({
  user_id: "user_id"
});

// 获取当前用户
const me = await getSelf();
javascript
// 获取用户信息
const users = await listUsers();

// 获取特定用户
const user = await getUser({
  user_id: "user_id"
});

// 获取当前用户
const me = await getSelf();

集成场景

Integration Scenarios

1. 项目管理系统

1. Project Management System

  • 创建项目概览页面
  • 设置任务跟踪数据库
  • 管理里程碑和时间线
  • 生成项目报告
  • 跟踪团队进度
  • Create project overview pages
  • Set up task tracking databases
  • Manage milestones and timelines
  • Generate project reports
  • Track team progress

2. 知识库管理

2. Knowledge Base Management

  • 组织文档结构
  • 创建知识库页面
  • 维护文档索引
  • 设置文档权限
  • 定期更新内容
  • Organize document structure
  • Create knowledge base pages
  • Maintain document indexes
  • Set document permissions
  • Update content regularly

3. 内容创作工作流

3. Content Creation Workflow

  • 创建内容日历
  • 管理草稿和发布
  • 协作编辑文档
  • 追踪评论反馈
  • 自动化内容发布
  • Create content calendars
  • Manage drafts and publishing
  • Collaborate on document editing
  • Track comment feedback
  • Automate content publishing

4. 团队协作平台

4. Team Collaboration Platform

  • 建立团队主页
  • 管理团队成员
  • 设置会议记录
  • 共享资源和链接
  • 跟踪团队任务
  • Build a team homepage
  • Manage team members
  • Set up meeting minutes
  • Share resources and links
  • Track team tasks

5. 自动化报告生成

5. Automated Report Generation

  • 收集数据更新
  • 生成定期报告
  • 导出报告内容
  • 分发报告给团队
  • 存档历史记录
  • Collect data updates
  • Generate regular reports
  • Export report content
  • Distribute reports to the team
  • Archive historical records

注意事项

Notes

  • 遵守 Notion API 速率限制
  • 正确处理认证和权限
  • 验证块类型和内容格式
  • 保护敏感信息不被泄露
  • 定期备份重要数据
  • 注意页面和数据库的层级关系
  • 使用正确的 ID 类型（page_id、database_id、block_id）
  • 处理 API 错误和异常情况
  • 遵守 Notion 的使用条款
  • 尊重数据隐私和安全规范
  • Comply with Notion API rate limits
  • Handle authentication and permissions correctly
  • Verify block types and content formats
  • Protect sensitive information from leakage
  • Back up important data regularly
  • Pay attention to the hierarchical relationship between pages and databases
  • Use the correct ID type (page_id, database_id, block_id)
  • Handle API errors and exceptions
  • Comply with Notion's terms of use
  • Respect data privacy and security specifications