功能入口与可见性
为什么看不到“分区配置”Tab
现象
你在编辑页面只看到“字段配置、索引配置、授权配置、杂项设置”，看不到“分区配置”。
快速判断
当前数据库类型是否为 MySQL、MariaDB 或 TiDB。
处理步骤
- 在表配置里查看当前数据库类型。结果：确认当前方言。
- 将数据库切换为 MySQL、MariaDB 或 TiDB。结果：页面会显示“分区配置”Tab。
仍未解决时
刷新页面后重新切换数据库类型再检查一次。
为什么看不到“分片配置”Tab
现象
页面没有“分片配置”Tab。
快速判断
当前数据库类型是否为 PostgreSQL (Citus)。
处理步骤
- 打开数据库类型选择器并切换到 PostgreSQL (Citus)。结果：页面显示“分片配置”Tab。
- 先在字段配置中补齐字段，再进入分片配置。结果：可选择可用分片字段。
仍未解决时
确认你选择的是 PostgreSQL (Citus) 而不是普通 PostgreSQL。
为什么看不到“外键配置”Tab
现象
页面没有“外键配置”Tab。
快速判断
外键配置在所有支持的数据库类型下都可用，但只有当字段配置中已存在至少一个字段时，外键配置才有意义。
处理步骤
- 先在字段配置中至少添加一个字段。结果：外键配置 Tab 会正常显示。
- 检查当前是否误将 Tab 折叠或隐藏。结果：展开所有配置 Tab 后重新查看。
仍未解决时
刷新页面并确认字段列表不为空。
为什么看不到“视图/Routine”输出面板
现象
右侧输出区只有 DDL 和 DCL，没有“视图”或“Routine”选项。
快速判断
当前是否在“表配置”区域填写了视图定义，或在“杂项设置”中配置了 Routine 模板。
处理步骤
- 如需生成视图 DDL，先在表配置区域的视图面板中填写 SELECT 查询。结果：右侧输出区会出现“视图”选项。
- 如需生成 Routine，先在杂项设置中选择存储过程、函数或触发器模板。结果：右侧输出区会出现“Routine”选项。
仍未解决时
确认当前数据库类型是否支持视图或 Routine（几乎所有数据库都支持，但语法细节有差异）。
为什么看不到“ORM”输出面板
现象
右侧输出区没有“ORM”选项。
快速判断
ORM 生成在右侧输出区以独立标签存在，与 DDL/DCL 并列。
处理步骤
- 检查右侧输出区顶部标签栏。结果：当字段列表不为空时，“ORM”标签会显示。
- 点击“ORM”并选择目标框架。结果：系统生成对应 ORM 模型代码。
仍未解决时
确认右侧输出区没有被折叠收起；若已折叠，点击展开按钮恢复。
为什么看不到“Schema 检查”面板
现象
页面找不到“Schema 检查”或“Lint”入口。
快速判断
Schema 检查入口通常在表配置区域附近，以“Schema 检查”按钮或面板形式存在。
处理步骤
- 在表配置区域查看是否有“Schema 检查”按钮。结果：点击后打开检查面板。
- 确保当前表至少有一个字段。结果：空表无可检查内容，入口可能隐藏。
仍未解决时
检查当前页面版本是否已包含 Schema 检查功能；如为旧版本，建议刷新或升级。
为什么看不到“Mock 数据”入口
现象
找不到 Mock 数据生成按钮。
快速判断
Mock 数据入口通常在字段配置表格的工具栏或表配置区域。
处理步骤
- 在表配置区域或字段配置工具栏查找“Mock 数据”按钮。结果：点击后打开生成对话框。
- 确保当前表至少有一个字段。结果：空表无法生成 Mock 数据。
仍未解决时
确认当前页面是否已加载最新版本功能。
为什么看不到“表蓝图”入口
现象
顶部操作区没有“表蓝图”按钮。
快速判断
表蓝图入口通常在顶部操作区，靠近“导入 SQL”按钮。
处理步骤
- 查看顶部操作区是否有“表蓝图”或“模板”按钮。结果：点击后弹出蓝图选择对话框。
- 如未看到，检查当前是否处于草稿箱或已保存表状态；蓝图在所有状态下均可用。
仍未解决时
刷新页面或检查当前部署版本是否包含蓝图功能。
为什么看不到“回收站”
现象
删除已保存表后找不到恢复入口。
快速判断
回收站通常在“已保存表”抽屉内，以独立标签或底部链接形式存在。
处理步骤
- 打开“查看已保存表”抽屉。结果：在抽屉底部或标签栏中找到“回收站”。
- 进入回收站查看被删除的表。结果：点击“恢复”可将表还原到已保存表列表。
仍未解决时
确认当前是否为最新版本；回收站功能在旧版本中可能不存在。
为什么看不到“查看表结构变更”按钮
现象
你已编辑字段，但看不到“查看表结构变更”按钮。
快速判断
- 当前是否加载了某张“已保存表”。
- 是否真的存在与加载版本的差异。
处理步骤
- 先从“查看已保存表”加载一张已保存表。结果：系统建立对比基线。
- 对该表做可观察修改（如新增字段、改字段类型、改索引）。结果：出现结构差异。
- 回到表配置区域查看按钮。结果：满足条件时“查看表结构变更”会显示。
仍未解决时
确认你不是在草稿箱中直接新建表；新建草稿没有历史基线可对比。
为什么“大师评审”按钮不可用
现象
“大师评审”按钮呈不可点击状态。
快速判断
右侧“建表 DDL”是否已经生成有效 SQL，而不是占位提示。
处理步骤
- 先补齐表名和至少一个有效字段。结果：右侧生成真实 DDL。
- 再点击“大师评审”。结果：按钮可用并开始评审流程。
仍未解决时
检查当前是否正在进行评审任务；进行中按钮会暂时不可用。
为什么看不到“AI 修改”入口
现象
顶部操作区没有“AI 修改”按钮，或按钮点击后提示无法使用。
快速判断
- 当前是否已登录账号。
- 当前表是否已有可用于修改的表名或字段。
处理步骤
- 先完成注册或登录。结果：AI 修改入口可发起请求。
- 在当前表补齐表名和至少一个字段。结果：AI 能拿到当前表上下文。
- 点击“AI 修改”，输入明确调整方向。结果：系统返回可确认的变更清单。
仍未解决时
确认当前部署环境是否启用了 AI 服务和点数系统。
为什么看不到“AI 索引顾问”入口
现象
顶部操作区没有“AI 索引顾问”按钮，或分析时提示缺少上下文。
快速判断
- 当前是否已登录账号。
- 当前表是否已填写表名和字段。
- 是否准备了典型查询 SQL 或慢查询片段。
处理步骤
- 先完成注册或登录。结果：AI 索引顾问入口可发起请求。
- 补齐表名和字段配置。结果：AI 能识别目标表和可用字段。
- 粘贴典型查询 SQL 后点击“分析索引”。结果：系统返回索引建议和置信度。
仍未解决时
确认当前部署环境是否启用了 AI 服务和点数系统。
为什么 AI 功能无法使用（建表、修改、索引顾问、评审、解释）
现象
点击 AI 建表、AI 修改、AI 索引顾问、大师评审或 SQL 解释后，弹出登录提示或点数不足提示。
快速判断
- 当前是否已登录账号。
- 登录后点数余额是否大于 0。
处理步骤
- 未登录用户需先完成注册或登录。结果：登录后 AI 功能入口才会真正生效。
- 登录后点击顶部头像区域查看剩余额度。结果：可确认当前余额。
- 若余额为 0，打开设置页的「点数中心」查看消费记录。结果：可了解点数去向；充值渠道开放后即可补充。
仍未解决时
确认当前环境是否配置了登录和点数系统；部分私有部署可能未启用这些能力。
为什么看不到「设置」入口
现象
顶部操作区没有账号头像或设置按钮。
快速判断
当前部署环境是否配置了用户系统（Better Auth + D1）。
处理步骤
- 在官方站点（ddl.xingkaixin.me）使用，该环境已完整配置用户系统。结果：设置入口正常显示。
- 若为本地开发或私有部署，检查环境变量是否正确配置了
BETTER_AUTH_URL和相关数据库。结果：配置完成后刷新页面即可看到登录与设置入口。
仍未解决时
联系部署管理员确认用户系统是否已启用。
为什么评审历史为空
现象
打开评审历史后显示“暂无评审记录”。
快速判断
当前表是否完成过一次成功评审。
处理步骤
- 在当前表先执行一次完整“大师评审”。结果：系统生成并保存一条评审记录。
- 评审完成后再打开历史。结果：可以看到对应记录。
仍未解决时
先确认你查看的是同一张表的历史，而不是另一张未评审的表。