SuperAPI AI 工具集

adapter-guide

前端与建站

查看项目

更新于 10-16 00:06

技能介绍

用途:该技能面向 Materialize 仓库的适配器层及相关 crate 开发。当用户处理 adapter layer、coordinator、pgwire、frontend peek path、peek client、timestamp oracle、batching oracle 等模块时,应使用本技能。

主要能力:在改动前强制阅读并遵循 doc/developer/guide-adapter.md 中的指导,该文档包含正确性不变量、架构说明,以及因正确性原因被尝试并否决的优化列表。处理时间戳预言机(src/timestamp-oracle/)时,还需阅读 src/timestamp-oracle/src/lib.rs 与 src/timestamp-oracle/src/batching_oracle.rs 的模块级文档,了解 TimestampOracle trait 契约及批处理/线性一致性不变量。

使用方式:开始相关改动前先阅读上述文档;当发现某方案不正确或方向错误时,建议将经验提炼进 doc/developer/guide-adapter.md,放入最合适的章节——新增正确性不变量、现有不变量下的新子节、被否决的优化,或必要时新增顶层章节,并说明尝试了什么、为何错误及相关背景。

适用场景:Materialize 适配器层、协调器、pgwire、peek 路径、时间戳预言机等模块的开发与维护。

限制:资料未提供具体安装命令、平台支持、收费方式或效果数据;具体内容以仓库内文档为准。