SuperAPI AI 工具集

yb-model

通用与其它

查看项目

更新于 10-16 08:49

技能介绍

用途:对既有 YugabyteDB YSQL 模式做离线审查,仅处理 YSQL,不适用于普通 PostgreSQL。审查由确定性引擎 scripts/yb-model.py 与规则 rules/rules.json 驱动,相同输入得到相同的发现、严重度、排序与 DDL;执行者只负责收集输入、运行引擎、补充引擎无法知道的上下文,不得自行增删、改序、改写或重新评级发现。

主要能力:按用途分组输出发现,给出事实、机制、影响、可选方案及各自核查结果与依据;含预检、重放(可用时用 Docker 镜像在临时容器注入行数与列统计并跑 EXPLAIN 与探针,被证伪的发现会撤回)、评审报告 review.md/review.json/chat.md 与 plan.json。报告含 Headline、输入基线、假设与未知、访问模式、按区域分组、发现、逐规则方案、重放争议、工作负载卫生、已验证项、验证与限制、待决策项等章节。

使用方式:先把采集文件(schema.sql、ybm_*.csv、ybm_pss.csv、ybm_pg_stats.csv 等)放入一个目录,运行 python3 <skill-dir>/scripts/yb-model.py preflight <bundle>;预检退出 3 说明缺少会改变发现的输入,需原样展示并询问用户是否在缺失下继续,只有用户明确同意才加 --accept-missing。随后 python3 <skill-dir>/scripts/yb-model.py review <bundle>;可选 --release、--replay、--measure。打印某项 DDL 用 python3 scripts/yb-model.py sketch <bundle> <finding> --option <id>。

适用场景:已有 ysql_dump 与统计、工作负载导出的模式审查;只有 DDL 时做结构性审查;不接受仅有慢查询或 pg_stat_statements 而无可审模式的请求。

限制:需要先取得完整采集包;重放需 Docker 镜像(约 1 GB,拉取前须征得同意);缺少统计或设置时相应规则被静音或削弱并加注;无重放时审查仅为静态,准确性显著下降;无客户精确版本时用最近的更早版本替代,绝不使用更新版本;文档未提供价格、收费或平台支持信息。