SQL Helper

一款轻量、专注的 SQL 参数整理工具。将日志、Excel、接口响应或查询结果中的逐行数据，一键转换为可直接放入 SQL IN (...) 的参数列表，也可以把已经格式化的参数重新还原为原始值。

基于 Tauri 2 + Vue 3 + TypeScript + Rust 构建，支持 Windows、macOS 和 Linux。

为什么使用 SQL Helper

开发和数据排查时，经常需要把这样的内容：

10001
10002
10001
O'Reilly

转换为：

'10001','10002','O''Reilly'

SQL Helper 会自动完成包装、去重、换行与 SQL 转义。输入值本身包含单引号时，会按照 SQL 规则进行双写转义，避免生成不可执行的参数。

界面预览

初始界面	还原模式

主要功能

• 整理参数：将逐行数据转换为 SQL 参数列表
• 还原参数：移除包装符和分隔符，恢复为每行一个原始值
• SQL 转义：正确处理 O'Reilly 等包含包装符的内容
• 安全解析：包装内容内部包含逗号时不会被错误拆分
• 灵活配置：自定义包装符、每行项数和紧凑排列
• 自动去重：实时显示输入、输出及重复项数量
• 剪贴板集成：整理后直接复制，或写回输入框
• 快捷操作：支持 Cmd/Ctrl + Enter
• 精简右键菜单：全选、复制、粘贴、清空
• 原生桌面体验：固定紧凑窗口、自绘标题栏、统一进程名称

下载与安装

稳定版本会发布在 GitHub 项目的 Releases 页面。

平台	发布产物
Windows	.msi、NSIS 安装程序
macOS	Apple Silicon + Intel Universal .dmg / .app
Linux	.deb、.rpm、.AppImage

macOS 首次运行

当前 macOS 安装包尚未经过 Apple Developer ID 公证，首次运行时系统可能提示“Apple 无法验证 SQL Helper.app”。将应用拖入“应用程序”目录后，可以在终端执行：

xattr -dr com.apple.quarantine "/Applications/SQL Helper.app"

然后重新打开 SQL Helper。该命令只会移除 SQL Helper 自身的下载隔离标记，不会关闭 macOS Gatekeeper 或修改全局安全设置。

使用方法

1. 将原始数据粘贴到左侧输入框。
2. 在右侧选择“整理”或“还原”。
3. 设置包装符、每行项数、去重等规则。
4. 点击“整理并复制”或“还原并复制”。

右键输入框可以使用应用内置的全选、复制、粘贴和清空操作。

本地开发

环境要求

• Node.js 20+
• pnpm 10+
• Rust stable
• 当前系统对应的 Tauri 系统依赖

启动项目

pnpm install
pnpm tauri dev

测试与检查

pnpm test
pnpm build
cargo check --manifest-path src-tauri/Cargo.toml

构建当前平台的安装包：

pnpm tauri build

项目结构

src/
├── components/       # 编辑器、规则、状态与自绘窗口组件
├── domain/           # 可独立测试的 SQL 文本转换逻辑
├── services/         # Tauri / Web 平台能力适配
└── styles/           # 应用视觉与固定窗口布局
src-tauri/
├── capabilities/     # 最小化的桌面权限
├── src/              # Rust 应用入口
└── tauri.conf.json   # 三端窗口与打包配置

核心转换逻辑位于 src/domain/sqlText.ts，不依赖 Vue、浏览器或 Tauri，可独立测试和复用。

Release 发版

项目配置了 GitHub Actions 自动发版。创建并推送 v* 标签后，CI 会分别在 Windows、macOS、Linux 原生 Runner 上构建，并将安装包发布到同一个 GitHub Release：

git tag v0.1.0
git push origin v0.1.0

也可以在 GitHub Actions 页面手动运行 Release 工作流并填写版本号。

技术栈

• Tauri 2
• Vue 3
• TypeScript
• Vite
• Vitest
• Rust