25 MB lightweight cross-platform database client for 100+ databases, including MySQL, PostgreSQL, SQLite, Redis, MongoDB, DuckDB, SQL Server, and Dameng. Built-in AI, MCP Server, CLI, desktop and Docker. | 轻量级跨平台数据库管理工具,支持 MySQL、PostgreSQL、SQLite、Redis、MongoDB、达梦等 100+ 数据库,提供桌面端、Docker、CLI、内置 AI 助手和 MCP。
TypeScript aicliclickhousedatabasedatabase-clientdatabase-managementdockerguimcpmongodbmysqlpostgresqlredisrustsql-serversqlitetaurivue
feat(sql-file): explain SQL file storage source in panel
zipg77458349557f
diff --git a/apps/desktop/src/components/layout/SqlFilePanel.vue b/apps/desktop/src/components/layout/SqlFilePanel.vueindex 6758a61846..27e16a628a 100644--- a/apps/desktop/src/components/layout/SqlFilePanel.vue+++ b/apps/desktop/src/components/layout/SqlFilePanel.vue@@ -7,6 +7,7 @@ import { Input } from "@/components/ui/input";import { Label } from "@/components/ui/label";import { Dialog, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle } from "@/components/ui/dialog";import LightTooltip from "@/components/ui/LightTooltip.vue";+import HelpTooltip from "@/components/ui/tooltip/HelpTooltip.vue";import CustomContextMenu, { type ContextMenuItem } from "@/components/ui/CustomContextMenu.vue";import { useQueryStore } from "@/stores/queryStore";import { useConnectionStore } from "@/stores/connectionStore";@@ -542,6 +543,9 @@ function clearContextTarget() {<div class="h-full flex flex-col overflow-hidden"><div class="h-9 flex items-center gap-1 px-2 border-b shrink-0 bg-muted/20"><span class="text-[13px] font-medium">{{ t("sqlFileTree.title") }}</span>+ <HelpTooltip :label="t('sqlFileTree.storageHelp')" side="bottom" :side-offset="4" trigger-class="h-4 w-4" content-class="max-w-[320px] whitespace-pre-line">+ {{ t("sqlFileTree.storageHelp") }}+ </HelpTooltip><span class="flex-1" /><LightTooltip :text="t('sqlFileTree.filterSettings')" side="bottom" :delay="0" :close-delay="0" nowrap><Buttondiff --git a/apps/desktop/src/components/layout/__tests__/SqlFilePanel.storageHelp.spec.ts b/apps/desktop/src/components/layout/__tests__/SqlFilePanel.storageHelp.spec.tsnew file mode 100644index 0000000000..0cd63d660e--- /dev/null+++ b/apps/desktop/src/components/layout/__tests__/SqlFilePanel.storageHelp.spec.ts@@ -0,0 +1,63 @@+// @vitest-environment happy-dom++import { createApp, nextTick, type App } from "vue";+import { createPinia, setActivePinia } from "pinia";+import { afterEach, describe, expect, it, vi } from "vitest";+import i18n from "@/i18n";++vi.mock("@/lib/sqlFile/sqlFileFolders", () => ({+ getSqlFileFilter: () => "",+ getSqlFileFolderPaths: () => [],+ saveSqlFileFilter: vi.fn(),+ saveSqlFileFolderPaths: vi.fn(),+ notifySqlFileFoldersChanged: vi.fn(),+}));+vi.mock("@/lib/backend/tauriRuntime", () => ({ isTauriRuntime: () => false }));++import SqlFilePanel from "../SqlFilePanel.vue";++const mounted: Array<{ app: App; host: HTMLElement }> = [];++function mountPanel() {+ setActivePinia(createPinia());+ const host = document.createElement("div");+ document.body.appendChild(host);+ const app = createApp(SqlFilePanel);+ app.use(i18n);+ app.mount(host);+ mounted.push({ app, host });+ return host;+}++afterEach(() => {+ for (const { app, host } of mounted.splice(0)) {+ app.unmount();+ host.remove();+ }+});++describe("SQL file panel storage help", () => {+ it("shows a help button next to the title", async () => {+ const host = mountPanel();+ await nextTick();++ const header = host.querySelector(".h-9");+ expect(header).not.toBeNull();++ const label = i18n.global.t("sqlFileTree.storageHelp");+ const helpButton = header!.querySelector<HTMLButtonElement>(`button[aria-label="${label}"]`);+ expect(helpButton).not.toBeNull();+ expect(helpButton!.querySelector("svg")).not.toBeNull();+ });++ it("keeps the help button directly after the panel title", async () => {+ const host = mountPanel();+ await nextTick();++ const header = host.querySelector(".h-9")!;+ const title = header.querySelector("span");+ expect(title?.textContent?.trim()).toBe(i18n.global.t("sqlFileTree.title"));+ const helpButton = title?.nextElementSibling?.querySelector<HTMLButtonElement>("button[aria-label]");+ expect(helpButton?.getAttribute("aria-label")).toBe(i18n.global.t("sqlFileTree.storageHelp"));+ });+});diff --git a/apps/desktop/src/i18n/__tests__/sqlFileTreeStorageHelpParity.spec.ts b/apps/desktop/src/i18n/__tests__/sqlFileTreeStorageHelpParity.spec.tsnew file mode 100644index 0000000000..c37d184c6b--- /dev/null+++ b/apps/desktop/src/i18n/__tests__/sqlFileTreeStorageHelpParity.spec.ts@@ -0,0 +1,61 @@+import { describe, expect, it } from "vitest";+import az from "../locales/az";+import en from "../locales/en";+import es from "../locales/es";+import it_ from "../locales/it";+import ja from "../locales/ja";+import ko from "../locales/ko";+import ptBR from "../locales/pt-BR";+import ru from "../locales/ru";+import tr from "../locales/tr";+import zhCN from "../locales/zh-CN";+import zhTW from "../locales/zh-TW";++// SQL 文件面板顶部的小问号说明这一侧的内容来源(磁盘上的 .sql 文件),+// SQL 库一侧已有自己的说明,所有语言都必须提供译文,避免回落到英文。+const KEY = "storageHelp";++const locales: Array<[string, Record<string, unknown>]> = [+ ["en", en as Record<string, unknown>],+ ["az", az as Record<string, unknown>],+ ["es", es],+ ["it", it_],+ ["ja", ja],+ ["ko", ko],+ ["pt-BR", ptBR],+ ["ru", ru],+ ["tr", tr],+ ["zh-CN", zhCN],+ ["zh-TW", zhTW],+];++function sqlFileTreeHelp(locale: Record<string, unknown>): unknown {+ const tree = locale.sqlFileTree;+ if (!tree || typeof tree !== "object") return undefined;+ return (tree as Record<string, unknown>)[KEY];+}++const englishHelp = sqlFileTreeHelp(en as Record<string, unknown>);++describe("SQL file panel storage help i18n messages", () => {+ it("en resolves sqlFileTree.storageHelp to text", () => {+ expect(englishHelp, "sqlFileTree.storageHelp missing from locales/en.ts").toBeTypeOf("string");+ });++ it("en explains that the panel lists real .sql files on disk", () => {+ expect(englishHelp).toContain(".sql");+ expect(englishHelp).toContain("Open Folder");+ });++ it.each(locales.slice(1))("%s translates sqlFileTree.storageHelp instead of using the English fallback", (_name, locale) => {+ const help = sqlFileTreeHelp(locale);+ expect(help, `${_name} sqlFileTree.storageHelp`).toBeTypeOf("string");+ expect(help, `${_name} sqlFileTree.storageHelp should not reuse the English text`).not.toBe(englishHelp);+ });++ it("zh-CN points at the Open Folder flow", () => {+ const help = sqlFileTreeHelp(zhCN as Record<string, unknown>) as string;+ expect(help).toContain("打开文件夹");+ expect(help).toContain(".sql");+ });+});diff --git a/apps/desktop/src/i18n/locales/az.ts b/apps/desktop/src/i18n/locales/az.tsindex 8131b1c57b..846db47a83 100644--- a/apps/desktop/src/i18n/locales/az.ts+++ b/apps/desktop/src/i18n/locales/az.ts@@ -6670,6 +6670,7 @@ export default withEnglishFallback({},sqlFileTree: {title: "SQL faylları",+ storageHelp: "Bunlar Qovluq aç ilə açılan diskdəki real .sql fayllarıdır; düzəlişlər birbaşa orijinal fayla yazılır.",openFolder: "Qovluq aç",closePanel: "Bağla",loading: "Yüklənir...",diff --git a/apps/desktop/src/i18n/locales/en.ts b/apps/desktop/src/i18n/locales/en.tsindex e2fbf3e42c..79b4b3f49f 100644--- a/apps/desktop/src/i18n/locales/en.ts+++ b/apps/desktop/src/i18n/locales/en.ts@@ -7409,6 +7409,7 @@ export default {},sqlFileTree: {title: "SQL Files",+ storageHelp: "These are the real .sql files on disk opened via Open Folder; edits are saved straight back to the original file.",openFolder: "Open Folder",closePanel: "Close",loading: "Loading...",diff --git a/apps/desktop/src/i18n/locales/es.ts b/apps/desktop/src/i18n/locales/es.tsindex 2b1dbc0b6b..79c738b84b 100644--- a/apps/desktop/src/i18n/locales/es.ts+++ b/apps/desktop/src/i18n/locales/es.ts@@ -9319,6 +9319,7 @@ export default withEnglishFallback({},sqlFileTree: {title: "Archivos SQL",+ storageHelp: "Son los archivos .sql reales del disco abiertos con Abrir carpeta; las ediciones se guardan directamente en el archivo original.",openFolder: "Abrir carpeta",closePanel: "Cerrar",loading: "Cargando...",diff --git a/apps/desktop/src/i18n/locales/it.ts b/apps/desktop/src/i18n/locales/it.tsindex 6052ec93aa..d3ecb0f469 100644--- a/apps/desktop/src/i18n/locales/it.ts+++ b/apps/desktop/src/i18n/locales/it.ts@@ -9244,6 +9244,7 @@ export default withEnglishFallback({},sqlFileTree: {title: "File SQL",+ storageHelp: "Sono i file .sql reali sul disco aperti con Apri cartella; le modifiche vengono salvate direttamente nel file originale.",openFolder: "Apri cartella",closePanel: "Chiudi",loading: "Caricamento in corso...",diff --git a/apps/desktop/src/i18n/locales/ja.ts b/apps/desktop/src/i18n/locales/ja.tsindex 7cd5fe51b7..1f6fa5e499 100644--- a/apps/desktop/src/i18n/locales/ja.ts+++ b/apps/desktop/src/i18n/locales/ja.ts@@ -9285,6 +9285,7 @@ export default withEnglishFallback({},sqlFileTree: {title: "SQL ファイル",+ storageHelp: "「フォルダを開く」で開いたディスク上の実際の.sqlファイルを表示し、編集内容は元のファイルに直接保存されます。",openFolder: "フォルダを開く",closePanel: "閉じる",loading: "読み込み中...",diff --git a/apps/desktop/src/i18n/locales/ko.ts b/apps/desktop/src/i18n/locales/ko.tsindex 4506d77e0d..41dda29e00 100644--- a/apps/desktop/src/i18n/locales/ko.ts+++ b/apps/desktop/src/i18n/locales/ko.ts@@ -6377,6 +6377,7 @@ export default withEnglishFallback({},sqlFileTree: {title: "SQL 파일",+ storageHelp: "폴더 열기로 연 디스크의 실제 .sql 파일을 표시하며, 편집 내용은 원본 파일에 바로 저장됩니다.",openFolder: "폴더 열기",closePanel: "닫기",loading: "불러오는 중...",diff --git a/apps/desktop/src/i18n/locales/pt-BR.ts b/apps/desktop/src/i18n/locales/pt-BR.tsindex 92036aa4ef..c304bb1e22 100644--- a/apps/desktop/src/i18n/locales/pt-BR.ts+++ b/apps/desktop/src/i18n/locales/pt-BR.ts@@ -9244,6 +9244,7 @@ export default withEnglishFallback({},sqlFileTree: {title: "Arquivos SQL",+ storageHelp: "São os arquivos .sql reais no disco abertos com Abrir pasta; as edições são salvas diretamente no arquivo original.",openFolder: "Abrir pasta",closePanel: "Fechar",loading: "Carregando...",diff --git a/apps/desktop/src/i18n/locales/ru.ts b/apps/desktop/src/i18n/locales/ru.tsindex cec950a856..217e709aa6 100644--- a/apps/desktop/src/i18n/locales/ru.ts+++ b/apps/desktop/src/i18n/locales/ru.ts@@ -7822,6 +7822,7 @@ export default withEnglishFallback({},sqlFileTree: {title: "SQL-файлы",+ storageHelp: "Это реальные .sql-файлы на диске, открытые через «Открыть папку»; изменения сохраняются прямо в исходный файл.",openFolder: "Открыть папку",closePanel: "Закрыть",loading: "Загрузка...",diff --git a/apps/desktop/src/i18n/locales/tr.ts b/apps/desktop/src/i18n/locales/tr.tsindex b75bf40752..677fcff419 100644--- a/apps/desktop/src/i18n/locales/tr.ts+++ b/apps/desktop/src/i18n/locales/tr.ts@@ -6552,6 +6552,7 @@ export default withEnglishFallback({},sqlFileTree: {title: "SQL Dosyaları",+ storageHelp: "Klasör Aç ile açılan diskteki gerçek .sql dosyalarıdır; düzenlemeler doğrudan özgün dosyaya kaydedilir.",openFolder: "Klasör Aç",closePanel: "Kapat",loading: "Yükleniyor...",diff --git a/apps/desktop/src/i18n/locales/zh-CN.ts b/apps/desktop/src/i18n/locales/zh-CN.tsindex 684eb93a64..28171a05af 100644--- a/apps/desktop/src/i18n/locales/zh-CN.ts+++ b/apps/desktop/src/i18n/locales/zh-CN.ts@@ -7376,6 +7376,7 @@ export default withEnglishFallback({},sqlFileTree: {title: "SQL 文件",+ storageHelp: "此处列出通过「打开文件夹」打开的磁盘上真实 .sql 文件,编辑后直接保存回原文件。",openFolder: "打开文件夹",closePanel: "关闭",loading: "加载中...",diff --git a/apps/desktop/src/i18n/locales/zh-TW.ts b/apps/desktop/src/i18n/locales/zh-TW.tsindex 9abe307db9..783266ac98 100644--- a/apps/desktop/src/i18n/locales/zh-TW.ts+++ b/apps/desktop/src/i18n/locales/zh-TW.ts@@ -9251,6 +9251,7 @@ export default withEnglishFallback({},sqlFileTree: {title: "SQL 檔案",+ storageHelp: "此處列出透過「開啟資料夾」開啟的磁碟上真實 .sql 檔案,編輯後直接儲存回原檔案。",openFolder: "開啟資料夾",closePanel: "關閉",loading: "載入中...",diff --git a/docs/screenshots/issue-5091-sql-file-panel-help-tooltip.png b/docs/screenshots/issue-5091-sql-file-panel-help-tooltip.pngnew file mode 100644index 0000000000..50fb819144Binary files /dev/null and b/docs/screenshots/issue-5091-sql-file-panel-help-tooltip.png differ