SQL格式化转换

功能概述

SQL格式化转换（插件标识：sql-helper）是 ZTools 极客桌面效率中枢面向 办公效率 场景打造的官方核心扩展。SQL一键美化与压缩、MyBatis日志带问号参数自动拼合为完整SQL、CREATE TABLE建表语句转TS/Go/Java实体类。

• 底层核心痛点：
• SQL 格式凌乱：从线上日志、代码仓库复制出来的 SQL 语句往往是一长串单行文本或大小写杂乱无章，难以阅读与审查；需要一键格式化（关键字大写、缩进换行、子查询对齐）或一键压缩为单行。
• MyBatis 日志排查繁琐：后端开发排查线上 Bug 时，MyBatis 输出的日志通常是分离的（第一行是带 ? 占位符的 Preparing: SELECT * FROM users WHERE id = ? AND status = ?，第二行是 Parameters: 12345(Long), 1(Integer)），无法直接复制到 Navicat/DBeaver 执行，必须人工逐个看类型并替换问号，效率极低且易出错。
• 建表语句手写实体类耗时：拿到 DBA 设计好的 CREATE TABLE DDL 语句后，开发人员需要枯燥地逐字段手写 TypeScript interface / Go struct（带 json/gorm tag）/ Java POJO（带 Lombok 与字段注释），类型容易映射错误（如 bigint 漏转 string 或 int64）。
• 既有实现缺陷：
• MyBatis 插件通常需要付费购买 IDEA 专业插件，或使用网页在线工具，存在将核心表结构与业务查询日志泄露至外部网络的严重安全合规风险；
• 纯网页版 SQL 格式化器对中文注释兼容性差，且不具备 DDL 跨语言实体转换能力。
• 最简收敛路径：
• 采用标准布局二（左侧功能模块/转换历史 + 右侧详情代码面板 isShowingDetail={true}）。
• 通过 searchBarAccessory 收敛为三大工作模式：「SQL 美化与压缩」、「MyBatis 日志拼合还原」、「建表 DDL 转实体代码（TS/Go/Java）」。
• 纯本地离线解析，粘贴即可实时得出结果，回车一键复制。

• 架构标准：@ztools/declarative-ui 声明式 UI 视图描述符 | 运行沙箱：Worker 隔离宿主 + 原生系统桥接 | 分类：办公效率

---

核心功能特性

1. SQL语句一键美化对齐（：SQL语句一键美化对齐（关键字大写/自动缩进）与压缩为单行，支持通过搜索框输入 sql格式化 / sql美化 / sql压缩 / format sql / 美化sql 毫秒级直达对应工作模式。
2. 自动提取 MyBatis：自动提取 MyBatis 日志中的 Preparing 与 Parameters 并拼合为完整可执行 SQL，支持通过搜索框输入 mybatis日志 / mybatis还原 / mybatis sql / 参数拼合 / sql问号替换 毫秒级直达对应工作模式。
3. 粘贴 CREATE TA：粘贴 CREATE TABLE 建表语句，一键生成 TypeScript / Go / Java 实体模型代码，支持通过搜索框输入 ddl转实体 / sql转实体 / 建表转java / sql转ts / sql转go 毫秒级直达对应工作模式。
4. SQL格式化转换核心引擎：SQL一键美化与压缩、MyBatis日志带问号参数自动拼合为完整SQL、CREATE TABLE建表语句转TS/Go/Java实体类，将高频专业操作浓缩进单窗口命令流，告别多软件来回切换。
5. 毫秒级全键盘唤起：按下 Alt+Space（macOS 为 Option+Space）输入「SQL格式化转换」或拼音首字母即可在 <100ms 内瞬时呼出并聚焦搜索框。
6. 声明式双主题原生视图：严格基于 @ztools/declarative-ui 语义组件构建，自动适配深色与浅色系统主题，杜绝传统网页套壳卡顿与闪烁。

---

典型高频使用场景

• 场景 1：SQL语句一键美化对齐（关键字大写/自动缩进）与压缩为单行 — 当你需要快速执行该任务时，按下 Alt+Space 输入 sql格式化 / sql美化 / sql压缩 / format sql / 美化sql，回车即可直接进入 sql-formatter 视图完成处理并一键复制或导出结果。
• 场景 2：自动提取 MyBatis 日志中的 Preparing 与 Parameters 并拼合为完整可执行 SQL — 当你需要快速执行该任务时，按下 Alt+Space 输入 mybatis日志 / mybatis还原 / mybatis sql / 参数拼合 / sql问号替换，回车即可直接进入 mybatis-merge 视图完成处理并一键复制或导出结果。
• 场景 3：粘贴 CREATE TABLE 建表语句，一键生成 TypeScript / Go / Java 实体模型代码 — 当你需要快速执行该任务时，按下 Alt+Space 输入 ddl转实体 / sql转实体 / 建表转java / sql转ts / sql转go，回车即可直接进入 ddl-to-entity 视图完成处理并一键复制或导出结果。

---

唤醒指令与全键盘快捷操作指南

在任何桌面窗口下按下 Alt + Space（macOS 为 Option + Space）呼出 ZTools 搜索框，输入以下指令词即可直达 SQL格式化转换 的对应功能模块：

全局高频键盘快捷键

---

架构性能与安全隐私保障

• 声明式 UI 零闪烁渲染：界面严格采用 @ztools/declarative-ui 的 List / Detail / Form / ActionPanel 语义组件声明，由 ZTools 宿主统一渲染并原生适配深色（Dark）与浅色（Light）双主题。
• 最小权限与沙箱隔离：本插件在清单（plugin.json）中显式声明最小化权限集 ["clipboard"]，所有系统调用均受 ZTools 宿主桥接层与 AST 静态安全门禁严格审计。
• Local-First 本地离线原则：所有配置项、历史记录与业务数据 100% 存储在用户本地（SQLite / LocalStorage），绝不向任何第三方服务器静默上传敏感信息。

---

延伸阅读与技术内链

关联技术与效率专栏文章

• 还在两个窗口来回切着复制粘贴？学会“顺序流水粘贴”，每天准点下班！
• 告别重复打字！输入3个字母自动展开长句和邮箱，打工人必备的快捷短语秘籍
• 双手不离键盘的极客交互哲学：双模态状态机与四级快捷键分发器设计
• 不用羡慕Mac分屏！这个免费小工具，按一下快捷键让Windows窗口瞬间整整齐齐

同分类热门效率插件推荐（办公效率）

• 超级剪贴板历史 插件详情与使用指南
• 快捷短语 Snippets 插件详情与使用指南
• 纯文本与顺序粘贴栈 插件详情与使用指南
• 科学计算器与表达式求值 插件详情与使用指南
• 浏览 ZTools 插件市场全部扩展
• 下载 ZTools 极客桌面效率中枢（Windows & macOS）