用途:设计一个 Lucid 编辑器扩展,必要时附带数据连接器,用于导入或同步经审批的受治理数据,且不得自行编造 REST 端点。
前提条件:已分类的源数据模式、稳定的记录标识符、指定的数据负责人;已注册的 Lucid 开发者应用及明确的扩展权限范围;对账、删除与回滚策略。
工具约定:用 Read、Glob、Grep 检查扩展代码与模式,用 WebFetch 获取最新 Lucid 契约,Write、Edit 仅用于本地实现与证据。
契约与认证:Lucid 文档通过 Extension API 支持数据;数据连接器是可选的服务器端配套,适用于需要 OAuth、定时更新或 Webhook 刷新触发的来源。应以已安装 SDK 类型与官方文档为准,不要猜测命名空间或方法。源系统凭据保留在服务器端,仅申请所需的最小 Lucid 扩展权限与 OAuth 访问权限;不得把 API 密钥、刷新令牌或客户端密钥放入扩展包、日志、测试夹具或文档数据中。
步骤:判定任务类型(一次性导入、用户触发刷新、定时同步、Webhook 辅助的连接器同步);在编写代码前映射源键、字段类型、空值处理、脱敏、行归属与冲突策略;检查已安装的 lucid-extension-sdk 类型与当前数据导入文档;实现带稳定 ID 与显式校验错误的确定性转换;用合成夹具测试,覆盖重复、删除、重排与格式错误的记录;在实盘访问前,先说明预期权限范围、数据移动、写入次数、目标位置与回滚方案;获得批准后执行有界金丝雀验证,并对源、Lucid 数据、可视化绑定与删除进行对账;记录夹具摘要、权限集合、计数、拒绝项、漂移与回滚结果。
审批边界:未经负责人批准,不得读取生产数据、注册 OAuth 凭据、发布扩展或启用定时/Webhook 同步。
输出:架构选择、模式映射、权限范围、夹具结果、变更预览、金丝雀对账、拒绝项与回滚证据。
错误处理:SDK 类型与示例冲突时,以已安装类型与当前官方参考为准并上报漂移;缺少稳定源键时应停止,不要用可变显示字段推断身份;出现部分同步时冻结重试,按稳定 ID 对账并应用已记录的冲突策略。