SuperAPI AI 工具集

planetscale-readonly-inventory

部署与运维

查看项目

更新于 10-16 08:06

技能介绍

用途:为 PlanetScale 数据库建立一份有证据支撑的只读盘点,不做任何变更。适用于审计、上线前评估、交接或排查前的基础信息采集。

主要能力(默认允许):列出组织、数据库、分支、keyspace、区域与规格;读取分支元数据与 schema;读取 Webhook 配置;读取 schema 建议;通过 MCP 或 API 读取 Query Insights、异常与查询模式;读取流量预算与规则;读取 Postgres 角色及非密钥元数据;读取备份计划与恢复元数据;用 Connections CLI 查看实时连接/会话元数据;检查仓库文件中的框架、ORM、迁移、SQL 标签与连接配置;检查 Terraform 等 IaC 定义。

限制:未经明确批准,禁止任何 create、update、delete、enable、disable、reset、deploy、restore、promote、enforce、apply 操作,禁止任何 SQL 变更,禁止生成新凭证的命令。命令与端点须以官方文档为准:文档索引 https://planetscale.com/docs/llms.txt;任何文档页 URL 后加 .md 可得 markdown;API 参考 https://planetscale.com/docs/openapi.yaml。调用前先核对端点路径,404 说明路径错误,不应记为平台状态或得出“未配置”结论。

已验证接口要点:pscale database show <database> --org <org>(org 是 flag);pscale api <path> 使用组织相对路径,无 get 子命令、无 /v1/ 前缀,查询参数用 -Q key=value;pscale api 路径不要内嵌 ?/&。pscale webhook list <database> --org <org>;pscale backup list <database> <branch> 需带分支;pscale branch connections top <database> <branch> 为只读,不得取消查询或终止连接,除非操作员明确批准。Query Insights 为公开 API,live 遥测在 .../branches/{branch}/insights;流量预算用 API(CLI 无 pscale traffic-control budget list);Postgres 角色列于 .../branches/{branch}/roles,单个角色按 ID 获取(pscale role get <db> <branch> <role-id>);IP 限制在数据库级 organizations/{org}/databases/{db}/cidrs;schema 建议在数据库级 .../databases/{db}/schema-recommendations,page=2 目前返回 404,应以 open_schema_recommendations_count 为权威总数并说明样本范围。PITR 状态与分支级备份策略无已验证读取路径,应标注“本次未评估”。列表端点分页,报告计数前需翻页取尽。403、缺少 token scope、超时记入内部运行日志,不进入客户报告。

盘点内容涵盖数据库身份、分支与 schema 工作流、可观测性、建议、Webhook 与自动化、Postgres 流量控制与安全、Vitess 安全、备份与恢复态势。每项发现需含来源、路径或命令、时间戳、原始值或摘录、置信度。输出为清单表、缺失证据表、风险标记、建议后续技能,并以“No changes have been applied.”结尾。