用途：使用官方 notion-client Python SDK 以编程方式控制 Notion，适用于通过 API 创建页面或数据库条目、查询数据库、向页面追加块（文本、代码、标题等）、用 Python 自动化 Notion 工作流，以及把外部数据源接入 Notion。
主要能力：提供 notion_wrapper.py（客户端初始化、令牌校验、重试封装）、create_page.py（创建页面与属性构造器）、add_blocks.py（追加块与块类型构造器）、query_database.py（查询、筛选、排序、搜索）等脚本。支持 24 种属性类型、多种块类型、富文本格式与分页处理。
使用方式：先安装依赖 uv pip install notion-client（v2.6+ 才支持 data_source）。使用前需收集集成令牌，格式必须以小写 ntn_ 或 secret_ 开头，并用 validate_token() 校验；随后需在 Notion 中把每个页面或数据库共享给该集成（页面 → ... 菜单 → Connections → Add connection）。示例：client = Client(auth="ntn_...")，再调用 create_database_page、append_blocks、query_data_source 等函数。
限制：速率约 3 请求/秒，429 响应含 Retry-After，可用 api_call_with_retry() 自动处理；写入后读取存在最终一致性延迟，建议至少等待 0.5 秒；页面只能归档（archived=True）不能永久删除；不支持修改工作区设置、用户权限管理、模板创建管理及账单订阅访问；筛选不会排除 NULL 属性，需在 Python 中判断；构造器不做输入校验，校验发生在 API 层。v2.6.0+ 使用 data_source_id 替代 database_id，旧版 database_id 对简单数据库仍可用。