跳到主要内容

0007 插件存储不开放 SQL

  • 状态:已接受(2026-10-23)
  • 相关:设计文档 05 §4.3

决策​

插件只能使用三种与数据库方言无关的存储:KV、带索引槽位的文档集合(plugin_docs,清单声明索引字段 → 映射到 s1..s3 / n1..n3 / t1 列并建复合索引)、插件私有文件空间。

理由​

三种方言的迁移脚本对插件作者是沉重负担;裸 SQL 也会让沙箱、配额与性能保证失效(BS 的插件靠 Schema::hasTable 自行建表,是事故来源之一)。

影响​

复杂查询需要拆集合或建反向索引;若将来确有需求,以方言中立的 schema DSL 形式开放,并另立 ADR。