AI 辅助建表流程

本指南介绍如何利用筑表师的 AI 矩阵（大师建表工坊、AI 修改当前表、AI 索引顾问与智能业务注释）进行高效的表结构设计与演进。

适用场景

适用于从零开始将模糊的业务需求转化为规范的数据库表结构，或对既有复杂大表进行小步增量重构，由 AI 提供架构决策建议并经由人工安全审查落地。

---

核心操作流程

1. 大师建表工坊（对话式全新设计）

1. 在表配置区域点击大师建表工坊打开 AI 交互面板。
2. 输入业务需求：描述业务实体、核心业务场景、高频查询条件及预期的特殊约束（例如：“设计一个多租户电商订单表，包含租户ID、订单号、支付状态、金额、优惠券减免，需要考虑按创建时间范围查询”）。
3. 结合模板生成：可勾选标准字段模板，AI 将优先复用团队统一的审计字段（如 created_at、updated_by）。
4. 审阅设计决策：AI 输出第一版完整结构，并附带设计理由（如选用某种数据类型的原因、为什么建立某复合索引）。
5. 多轮对话演进：可直接在对话中补充细化指令（如“补一个软删除字段”、“把金额改成精准数字类型”），AI 将基于上下文连续迭代。
6. 点击应用到表配置，字段、索引与 Schema Name 将完整回填至工作区。

2. AI 修改当前表（安全审查清单模式）

当表结构已经存在，需要做增量重构时：

1. 点击顶部操作栏的AI 修改。
2. 描述具体的变更诉求（例如：“增加一个微信 OpenID 字段，并把手机号唯一索引改为租户 ID + 手机号的联合唯一索引”）。
3. 生成结构化变更清单：AI 会对比当前表并列出细粒度的修改项（表级、字段级、索引级）。
4. 逐项勾选与审查：支持单独确认（Accept）或拒绝（Reject）某项变更，杜绝整表盲目覆盖。
5. 点击应用选中变更，已确认的项将原子生效。

3. AI 智能业务注释生成

• 在设计或导入表后，点击生成 AI 注释。
• AI 基于字段名命名惯例（如 is_deleted、pay_channel）与数据类型智能推断语义，自动补全表与字段的中文说明，降低团队文档化维护成本。

---

校验与完成标志

• [ ] AI 生成的表结构已成功回填至工作区，未发生字段丢失或类型错配。
• [ ] AI 修改模式下的变更清单已经过逐项确认并正确生效。
• [ ] 关键业务约束（非空、唯一性、精度与主键策略）经人工审查确认。
• [ ] 表名与字段注释语义准确、规范统一。

常见注意事项

提示词质量与准确度

提示词越具体（包含主键偏好、并发量级、高频 WHERE 过滤字段），AI 生成的索引策略与类型选型就越精准。

• 草案性质与人工复核：AI 输出属于架构草案，在生产环境执行 DDL 前务必结合业务逻辑做最终人工确认。
• 登录与点数扣除：AI 能力依托大模型服务，使用时会按实际消耗扣除账号点数。未登录时系统会弹出登录引导。
• 重置上下文：若多轮对话偏离预期，点击面板中的“重新开始”清空历史会话，重新输入清晰的目标需求。