用途:为 Framer 集成开发提供生产级 SDK 模式,适用于实现 Framer 集成、重构 SDK 用法或建立团队规范。
主要能力:类型安全的 CMS 字段定义与条目转换;插件状态管理 Hook(同步状态、错误与计数);带属性控制的可复用组件模式;Server API 客户端封装(连接、同步集合、发布);以工厂函数生成 Override 动画。
使用方式:需先完成 framer-install-auth 设置,并熟悉 React 与 TypeScript。示例包括在 src/cms/types.ts 定义字段、在 src/hooks/usePluginState.ts 使用 framer-plugin 的 framer.notify、在组件中使用 addPropertyControls 与 ControlType、在 src/server/framer-client.ts 通过 framer-api 的 framer.connect 连接并调用 getCollections、createManagedCollection、setItems、publish,以及在 src/overrides/factory.ts 生成 FadeIn 系列 Override。
适用场景:CMS 同步插件、设计系统组件、Server API 集成与交错动画等。
限制:资料未提供具体版本要求、Python 示例细节、错误处理完整实现及收费信息;建议先用隔离的暂存集成与虚构 CMS 数据验证 schema 与幂等性,发布前拒绝意外目标,仅记录不透明 ID 与聚合结果。