用途:为跨环境的 Notion 集成定义隔离的开发、预发布与生产连接、密钥、内容根和晋级规则,在真正执行线上操作前产出可审计的决策或产物。
主要能力:清理各环境的 workspace、连接、负责人、能力、共享根、webhook、队列与目标;定义不可变的环境标识和失败即关闭的启动断言;分离密钥、对象 ID、回调 URL、加密密钥与遥测标签;在生产外使用合成夹具并阻止配置回退;让代码产物与凭证、内容配置独立晋级;运行跨环境泄漏测试并记录轮换、拆除与应急负责人。
使用方式:用 Read、Glob、Grep 检查文档、配置、代码、夹具与证据,仅在批准的仓库产物上使用 Write 和 Edit。输出环境矩阵、指纹、共享根映射、晋级门、泄漏测试结果、生命周期负责人与例外,并明确假设、负责人、过期时间与证据缺口。
前提:需要当前 Notion 官方文档与所选集成经测试的 API 版本契约;指定 workspace 负责人、内容或数据负责人及操作负责人;使用已移除密钥与工作区内容的合成或已批准的非生产夹具。
限制:Notion 没有通用的集成环境抽象,隔离依赖不同连接或令牌、工作区/内容边界、密钥、目标、队列、webhook 与应用防护。缺少非生产密钥时不得回退到生产。若两个环境共享凭证指纹则中止;不得仅凭页面标题或主机名推断环境;未经治理不得将生产导出复制到低环境。共享内容需各 workspace 负责人批准,生产绑定需发布批准,应急访问需安全批准。调用本身不授权网络访问、凭证、工作区内容、用户数据、文件传输、部署、能力或共享变更、写入、支出或删除。应把观察到的租户行为视为环境特定证据,而非 Notion 的通用保证。