SuperAPI AI 工具集

webflow-reference-architecture

前端与建站

查看项目

更新于 10-15 23:30

技能介绍

用途:为仓库中的 Webflow 集成产出架构方案或实现计划,以官方文档和项目实际安装版本为准,发现阶段保持只读,并将准备与线上变更分离。

主要能力:梳理参与者、站点、语言区域、数据分级、新鲜度需求、写入路径、事件路径与运维负责人;划定 OAuth 或站点令牌、密钥存储、Webflow API、队列、数据库、日志与公开交付的信任边界;为 Data API、Content Delivery 和 Webhook 验证定义适配器;区分读模型、暂存写入、发布命令与破坏性操作;为每条数据流规定幂等、对账、速率预算、缓存策略、可观测性与恢复。

使用方式:用 Read 读取仓库说明与相关文件,Glob 盘点清单与集成路径,Grep 定位 API 主机、ID、作用域与凭据名;WebFetch 仅用于当前官方 Webflow 文档;Write 用于新建用户要求的产物,Edit 用于证据收集后的最小改动。Data API 调用使用按集成选择的 bearer 令牌:受控单站点用站点令牌,工作区令牌仅用于其支持的工作区/读取场景,用户授权应用用 OAuth。作用域由具体端点推导。令牌值不得读取、回显、持久化或写入命令、补丁、示例、日志与报告。

适用场景:多租户 CMS 服务为每个租户保存一份 OAuth 授权,用 Data API 做暂存写入,用 Content Delivery 做符合条件的实时读取,验证并去重 Webhook,并单独控制发布。

限制:默认只读检查;任何创建、更新、删除、发布、取消发布、归档、部署、吊销令牌或注册 Webhook 前,需展示确切环境与资源 ID、拟议变更、验证方法与回滚动作,并仅在用户明确授权时执行,生产发布或破坏性操作需重新明确批准。输出需区分文档事实、仓库证据与推断。若站点身份不明确,先加白名单站点/租户映射;若发布与保存耦合,拆分为分别授权的命令;若 Webhook 是唯一真相,需对权威 Webflow 资源做对账。