From 65db95bfaa72c756d6a8c3154831e1fda05a26df Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Sun, 7 Jun 2026 23:17:11 +0800
Subject: [PATCH 01/25] =?UTF-8?q?feat:=20AI=20=E8=87=AA=E7=84=B6=E8=AF=AD?=
 =?UTF-8?q?=E8=A8=80=E7=94=9F=E6=88=90=20SQL?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 新增 AiSql: SQL 编辑器头部「AI」入口, 输入自然语言生成 SQL
- 自动附带当前数据源结构(表+字段)作上下文, 复用 ai_chat 命令与已配置的 AI 服务商
- 结果去除 Markdown 围栏后插入到编辑器光标处; ⌘/Ctrl+↵ 快捷生成
- 未配置 API Key 时友好提示
---
 src/App.vue              |   3 +
 src/components/AiSql.vue | 152 +++++++++++++++++++++++++++++++++++++++
 2 files changed, 155 insertions(+)
 create mode 100644 src/components/AiSql.vue

diff --git a/src/App.vue b/src/App.vue
index c2ef41e..9422104 100644
--- a/src/App.vue
+++ b/src/App.vue
@@ -91,6 +91,7 @@
                   </span>
                   <SqlSourceSelect v-if="currentLanguage === 'sql'" class="flex-shrink-0"/>
                   <SchemaBrowser v-if="currentLanguage === 'sql'" class="flex-shrink-0" @preview="previewTable" @insert="insertAtCursor"/>
+                  <AiSql v-if="currentLanguage === 'sql'" class="flex-shrink-0" @generated="insertAtCursor"/>
                 </div>
 
                 <div class="flex items-center space-x-2 text-xs text-gray-500 whitespace-nowrap flex-shrink-0 pl-3">
@@ -217,6 +218,7 @@
             </span>
             <SqlSourceSelect v-if="currentLanguage === 'sql'" class="flex-shrink-0"/>
             <SchemaBrowser v-if="currentLanguage === 'sql'" class="flex-shrink-0" @preview="previewTable" @insert="insertAtCursor"/>
+                  <AiSql v-if="currentLanguage === 'sql'" class="flex-shrink-0" @generated="insertAtCursor"/>
           </div>
 
           <div class="flex items-center space-x-2 text-xs text-gray-500 whitespace-nowrap flex-shrink-0 pl-3">
@@ -372,6 +374,7 @@ import SqlTableView from "./components/SqlTableView.vue";
 import DataTableView from "./components/DataTableView.vue";
 import SqlSourceSelect from "./components/SqlSourceSelect.vue";
 import SchemaBrowser from "./components/SchemaBrowser.vue";
+import AiSql from "./components/AiSql.vue";
 import StatusBar from './components/StatusBar.vue'
 import About from './components/About.vue'
 import Settings from './components/Settings.vue'
diff --git a/src/components/AiSql.vue b/src/components/AiSql.vue
new file mode 100644
index 0000000..00b7b6d
--- /dev/null
+++ b/src/components/AiSql.vue
@@ -0,0 +1,152 @@
+<template>
+  <div class="inline-block">
+    <button ref="btnRef" class="inline-flex items-center gap-1 px-2 py-0.5 rounded text-xs text-violet-500 hover:bg-violet-50 dark:hover:bg-violet-900/30 cursor-pointer"
+            title="用自然语言生成 SQL" @click="toggle">
+      <Sparkles class="w-3.5 h-3.5"/>
+      <span>AI</span>
+    </button>
+
+    <Teleport to="body">
+      <template v-if="open">
+        <div class="fixed inset-0 z-[60]" @click="open = false"/>
+        <div class="fixed z-[61] w-80 p-3 rounded-md border border-gray-200 dark:border-gray-700 bg-white dark:bg-gray-800 shadow-lg text-xs"
+             :style="{left: pos.left + 'px', top: pos.top + 'px'}">
+          <div class="flex items-center gap-1 mb-2 text-gray-600 dark:text-gray-300 font-medium">
+            <Sparkles class="w-3.5 h-3.5 text-violet-500"/>自然语言生成 SQL
+            <span class="ml-auto text-[10px] text-gray-400">{{ active.model }}</span>
+          </div>
+          <textarea v-model="prompt" rows="3" :disabled="loading"
+                    placeholder="描述你想查询的内容，例如：统计每天的注册用户数，按日期倒序"
+                    class="w-full px-2 py-1.5 rounded border border-gray-200 dark:border-gray-700 bg-gray-50 dark:bg-gray-900 text-gray-700 dark:text-gray-200 resize-none focus:outline-none focus:border-violet-400"
+                    @keydown.meta.enter="generate" @keydown.ctrl.enter="generate"/>
+          <div v-if="error" class="mt-1 text-red-500 whitespace-pre-wrap">{{ error }}</div>
+          <div class="mt-2 flex items-center justify-between">
+            <span class="text-[10px] text-gray-400">{{ schemaNote }}</span>
+            <button class="inline-flex items-center gap-1 px-3 py-1 rounded bg-violet-500 text-white hover:bg-violet-600 disabled:opacity-50 cursor-pointer"
+                    :disabled="loading || !prompt.trim()" @click="generate">
+              <RefreshCw v-if="loading" class="w-3 h-3 animate-spin"/>
+              <Sparkles v-else class="w-3 h-3"/>
+              {{ loading ? '生成中…' : '生成 (⌘↵)' }}
+            </button>
+          </div>
+        </div>
+      </template>
+    </Teleport>
+  </div>
+</template>
+
+<script setup lang="ts">
+import {ref} from 'vue'
+import {invoke} from '@tauri-apps/api/core'
+import {RefreshCw, Sparkles} from 'lucide-vue-next'
+import {useAiConfig} from '../composables/useAiConfig'
+import {useDbConnections} from '../composables/useDbConnections'
+
+const emit = defineEmits<{ generated: [sql: string] }>()
+
+const {active} = useAiConfig()
+const {resolveActiveSource} = useDbConnections()
+
+const open = ref(false)
+const btnRef = ref<HTMLElement>()
+const pos = ref({left: 0, top: 0})
+const prompt = ref('')
+const loading = ref(false)
+const error = ref('')
+const schemaNote = ref('')
+
+const toggle = () => {
+  open.value = !open.value
+  if (open.value) {
+    const r = btnRef.value?.getBoundingClientRect()
+    if (r) {
+      pos.value = {left: Math.max(8, Math.min(r.left, window.innerWidth - 328)), top: r.bottom + 4}
+    }
+    error.value = ''
+  }
+}
+
+const introspectSql = (kind: string): string => {
+  if (kind === 'mysql') {
+    return 'SELECT table_name AS t, column_name AS c, column_type AS ty '
+      + 'FROM information_schema.columns WHERE table_schema = DATABASE() '
+      + 'ORDER BY table_name, ordinal_position'
+  }
+  return 'SELECT m.name AS t, p.name AS c, p.type AS ty '
+    + 'FROM sqlite_master m JOIN pragma_table_info(m.name) p '
+    + "WHERE m.type IN ('table','view') AND m.name NOT LIKE 'sqlite\\_%' ESCAPE '\\' "
+    + 'ORDER BY m.name, p.cid'
+}
+
+// 拉取结构，拼成紧凑文本作为上下文（限表数避免超长）
+const fetchSchema = async (source: any): Promise<string> => {
+  try {
+    const res = await invoke<any>('run_sql', {sql: introspectSql(source.kind), source})
+    if (res.error) {
+      return ''
+    }
+    const rows = (res.result_sets || [])[0]?.rows || []
+    const map = new Map<string, string[]>()
+    for (const r of rows) {
+      const t = String(r[0])
+      if (!map.has(t)) {
+        map.set(t, [])
+      }
+      map.get(t)!.push(`${r[1]} ${r[2] ?? ''}`.trim())
+    }
+    const tables = [...map.entries()].slice(0, 60)
+    return tables.map(([t, cols]) => `${t}(${cols.join(', ')})`).join('\n')
+  }
+  catch {
+    return ''
+  }
+}
+
+const stripFences = (s: string): string => {
+  return s.trim().replace(/^```(?:sql)?\s*/i, '').replace(/```$/i, '').trim()
+}
+
+const generate = async () => {
+  if (loading.value || !prompt.value.trim()) {
+    return
+  }
+  if (!active.value.apiKey?.trim()) {
+    error.value = '未配置 AI API Key，请在设置 → AI 中填写'
+    return
+  }
+  loading.value = true
+  error.value = ''
+  try {
+    const source = resolveActiveSource()
+    const dialect = source.kind === 'mysql' ? 'MySQL' : 'SQLite'
+    schemaNote.value = '读取结构中…'
+    const schema = await fetchSchema(source)
+    schemaNote.value = schema ? '已附带数据库结构' : '未读取到结构'
+    const system = `你是资深数据库工程师。根据「数据库结构」和用户需求，生成可直接执行的 ${dialect} SQL。`
+      + '要求：只输出 SQL 本身，不要任何解释，不要使用 Markdown 代码块标记。\n'
+      + `数据库结构：\n${schema || '(未提供，请根据需求合理假设表名与字段名)'}`
+    const text = await invoke<string>('ai_chat', {
+      provider: active.value.provider,
+      baseUrl: active.value.baseUrl,
+      apiKey: active.value.apiKey,
+      model: active.value.model,
+      system,
+      messages: [{role: 'user', content: prompt.value.trim()}]
+    })
+    const sql = stripFences(text)
+    if (!sql) {
+      error.value = 'AI 未返回内容'
+      return
+    }
+    emit('generated', sql)
+    open.value = false
+    prompt.value = ''
+  }
+  catch (e: any) {
+    error.value = String(e?.message || e)
+  }
+  finally {
+    loading.value = false
+  }
+}
+</script>

From 52341f7a8a89339381535dcb18f77399ea9945f2 Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Sun, 7 Jun 2026 23:21:37 +0800
Subject: [PATCH 02/25] =?UTF-8?q?feat:=20AI=20=E8=87=AA=E7=84=B6=E8=AF=AD?=
 =?UTF-8?q?=E8=A8=80=E9=85=8D=E5=9B=BE?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- ChartPanel 增加「AI 配图」: 描述需求, AI 返回图表配置 JSON 并自动应用
- 以可用列(名+类型)与支持的图表类型作上下文, 复用 ai_chat
- 解析后设置图表类型/维度/指标/聚合(散点映射 X/Y/分组), 字段按列名校验
- ⌘/Ctrl+↵ 生成; 未配置 Key 友好提示
---
 src/components/charts/ChartPanel.vue | 92 +++++++++++++++++++++++++++-
 1 file changed, 90 insertions(+), 2 deletions(-)

diff --git a/src/components/charts/ChartPanel.vue b/src/components/charts/ChartPanel.vue
index 85c44e0..15e3624 100644
--- a/src/components/charts/ChartPanel.vue
+++ b/src/components/charts/ChartPanel.vue
@@ -4,8 +4,28 @@
     <div class="w-56 flex-shrink-0 border-r border-gray-200 dark:border-gray-700 flex flex-col min-h-0 h-full bg-gray-50 dark:bg-gray-800/40 overflow-y-auto">
       <!-- 图表类型 -->
       <div class="px-3 py-2 border-b border-gray-200 dark:border-gray-700">
-        <div class="text-[11px] text-gray-400 mb-1">图表类型</div>
+        <div class="flex items-center justify-between mb-1">
+          <span class="text-[11px] text-gray-400">图表类型</span>
+          <button class="inline-flex items-center gap-1 px-1.5 py-0.5 rounded text-[11px] text-violet-500 hover:bg-violet-50 dark:hover:bg-violet-900/30 cursor-pointer" title="用自然语言配图" @click="toggleAi">
+            <Sparkles class="w-3 h-3"/>AI 配图
+          </button>
+        </div>
         <Select v-model="chartType" :options="chartTypes" searchable :button-classes="['!py-1', '!px-2.5', 'text-xs', '!rounded-md']"/>
+        <div v-if="aiOpen" class="mt-2 p-2 rounded border border-violet-200 dark:border-violet-800 bg-violet-50/40 dark:bg-violet-900/10">
+          <textarea v-model="aiPrompt" rows="2" :disabled="aiLoading"
+                    placeholder="例如：按状态统计数量，用饼图"
+                    class="w-full px-2 py-1 text-[11px] rounded border border-gray-200 dark:border-gray-700 bg-white dark:bg-gray-900 text-gray-700 dark:text-gray-200 resize-none focus:outline-none focus:border-violet-400"
+                    @keydown.meta.enter="aiGenerate" @keydown.ctrl.enter="aiGenerate"/>
+          <div v-if="aiError" class="mt-1 text-[10px] text-red-500 whitespace-pre-wrap">{{ aiError }}</div>
+          <div class="mt-1.5 flex justify-end">
+            <button class="inline-flex items-center gap-1 px-2.5 py-0.5 rounded bg-violet-500 text-white text-[11px] hover:bg-violet-600 disabled:opacity-50 cursor-pointer"
+                    :disabled="aiLoading || !aiPrompt.trim()" @click="aiGenerate">
+              <RefreshCw v-if="aiLoading" class="w-3 h-3 animate-spin"/>
+              <Sparkles v-else class="w-3 h-3"/>
+              {{ aiLoading ? '生成中…' : '生成' }}
+            </button>
+          </div>
+        </div>
       </div>
 
       <!-- 可用字段 -->
@@ -177,9 +197,11 @@ import {computed, ref, watch} from 'vue'
 import {debounce} from 'lodash-es'
 import * as echarts from 'echarts/core'
 import {SVGRenderer} from 'echarts/renderers'
-import {BarChart3, Copy, Download, FileDown, Image as ImageIcon, Hash, Type, X} from 'lucide-vue-next'
+import {invoke} from '@tauri-apps/api/core'
+import {BarChart3, Copy, Download, FileDown, Image as ImageIcon, Hash, RefreshCw, Sparkles, Type, X} from 'lucide-vue-next'
 import {useTheme} from '../../composables/useTheme'
 import {kvGetJSON, kvSetJSON} from '../../composables/useKvStore'
+import {useAiConfig} from '../../composables/useAiConfig'
 import {useToast} from '../../plugins/toast'
 import {downloadCsv} from '../../utils/csv'
 import Select from '../../ui/Select.vue'
@@ -441,6 +463,72 @@ const runExport = (fn: () => void) => {
 
 const fields = computed(() => props.columns.map((name, i) => ({name, numeric: isNumericColumn(props.rows, i)})))
 
+// ---- AI 配图：自然语言 → 图表配置 ----
+const {active: aiActive} = useAiConfig()
+const aiOpen = ref(false)
+const aiPrompt = ref('')
+const aiLoading = ref(false)
+const aiError = ref('')
+const toggleAi = () => {
+  aiOpen.value = !aiOpen.value
+  aiError.value = ''
+}
+const aiGenerate = async () => {
+  if (aiLoading.value || !aiPrompt.value.trim()) {
+    return
+  }
+  if (!aiActive.value.apiKey?.trim()) {
+    aiError.value = '未配置 AI API Key（设置 → AI）'
+    return
+  }
+  aiLoading.value = true
+  aiError.value = ''
+  try {
+    const cols = fields.value.map(f => `${f.name}:${f.numeric ? 'number' : 'text'}`).join(', ')
+    const types = Object.keys(CHART_META).join(', ')
+    const system = '你是数据可视化助手。根据可用列与用户需求，输出图表配置 JSON。\n'
+      + `可用列(name:type): ${cols}\n`
+      + `支持的图表类型(value): ${types}\n`
+      + '严格输出 JSON：{"chartType":"...","dimensions":["列名"],"metrics":["列名"],"agg":"sum|count|avg|max|min"}。'
+      + '只输出 JSON，不要解释或 Markdown。维度/指标必须使用上面的列名。'
+    const text = await invoke<string>('ai_chat', {
+      provider: aiActive.value.provider,
+      baseUrl: aiActive.value.baseUrl,
+      apiKey: aiActive.value.apiKey,
+      model: aiActive.value.model,
+      system,
+      messages: [{role: 'user', content: aiPrompt.value.trim()}]
+    })
+    const cleaned = text.trim().replace(/^```(?:json)?\s*/i, '').replace(/```$/i, '').trim()
+    const cfg = JSON.parse(cleaned)
+    if (cfg.chartType && CHART_META[cfg.chartType]) {
+      chartType.value = cfg.chartType
+    }
+    const dims = Array.isArray(cfg.dimensions) ? cfg.dimensions.filter((d: string) => props.columns.includes(d)) : []
+    const mets = Array.isArray(cfg.metrics) ? cfg.metrics.filter((m: string) => props.columns.includes(m)) : []
+    if (cfg.agg && (cfg.agg in AGG_LABELS)) {
+      agg.value = cfg.agg
+    }
+    if (meta.value.layout === 'scatter') {
+      xField.value = mets[0] || dims[0] || ''
+      yField.value = mets[1] || ''
+      groupField.value = dims[0] || ''
+    }
+    else {
+      dimensions.value = dims
+      metrics.value = mets
+    }
+    aiOpen.value = false
+    aiPrompt.value = ''
+  }
+  catch (e: any) {
+    aiError.value = 'AI 返回无法解析或出错：' + String(e?.message || e)
+  }
+  finally {
+    aiLoading.value = false
+  }
+}
+
 // 列变化（新查询）时，剔除已不存在的字段
 watch(() => props.columns, (cols) => {
   dimensions.value = dimensions.value.filter(d => cols.includes(d))

From 879289c564fc5bc9c90431dcf546eb7df47da0a4 Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Sun, 7 Jun 2026 23:26:05 +0800
Subject: [PATCH 03/25] =?UTF-8?q?feat:=20=E7=BB=93=E6=9E=84=E6=B5=8F?=
 =?UTF-8?q?=E8=A7=88=E5=99=A8=E6=94=AF=E6=8C=81=E5=A4=8D=E5=88=B6=E5=BB=BA?=
 =?UTF-8?q?=E8=A1=A8=20DDL?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 每张表新增「复制建表语句」: MySQL 用 SHOW CREATE TABLE, SQLite 取 sqlite_master.sql
- 复制到剪贴板并提示; 兼容库限定(库.表)
---
 src/components/SchemaBrowser.vue | 32 +++++++++++++++++++++++++++++++-
 1 file changed, 31 insertions(+), 1 deletion(-)

diff --git a/src/components/SchemaBrowser.vue b/src/components/SchemaBrowser.vue
index 3ab0241..d05dc2f 100644
--- a/src/components/SchemaBrowser.vue
+++ b/src/components/SchemaBrowser.vue
@@ -45,6 +45,9 @@
                     <Table2 class="w-3 h-3 text-blue-500 flex-shrink-0"/>
                     <span class="flex-1 truncate text-gray-700 dark:text-gray-200" :title="t.name" @click.stop="emit('insert', t.name)">{{ t.name }}</span>
                     <span class="text-[10px] text-gray-400">{{ t.columns.length }}</span>
+                    <button class="opacity-0 group-hover:opacity-100 p-0.5 rounded text-gray-400 hover:text-violet-500 cursor-pointer" title="复制建表语句" @click.stop="copyDdl(t.name, db.name)">
+                      <Copy class="w-3 h-3"/>
+                    </button>
                     <button class="opacity-0 group-hover:opacity-100 p-0.5 rounded text-gray-400 hover:text-blue-500 cursor-pointer" title="预览前 100 行" @click.stop="preview(t.name, db.name)">
                       <Play class="w-3 h-3"/>
                     </button>
@@ -69,6 +72,9 @@
                 <Table2 class="w-3 h-3 text-blue-500 flex-shrink-0"/>
                 <span class="flex-1 truncate text-gray-700 dark:text-gray-200" :title="t.name" @click.stop="emit('insert', t.name)">{{ t.name }}</span>
                 <span class="text-[10px] text-gray-400">{{ t.columns.length }}</span>
+                <button class="opacity-0 group-hover:opacity-100 p-0.5 rounded text-gray-400 hover:text-violet-500 cursor-pointer" title="复制建表语句" @click.stop="copyDdl(t.name)">
+                  <Copy class="w-3 h-3"/>
+                </button>
                 <button class="opacity-0 group-hover:opacity-100 p-0.5 rounded text-gray-400 hover:text-blue-500 cursor-pointer" title="预览前 100 行" @click.stop="preview(t.name)">
                   <Play class="w-3 h-3"/>
                 </button>
@@ -90,10 +96,12 @@
 <script setup lang="ts">
 import {computed, ref, watch} from 'vue'
 import {invoke} from '@tauri-apps/api/core'
-import {ChevronRight, Database, Play, RefreshCw, Table2} from 'lucide-vue-next'
+import {ChevronRight, Copy, Database, Play, RefreshCw, Table2} from 'lucide-vue-next'
 import {useDbConnections} from '../composables/useDbConnections'
+import {useToast} from '../plugins/toast'
 
 const emit = defineEmits<{ insert: [text: string]; preview: [sql: string] }>()
+const toast = useToast()
 
 const {resolveActiveSource, activeRef, activeLabel} = useDbConnections()
 
@@ -228,6 +236,28 @@ const preview = (name: string, db?: string) => {
   open.value = false
 }
 
+const copyDdl = async (name: string, db?: string) => {
+  try {
+    const source = resolveActiveSource()
+    const qualified = db ? `${quote(source.kind, db)}.${quote(source.kind, name)}` : quote(source.kind, name)
+    const sql = source.kind === 'mysql'
+      ? `SHOW CREATE TABLE ${qualified}`
+      : `SELECT sql FROM sqlite_master WHERE name = '${esc(name)}'`
+    const rows = await runRows(sql)
+    // MySQL: 第 2 列为建表语句；SQLite: 第 1 列
+    const ddl = String((source.kind === 'mysql' ? rows[0]?.[1] : rows[0]?.[0]) ?? '')
+    if (!ddl) {
+      toast.error('未获取到建表语句')
+      return
+    }
+    await navigator.clipboard.writeText(ddl.endsWith(';') ? ddl : ddl + ';')
+    toast.success(`已复制 ${name} 的建表语句`)
+  }
+  catch (e: any) {
+    toast.error('复制失败：' + String(e?.message || e))
+  }
+}
+
 const toggle = () => {
   open.value = !open.value
   if (open.value) {

From bb72e16bace0c03fe0232fb26cac0a51f4f77c3f Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Sun, 7 Jun 2026 23:29:04 +0800
Subject: [PATCH 04/25] =?UTF-8?q?feat:=20=E7=BB=93=E6=9E=84=E6=B5=8F?=
 =?UTF-8?q?=E8=A7=88=E5=99=A8=E6=94=AF=E6=8C=81=E6=95=B4=E8=A1=A8=E5=AF=BC?=
 =?UTF-8?q?=E5=87=BA=20CSV?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 每张表新增「导出 CSV」: 运行 SELECT *(上限 10 万行)并下载
- 复用 downloadCsv(带 BOM); 兼容库限定与 MySQL/SQLite
---
 src/components/SchemaBrowser.vue | 31 ++++++++++++++++++++++++++++++-
 1 file changed, 30 insertions(+), 1 deletion(-)

diff --git a/src/components/SchemaBrowser.vue b/src/components/SchemaBrowser.vue
index d05dc2f..dc977de 100644
--- a/src/components/SchemaBrowser.vue
+++ b/src/components/SchemaBrowser.vue
@@ -48,6 +48,9 @@
                     <button class="opacity-0 group-hover:opacity-100 p-0.5 rounded text-gray-400 hover:text-violet-500 cursor-pointer" title="复制建表语句" @click.stop="copyDdl(t.name, db.name)">
                       <Copy class="w-3 h-3"/>
                     </button>
+                    <button class="opacity-0 group-hover:opacity-100 p-0.5 rounded text-gray-400 hover:text-emerald-500 cursor-pointer" title="导出 CSV" @click.stop="exportCsv(t.name, db.name)">
+                      <FileDown class="w-3 h-3"/>
+                    </button>
                     <button class="opacity-0 group-hover:opacity-100 p-0.5 rounded text-gray-400 hover:text-blue-500 cursor-pointer" title="预览前 100 行" @click.stop="preview(t.name, db.name)">
                       <Play class="w-3 h-3"/>
                     </button>
@@ -75,6 +78,9 @@
                 <button class="opacity-0 group-hover:opacity-100 p-0.5 rounded text-gray-400 hover:text-violet-500 cursor-pointer" title="复制建表语句" @click.stop="copyDdl(t.name)">
                   <Copy class="w-3 h-3"/>
                 </button>
+                <button class="opacity-0 group-hover:opacity-100 p-0.5 rounded text-gray-400 hover:text-emerald-500 cursor-pointer" title="导出 CSV" @click.stop="exportCsv(t.name)">
+                  <FileDown class="w-3 h-3"/>
+                </button>
                 <button class="opacity-0 group-hover:opacity-100 p-0.5 rounded text-gray-400 hover:text-blue-500 cursor-pointer" title="预览前 100 行" @click.stop="preview(t.name)">
                   <Play class="w-3 h-3"/>
                 </button>
@@ -96,9 +102,10 @@
 <script setup lang="ts">
 import {computed, ref, watch} from 'vue'
 import {invoke} from '@tauri-apps/api/core'
-import {ChevronRight, Copy, Database, Play, RefreshCw, Table2} from 'lucide-vue-next'
+import {ChevronRight, Copy, Database, FileDown, Play, RefreshCw, Table2} from 'lucide-vue-next'
 import {useDbConnections} from '../composables/useDbConnections'
 import {useToast} from '../plugins/toast'
+import {downloadCsv} from '../utils/csv'
 
 const emit = defineEmits<{ insert: [text: string]; preview: [sql: string] }>()
 const toast = useToast()
@@ -236,6 +243,28 @@ const preview = (name: string, db?: string) => {
   open.value = false
 }
 
+const exportCsv = async (name: string, db?: string) => {
+  try {
+    const source = resolveActiveSource()
+    const qualified = db ? `${quote(source.kind, db)}.${quote(source.kind, name)}` : quote(source.kind, name)
+    const res = await invoke<any>('run_sql', {sql: `SELECT * FROM ${qualified} LIMIT 100000`, source})
+    if (res.error) {
+      toast.error(res.error)
+      return
+    }
+    const rs = (res.result_sets || [])[0]
+    if (!rs || rs.columns.length === 0) {
+      toast.error('无数据可导出')
+      return
+    }
+    downloadCsv(rs.columns, rs.rows, `${name}-${Date.now()}.csv`)
+    toast.success(`已导出 ${rs.rows.length} 行`)
+  }
+  catch (e: any) {
+    toast.error('导出失败：' + String(e?.message || e))
+  }
+}
+
 const copyDdl = async (name: string, db?: string) => {
   try {
     const source = resolveActiveSource()

From 1f607f1202db1475c484ec9dcee3d92682a5d464 Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Sun, 7 Jun 2026 23:31:35 +0800
Subject: [PATCH 05/25] =?UTF-8?q?feat:=20=E5=9B=BE=E8=A1=A8=E9=85=8D?=
 =?UTF-8?q?=E7=BD=AE=E5=91=BD=E5=90=8D=E9=A2=84=E8=AE=BE?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 图表配置可「存预设」(命名)并以标签列表一键套用、删除
- 预设存入 KV(数据库), 套用时字段按当前结果列过滤
- 抽出 buildConfig/applyConfig, 与上次配置持久化共用
---
 src/components/charts/ChartPanel.vue | 110 +++++++++++++++++++++------
 1 file changed, 87 insertions(+), 23 deletions(-)

diff --git a/src/components/charts/ChartPanel.vue b/src/components/charts/ChartPanel.vue
index 15e3624..4e72bff 100644
--- a/src/components/charts/ChartPanel.vue
+++ b/src/components/charts/ChartPanel.vue
@@ -6,11 +6,25 @@
       <div class="px-3 py-2 border-b border-gray-200 dark:border-gray-700">
         <div class="flex items-center justify-between mb-1">
           <span class="text-[11px] text-gray-400">图表类型</span>
-          <button class="inline-flex items-center gap-1 px-1.5 py-0.5 rounded text-[11px] text-violet-500 hover:bg-violet-50 dark:hover:bg-violet-900/30 cursor-pointer" title="用自然语言配图" @click="toggleAi">
-            <Sparkles class="w-3 h-3"/>AI 配图
-          </button>
+          <div class="flex items-center gap-1">
+            <button class="inline-flex items-center gap-1 px-1.5 py-0.5 rounded text-[11px] text-gray-500 hover:bg-gray-100 dark:hover:bg-gray-700 cursor-pointer" title="保存为预设" @click="savePreset">
+              <Star class="w-3 h-3"/>存预设
+            </button>
+            <button class="inline-flex items-center gap-1 px-1.5 py-0.5 rounded text-[11px] text-violet-500 hover:bg-violet-50 dark:hover:bg-violet-900/30 cursor-pointer" title="用自然语言配图" @click="toggleAi">
+              <Sparkles class="w-3 h-3"/>AI 配图
+            </button>
+          </div>
         </div>
         <Select v-model="chartType" :options="chartTypes" searchable :button-classes="['!py-1', '!px-2.5', 'text-xs', '!rounded-md']"/>
+        <!-- 预设列表 -->
+        <div v-if="presets.length" class="mt-1.5 flex flex-wrap gap-1">
+          <span v-for="p in presets" :key="p.name"
+                class="group inline-flex items-center gap-1 px-1.5 py-0.5 rounded text-[10px] bg-gray-100 dark:bg-gray-700 text-gray-600 dark:text-gray-300 cursor-pointer hover:bg-blue-100 dark:hover:bg-blue-900/40"
+                :title="`套用预设：${p.name}`" @click="applyPreset(p.name)">
+            {{ p.name }}
+            <X class="w-2.5 h-2.5 opacity-0 group-hover:opacity-100 hover:text-red-500" @click.stop="deletePreset(p.name)"/>
+          </span>
+        </div>
         <div v-if="aiOpen" class="mt-2 p-2 rounded border border-violet-200 dark:border-violet-800 bg-violet-50/40 dark:bg-violet-900/10">
           <textarea v-model="aiPrompt" rows="2" :disabled="aiLoading"
                     placeholder="例如：按状态统计数量，用饼图"
@@ -198,7 +212,7 @@ import {debounce} from 'lodash-es'
 import * as echarts from 'echarts/core'
 import {SVGRenderer} from 'echarts/renderers'
 import {invoke} from '@tauri-apps/api/core'
-import {BarChart3, Copy, Download, FileDown, Image as ImageIcon, Hash, RefreshCw, Sparkles, Type, X} from 'lucide-vue-next'
+import {BarChart3, Copy, Download, FileDown, Image as ImageIcon, Hash, RefreshCw, Sparkles, Star, Type, X} from 'lucide-vue-next'
 import {useTheme} from '../../composables/useTheme'
 import {kvGetJSON, kvSetJSON} from '../../composables/useKvStore'
 import {useAiConfig} from '../../composables/useAiConfig'
@@ -359,28 +373,78 @@ if (typeof saved.radarFill === 'boolean') {
   radarFill.value = saved.radarFill
 }
 
-const persist = debounce(() => {
-  kvSetJSON(CFG_KEY, {
-    chartType: chartType.value,
-    agg: agg.value,
-    sortOrder: sortOrder.value,
-    topN: topN.value,
-    dimensions: dimensions.value,
-    metrics: metrics.value,
-    xField: xField.value,
-    yField: yField.value,
-    groupField: groupField.value,
-    horizontal: horizontal.value,
-    stacked: stacked.value,
-    smooth: smooth.value,
-    ring: ring.value,
-    radarFill: radarFill.value,
-    showLabel: showLabel.value
-  })
-}, 300)
+const buildConfig = () => ({
+  chartType: chartType.value,
+  agg: agg.value,
+  sortOrder: sortOrder.value,
+  topN: topN.value,
+  dimensions: dimensions.value,
+  metrics: metrics.value,
+  xField: xField.value,
+  yField: yField.value,
+  groupField: groupField.value,
+  horizontal: horizontal.value,
+  stacked: stacked.value,
+  smooth: smooth.value,
+  ring: ring.value,
+  radarFill: radarFill.value,
+  showLabel: showLabel.value
+})
+// 套用配置（字段按当前列过滤）
+const applyConfig = (cfg: Record<string, any>) => {
+  if (cfg.chartType && CHART_META[cfg.chartType]) {
+    chartType.value = cfg.chartType
+  }
+  if (cfg.agg) {
+    agg.value = cfg.agg
+  }
+  if (cfg.sortOrder) {
+    sortOrder.value = cfg.sortOrder
+  }
+  if (typeof cfg.topN === 'number') {
+    topN.value = cfg.topN
+  }
+  dimensions.value = Array.isArray(cfg.dimensions) ? cfg.dimensions.filter((d: string) => props.columns.includes(d)) : []
+  metrics.value = Array.isArray(cfg.metrics) ? cfg.metrics.filter((m: string) => props.columns.includes(m)) : []
+  xField.value = cfg.xField && props.columns.includes(cfg.xField) ? cfg.xField : ''
+  yField.value = cfg.yField && props.columns.includes(cfg.yField) ? cfg.yField : ''
+  groupField.value = cfg.groupField && props.columns.includes(cfg.groupField) ? cfg.groupField : ''
+  for (const k of ['horizontal', 'stacked', 'smooth', 'ring', 'radarFill', 'showLabel'] as const) {
+    if (typeof cfg[k] === 'boolean') {
+      ({horizontal, stacked, smooth, ring, radarFill, showLabel}[k]).value = cfg[k]
+    }
+  }
+}
+
+const persist = debounce(() => kvSetJSON(CFG_KEY, buildConfig()), 300)
 watch([chartType, agg, sortOrder, topN, dimensions, metrics, xField, yField, groupField,
   horizontal, stacked, smooth, ring, radarFill, showLabel], persist, {deep: true})
 
+// ---- 命名预设 ----
+interface Preset { name: string; config: Record<string, any> }
+const PRESETS_KEY = 'chart.presets'
+const presets = ref<Preset[]>(kvGetJSON<Preset[]>(PRESETS_KEY, []))
+const savePreset = () => {
+  const name = (window.prompt('预设名称') || '').trim()
+  if (!name) {
+    return
+  }
+  const list = presets.value.filter(p => p.name !== name)
+  list.push({name, config: buildConfig()})
+  presets.value = list
+  kvSetJSON(PRESETS_KEY, list)
+}
+const applyPreset = (name: string) => {
+  const p = presets.value.find(x => x.name === name)
+  if (p) {
+    applyConfig(p.config)
+  }
+}
+const deletePreset = (name: string) => {
+  presets.value = presets.value.filter(p => p.name !== name)
+  kvSetJSON(PRESETS_KEY, presets.value)
+}
+
 const {isDark} = useTheme()
 const toast = useToast()
 const chartHost = ref<HTMLElement>()

From 5d0f06deb368236ac61c4f3bfeabb86c37479f64 Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Sun, 7 Jun 2026 23:35:59 +0800
Subject: [PATCH 06/25] =?UTF-8?q?fix:=20=E5=AD=98=E9=A2=84=E8=AE=BE?=
 =?UTF-8?q?=E6=94=B9=E7=94=A8=E5=BA=94=E7=94=A8=E5=86=85=E8=BE=93=E5=85=A5?=
 =?UTF-8?q?=E6=A1=86?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Tauri WebView 不支持 window.prompt, 导致点击无反应
- 改为内联命名输入(回车保存/Esc 取消)
---
 src/components/charts/ChartPanel.vue | 18 +++++++++++++++---
 1 file changed, 15 insertions(+), 3 deletions(-)

diff --git a/src/components/charts/ChartPanel.vue b/src/components/charts/ChartPanel.vue
index 4e72bff..28551a0 100644
--- a/src/components/charts/ChartPanel.vue
+++ b/src/components/charts/ChartPanel.vue
@@ -7,7 +7,7 @@
         <div class="flex items-center justify-between mb-1">
           <span class="text-[11px] text-gray-400">图表类型</span>
           <div class="flex items-center gap-1">
-            <button class="inline-flex items-center gap-1 px-1.5 py-0.5 rounded text-[11px] text-gray-500 hover:bg-gray-100 dark:hover:bg-gray-700 cursor-pointer" title="保存为预设" @click="savePreset">
+            <button class="inline-flex items-center gap-1 px-1.5 py-0.5 rounded text-[11px] text-gray-500 hover:bg-gray-100 dark:hover:bg-gray-700 cursor-pointer" title="保存为预设" @click="savingPreset = !savingPreset">
               <Star class="w-3 h-3"/>存预设
             </button>
             <button class="inline-flex items-center gap-1 px-1.5 py-0.5 rounded text-[11px] text-violet-500 hover:bg-violet-50 dark:hover:bg-violet-900/30 cursor-pointer" title="用自然语言配图" @click="toggleAi">
@@ -16,6 +16,14 @@
           </div>
         </div>
         <Select v-model="chartType" :options="chartTypes" searchable :button-classes="['!py-1', '!px-2.5', 'text-xs', '!rounded-md']"/>
+        <!-- 保存预设输入 -->
+        <div v-if="savingPreset" class="mt-1.5 flex items-center gap-1">
+          <input v-model="presetName" type="text" placeholder="预设名称" autofocus
+                 class="flex-1 min-w-0 px-2 py-0.5 text-[11px] rounded border border-gray-200 dark:border-gray-700 bg-white dark:bg-gray-900 text-gray-700 dark:text-gray-200 focus:outline-none focus:border-blue-400"
+                 @keydown.enter="confirmSavePreset" @keydown.esc="savingPreset = false"/>
+          <button class="px-2 py-0.5 text-[11px] rounded bg-blue-500 text-white hover:bg-blue-600 disabled:opacity-50 cursor-pointer" :disabled="!presetName.trim()" @click="confirmSavePreset">保存</button>
+          <button class="px-1.5 py-0.5 text-[11px] rounded text-gray-400 hover:bg-gray-100 dark:hover:bg-gray-700 cursor-pointer" @click="savingPreset = false">取消</button>
+        </div>
         <!-- 预设列表 -->
         <div v-if="presets.length" class="mt-1.5 flex flex-wrap gap-1">
           <span v-for="p in presets" :key="p.name"
@@ -424,8 +432,10 @@ watch([chartType, agg, sortOrder, topN, dimensions, metrics, xField, yField, gro
 interface Preset { name: string; config: Record<string, any> }
 const PRESETS_KEY = 'chart.presets'
 const presets = ref<Preset[]>(kvGetJSON<Preset[]>(PRESETS_KEY, []))
-const savePreset = () => {
-  const name = (window.prompt('预设名称') || '').trim()
+const savingPreset = ref(false)
+const presetName = ref('')
+const confirmSavePreset = () => {
+  const name = presetName.value.trim()
   if (!name) {
     return
   }
@@ -433,6 +443,8 @@ const savePreset = () => {
   list.push({name, config: buildConfig()})
   presets.value = list
   kvSetJSON(PRESETS_KEY, list)
+  savingPreset.value = false
+  presetName.value = ''
 }
 const applyPreset = (name: string) => {
   const p = presets.value.find(x => x.name === name)

From e423debef5df71e0b56a30a42fad41ad9ceafbce Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Sun, 7 Jun 2026 23:42:29 +0800
Subject: [PATCH 07/25] =?UTF-8?q?fix:=20=E5=85=A8=E5=B1=80=E6=9B=BF?=
 =?UTF-8?q?=E6=8D=A2=E7=A1=AE=E8=AE=A4=E6=94=B9=E7=94=A8=E5=BA=94=E7=94=A8?=
 =?UTF-8?q?=E5=86=85=E7=A1=AE=E8=AE=A4=E6=9D=A1?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- window.confirm 在 Tauri WebView 不可靠
- 全部替换前改为内联确认条(取消/确认替换), 展示影响处数与文件数
---
 src/components/SearchPanel.vue | 25 +++++++++++++++++--------
 1 file changed, 17 insertions(+), 8 deletions(-)

diff --git a/src/components/SearchPanel.vue b/src/components/SearchPanel.vue
index a9a4854..1897a03 100644
--- a/src/components/SearchPanel.vue
+++ b/src/components/SearchPanel.vue
@@ -25,11 +25,23 @@
         <button class="text-xs px-2 py-1 rounded bg-blue-500 hover:bg-blue-600 disabled:opacity-40 disabled:cursor-not-allowed text-white flex-shrink-0"
                 :disabled="replacing || results.length === 0"
                 :title="results.length ? `替换全部 ${results.length} 处` : '先搜索出结果'"
-                @click="replaceAll">
+                @click="confirming = true">
           {{ replacing ? '替换中…' : '全部替换' }}
         </button>
       </div>
 
+      <!-- 全部替换确认 -->
+      <div v-if="confirming" class="px-3 py-2 border-b border-amber-200 dark:border-amber-800 bg-amber-50 dark:bg-amber-900/20 flex-shrink-0 text-xs">
+        <p class="text-amber-700 dark:text-amber-300 mb-2">
+          将把 {{ results.length }} 处「{{ query.trim() }}」替换为「{{ replacement }}」，涉及 {{ affectedCount }} 个文件。<br/>
+          直接写入磁盘且不可撤销，确定继续？
+        </p>
+        <div class="flex justify-end gap-2">
+          <button class="px-2 py-1 rounded text-gray-500 hover:bg-gray-100 dark:hover:bg-gray-700 cursor-pointer" @click="confirming = false">取消</button>
+          <button class="px-2 py-1 rounded bg-red-500 hover:bg-red-600 text-white cursor-pointer" @click="replaceAll">确认替换</button>
+        </div>
+      </div>
+
       <div class="flex-1 overflow-y-auto">
         <div v-if="!loading && query && results.length === 0" class="px-4 py-6 text-center text-sm text-gray-400">无匹配结果</div>
 
@@ -78,25 +90,22 @@ const toast = useToast()
 const query = ref('')
 const replacement = ref('')
 const replacing = ref(false)
+const confirming = ref(false)
 const results = ref<Match[]>([])
+const affectedCount = computed(() => new Set(results.value.map(m => m.path)).size)
 const loading = ref(false)
 const inputRef = ref<HTMLInputElement | null>(null)
 
 onMounted(() => inputRef.value?.focus())
 
-// 全部替换：确认后调用后端，完成后刷新搜索并通知刷新已打开文件
+// 全部替换：经应用内确认后调用后端，完成后刷新搜索并通知刷新已打开文件
 const replaceAll = async () => {
+  confirming.value = false
   const q = query.value.trim()
   if (q.length < 2 || results.value.length === 0) {
     return
   }
   const affected = Array.from(new Set(results.value.map(m => m.path)))
-  const ok = window.confirm(
-      `将把 ${results.value.length} 处「${q}」替换为「${replacement.value}」，涉及 ${affected.length} 个文件。\n此操作会直接写入磁盘且不可撤销，确定继续？`
-  )
-  if (!ok) {
-    return
-  }
   replacing.value = true
   try {
     const summary = await invoke<{ files_changed: number, replacements: number }>('replace_in_files', {

From 77cf923411712508fb6f811585073f0156ba5b6e Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Sun, 7 Jun 2026 23:53:17 +0800
Subject: [PATCH 08/25] =?UTF-8?q?feat:=20=E6=96=B0=E5=A2=9E=20Excel(.xlsx/?=
 =?UTF-8?q?.xls)=20=E6=95=B0=E6=8D=AE=E6=BA=90=E6=8F=92=E4=BB=B6?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 后端 xlsx 插件(console_type=xlsx, 运行输出文件路径)
- 新增 XlsxView: 用 Tauri fs 读取字节 + SheetJS 解析, 工作表切换
- 复用 VirtualTable(虚拟滚动) + ChartPanel(27 种图表) + 导出 CSV
- SheetJS 动态导入按需分包(~430KB), 不拖大主包
- App.vue 增加 xlsx 输出分支, 设置项新增 Excel 表/图表
---
 package.json                           |   3 +-
 src-tauri/src/plugins/manager.rs       |   2 +
 src-tauri/src/plugins/mod.rs           |   1 +
 src-tauri/src/plugins/xlsx.rs          |  56 +++++++++
 src/App.vue                            |   9 ++
 src/components/XlsxView.vue            | 153 +++++++++++++++++++++++++
 src/composables/useLanguageSettings.ts |   2 +-
 7 files changed, 224 insertions(+), 2 deletions(-)
 create mode 100644 src-tauri/src/plugins/xlsx.rs
 create mode 100644 src/components/XlsxView.vue

diff --git a/package.json b/package.json
index e93a1df..6517b14 100644
--- a/package.json
+++ b/package.json
@@ -49,7 +49,8 @@
     "markdown-it": "^14.2.0",
     "vue": "^3.5.13",
     "vue-codemirror": "^6.1.1",
-    "vue3-markdown-it": "^1.0.10"
+    "vue3-markdown-it": "^1.0.10",
+    "xlsx": "^0.18.5"
   },
   "devDependencies": {
     "@tailwindcss/postcss": "^4.1.11",
diff --git a/src-tauri/src/plugins/manager.rs b/src-tauri/src/plugins/manager.rs
index f55f759..994f9e8 100644
--- a/src-tauri/src/plugins/manager.rs
+++ b/src-tauri/src/plugins/manager.rs
@@ -36,6 +36,7 @@ use crate::plugins::swift::SwiftPlugin;
 use crate::plugins::text::TextPlugin;
 use crate::plugins::tsv::TsvPlugin;
 use crate::plugins::typescript::TypeScriptPlugin;
+use crate::plugins::xlsx::XlsxPlugin;
 use crate::plugins::typescript_browser::TypeScriptBrowserPlugin;
 use crate::plugins::typescript_nodejs::TypeScriptNodeJsPlugin;
 use crate::plugins::xml::XmlPlugin;
@@ -80,6 +81,7 @@ impl PluginManager {
             ("text".to_string(), Box::new(TextPlugin)),
             ("csv".to_string(), Box::new(CsvPlugin)),
             ("tsv".to_string(), Box::new(TsvPlugin)),
+            ("xlsx".to_string(), Box::new(XlsxPlugin)),
             ("sql".to_string(), Box::new(SqlPlugin)),
             ("php".to_string(), Box::new(PHPPlugin)),
             ("r".to_string(), Box::new(RPlugin)),
diff --git a/src-tauri/src/plugins/mod.rs b/src-tauri/src/plugins/mod.rs
index 931c24d..29fb884 100644
--- a/src-tauri/src/plugins/mod.rs
+++ b/src-tauri/src/plugins/mod.rs
@@ -436,6 +436,7 @@ pub mod swift;
 pub mod text;
 pub mod tsv;
 pub mod typescript;
+pub mod xlsx;
 pub mod typescript_browser;
 pub mod typescript_nodejs;
 pub mod xml;
diff --git a/src-tauri/src/plugins/xlsx.rs b/src-tauri/src/plugins/xlsx.rs
new file mode 100644
index 0000000..1209f0c
--- /dev/null
+++ b/src-tauri/src/plugins/xlsx.rs
@@ -0,0 +1,56 @@
+use super::{LanguagePlugin, PluginConfig};
+use std::vec;
+
+pub struct XlsxPlugin;
+
+impl LanguagePlugin for XlsxPlugin {
+    fn get_order(&self) -> i32 {
+        42
+    }
+
+    fn get_language_name(&self) -> &'static str {
+        "Excel"
+    }
+
+    fn get_language_key(&self) -> &'static str {
+        "xlsx"
+    }
+
+    fn get_file_extension(&self) -> String {
+        self.get_config()
+            .map(|config| config.extension.clone())
+            .unwrap_or_else(|| "xlsx".to_string())
+    }
+
+    fn get_version_args(&self) -> Vec<&'static str> {
+        vec!["--"]
+    }
+
+    fn get_path_command(&self) -> String {
+        "--".to_string()
+    }
+
+    fn get_default_config(&self) -> PluginConfig {
+        PluginConfig {
+            enabled: true,
+            language: String::from("xlsx"),
+            before_compile: None,
+            // 多扩展名：xlsx / xls
+            extension: String::from("xlsx,xls"),
+            execute_home: None,
+            // Excel 为二进制，运行时输出文件路径，由前端用 SheetJS 读取解析
+            run_command: Some(String::from("echo $filename")),
+            after_compile: None,
+            template: None,
+            timeout: Some(30),
+            console_type: Some(String::from("xlsx")),
+            icon_path: None,
+        }
+    }
+
+    fn get_default_command(&self) -> String {
+        self.get_config()
+            .and_then(|config| config.run_command.clone())
+            .unwrap_or_else(|| "echo".to_string())
+    }
+}
diff --git a/src/App.vue b/src/App.vue
index 9422104..1706f9c 100644
--- a/src/App.vue
+++ b/src/App.vue
@@ -193,6 +193,14 @@
                              :is-running="isRunning"
                              :execution-time="lastExecutionTime"
                              @clear="clearOutput"/>
+
+              <!-- Excel 表 / 图表（xlsx / xls） -->
+              <XlsxView v-else-if="consoleType === 'xlsx'"
+                        class="flex-1 min-h-0"
+                        :output="output"
+                        :is-running="isRunning"
+                        :execution-time="lastExecutionTime"
+                        @clear="clearOutput"/>
             </div>
           </template>
         </ResizablePanels>
@@ -372,6 +380,7 @@ import XmlView from "./components/XmlView.vue";
 import YamlView from "./components/YamlView.vue";
 import SqlTableView from "./components/SqlTableView.vue";
 import DataTableView from "./components/DataTableView.vue";
+import XlsxView from "./components/XlsxView.vue";
 import SqlSourceSelect from "./components/SqlSourceSelect.vue";
 import SchemaBrowser from "./components/SchemaBrowser.vue";
 import AiSql from "./components/AiSql.vue";
diff --git a/src/components/XlsxView.vue b/src/components/XlsxView.vue
new file mode 100644
index 0000000..f66258b
--- /dev/null
+++ b/src/components/XlsxView.vue
@@ -0,0 +1,153 @@
+<template>
+  <div class="flex flex-col h-full bg-white dark:bg-gray-900">
+    <!-- 头部 -->
+    <div class="flex items-center justify-between px-3 py-1.5 border-b border-gray-200 dark:border-gray-700 flex-shrink-0">
+      <div class="flex items-center gap-2 text-xs text-gray-500 dark:text-gray-400 min-w-0">
+        <Sheet class="w-3.5 h-3.5 flex-shrink-0"/>
+        <span>Excel</span>
+        <span v-if="isRunning || loading" class="text-blue-500">读取中…</span>
+        <span v-else-if="error" class="text-red-500 truncate">{{ error }}</span>
+        <span v-else-if="table.rows.length" class="text-gray-400">{{ table.columns.length }} 列 · {{ table.rows.length }} 行</span>
+      </div>
+      <div class="flex items-center gap-1">
+        <div class="flex items-center rounded-md border border-gray-200 dark:border-gray-700 overflow-hidden">
+          <button class="p-1 transition-colors" :class="viewMode === 'table' ? 'bg-blue-500 text-white' : 'text-gray-400 hover:text-gray-600 dark:hover:text-gray-300'" title="表格" @click="viewMode = 'table'">
+            <Table2 class="w-3.5 h-3.5"/>
+          </button>
+          <button class="p-1 transition-colors" :class="viewMode === 'chart' ? 'bg-blue-500 text-white' : 'text-gray-400 hover:text-gray-600 dark:hover:text-gray-300'"
+                  :disabled="!table.columns.length" :title="table.columns.length ? '图表' : '无数据可绘图'" @click="viewMode = 'chart'">
+            <BarChart3 class="w-3.5 h-3.5" :class="!table.columns.length ? 'opacity-40' : ''"/>
+          </button>
+        </div>
+        <button v-if="table.columns.length" class="p-1 rounded text-gray-400 hover:text-gray-600 dark:hover:text-gray-300 hover:bg-gray-100 dark:hover:bg-gray-700 cursor-pointer" title="导出 CSV" @click="exportCsv">
+          <FileDown class="w-3.5 h-3.5"/>
+        </button>
+        <button class="p-1 rounded text-gray-400 hover:text-gray-600 dark:hover:text-gray-300 hover:bg-gray-100 dark:hover:bg-gray-700 cursor-pointer" title="清空" @click="emit('clear')">
+          <Trash2 class="w-3.5 h-3.5"/>
+        </button>
+      </div>
+    </div>
+
+    <!-- 工作表标签 -->
+    <div v-if="sheets.length > 1" class="flex items-center gap-1 px-2 py-1 border-b border-gray-200 dark:border-gray-700 overflow-x-auto flex-shrink-0">
+      <button v-for="s in sheets" :key="s" class="px-2 py-0.5 rounded text-xs whitespace-nowrap cursor-pointer"
+              :class="s === activeSheet ? 'bg-blue-500 text-white' : 'text-gray-500 hover:bg-gray-100 dark:hover:bg-gray-700'"
+              @click="activeSheet = s">{{ s }}</button>
+    </div>
+
+    <!-- 图表 -->
+    <div v-if="viewMode === 'chart' && table.columns.length" class="flex-1 min-h-0 overflow-hidden">
+      <ChartPanel :columns="table.columns" :rows="table.rows"/>
+    </div>
+    <!-- 表格（虚拟滚动） -->
+    <div v-else-if="!table.columns.length" class="flex-1 overflow-auto p-2 text-xs">
+      <div class="text-gray-400 px-2 py-4 text-center">{{ error ? error : '运行 .xlsx / .xls 后在此查看数据' }}</div>
+    </div>
+    <VirtualTable v-else class="flex-1" :columns="table.columns" :rows="table.rows"/>
+  </div>
+</template>
+
+<script setup lang="ts">
+import {ref, shallowRef, watch} from 'vue'
+import {BarChart3, FileDown, Sheet, Table2, Trash2} from 'lucide-vue-next'
+import type * as XLSXType from 'xlsx'
+import ChartPanel from './charts/ChartPanel.vue'
+import VirtualTable from './VirtualTable.vue'
+import {downloadCsv} from '../utils/csv'
+
+const props = defineProps<{
+  output: string
+  isRunning: boolean
+  executionTime?: number
+}>()
+const emit = defineEmits<{ clear: [] }>()
+
+const viewMode = ref<'table' | 'chart'>('table')
+const loading = ref(false)
+const error = ref('')
+const sheets = ref<string[]>([])
+const activeSheet = ref('')
+const workbook = shallowRef<XLSXType.WorkBook | null>(null)
+const table = shallowRef<{ columns: string[]; rows: any[][] }>({columns: [], rows: []})
+
+// 动态加载 xlsx（体积大，按需引入）
+let XLSX: typeof XLSXType | null = null
+const ensureXlsx = async () => {
+  if (!XLSX) {
+    XLSX = await import('xlsx')
+  }
+  return XLSX
+}
+
+const fmtCell = (v: any) => {
+  if (v === null || v === undefined) {
+    return ''
+  }
+  if (v instanceof Date) {
+    const p = (n: number) => String(n).padStart(2, '0')
+    return `${v.getFullYear()}-${p(v.getMonth() + 1)}-${p(v.getDate())} ${p(v.getHours())}:${p(v.getMinutes())}:${p(v.getSeconds())}`.replace(' 00:00:00', '')
+  }
+  return v
+}
+
+const buildTable = (name: string) => {
+  const wb = workbook.value
+  if (!wb || !XLSX || !wb.Sheets[name]) {
+    table.value = {columns: [], rows: []}
+    return
+  }
+  const aoa = XLSX.utils.sheet_to_json<any[]>(wb.Sheets[name], {header: 1, defval: null, blankrows: false})
+  if (aoa.length === 0) {
+    table.value = {columns: [], rows: []}
+    return
+  }
+  const columns = (aoa[0] || []).map((c: any, i: number) => (c === null || c === '' ? `列${i + 1}` : String(c)))
+  const rows = aoa.slice(1).map(r => columns.map((_c, i) => fmtCell(r[i])))
+  table.value = {columns, rows}
+}
+
+const loadFile = async (path: string) => {
+  const p = path.trim()
+  if (!p) {
+    workbook.value = null
+    sheets.value = []
+    table.value = {columns: [], rows: []}
+    return
+  }
+  loading.value = true
+  error.value = ''
+  try {
+    const lib = await ensureXlsx()
+    const {readFile} = await import('@tauri-apps/plugin-fs')
+    const bytes = await readFile(p)
+    const wb = lib.read(bytes, {type: 'array', cellDates: true})
+    workbook.value = wb
+    sheets.value = wb.SheetNames
+    activeSheet.value = wb.SheetNames[0] || ''
+    buildTable(activeSheet.value)
+  }
+  catch (e: any) {
+    error.value = '读取失败：' + String(e?.message || e)
+    workbook.value = null
+    sheets.value = []
+    table.value = {columns: [], rows: []}
+  }
+  finally {
+    loading.value = false
+  }
+}
+
+watch(() => props.output, (v) => loadFile(v), {immediate: true})
+watch(activeSheet, (s) => {
+  if (s) {
+    buildTable(s)
+  }
+})
+watch(() => table.value.columns.length, (n) => {
+  if (!n && viewMode.value === 'chart') {
+    viewMode.value = 'table'
+  }
+})
+
+const exportCsv = () => downloadCsv(table.value.columns, table.value.rows, `${activeSheet.value || 'sheet'}-${Date.now()}.csv`)
+</script>
diff --git a/src/composables/useLanguageSettings.ts b/src/composables/useLanguageSettings.ts
index afa25e3..9d4e2f5 100644
--- a/src/composables/useLanguageSettings.ts
+++ b/src/composables/useLanguageSettings.ts
@@ -33,7 +33,7 @@ export function useLanguageSettings(emit: any)
         }
     ]
 
-    const consoleTypes = [{label: '控制台', value: 'console'}, {label: 'Web', value: 'web'}, {label: 'JSON', value: 'json'}, {label: 'Markdown', value: 'markdown'}, {label: 'XML', value: 'xml'}, {label: 'YAML', value: 'yaml'}, {label: 'SQL 表格', value: 'sqltable'}, {label: '数据表/图表', value: 'table'}]
+    const consoleTypes = [{label: '控制台', value: 'console'}, {label: 'Web', value: 'web'}, {label: 'JSON', value: 'json'}, {label: 'Markdown', value: 'markdown'}, {label: 'XML', value: 'xml'}, {label: 'YAML', value: 'yaml'}, {label: 'SQL 表格', value: 'sqltable'}, {label: '数据表/图表', value: 'table'}, {label: 'Excel 表/图表', value: 'xlsx'}]
 
     const {
         activePlugin,

From 0f64a974e9725ed635acd89dbea66cc8f4b49429 Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Sun, 7 Jun 2026 23:56:22 +0800
Subject: [PATCH 09/25] =?UTF-8?q?docs:=20README=20=E4=B8=8E=E5=9B=BE?=
 =?UTF-8?q?=E6=A0=87=E8=A1=A5=E5=85=85=20Excel=20=E6=95=B0=E6=8D=AE?=
 =?UTF-8?q?=E6=BA=90?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md             | 8 +++++---
 public/icons/xlsx.svg | 9 +++++++++
 2 files changed, 14 insertions(+), 3 deletions(-)
 create mode 100644 public/icons/xlsx.svg

diff --git a/README.md b/README.md
index e8e9226..4f7678b 100644
--- a/README.md
+++ b/README.md
@@ -49,7 +49,8 @@
 - **JSON / XML / YAML** —— 可折叠**层级树**，以及卡片 + 连线的**关系图**两种可视化
 - **SQL** —— 插件式执行器（内存库 / `.sqlite` 文件 / **MySQL**，可在设置中配置连接、运行时选择数据源），结果渲染为**表格**，失败显示具体错误；执行历史与实时运行一致
 - **图表可视化** —— SQL 结果一键切换为图表：**拖拽**字段到「维度 / 指标」即可成图，自动识别数值列，支持聚合（求和/计数/平均/最大/最小）、排序、Top N。基于 ECharts，内置 **27 种**图表：柱状图 · 折线图 · 面积图 · 饼图/环形图 · 玫瑰图 · 散点图 · 涟漪散点图 · 雷达图 · 漏斗图 · 热力图 · 仪表盘 · 桑基图 · 关系图 · 旭日图 · 矩形树图 · 树图 · 箱线图 · K 线图 · 平行坐标 · 主题河流 · 日历热力图 · 极坐标柱状图 · 象形柱图 · 词云 · 水球图 · 中国地图 · 世界地图（配色跟随主题，支持导出 PNG）。配置面板表驱动，组件与数据源解耦，后续 CSV 等本地数据可复用
-- **CSV / TSV** —— 解析为**数据表**（支持引号转义、字段内换行、自动识别分隔符），并可一键切换为上述 27 种图表（与 SQL 共用图表面板）
+- **CSV / TSV** —— 解析为**数据表**（支持引号转义、字段内换行、自动识别分隔符、Web Worker 后台解析 + 进度），并可一键切换为上述 27 种图表（与 SQL 共用图表面板）
+- **Excel（.xlsx / .xls）** —— 用 SheetJS 解析，**多工作表**切换，同样可切表格 / 27 种图表 / 导出 CSV
 - **Markdown** —— 实时渲染预览（支持内嵌 HTML，DOMPurify 净化防 XSS）
 - **GitHub Actions 工作流** —— 自动识别并渲染为 **Jobs 依赖 DAG 图**（触发事件 → 各 Job → Steps）
 
@@ -73,7 +74,7 @@
 
 ## 🧩 支持的语言
 
-可运行语言均采用**插件化架构**，每种语言独立实现；JSON / XML / YAML / Markdown / CSV / TSV / 纯文本为编辑与可视化类型。
+可运行语言均采用**插件化架构**，每种语言独立实现；JSON / XML / YAML / Markdown / CSV / TSV / Excel / 纯文本为编辑与可视化类型。
 
 <div align="center">
   <img src="public/icons/python.svg" width="48" title="Python 2 / 3" />
@@ -112,12 +113,13 @@
   <img src="public/icons/markdown.svg" width="48" title="Markdown" />
   <img src="public/icons/csv.svg" width="48" title="CSV" />
   <img src="public/icons/tsv.svg" width="48" title="TSV" />
+  <img src="public/icons/xlsx.svg" width="48" title="Excel" />
   <img src="public/icons/text.svg" width="48" title="纯文本" />
 </div>
 
 <div align="center">
 
-`Python` · `Node.js` · `TypeScript` · `JavaScript` · `Go` · `Rust` · `Java` · `Kotlin` · `Scala` · `Groovy` · `Clojure` · `C` · `C++` · `Objective-C/C++` · `Swift` · `Ruby` · `PHP` · `R` · `Lua` · `Haskell` · `Cangjie` · `Shell` · `AppleScript` · `SQL` · `HTML` · `CSS` · `SVG` · `JSON` · `XML` · `YAML` · `Markdown` · `CSV` · `TSV` · `Text`
+`Python` · `Node.js` · `TypeScript` · `JavaScript` · `Go` · `Rust` · `Java` · `Kotlin` · `Scala` · `Groovy` · `Clojure` · `C` · `C++` · `Objective-C/C++` · `Swift` · `Ruby` · `PHP` · `R` · `Lua` · `Haskell` · `Cangjie` · `Shell` · `AppleScript` · `SQL` · `HTML` · `CSS` · `SVG` · `JSON` · `XML` · `YAML` · `Markdown` · `CSV` · `TSV` · `Excel` · `Text`
 
 </div>
 
diff --git a/public/icons/xlsx.svg b/public/icons/xlsx.svg
new file mode 100644
index 0000000..990753c
--- /dev/null
+++ b/public/icons/xlsx.svg
@@ -0,0 +1,9 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 48 48" fill="none">
+  <rect x="6" y="6" width="36" height="36" rx="5" fill="#16a34a"/>
+  <rect x="12" y="14" width="24" height="20" rx="2" fill="#ffffff"/>
+  <line x1="12" y1="21" x2="36" y2="21" stroke="#16a34a" stroke-width="2"/>
+  <line x1="12" y1="28" x2="36" y2="28" stroke="#16a34a" stroke-width="2"/>
+  <line x1="20" y1="14" x2="20" y2="34" stroke="#16a34a" stroke-width="2"/>
+  <line x1="28" y1="14" x2="28" y2="34" stroke="#16a34a" stroke-width="2"/>
+  <text x="24" y="44" font-size="9" fill="#16a34a" text-anchor="middle" font-family="sans-serif" font-weight="bold">XLS</text>
+</svg>

From d3eae9098348a0ca85f2244754a939c45fefc34d Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Mon, 8 Jun 2026 09:31:32 +0800
Subject: [PATCH 10/25] =?UTF-8?q?fix:=20=E6=89=93=E5=BC=80=20.xlsx/.xls=20?=
 =?UTF-8?q?=E4=B8=8D=E5=86=8D=E6=8A=A5"=E4=B8=8D=E6=98=AF=E6=96=87?=
 =?UTF-8?q?=E6=9C=AC=E6=96=87=E4=BB=B6"?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- smartOpen 对 Excel 扩展名直接路由到数据视图(切 xlsx 语言, 控制台显示 Excel 表/图表)
- 不再走文本打开判断, XlsxView 读取该路径解析展示
---
 src/App.vue | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/src/App.vue b/src/App.vue
index 1706f9c..9b73ac4 100644
--- a/src/App.vue
+++ b/src/App.vue
@@ -673,9 +673,25 @@ const openFolder = async () => {
 const showViewer = ref(false)
 const viewerFile = ref<{ path: string, lineCount: number, sizeBytes: number } | null>(null)
 
+// 二进制数据文件（Excel 等）：切到对应语言并在控制台用数据视图展示，不进代码编辑器
+const openDataFile = (filePath: string, lang: string) => {
+  addRecentFile(filePath)
+  applyLanguage(lang)
+  currentFilePath.value = filePath
+  output.value = filePath
+  showConsole.value = true
+  consoleType.value = getCurrentConsoleType()
+}
+
 // 按文件大小决定：可编辑打开 / 只读查看
 const smartOpen = async (filePath: string) => {
   try {
+    // Excel 等二进制数据文件：直接路由到数据视图，不当文本打开
+    if (/\.(xlsx|xls)$/i.test(filePath)) {
+      openDataFile(filePath, 'xlsx')
+      return
+    }
+
     const meta = await invoke<{ size_bytes: number, line_count: number, is_text: boolean }>('get_text_file_meta', {path: filePath})
     if (!meta.is_text) {
       toast.error('不是文本文件，无法打开')

From 900036b69b4086277e966fd8128a73a1ef49d901 Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Mon, 8 Jun 2026 09:49:22 +0800
Subject: [PATCH 11/25] =?UTF-8?q?feat(lsp):=20=E5=90=8E=E7=AB=AF=20LSP=20?=
 =?UTF-8?q?=E6=A1=A5=E6=8E=A5=E5=B1=82?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 新增 lsp.rs: 按语言拉起语言服务器, Content-Length 帧解析, 事件转发(lsp:message/lsp:exit)
- 命令: lsp_available/lsp_start/lsp_send/lsp_stop, 透明转发 JSON-RPC
- 解析可执行全路径并增广 PATH(解决 GUI 应用 PATH 缺失)
- 内置 python/ts-js/rust/go/c-cpp/lua/php/ruby/html/css/json 服务器映射
---
 src-tauri/src/lsp.rs  | 255 ++++++++++++++++++++++++++++++++++++++++++
 src-tauri/src/main.rs |  10 +-
 2 files changed, 264 insertions(+), 1 deletion(-)
 create mode 100644 src-tauri/src/lsp.rs

diff --git a/src-tauri/src/lsp.rs b/src-tauri/src/lsp.rs
new file mode 100644
index 0000000..21aa572
--- /dev/null
+++ b/src-tauri/src/lsp.rs
@@ -0,0 +1,255 @@
+//! LSP 桥接：按语言拉起语言服务器进程，转发 JSON-RPC（Content-Length 帧）。
+//! 后端只做透明转发：前端发送/接收原始 JSON 字符串，握手与协议由前端负责。
+
+use serde::Serialize;
+use std::collections::HashMap;
+use std::io::{BufReader, Read, Write};
+use std::path::PathBuf;
+use std::process::{Child, ChildStdin, Command, Stdio};
+use std::sync::Mutex as StdMutex;
+use tauri::{AppHandle, Emitter, State};
+
+struct Server {
+    child: Child,
+    stdin: ChildStdin,
+}
+
+pub struct LspState {
+    servers: StdMutex<HashMap<String, Server>>,
+}
+
+impl LspState {
+    pub fn new() -> Self {
+        Self {
+            servers: StdMutex::new(HashMap::new()),
+        }
+    }
+}
+
+#[derive(Clone, Serialize)]
+struct LspEvent {
+    language: String,
+    message: String,
+}
+
+/// 语言 -> (可执行名, 参数)。新增语言在此加一行。
+fn server_cmd(language: &str) -> Option<(&'static str, Vec<&'static str>)> {
+    match language {
+        "python3" | "python2" | "python" => Some(("pyright-langserver", vec!["--stdio"])),
+        "typescript" | "typescript-nodejs" | "typescript-browser" | "javascript-nodejs"
+        | "javascript-browser" | "javascript-jquery" | "nodejs" => {
+            Some(("typescript-language-server", vec!["--stdio"]))
+        }
+        "rust" => Some(("rust-analyzer", vec![])),
+        "go" => Some(("gopls", vec![])),
+        "c" | "cpp" | "objective-c" | "objective-cpp" => Some(("clangd", vec![])),
+        "lua" => Some(("lua-language-server", vec![])),
+        "php" => Some(("intelephense", vec!["--stdio"])),
+        "ruby" => Some(("solargraph", vec!["stdio"])),
+        "html" => Some(("vscode-html-language-server", vec!["--stdio"])),
+        "css" => Some(("vscode-css-language-server", vec!["--stdio"])),
+        "json" => Some(("vscode-json-language-server", vec!["--stdio"])),
+        _ => None,
+    }
+}
+
+/// GUI 应用 PATH 常缺失，补充常见安装目录
+fn extra_bin_dirs() -> Vec<PathBuf> {
+    let mut dirs = vec![
+        PathBuf::from("/usr/local/bin"),
+        PathBuf::from("/opt/homebrew/bin"),
+        PathBuf::from("/usr/bin"),
+    ];
+    if let Some(home) = dirs_home() {
+        dirs.push(home.join(".cargo/bin"));
+        dirs.push(home.join(".local/bin"));
+        dirs.push(home.join("go/bin"));
+        dirs.push(home.join(".npm-global/bin"));
+    }
+    dirs
+}
+
+fn dirs_home() -> Option<PathBuf> {
+    std::env::var_os("HOME").map(PathBuf::from)
+}
+
+/// 在 PATH 与常见目录中查找可执行文件全路径
+fn find_in_path(prog: &str) -> Option<PathBuf> {
+    let exts: Vec<&str> = if cfg!(windows) {
+        vec!["", ".cmd", ".exe", ".bat"]
+    } else {
+        vec![""]
+    };
+    let mut dirs: Vec<PathBuf> = Vec::new();
+    if let Some(path) = std::env::var_os("PATH") {
+        dirs.extend(std::env::split_paths(&path));
+    }
+    dirs.extend(extra_bin_dirs());
+    for dir in dirs {
+        for ext in &exts {
+            let full = dir.join(format!("{}{}", prog, ext));
+            if full.is_file() {
+                return Some(full);
+            }
+        }
+    }
+    None
+}
+
+/// 给子进程增广 PATH（语言服务器常依赖 node 等）
+fn augmented_path() -> String {
+    let mut parts: Vec<String> = Vec::new();
+    if let Some(path) = std::env::var_os("PATH") {
+        parts.push(path.to_string_lossy().to_string());
+    }
+    for d in extra_bin_dirs() {
+        parts.push(d.to_string_lossy().to_string());
+    }
+    parts.join(":")
+}
+
+/// 该语言是否有可用的语言服务器
+#[tauri::command]
+pub fn lsp_available(language: String) -> bool {
+    server_cmd(&language)
+        .map(|(prog, _)| find_in_path(prog).is_some())
+        .unwrap_or(false)
+}
+
+/// 启动语言服务器；已启动则直接返回 true。
+#[tauri::command]
+pub fn lsp_start(app: AppHandle, state: State<'_, LspState>, language: String) -> Result<bool, String> {
+    {
+        let servers = state.servers.lock().map_err(|e| e.to_string())?;
+        if servers.contains_key(&language) {
+            return Ok(true);
+        }
+    }
+    let (prog, args) = server_cmd(&language).ok_or_else(|| "该语言暂不支持 LSP".to_string())?;
+    let exe = find_in_path(prog).ok_or_else(|| format!("未找到语言服务器：{}（请先安装并确保在 PATH 中）", prog))?;
+
+    let mut cmd = Command::new(&exe);
+    cmd.args(&args)
+        .env("PATH", augmented_path())
+        .stdin(Stdio::piped())
+        .stdout(Stdio::piped())
+        .stderr(Stdio::piped());
+
+    let mut child = cmd.spawn().map_err(|e| format!("启动 {} 失败: {}", prog, e))?;
+    let stdin = child.stdin.take().ok_or("无法获取 stdin")?;
+    let stdout = child.stdout.take().ok_or("无法获取 stdout")?;
+    let stderr = child.stderr.take();
+
+    // 读取线程：解析 Content-Length 帧，原样转发 JSON 给前端
+    let app_reader = app.clone();
+    let lang_reader = language.clone();
+    std::thread::spawn(move || {
+        let mut reader = BufReader::new(stdout);
+        loop {
+            match read_message(&mut reader) {
+                Some(body) => {
+                    let _ = app_reader.emit(
+                        "lsp:message",
+                        LspEvent {
+                            language: lang_reader.clone(),
+                            message: body,
+                        },
+                    );
+                }
+                None => break,
+            }
+        }
+        let _ = app_reader.emit("lsp:exit", lang_reader.clone());
+    });
+
+    // 排空 stderr，避免阻塞
+    if let Some(mut err) = stderr {
+        std::thread::spawn(move || {
+            let mut buf = [0u8; 4096];
+            while let Ok(n) = err.read(&mut buf) {
+                if n == 0 {
+                    break;
+                }
+            }
+        });
+    }
+
+    state
+        .servers
+        .lock()
+        .map_err(|e| e.to_string())?
+        .insert(language, Server { child, stdin });
+    Ok(true)
+}
+
+/// 向语言服务器发送一条 JSON-RPC（已是完整 JSON 字符串）
+#[tauri::command]
+pub fn lsp_send(state: State<'_, LspState>, language: String, message: String) -> Result<(), String> {
+    let mut servers = state.servers.lock().map_err(|e| e.to_string())?;
+    let server = servers
+        .get_mut(&language)
+        .ok_or_else(|| "语言服务器未启动".to_string())?;
+    let frame = format!("Content-Length: {}\r\n\r\n{}", message.as_bytes().len(), message);
+    server
+        .stdin
+        .write_all(frame.as_bytes())
+        .map_err(|e| e.to_string())?;
+    server.stdin.flush().map_err(|e| e.to_string())?;
+    Ok(())
+}
+
+/// 停止语言服务器
+#[tauri::command]
+pub fn lsp_stop(state: State<'_, LspState>, language: String) -> Result<(), String> {
+    if let Some(mut server) = state
+        .servers
+        .lock()
+        .map_err(|e| e.to_string())?
+        .remove(&language)
+    {
+        let _ = server.child.kill();
+    }
+    Ok(())
+}
+
+/// 读取一条 LSP 消息（Content-Length 帧）；EOF 返回 None
+fn read_message<R: Read>(reader: &mut BufReader<R>) -> Option<String> {
+    let mut content_length: usize = 0;
+    // 逐字节读 header 行直到空行
+    loop {
+        let line = read_line(reader)?;
+        if line.is_empty() {
+            break;
+        }
+        if let Some(rest) = line.strip_prefix("Content-Length:") {
+            content_length = rest.trim().parse().unwrap_or(0);
+        }
+    }
+    if content_length == 0 {
+        return Some(String::new());
+    }
+    let mut body = vec![0u8; content_length];
+    reader.read_exact(&mut body).ok()?;
+    Some(String::from_utf8_lossy(&body).to_string())
+}
+
+/// 读取一行（以 \r\n 结尾），返回不含结尾的内容；EOF 返回 None
+fn read_line<R: Read>(reader: &mut BufReader<R>) -> Option<String> {
+    let mut buf = Vec::new();
+    let mut byte = [0u8; 1];
+    loop {
+        match reader.read(&mut byte) {
+            Ok(0) => return None,
+            Ok(_) => {
+                if byte[0] == b'\n' {
+                    if buf.last() == Some(&b'\r') {
+                        buf.pop();
+                    }
+                    return Some(String::from_utf8_lossy(&buf).to_string());
+                }
+                buf.push(byte[0]);
+            }
+            Err(_) => return None,
+        }
+    }
+}
diff --git a/src-tauri/src/main.rs b/src-tauri/src/main.rs
index 3f16a92..c241e84 100644
--- a/src-tauri/src/main.rs
+++ b/src-tauri/src/main.rs
@@ -18,6 +18,7 @@ mod filesystem;
 mod font;
 mod kv;
 mod logger;
+mod lsp;
 mod plugin;
 mod plugins;
 mod setup;
@@ -58,6 +59,7 @@ use crate::filesystem::{
     reveal_path, search_in_files, watch_directory, write_file_text,
 };
 use crate::kv::{KvStore, kv_delete, kv_get_all, kv_set};
+use crate::lsp::{LspState, lsp_available, lsp_send, lsp_start, lsp_stop};
 use crate::plugin::{get_info, get_supported_languages};
 use crate::setup::app::get_app_info;
 use crate::snippets::{Snippets, delete_snippet, get_snippets, save_snippet};
@@ -97,6 +99,7 @@ fn main() {
         .manage(Snippets::new().expect("failed to initialize snippets database"))
         .manage(KvStore::new().expect("failed to initialize kv store database"))
         .manage(TerminalState::new())
+        .manage(LspState::new())
         .manage(ExecutionPluginManagerState::new(PluginManager::new()))
         .manage(EnvironmentManagerState::new(env_manager))
         .setup(|app| {
@@ -226,7 +229,12 @@ fn main() {
             terminal_resize,
             terminal_kill,
             // SQL 执行
-            run_sql
+            run_sql,
+            // LSP 桥接
+            lsp_available,
+            lsp_start,
+            lsp_send,
+            lsp_stop
         ])
         .run(tauri::generate_context!())
         .expect("error while running tauri application");

From e30778267993682ca220d4a4c819453e02d1f17d Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Mon, 8 Jun 2026 09:57:51 +0800
Subject: [PATCH 12/25] =?UTF-8?q?feat(lsp):=20=E5=89=8D=E7=AB=AF=E6=8E=A5?=
 =?UTF-8?q?=E5=85=A5=20LSP(=E8=A1=A5=E5=85=A8/=E6=82=AC=E6=B5=AE/=E8=AF=8A?=
 =?UTF-8?q?=E6=96=AD/=E8=B7=B3=E8=BD=AC/=E9=87=8D=E5=91=BD=E5=90=8D)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 新增 lspTransport: 把 codemirror-languageserver 的 Transport 桥到 Tauri 命令/事件
- 新增 lspExtension: 按语言+文件构建 LSP 扩展, 语言/服务器不可用时返回 null(不影响编辑器)
- useCodeMirrorEditor: 有文件且服务器可用时挂载 LSP, 文件切换就地重配置
- CodeEditor/App 传入 filePath/rootDir
- 引入 codemirror-languageserver 等依赖
---
 package.json                           |  3 +
 src/App.vue                            |  4 +-
 src/components/CodeEditor.vue          |  2 +
 src/composables/useCodeMirrorEditor.ts | 21 +++++++
 src/editor/lspExtension.ts             | 78 ++++++++++++++++++++++++++
 src/editor/lspTransport.ts             | 60 ++++++++++++++++++++
 6 files changed, 166 insertions(+), 2 deletions(-)
 create mode 100644 src/editor/lspExtension.ts
 create mode 100644 src/editor/lspTransport.ts

diff --git a/package.json b/package.json
index 6517b14..e87ff95 100644
--- a/package.json
+++ b/package.json
@@ -29,6 +29,7 @@
     "@codemirror/legacy-modes": "^6.5.1",
     "@codemirror/state": "^6.5.2",
     "@codemirror/view": "^6.38.1",
+    "@open-rpc/client-js": "^2.0.0",
     "@tauri-apps/api": "^2",
     "@tauri-apps/plugin-dialog": "^2.3.2",
     "@tauri-apps/plugin-fs": "^2.4.2",
@@ -39,6 +40,7 @@
     "@xterm/addon-fit": "^0.11.0",
     "@xterm/xterm": "^6.0.0",
     "codemirror": "^6.0.2",
+    "codemirror-languageserver": "^1.22.0",
     "dompurify": "^3.4.8",
     "echarts": "^6.1.0",
     "echarts-liquidfill": "^3.1.0",
@@ -47,6 +49,7 @@
     "lodash-es": "^4.17.21",
     "lucide-vue-next": "^0.539.0",
     "markdown-it": "^14.2.0",
+    "vscode-languageserver-protocol": "^3.18.0",
     "vue": "^3.5.13",
     "vue-codemirror": "^6.1.1",
     "vue3-markdown-it": "^1.0.10",
diff --git a/src/App.vue b/src/App.vue
index 9b73ac4..589c822 100644
--- a/src/App.vue
+++ b/src/App.vue
@@ -106,7 +106,7 @@
                 </div>
               </div>
               <div class="flex-1 overflow-hidden relative">
-                <CodeEditor v-model="code" class="h-full" :language="currentLanguage" :editor-config="editorConfig" :key="editorConfigKey" @ready="editorView = $event"/>
+                <CodeEditor v-model="code" class="h-full" :language="currentLanguage" :file-path="currentFilePath" :root-dir="rootDir" :editor-config="editorConfig" :key="editorConfigKey" @ready="editorView = $event"/>
                 <LargeFileViewer v-if="showViewer && viewerFile"
                                  :file-path="viewerFile.path"
                                  :line-count="viewerFile.lineCount"
@@ -241,7 +241,7 @@
           </div>
         </div>
         <div class="flex-1 overflow-hidden relative">
-          <CodeEditor v-model="code" class="h-full" :language="currentLanguage" :editor-config="editorConfig" :key="editorConfigKey" @ready="editorView = $event"/>
+          <CodeEditor v-model="code" class="h-full" :language="currentLanguage" :file-path="currentFilePath" :root-dir="rootDir" :editor-config="editorConfig" :key="editorConfigKey" @ready="editorView = $event"/>
           <LargeFileViewer v-if="showViewer && viewerFile"
                            :file-path="viewerFile.path"
                            :line-count="viewerFile.lineCount"
diff --git a/src/components/CodeEditor.vue b/src/components/CodeEditor.vue
index 4691fa4..2a6ae95 100644
--- a/src/components/CodeEditor.vue
+++ b/src/components/CodeEditor.vue
@@ -19,6 +19,8 @@ import { useCodeMirrorEditor } from '../composables/useCodeMirrorEditor'
 const props = defineProps<{
   modelValue: string
   language?: string
+  filePath?: string | null
+  rootDir?: string | null
 }>()
 
 const emit = defineEmits<{
diff --git a/src/composables/useCodeMirrorEditor.ts b/src/composables/useCodeMirrorEditor.ts
index e7e7a59..7c79398 100644
--- a/src/composables/useCodeMirrorEditor.ts
+++ b/src/composables/useCodeMirrorEditor.ts
@@ -85,11 +85,14 @@ import {markdown} from "@codemirror/lang-markdown";
 import {yaml} from "@codemirror/lang-yaml";
 import {sql} from "@codemirror/lang-sql";
 import {useSnippets} from "./useSnippets";
+import {createLspExtensions} from "../editor/lspExtension";
 
 interface Props
 {
     modelValue: string
     language?: string
+    filePath?: string | null
+    rootDir?: string | null
 }
 
 export function useCodeMirrorEditor(props: Props)
@@ -381,6 +384,19 @@ export function useCodeMirrorEditor(props: Props)
             }
         }
 
+        // LSP 语义能力（补全/悬浮/诊断/跳转/重命名）；无服务器时为 null，不影响编辑器
+        if (props.language && props.filePath) {
+            try {
+                const lsp = await createLspExtensions(props.language, props.filePath, props.rootDir)
+                if (lsp) {
+                    result.push(lsp)
+                }
+            }
+            catch (e) {
+                console.warn('LSP 初始化失败:', e)
+            }
+        }
+
         // 处理行号显示逻辑
         const shouldShowLineNumbers = showLineNumbers ?? editorConfig.value?.show_line_numbers ?? false
         // 如果配置为不显示行号，则添加隐藏行号的扩展
@@ -473,6 +489,11 @@ export function useCodeMirrorEditor(props: Props)
         await reRenderEditor()
     }, {immediate: false})
 
+    // 文件切换：重建扩展以切换 LSP 文档（就地重配置，避免闪烁）
+    watch(() => props.filePath, async () => {
+        await updateExtensions()
+    }, {immediate: false})
+
     // 监听编辑器配置变化
     watch(() => editorConfig.value?.theme, async (newTheme, oldTheme) => {
         if (newTheme && newTheme !== oldTheme) {
diff --git a/src/editor/lspExtension.ts b/src/editor/lspExtension.ts
new file mode 100644
index 0000000..3405361
--- /dev/null
+++ b/src/editor/lspExtension.ts
@@ -0,0 +1,78 @@
+// 根据语言/文件构建 CodeMirror LSP 扩展（补全、悬浮、诊断、跳转、重命名）
+import {invoke} from '@tauri-apps/api/core'
+import {languageServerWithTransport} from 'codemirror-languageserver'
+import {TauriLspTransport} from './lspTransport'
+
+// CodeForge 语言 key → LSP languageId（与后端 server_cmd 对应）
+const LANGUAGE_ID: Record<string, string> = {
+  python3: 'python',
+  python2: 'python',
+  python: 'python',
+  typescript: 'typescript',
+  'typescript-nodejs': 'typescript',
+  'typescript-browser': 'typescript',
+  'javascript-nodejs': 'javascript',
+  'javascript-browser': 'javascript',
+  'javascript-jquery': 'javascript',
+  nodejs: 'javascript',
+  rust: 'rust',
+  go: 'go',
+  c: 'c',
+  cpp: 'cpp',
+  'objective-c': 'objective-c',
+  'objective-cpp': 'objective-cpp',
+  lua: 'lua',
+  php: 'php',
+  ruby: 'ruby',
+  html: 'html',
+  css: 'css',
+  json: 'json'
+}
+
+export const lspSupportsLanguage = (language?: string): boolean =>
+  !!language && language in LANGUAGE_ID
+
+const toUri = (p: string): string =>
+  'file://' + encodeURI(p.replace(/\\/g, '/')).replace(/#/g, '%23').replace(/\?/g, '%3F')
+
+/**
+ * 构建当前文件的 LSP 扩展；语言不支持 / 无文件 / 服务器不可用时返回 null。
+ */
+export async function createLspExtensions(
+  language: string | undefined,
+  filePath: string | null | undefined,
+  rootDir?: string | null
+): Promise<any | null> {
+  if (!language || !filePath) {
+    return null
+  }
+  const languageId = LANGUAGE_ID[language]
+  if (!languageId) {
+    return null
+  }
+  let available = false
+  try {
+    available = await invoke<boolean>('lsp_available', {language})
+  }
+  catch {
+    available = false
+  }
+  if (!available) {
+    return null
+  }
+  try {
+    const transport = new TauriLspTransport(language)
+    const rootUri = rootDir ? toUri(rootDir) : null
+    return languageServerWithTransport({
+      transport,
+      rootUri,
+      workspaceFolders: rootUri ? [{uri: rootUri, name: 'workspace'}] : null,
+      documentUri: toUri(filePath),
+      languageId,
+      allowHTMLContent: true
+    })
+  }
+  catch {
+    return null
+  }
+}
diff --git a/src/editor/lspTransport.ts b/src/editor/lspTransport.ts
new file mode 100644
index 0000000..491793e
--- /dev/null
+++ b/src/editor/lspTransport.ts
@@ -0,0 +1,60 @@
+// 将 codemirror-languageserver 的 Transport 桥接到 Tauri 后端 LSP 命令/事件
+import {invoke} from '@tauri-apps/api/core'
+import {listen, type UnlistenFn} from '@tauri-apps/api/event'
+import type {Transport} from 'codemirror-languageserver'
+
+export class TauriLspTransport implements Transport {
+  private language: string
+  private msgCb: ((m: string) => void) | null = null
+  private closeCb: (() => void) | null = null
+  private errorCb: ((e: Error) => void) | null = null
+  private unlisten: UnlistenFn[] = []
+  private ready: Promise<void>
+
+  constructor(language: string) {
+    this.language = language
+    this.ready = this.init()
+  }
+
+  private async init() {
+    const un1 = await listen<{ language: string; message: string }>('lsp:message', (e) => {
+      if (e.payload.language === this.language) {
+        this.msgCb?.(e.payload.message)
+      }
+    })
+    const un2 = await listen<string>('lsp:exit', (e) => {
+      if (e.payload === this.language) {
+        this.closeCb?.()
+      }
+    })
+    this.unlisten = [un1, un2]
+    await invoke('lsp_start', {language: this.language})
+  }
+
+  send(message: string): void {
+    // 等服务器启动后再发，保持顺序
+    this.ready
+      .then(() => invoke('lsp_send', {language: this.language, message}))
+      .catch((e) => this.errorCb?.(new Error(String(e))))
+  }
+
+  onMessage(callback: (message: string) => void): void {
+    this.msgCb = callback
+  }
+
+  onClose(callback: () => void): void {
+    this.closeCb = callback
+  }
+
+  onError(callback: (error: Error) => void): void {
+    this.errorCb = callback
+  }
+
+  close(): void {
+    for (const u of this.unlisten) {
+      u()
+    }
+    this.unlisten = []
+    // 不停止服务器进程，保持热以便同语言其它文件复用
+  }
+}

From 3744b9745bc5dc8eaaedf7fef31ed650a63409fd Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Mon, 8 Jun 2026 09:58:48 +0800
Subject: [PATCH 13/25] =?UTF-8?q?docs:=20README=20=E8=A1=A5=E5=85=85=20LSP?=
 =?UTF-8?q?=20=E8=AF=AD=E4=B9=89=E8=83=BD=E5=8A=9B=E4=B8=8E=E6=89=80?=
 =?UTF-8?q?=E9=9C=80=E8=AF=AD=E8=A8=80=E6=9C=8D=E5=8A=A1=E5=99=A8?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 4f7678b..7faa376 100644
--- a/README.md
+++ b/README.md
@@ -35,6 +35,7 @@
 - **快速打开**（`Cmd/Ctrl + P`）—— 模糊匹配 + 最近文件优先
 - **符号大纲**（`Cmd/Ctrl + Shift + O`）、**跳转到行**（`Cmd/Ctrl + G`）
 - **代码片段** —— 自定义前缀，输入后按 `Tab` 展开（`$0` 为光标落点）
+- **LSP 语义能力** —— 接入语言服务器，提供精准补全、悬浮文档、跳转定义、查找引用、重命名与实时诊断（需本机安装对应语言服务器，未安装则自动回退，不影响编辑）
 - **会话恢复** —— 重启自动恢复上次的文件夹与标签页
 - **深色模式** —— 跟随系统 / 浅色 / 深色，编辑器主题同步切换
 
@@ -153,7 +154,9 @@ pnpm tauri build
 | 前端 | Vue 3 · TypeScript · Tailwind CSS · CodeMirror 6 · ECharts |
 | 后端 | Rust · Tauri 2（rusqlite · mysql） |
 | 存储 | SQLite（执行历史 / AI 对话 / 代码片段 / 应用配置统一入库） |
-| 架构 | 插件化语言支持系统 · 插件式数据库执行器 · 可复用图表组件 |
+| 架构 | 插件化语言支持系统 · 插件式数据库执行器 · 可复用图表组件 · LSP 桥接 |
+
+> **LSP 语言服务器**（可选，按需安装）：Python `pyright`、TS/JS `typescript-language-server`、Rust `rust-analyzer`、Go `gopls`、C/C++ `clangd`、Lua `lua-language-server`、PHP `intelephense`、Ruby `solargraph`、HTML/CSS/JSON `vscode-langservers-extracted`。未安装的语言会自动跳过 LSP，仅用基础高亮 + AI 预测。
 
 ---
 

From 5bf042737fa32be2d47c9b39a75a661d79166ad5 Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Mon, 8 Jun 2026 10:06:47 +0800
Subject: [PATCH 14/25] =?UTF-8?q?feat(lsp):=20=E8=AE=BE=E7=BD=AE=E9=A1=B5?=
 =?UTF-8?q?=E3=80=8C=E8=AF=AD=E8=A8=80=E6=9C=8D=E5=8A=A1=E3=80=8D=E9=9D=A2?=
 =?UTF-8?q?=E6=9D=BF=EF=BC=8C=E4=B8=80=E9=94=AE=E5=AE=89=E8=A3=85=E8=AF=AD?=
 =?UTF-8?q?=E8=A8=80=E6=9C=8D=E5=8A=A1=E5=99=A8?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 后端 lsp_server_list/lsp_install: 列出状态并执行安装命令, 实时输出日志(lsp:install/lsp:install-done)
- 新增设置「语言服务」标签: 显示各语言服务器是否已安装, 未装可一键安装并看日志, 装完自动重检
- 安装走 npm/rustup/go/brew/gem, 失败可按提示手动安装
---
 src-tauri/src/lsp.rs           | 124 +++++++++++++++++++++++++++++++++
 src-tauri/src/main.rs          |   8 ++-
 src/components/Settings.vue    |   6 ++
 src/components/setting/Lsp.vue |  98 ++++++++++++++++++++++++++
 src/composables/useSettings.ts |   3 +-
 5 files changed, 236 insertions(+), 3 deletions(-)
 create mode 100644 src/components/setting/Lsp.vue

diff --git a/src-tauri/src/lsp.rs b/src-tauri/src/lsp.rs
index 21aa572..a674184 100644
--- a/src-tauri/src/lsp.rs
+++ b/src-tauri/src/lsp.rs
@@ -53,6 +53,130 @@ fn server_cmd(language: &str) -> Option<(&'static str, Vec<&'static str>)> {
     }
 }
 
+/// 可在设置中一键安装的语言服务器清单（用于检测与安装）
+/// (id, 展示名, 用于检测的可执行名, 安装命令)
+fn server_defs() -> Vec<(&'static str, &'static str, &'static str, &'static str)> {
+    vec![
+        ("python", "Python (pyright)", "pyright-langserver", "npm i -g pyright"),
+        (
+            "typescript",
+            "TypeScript / JavaScript",
+            "typescript-language-server",
+            "npm i -g typescript-language-server typescript",
+        ),
+        ("rust", "Rust (rust-analyzer)", "rust-analyzer", "rustup component add rust-analyzer"),
+        ("go", "Go (gopls)", "gopls", "go install golang.org/x/tools/gopls@latest"),
+        ("clangd", "C / C++ (clangd)", "clangd", "brew install llvm"),
+        ("lua", "Lua", "lua-language-server", "brew install lua-language-server"),
+        ("php", "PHP (intelephense)", "intelephense", "npm i -g intelephense"),
+        ("ruby", "Ruby (solargraph)", "solargraph", "gem install solargraph"),
+        (
+            "web",
+            "HTML / CSS / JSON",
+            "vscode-html-language-server",
+            "npm i -g vscode-langservers-extracted",
+        ),
+    ]
+}
+
+#[derive(Serialize)]
+pub struct LspServerInfo {
+    id: String,
+    label: String,
+    program: String,
+    installed: bool,
+    install: String,
+}
+
+/// 列出可安装的语言服务器及其安装状态
+#[tauri::command]
+pub fn lsp_server_list() -> Vec<LspServerInfo> {
+    server_defs()
+        .into_iter()
+        .map(|(id, label, program, install)| LspServerInfo {
+            id: id.to_string(),
+            label: label.to_string(),
+            program: program.to_string(),
+            installed: find_in_path(program).is_some(),
+            install: install.to_string(),
+        })
+        .collect()
+}
+
+/// 一键安装某语言服务器：执行其安装命令并实时输出日志（事件 lsp:install / lsp:install-done）
+#[tauri::command]
+pub fn lsp_install(app: AppHandle, id: String) -> Result<(), String> {
+    let def = server_defs()
+        .into_iter()
+        .find(|(d, ..)| *d == id)
+        .ok_or_else(|| "未知的语言服务器".to_string())?;
+    let cmd_str = def.3.to_string();
+
+    let (shell, flag) = if cfg!(windows) { ("cmd", "/C") } else { ("sh", "-c") };
+    let mut child = Command::new(shell)
+        .arg(flag)
+        .arg(&cmd_str)
+        .env("PATH", augmented_path())
+        .stdout(Stdio::piped())
+        .stderr(Stdio::piped())
+        .spawn()
+        .map_err(|e| format!("无法执行安装命令: {}", e))?;
+
+    let stdout = child.stdout.take();
+    let stderr = child.stderr.take();
+    let id_done = id.clone();
+    let app_done = app.clone();
+
+    let emit_lines = |app: AppHandle, id: String, reader: Option<Box<dyn Read + Send>>| {
+        if let Some(r) = reader {
+            std::thread::spawn(move || {
+                let mut buf = BufReader::new(r);
+                loop {
+                    match read_raw_line(&mut buf) {
+                        Some(line) => {
+                            let _ = app.emit("lsp:install", (id.clone(), line));
+                        }
+                        None => break,
+                    }
+                }
+            });
+        }
+    };
+    emit_lines(app.clone(), id.clone(), stdout.map(|s| Box::new(s) as Box<dyn Read + Send>));
+    emit_lines(app.clone(), id.clone(), stderr.map(|s| Box::new(s) as Box<dyn Read + Send>));
+
+    std::thread::spawn(move || {
+        let success = child.wait().map(|s| s.success()).unwrap_or(false);
+        let _ = app_done.emit("lsp:install-done", (id_done, success));
+    });
+    Ok(())
+}
+
+/// 读取一行普通文本（以 \n 结尾，用于安装日志）
+fn read_raw_line<R: Read>(reader: &mut BufReader<R>) -> Option<String> {
+    let mut buf = Vec::new();
+    let mut byte = [0u8; 1];
+    loop {
+        match reader.read(&mut byte) {
+            Ok(0) => {
+                if buf.is_empty() {
+                    return None;
+                }
+                return Some(String::from_utf8_lossy(&buf).to_string());
+            }
+            Ok(_) => {
+                if byte[0] == b'\n' {
+                    return Some(String::from_utf8_lossy(&buf).to_string());
+                }
+                if byte[0] != b'\r' {
+                    buf.push(byte[0]);
+                }
+            }
+            Err(_) => return None,
+        }
+    }
+}
+
 /// GUI 应用 PATH 常缺失，补充常见安装目录
 fn extra_bin_dirs() -> Vec<PathBuf> {
     let mut dirs = vec![
diff --git a/src-tauri/src/main.rs b/src-tauri/src/main.rs
index c241e84..e0656b5 100644
--- a/src-tauri/src/main.rs
+++ b/src-tauri/src/main.rs
@@ -59,7 +59,9 @@ use crate::filesystem::{
     reveal_path, search_in_files, watch_directory, write_file_text,
 };
 use crate::kv::{KvStore, kv_delete, kv_get_all, kv_set};
-use crate::lsp::{LspState, lsp_available, lsp_send, lsp_start, lsp_stop};
+use crate::lsp::{
+    LspState, lsp_available, lsp_install, lsp_send, lsp_server_list, lsp_start, lsp_stop,
+};
 use crate::plugin::{get_info, get_supported_languages};
 use crate::setup::app::get_app_info;
 use crate::snippets::{Snippets, delete_snippet, get_snippets, save_snippet};
@@ -234,7 +236,9 @@ fn main() {
             lsp_available,
             lsp_start,
             lsp_send,
-            lsp_stop
+            lsp_stop,
+            lsp_server_list,
+            lsp_install
         ])
         .run(tauri::generate_context!())
         .expect("error while running tauri application");
diff --git a/src/components/Settings.vue b/src/components/Settings.vue
index 7b73e63..ecfd946 100644
--- a/src/components/Settings.vue
+++ b/src/components/Settings.vue
@@ -36,6 +36,11 @@
         <Language v-if="activeTab === 'language'" @settings-changed="handleLanguageSettingsChanged"/>
       </template>
 
+      <!-- 语言服务（LSP） -->
+      <template #lsp>
+        <Lsp v-if="activeTab === 'lsp'"/>
+      </template>
+
       <!-- 网络配置 -->
       <template #network>
         <Network v-if="activeTab === 'network'" @settings-changed="handleNetworkSettingsChanged" @error="handleEditorError"/>
@@ -64,6 +69,7 @@ import Editor from './setting/Editor.vue'
 import Shortcut from './setting/Shortcut.vue'
 import Ai from './setting/Ai.vue'
 import Database from './setting/Database.vue'
+import Lsp from './setting/Lsp.vue'
 import Network from './setting/Network.vue'
 import Cache from './setting/Cache.vue'
 import Logs from './setting/Logs.vue'
diff --git a/src/components/setting/Lsp.vue b/src/components/setting/Lsp.vue
new file mode 100644
index 0000000..1fcf7ee
--- /dev/null
+++ b/src/components/setting/Lsp.vue
@@ -0,0 +1,98 @@
+<template>
+  <div class="space-y-4">
+    <div class="flex items-center justify-between">
+      <div>
+        <h3 class="text-sm font-medium text-gray-800 dark:text-gray-100">语言服务（LSP）</h3>
+        <p class="text-xs text-gray-500 dark:text-gray-400 mt-0.5">安装后可获得精准补全、悬浮文档、跳转定义、查找引用、重命名与实时诊断</p>
+      </div>
+      <button class="inline-flex items-center gap-1 px-2 py-1 text-xs rounded border border-gray-200 dark:border-gray-700 text-gray-600 dark:text-gray-300 hover:bg-gray-100 dark:hover:bg-gray-700 cursor-pointer" @click="reload">
+        <RefreshCw class="w-3.5 h-3.5" :class="loading ? 'animate-spin' : ''"/>重新检测
+      </button>
+    </div>
+
+    <div class="space-y-2">
+      <div v-for="s in servers" :key="s.id" class="rounded-lg border border-gray-200 dark:border-gray-700 p-3">
+        <div class="flex items-center gap-3">
+          <span class="w-2 h-2 rounded-full flex-shrink-0" :class="s.installed ? 'bg-emerald-500' : 'bg-gray-300 dark:bg-gray-600'"/>
+          <div class="min-w-0 flex-1">
+            <div class="text-sm text-gray-800 dark:text-gray-100">{{ s.label }}</div>
+            <code class="text-[11px] text-gray-400">{{ s.install }}</code>
+          </div>
+          <span v-if="s.installed" class="text-xs text-emerald-600 dark:text-emerald-400 flex-shrink-0">已安装</span>
+          <button v-else class="px-2.5 py-1 text-xs rounded bg-blue-500 text-white hover:bg-blue-600 disabled:opacity-50 cursor-pointer flex-shrink-0"
+                  :disabled="installing === s.id" @click="install(s)">
+            <RefreshCw v-if="installing === s.id" class="w-3 h-3 animate-spin inline"/>
+            {{ installing === s.id ? '安装中…' : '安装' }}
+          </button>
+        </div>
+        <!-- 安装日志 -->
+        <pre v-if="logs[s.id]" class="mt-2 max-h-32 overflow-auto rounded bg-gray-950 text-gray-300 text-[11px] p-2 whitespace-pre-wrap">{{ logs[s.id] }}</pre>
+      </div>
+    </div>
+
+    <p class="text-[11px] text-gray-400 leading-relaxed">
+      自动安装依赖本机已具备对应工具链：npm（pyright / typescript / intelephense / vscode-langservers-extracted）、rustup（rust-analyzer）、go（gopls）、Homebrew（clangd / lua-language-server）、gem（solargraph）。
+      若安装失败，可按上方命令手动安装后点「重新检测」。安装完成后请重启应用以加载新服务器。
+    </p>
+  </div>
+</template>
+
+<script setup lang="ts">
+import {onMounted, onUnmounted, ref} from 'vue'
+import {invoke} from '@tauri-apps/api/core'
+import {listen, type UnlistenFn} from '@tauri-apps/api/event'
+import {RefreshCw} from 'lucide-vue-next'
+
+interface ServerInfo { id: string; label: string; program: string; installed: boolean; install: string }
+
+const servers = ref<ServerInfo[]>([])
+const loading = ref(false)
+const installing = ref('')
+const logs = ref<Record<string, string>>({})
+let unlisten: UnlistenFn[] = []
+
+const reload = async () => {
+  loading.value = true
+  try {
+    servers.value = await invoke<ServerInfo[]>('lsp_server_list')
+  }
+  catch {
+    servers.value = []
+  }
+  finally {
+    loading.value = false
+  }
+}
+
+const install = async (s: ServerInfo) => {
+  installing.value = s.id
+  logs.value = {...logs.value, [s.id]: '开始安装…\n'}
+  try {
+    await invoke('lsp_install', {id: s.id})
+  }
+  catch (e: any) {
+    logs.value = {...logs.value, [s.id]: (logs.value[s.id] || '') + '启动安装失败：' + String(e?.message || e) + '\n'}
+    installing.value = ''
+  }
+}
+
+onMounted(async () => {
+  await reload()
+  unlisten.push(await listen<[string, string]>('lsp:install', (e) => {
+    const [id, line] = e.payload
+    logs.value = {...logs.value, [id]: (logs.value[id] || '') + line + '\n'}
+  }))
+  unlisten.push(await listen<[string, boolean]>('lsp:install-done', async (e) => {
+    const [id, success] = e.payload
+    logs.value = {...logs.value, [id]: (logs.value[id] || '') + (success ? '\n✓ 安装完成' : '\n✗ 安装失败') + '\n'}
+    installing.value = ''
+    await reload()
+  }))
+})
+onUnmounted(() => {
+  for (const u of unlisten) {
+    u()
+  }
+  unlisten = []
+})
+</script>
diff --git a/src/composables/useSettings.ts b/src/composables/useSettings.ts
index 3ec1e78..3a8eb2e 100644
--- a/src/composables/useSettings.ts
+++ b/src/composables/useSettings.ts
@@ -1,5 +1,5 @@
 import { nextTick, ref } from 'vue'
-import { BracesIcon, CodeIcon, Database, FileText, Globe, Keyboard, Server, ShieldIcon, Sparkles } from 'lucide-vue-next'
+import { BracesIcon, CodeIcon, Cpu, Database, FileText, Globe, Keyboard, Server, ShieldIcon, Sparkles } from 'lucide-vue-next'
 
 export function useSettings(emit: any)
 {
@@ -15,6 +15,7 @@ export function useSettings(emit: any)
         { key: 'ai', label: 'AI', icon: Sparkles },
         { key: 'database', label: '数据库', icon: Server },
         { key: 'language', label: '语言', icon: BracesIcon },
+        { key: 'lsp', label: '语言服务', icon: Cpu },
         { key: 'network', label: '网络', icon: Globe },
         { key: 'cache', label: '缓存', icon: Database },
         { key: 'logs', label: '日志', icon: FileText }

From f5b484bc9c035990330ae50e04ba5341bac2b304 Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Mon, 8 Jun 2026 10:14:13 +0800
Subject: [PATCH 15/25] =?UTF-8?q?fix(lsp):=20=E8=8D=89=E7=A8=BF(=E6=9C=AA?=
 =?UTF-8?q?=E4=BF=9D=E5=AD=98)=E6=96=87=E4=BB=B6=E4=B9=9F=E5=90=AF?=
 =?UTF-8?q?=E7=94=A8=20LSP?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 无文件路径时用 untitled: 文档 URI(语言服务器按内存内容分析)
- 放开仅已保存文件才挂载 LSP 的限制; 默认 Python 草稿即可触发诊断/补全
- autoClose:true 避免扩展重建时事件监听泄漏
---
 src/composables/useCodeMirrorEditor.ts |  4 ++--
 src/editor/lspExtension.ts             | 18 +++++++++++++++---
 2 files changed, 17 insertions(+), 5 deletions(-)

diff --git a/src/composables/useCodeMirrorEditor.ts b/src/composables/useCodeMirrorEditor.ts
index 7c79398..09925ac 100644
--- a/src/composables/useCodeMirrorEditor.ts
+++ b/src/composables/useCodeMirrorEditor.ts
@@ -384,8 +384,8 @@ export function useCodeMirrorEditor(props: Props)
             }
         }
 
-        // LSP 语义能力（补全/悬浮/诊断/跳转/重命名）；无服务器时为 null，不影响编辑器
-        if (props.language && props.filePath) {
+        // LSP 语义能力（补全/悬浮/诊断/跳转/重命名）；草稿用 untitled 文档，无服务器时为 null
+        if (props.language) {
             try {
                 const lsp = await createLspExtensions(props.language, props.filePath, props.rootDir)
                 if (lsp) {
diff --git a/src/editor/lspExtension.ts b/src/editor/lspExtension.ts
index 3405361..a0bdd0b 100644
--- a/src/editor/lspExtension.ts
+++ b/src/editor/lspExtension.ts
@@ -29,6 +29,13 @@ const LANGUAGE_ID: Record<string, string> = {
   json: 'json'
 }
 
+// 草稿(未保存)时用的文件扩展名，构造 untitled 文档 URI
+const LANGUAGE_EXT: Record<string, string> = {
+  python: 'py', typescript: 'ts', javascript: 'js', rust: 'rs', go: 'go',
+  c: 'c', cpp: 'cpp', 'objective-c': 'm', 'objective-cpp': 'mm',
+  lua: 'lua', php: 'php', ruby: 'rb', html: 'html', css: 'css', json: 'json'
+}
+
 export const lspSupportsLanguage = (language?: string): boolean =>
   !!language && language in LANGUAGE_ID
 
@@ -43,7 +50,7 @@ export async function createLspExtensions(
   filePath: string | null | undefined,
   rootDir?: string | null
 ): Promise<any | null> {
-  if (!language || !filePath) {
+  if (!language) {
     return null
   }
   const languageId = LANGUAGE_ID[language]
@@ -63,13 +70,18 @@ export async function createLspExtensions(
   try {
     const transport = new TauriLspTransport(language)
     const rootUri = rootDir ? toUri(rootDir) : null
+    // 已保存文件用真实路径；草稿用 untitled 文档 URI（语言服务器按内存内容分析）
+    const documentUri = filePath
+      ? toUri(filePath)
+      : `untitled:Untitled.${LANGUAGE_EXT[languageId] || 'txt'}`
     return languageServerWithTransport({
       transport,
       rootUri,
       workspaceFolders: rootUri ? [{uri: rootUri, name: 'workspace'}] : null,
-      documentUri: toUri(filePath),
+      documentUri,
       languageId,
-      allowHTMLContent: true
+      allowHTMLContent: true,
+      autoClose: true
     })
   }
   catch {

From f0a64f52c6d38fb59a6ec5bdcdfc61d407bc88be Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Mon, 8 Jun 2026 10:17:50 +0800
Subject: [PATCH 16/25] =?UTF-8?q?fix(lsp):=20=E4=BF=AE=E6=AD=A3=E6=82=AC?=
 =?UTF-8?q?=E6=B5=AE=E7=AA=97=E9=94=99=E4=BD=8D=20+=20=E7=8A=B6=E6=80=81?=
 =?UTF-8?q?=E6=A0=8F=20LSP=20=E6=8C=87=E7=A4=BA?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- tooltip 挂到 document.body, 解决父级 transform/overflow 导致的悬浮窗错位
- 新增 lspStatus 共享状态, 状态栏显示绿色「LSP」表示当前语言已启用语言服务
---
 src/components/StatusBar.vue           | 7 +++++++
 src/composables/useCodeMirrorEditor.ts | 5 ++++-
 src/editor/lspExtension.ts             | 4 ++++
 src/editor/lspStatus.ts                | 9 +++++++++
 4 files changed, 24 insertions(+), 1 deletion(-)
 create mode 100644 src/editor/lspStatus.ts

diff --git a/src/components/StatusBar.vue b/src/components/StatusBar.vue
index ac5ec55..d9acbc4 100644
--- a/src/components/StatusBar.vue
+++ b/src/components/StatusBar.vue
@@ -22,6 +22,12 @@
     </div>
 
     <div class="flex items-center space-x-4">
+      <!-- LSP 状态 -->
+      <div v-if="lspState.status === 'on'" class="flex items-center space-x-1" :title="`语言服务已启用：${lspState.language}`">
+        <span class="w-1.5 h-1.5 rounded-full bg-emerald-300"/>
+        <span>LSP</span>
+      </div>
+
       <div class="flex items-center space-x-2">
         <Hash class="w-3 h-3 font-normal"/>
         <span><strong>{{ codeLength }}</strong> 字符</span>
@@ -41,6 +47,7 @@
 import { Clock, Hash, RefreshCw, Terminal as TerminalIcon } from 'lucide-vue-next'
 import { computed, toRefs } from 'vue'
 import { useStatusBar } from '../composables/useStatusBar'
+import { lspState } from '../editor/lspStatus'
 import { useShortcuts } from '../composables/useShortcuts'
 
 const props = defineProps<{
diff --git a/src/composables/useCodeMirrorEditor.ts b/src/composables/useCodeMirrorEditor.ts
index 09925ac..8bad6e5 100644
--- a/src/composables/useCodeMirrorEditor.ts
+++ b/src/composables/useCodeMirrorEditor.ts
@@ -74,7 +74,7 @@ import {StreamLanguage} from '@codemirror/language'
 import {EditorConfig} from '../types/app.ts'
 import {useCodeMirrorFunctionHelp} from './useCodeMirrorFunctionHelp'
 import {useCodeMirrorSpaceOmission} from './useCodeMirrorSpaceOmission.ts'
-import {EditorView, keymap} from "@codemirror/view";
+import {EditorView, keymap, tooltips} from "@codemirror/view";
 import {Prec} from "@codemirror/state";
 import {useCodeMirrorFontFamily} from "./useCodeMirrorFontFamily.ts";
 import {diffGutterExtension} from "../editor/diffGutter";
@@ -384,6 +384,9 @@ export function useCodeMirrorEditor(props: Props)
             }
         }
 
+        // tooltip 挂到 body，避免父级 transform/overflow 导致悬浮窗错位
+        result.push(tooltips({parent: document.body}))
+
         // LSP 语义能力（补全/悬浮/诊断/跳转/重命名）；草稿用 untitled 文档，无服务器时为 null
         if (props.language) {
             try {
diff --git a/src/editor/lspExtension.ts b/src/editor/lspExtension.ts
index a0bdd0b..628c00a 100644
--- a/src/editor/lspExtension.ts
+++ b/src/editor/lspExtension.ts
@@ -2,6 +2,7 @@
 import {invoke} from '@tauri-apps/api/core'
 import {languageServerWithTransport} from 'codemirror-languageserver'
 import {TauriLspTransport} from './lspTransport'
+import {setLspState} from './lspStatus'
 
 // CodeForge 语言 key → LSP languageId（与后端 server_cmd 对应）
 const LANGUAGE_ID: Record<string, string> = {
@@ -55,6 +56,7 @@ export async function createLspExtensions(
   }
   const languageId = LANGUAGE_ID[language]
   if (!languageId) {
+    setLspState(language || '', 'off')
     return null
   }
   let available = false
@@ -65,8 +67,10 @@ export async function createLspExtensions(
     available = false
   }
   if (!available) {
+    setLspState(language, 'off')
     return null
   }
+  setLspState(language, 'on')
   try {
     const transport = new TauriLspTransport(language)
     const rootUri = rootDir ? toUri(rootDir) : null
diff --git a/src/editor/lspStatus.ts b/src/editor/lspStatus.ts
new file mode 100644
index 0000000..cfc05e3
--- /dev/null
+++ b/src/editor/lspStatus.ts
@@ -0,0 +1,9 @@
+import {ref} from 'vue'
+
+// 当前编辑器语言的 LSP 状态（供状态栏显示）
+export type LspStatus = 'off' | 'on'
+export const lspState = ref<{ language: string; status: LspStatus }>({language: '', status: 'off'})
+
+export const setLspState = (language: string, status: LspStatus) => {
+  lspState.value = {language, status}
+}

From 9c3cee27aed206561f8c71fd79c7e73503f12af6 Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Mon, 8 Jun 2026 10:21:25 +0800
Subject: [PATCH 17/25] =?UTF-8?q?feat(lsp):=20=E8=87=AA=E5=AE=9A=E4=B9=89?=
 =?UTF-8?q?=E4=B8=BB=E9=A2=98=E5=8C=96=E6=8F=90=E7=A4=BA=E6=A1=86=20+=20?=
 =?UTF-8?q?=E4=BF=AE=E6=AD=A3=E5=AE=9A=E4=BD=8D=E4=BC=98=E5=85=88=E7=BA=A7?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- tooltip 配置用 Prec.highest + parent:body + position:fixed, 确保精确定位到悬停 token
- 新增 buildTooltipTheme: 悬浮文档/诊断/补全统一美化, 跟随明暗主题(圆角/阴影/代码块/选中态/诊断色条)
---
 src/composables/useCodeMirrorEditor.ts | 57 +++++++++++++++++++++++++-
 1 file changed, 55 insertions(+), 2 deletions(-)

diff --git a/src/composables/useCodeMirrorEditor.ts b/src/composables/useCodeMirrorEditor.ts
index 8bad6e5..208009f 100644
--- a/src/composables/useCodeMirrorEditor.ts
+++ b/src/composables/useCodeMirrorEditor.ts
@@ -95,6 +95,57 @@ interface Props
     rootDir?: string | null
 }
 
+// 自定义提示框样式（悬浮文档 / 诊断 / 补全），跟随明暗主题
+function buildTooltipTheme(dark: boolean) {
+    const bg = dark ? '#1f2937' : '#ffffff'
+    const border = dark ? '#374151' : '#e5e7eb'
+    const text = dark ? '#e5e7eb' : '#1f2937'
+    const codeBg = dark ? '#111827' : '#f3f4f6'
+    const sel = dark ? '#2563eb' : '#dbeafe'
+    const selText = dark ? '#ffffff' : '#1e3a8a'
+    return EditorView.theme({
+        '.cm-tooltip': {
+            border: `1px solid ${border}`,
+            borderRadius: '8px',
+            backgroundColor: bg,
+            color: text,
+            boxShadow: dark ? '0 8px 28px rgba(0,0,0,0.5)' : '0 8px 28px rgba(0,0,0,0.14)',
+            fontSize: '12px',
+            overflow: 'hidden'
+        },
+        '.cm-tooltip.cm-tooltip-hover': {maxWidth: '480px'},
+        '.cm-tooltip-hover .cm-tooltip-section': {
+            padding: '8px 10px',
+            borderTop: `1px solid ${border}`,
+            lineHeight: '1.5'
+        },
+        '.cm-tooltip-hover .cm-tooltip-section:first-child': {borderTop: 'none'},
+        '.cm-tooltip-hover pre, .cm-tooltip-hover code': {
+            backgroundColor: codeBg,
+            borderRadius: '4px',
+            padding: '1px 4px',
+            fontFamily: 'monospace',
+            whiteSpace: 'pre-wrap'
+        },
+        '.cm-tooltip-hover pre': {padding: '8px 10px', margin: '4px 0', overflowX: 'auto'},
+        // 诊断悬浮
+        '.cm-tooltip.cm-tooltip-lint': {padding: '0'},
+        '.cm-diagnostic': {padding: '6px 10px', borderLeft: 'none', marginLeft: '0'},
+        '.cm-diagnostic-error': {borderLeft: '3px solid #ef4444'},
+        '.cm-diagnostic-warning': {borderLeft: '3px solid #f59e0b'},
+        '.cm-diagnostic-info': {borderLeft: '3px solid #3b82f6'},
+        // 自动补全
+        '.cm-tooltip-autocomplete > ul': {fontFamily: 'monospace', maxHeight: '16em'},
+        '.cm-tooltip-autocomplete > ul > li': {padding: '3px 8px'},
+        '.cm-tooltip-autocomplete > ul > li[aria-selected]': {
+            backgroundColor: sel,
+            color: selText
+        },
+        '.cm-completionIcon': {opacity: '0.7', paddingRight: '6px'},
+        '.cm-completionDetail': {color: dark ? '#9ca3af' : '#6b7280', fontStyle: 'normal'}
+    }, {dark})
+}
+
 export function useCodeMirrorEditor(props: Props)
 {
     const toast = useToast()
@@ -384,8 +435,10 @@ export function useCodeMirrorEditor(props: Props)
             }
         }
 
-        // tooltip 挂到 body，避免父级 transform/overflow 导致悬浮窗错位
-        result.push(tooltips({parent: document.body}))
+        // tooltip 挂到 body 并以最高优先级生效，避免父级 transform/overflow 导致错位
+        result.push(Prec.highest(tooltips({parent: document.body, position: 'fixed'})))
+        // 自定义悬浮/诊断/补全提示框样式（主题适配）
+        result.push(buildTooltipTheme(isDark.value))
 
         // LSP 语义能力（补全/悬浮/诊断/跳转/重命名）；草稿用 untitled 文档，无服务器时为 null
         if (props.language) {

From 1412962f6a331fc7c6941d698a12ccc1c0f57029 Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Mon, 8 Jun 2026 10:33:59 +0800
Subject: [PATCH 18/25] =?UTF-8?q?fix(lsp):=20=E7=A7=BB=E9=99=A4=E5=BC=BA?=
 =?UTF-8?q?=E5=88=B6=20fixed/=E6=9C=80=E9=AB=98=E4=BC=98=E5=85=88=E7=BA=A7?=
 =?UTF-8?q?=E7=9A=84=20tooltip=20=E8=A6=86=E7=9B=96,=20=E5=9B=9E=E5=88=B0?=
 =?UTF-8?q?=E9=BB=98=E8=AE=A4=E5=AE=9A=E4=BD=8D?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 之前的 Prec.highest + parent:body + position:fixed 反而把悬浮窗顶到下方
- 改回与 useCodeMirrorFunctionHelp 一致的默认定位机制, 仅保留样式主题
---
 src/composables/useCodeMirrorEditor.ts | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/src/composables/useCodeMirrorEditor.ts b/src/composables/useCodeMirrorEditor.ts
index 208009f..3abdcb9 100644
--- a/src/composables/useCodeMirrorEditor.ts
+++ b/src/composables/useCodeMirrorEditor.ts
@@ -74,7 +74,7 @@ import {StreamLanguage} from '@codemirror/language'
 import {EditorConfig} from '../types/app.ts'
 import {useCodeMirrorFunctionHelp} from './useCodeMirrorFunctionHelp'
 import {useCodeMirrorSpaceOmission} from './useCodeMirrorSpaceOmission.ts'
-import {EditorView, keymap, tooltips} from "@codemirror/view";
+import {EditorView, keymap} from "@codemirror/view";
 import {Prec} from "@codemirror/state";
 import {useCodeMirrorFontFamily} from "./useCodeMirrorFontFamily.ts";
 import {diffGutterExtension} from "../editor/diffGutter";
@@ -435,9 +435,7 @@ export function useCodeMirrorEditor(props: Props)
             }
         }
 
-        // tooltip 挂到 body 并以最高优先级生效，避免父级 transform/overflow 导致错位
-        result.push(Prec.highest(tooltips({parent: document.body, position: 'fixed'})))
-        // 自定义悬浮/诊断/补全提示框样式（主题适配）
+        // 自定义悬浮/诊断/补全提示框样式（主题适配，仅样式不改定位）
         result.push(buildTooltipTheme(isDark.value))
 
         // LSP 语义能力（补全/悬浮/诊断/跳转/重命名）；草稿用 untitled 文档，无服务器时为 null

From 0ec7a955b0c6eeb5174b3cc1e7833282a4b16fdc Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Mon, 8 Jun 2026 10:43:51 +0800
Subject: [PATCH 19/25] =?UTF-8?q?feat(lsp):=20=E8=87=AA=E7=BB=98=E6=82=AC?=
 =?UTF-8?q?=E6=B5=AE=E6=8F=90=E7=A4=BA=EF=BC=8C=E7=B2=BE=E7=A1=AE=E5=AE=9A?=
 =?UTF-8?q?=E4=BD=8D=E5=88=B0=E9=BC=A0=E6=A0=87=E5=A4=84?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 不再依赖 CodeMirror tooltip 定位; 监听鼠标 posAtCoords 取诊断+hover, 挂到 body 的 fixed 浮层显示在鼠标下方(越界翻转/夹紧)
- 隐藏库默认的 hover/诊断 tooltip(避免重复与错位)
- 主题适配(明暗), 诊断按严重级色条; 引入 @codemirror/lint 读诊断
---
 package.json               |   1 +
 src/editor/lspExtension.ts |   5 +-
 src/editor/lspHover.ts     | 157 +++++++++++++++++++++++++++++++++++++
 3 files changed, 162 insertions(+), 1 deletion(-)
 create mode 100644 src/editor/lspHover.ts

diff --git a/package.json b/package.json
index e87ff95..75f39a3 100644
--- a/package.json
+++ b/package.json
@@ -27,6 +27,7 @@
     "@codemirror/lang-yaml": "^6.1.3",
     "@codemirror/language": "^6.11.2",
     "@codemirror/legacy-modes": "^6.5.1",
+    "@codemirror/lint": "6.9.6",
     "@codemirror/state": "^6.5.2",
     "@codemirror/view": "^6.38.1",
     "@open-rpc/client-js": "^2.0.0",
diff --git a/src/editor/lspExtension.ts b/src/editor/lspExtension.ts
index 628c00a..5e8d619 100644
--- a/src/editor/lspExtension.ts
+++ b/src/editor/lspExtension.ts
@@ -3,6 +3,7 @@ import {invoke} from '@tauri-apps/api/core'
 import {languageServerWithTransport} from 'codemirror-languageserver'
 import {TauriLspTransport} from './lspTransport'
 import {setLspState} from './lspStatus'
+import {lspCustomHover} from './lspHover'
 
 // CodeForge 语言 key → LSP languageId（与后端 server_cmd 对应）
 const LANGUAGE_ID: Record<string, string> = {
@@ -78,7 +79,7 @@ export async function createLspExtensions(
     const documentUri = filePath
       ? toUri(filePath)
       : `untitled:Untitled.${LANGUAGE_EXT[languageId] || 'txt'}`
-    return languageServerWithTransport({
+    const base = languageServerWithTransport({
       transport,
       rootUri,
       workspaceFolders: rootUri ? [{uri: rootUri, name: 'workspace'}] : null,
@@ -87,6 +88,8 @@ export async function createLspExtensions(
       allowHTMLContent: true,
       autoClose: true
     })
+    // 用自绘悬浮替代库的 hover/诊断 tooltip（定位精确到鼠标 + 主题适配）
+    return [base, lspCustomHover]
   }
   catch {
     return null
diff --git a/src/editor/lspHover.ts b/src/editor/lspHover.ts
new file mode 100644
index 0000000..91105b2
--- /dev/null
+++ b/src/editor/lspHover.ts
@@ -0,0 +1,157 @@
+// 自绘 LSP 悬浮提示：完全不依赖 CodeMirror 的 tooltip 定位，
+// 监听鼠标 → posAtCoords 定位 → 取诊断 + textDocument/hover → 在鼠标处用挂到 body 的 fixed 浮层显示。
+import {EditorView, ViewPlugin} from '@codemirror/view'
+import {forEachDiagnostic} from '@codemirror/lint'
+import {languageServerPlugin} from 'codemirror-languageserver'
+import {useTheme} from '../composables/useTheme'
+
+const offsetToPos = (doc: any, offset: number) => {
+  const line = doc.lineAt(offset)
+  return {line: line.number - 1, character: offset - line.from}
+}
+
+const SEVERITY_COLOR: Record<string, string> = {
+  error: '#ef4444',
+  warning: '#f59e0b',
+  info: '#3b82f6',
+  hint: '#6b7280'
+}
+
+function makeHoverPlugin() {
+  return ViewPlugin.fromClass(class {
+    view: EditorView
+    box: HTMLElement
+    timer: any = null
+    reqId = 0
+    onMove: (e: MouseEvent) => void
+    onLeave: () => void
+    onScroll: () => void
+
+    constructor(view: EditorView) {
+      this.view = view
+      this.box = document.createElement('div')
+      this.box.className = 'cf-lsp-hover'
+      this.box.style.cssText = 'position:fixed;z-index:9999;display:none;max-width:520px;max-height:340px;overflow:auto;border-radius:8px;padding:8px 10px;font-size:12px;line-height:1.5;pointer-events:none;'
+      document.body.appendChild(this.box)
+
+      this.onMove = (e: MouseEvent) => {
+        if (this.timer) {
+          clearTimeout(this.timer)
+        }
+        this.timer = setTimeout(() => this.show(e.clientX, e.clientY), 280)
+      }
+      this.onLeave = () => {
+        if (this.timer) {
+          clearTimeout(this.timer)
+        }
+        this.hide()
+      }
+      this.onScroll = () => this.hide()
+
+      view.dom.addEventListener('mousemove', this.onMove)
+      view.dom.addEventListener('mouseleave', this.onLeave)
+      view.scrollDOM.addEventListener('scroll', this.onScroll, true)
+    }
+
+    applyTheme() {
+      const {isDark} = useTheme()
+      const dark = isDark.value
+      this.box.style.background = dark ? '#1f2937' : '#ffffff'
+      this.box.style.color = dark ? '#e5e7eb' : '#1f2937'
+      this.box.style.border = `1px solid ${dark ? '#374151' : '#e5e7eb'}`
+      this.box.style.boxShadow = dark ? '0 8px 28px rgba(0,0,0,0.5)' : '0 8px 28px rgba(0,0,0,0.14)'
+    }
+
+    async show(x: number, y: number) {
+      const pos = this.view.posAtCoords({x, y})
+      if (pos == null) {
+        this.hide()
+        return
+      }
+      const myReq = ++this.reqId
+      const parts: string[] = []
+
+      // 1) 该位置的诊断
+      forEachDiagnostic(this.view.state, (d, from, to) => {
+        if (pos >= from && pos <= to) {
+          const color = SEVERITY_COLOR[d.severity] || SEVERITY_COLOR.info
+          parts.push(`<div style="border-left:3px solid ${color};padding-left:8px;margin:2px 0;white-space:pre-wrap">${escapeHtml(d.message)}</div>`)
+        }
+      })
+
+      // 2) LSP textDocument/hover
+      try {
+        const plugin: any = this.view.plugin(languageServerPlugin as any)
+        if (plugin?.requestHoverTooltip) {
+          const spec = await plugin.requestHoverTooltip(this.view, offsetToPos(this.view.state.doc, pos))
+          if (myReq !== this.reqId) {
+            return // 过期
+          }
+          if (spec && typeof spec.create === 'function') {
+            const built = spec.create(this.view)
+            const dom: HTMLElement | undefined = built?.dom
+            if (dom && dom.textContent && dom.textContent.trim()) {
+              parts.push(`<div class="cf-lsp-hover-doc">${dom.innerHTML}</div>`)
+            }
+          }
+        }
+      }
+      catch {
+        // 忽略
+      }
+
+      if (myReq !== this.reqId) {
+        return
+      }
+      if (parts.length === 0) {
+        this.hide()
+        return
+      }
+
+      this.applyTheme()
+      this.box.innerHTML = parts.join('<div style="height:1px;background:rgba(128,128,128,0.2);margin:6px -10px"></div>')
+      this.box.style.display = 'block'
+      // 定位到鼠标下方，越界则翻转/夹紧
+      const rect = this.box.getBoundingClientRect()
+      let left = x + 2
+      let top = y + 18
+      if (left + rect.width > window.innerWidth - 8) {
+        left = window.innerWidth - rect.width - 8
+      }
+      if (top + rect.height > window.innerHeight - 8) {
+        top = y - rect.height - 12
+      }
+      this.box.style.left = Math.max(8, left) + 'px'
+      this.box.style.top = Math.max(8, top) + 'px'
+    }
+
+    hide() {
+      this.box.style.display = 'none'
+    }
+
+    destroy() {
+      if (this.timer) {
+        clearTimeout(this.timer)
+      }
+      this.view.dom.removeEventListener('mousemove', this.onMove)
+      this.view.dom.removeEventListener('mouseleave', this.onLeave)
+      this.view.scrollDOM.removeEventListener('scroll', this.onScroll, true)
+      this.box.remove()
+    }
+  })
+}
+
+function escapeHtml(s: string): string {
+  return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;')
+}
+
+// 自绘 hover + 隐藏 CodeMirror 默认的 hover / 诊断 tooltip（避免重复且定位错乱）
+export const lspCustomHover = [
+  makeHoverPlugin(),
+  EditorView.theme({
+    '.cm-tooltip.cm-tooltip-hover': {display: 'none !important'},
+    '.cm-tooltip.cm-tooltip-lint': {display: 'none !important'},
+    '.cf-lsp-hover-doc pre': {whiteSpace: 'pre-wrap', margin: '4px 0'},
+    '.cf-lsp-hover-doc code': {fontFamily: 'monospace'}
+  })
+]

From e4226411c8939e2bb8da137665de1e686a97a0f9 Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Mon, 8 Jun 2026 10:55:32 +0800
Subject: [PATCH 20/25] =?UTF-8?q?fix(lsp):=20=E6=82=AC=E6=B5=AE=E4=BB=85?=
 =?UTF-8?q?=E5=9C=A8=E9=BC=A0=E6=A0=87=E8=90=BD=E5=9C=A8=E5=AE=9E=E9=99=85?=
 =?UTF-8?q?=E6=96=87=E6=9C=AC=E4=B8=8A=E6=89=8D=E6=98=BE=E7=A4=BA?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- posAtCoords 会就近吸附到最近字符, 导致移到空白处仍显示错误并跟随
- 增加行垂直区间 + 行内水平范围判断, 鼠标不在文本上即隐藏
---
 src/editor/lspHover.ts | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/src/editor/lspHover.ts b/src/editor/lspHover.ts
index 91105b2..a75741d 100644
--- a/src/editor/lspHover.ts
+++ b/src/editor/lspHover.ts
@@ -68,6 +68,20 @@ function makeHoverPlugin() {
         this.hide()
         return
       }
+      // posAtCoords 会就近吸附到最近字符；确认鼠标确实落在该行文本范围内，否则不显示
+      const block = this.view.lineBlockAt(pos)
+      if (y < block.top - 1 || y > block.bottom + 1) {
+        this.hide()
+        return
+      }
+      const line = this.view.state.doc.lineAt(pos)
+      const startC = this.view.coordsAtPos(line.from)
+      const endC = this.view.coordsAtPos(line.to)
+      if ((startC && x < startC.left - 4) || (endC && x > endC.right + 4)) {
+        this.hide()
+        return
+      }
+
       const myReq = ++this.reqId
       const parts: string[] = []
 

From d69bc6455b17b64cb990572d5766e7e8e0f66d93 Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Mon, 8 Jun 2026 10:57:53 +0800
Subject: [PATCH 21/25] =?UTF-8?q?fix(lsp):=20=E6=82=AC=E6=B5=AE=E8=BE=B9?=
 =?UTF-8?q?=E7=95=8C=E5=88=A4=E6=96=AD=E6=94=B9=E7=94=A8=E8=A7=86=E5=8F=A3?=
 =?UTF-8?q?=E5=9D=90=E6=A0=87(coordsAtPos)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 之前用 lineBlockAt 的文档内坐标与鼠标视口坐标比较, 永远判定不在行内 → 全隐藏
- 改用 coordsAtPos 的视口坐标做行内垂直/水平判断
---
 src/editor/lspHover.ts | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/editor/lspHover.ts b/src/editor/lspHover.ts
index a75741d..7f52e6e 100644
--- a/src/editor/lspHover.ts
+++ b/src/editor/lspHover.ts
@@ -68,16 +68,16 @@ function makeHoverPlugin() {
         this.hide()
         return
       }
-      // posAtCoords 会就近吸附到最近字符；确认鼠标确实落在该行文本范围内，否则不显示
-      const block = this.view.lineBlockAt(pos)
-      if (y < block.top - 1 || y > block.bottom + 1) {
+      // posAtCoords 会就近吸附到最近字符；用视口坐标确认鼠标确实落在该行文本上
+      const c = this.view.coordsAtPos(pos)
+      if (!c || y < c.top - 2 || y > c.bottom + 2) {
         this.hide()
         return
       }
       const line = this.view.state.doc.lineAt(pos)
       const startC = this.view.coordsAtPos(line.from)
       const endC = this.view.coordsAtPos(line.to)
-      if ((startC && x < startC.left - 4) || (endC && x > endC.right + 4)) {
+      if ((startC && x < startC.left - 4) || (endC && x > endC.right + 6)) {
         this.hide()
         return
       }

From f031d8fefc2e7f580072ab168a65689a82d05188 Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Mon, 8 Jun 2026 11:13:09 +0800
Subject: [PATCH 22/25] =?UTF-8?q?fix(ui):=20Select=20=E4=B8=8B=E6=8B=89?=
 =?UTF-8?q?=E7=A9=BA=E9=97=B4=E4=B8=8D=E8=B6=B3=E6=97=B6=E4=B8=8A=E7=BF=BB?=
 =?UTF-8?q?=E5=B9=B6=E5=86=85=E9=83=A8=E6=BB=9A=E5=8A=A8=EF=BC=8C=E9=81=BF?=
 =?UTF-8?q?=E5=85=8D=E8=A2=AB=E8=A3=81?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 内层选项列表由固定 max-h-60 改为 flex-1 + min-h-0 + overflow-auto, 始终在算出的可用高度内滚动
- 下方放不下且上方更大时翻转到上方显示
---
 src/ui/Select.vue | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/ui/Select.vue b/src/ui/Select.vue
index 6a4710d..a953ced 100644
--- a/src/ui/Select.vue
+++ b/src/ui/Select.vue
@@ -54,7 +54,7 @@
                   @after-leave="$emit('after-close')">
         <div v-show="isOpen"
              ref="dropdown"
-             class="fixed z-[99999] bg-white dark:bg-gray-800 dark:text-gray-100 text-base shadow-lg ring-1 ring-blue-200 dark:ring-gray-700 focus:outline-none rounded-md overflow-hidden"
+             class="fixed z-[99999] flex flex-col bg-white dark:bg-gray-800 dark:text-gray-100 text-base shadow-lg ring-1 ring-blue-200 dark:ring-gray-700 focus:outline-none rounded-md overflow-hidden"
              :class="dropdownClasses"
              :style="dropdownStyle"
              role="listbox"
@@ -72,7 +72,7 @@
           </div>
 
           <!-- 选项列表容器 -->
-          <div class="max-h-60 overflow-auto" @scroll.stop>
+          <div class="flex-1 min-h-0 overflow-auto" @scroll.stop>
             <!-- 选项列表 -->
             <template v-if="filteredOptions.length > 0">
               <div v-for="(option, index) in filteredOptions"
@@ -252,8 +252,8 @@ const updateDropdownPosition = async () => {
   let width = buttonRect.width
   let maxHeight = Math.min(totalDropdownHeight, spaceBelow)
 
-  // 如果下方空间不足且上方空间更大，显示在上方
-  if (spaceBelow < 150 && spaceAbove > spaceBelow) {
+  // 下方放不下且上方空间更大时，翻转到上方显示
+  if (spaceBelow < totalDropdownHeight && spaceAbove > spaceBelow) {
     top = buttonRect.top - 4 // 显示在上方，留4px间距
     maxHeight = Math.min(totalDropdownHeight, spaceAbove)
 

From 759cfe9711839376bacb604e63234acfb3933499 Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Mon, 8 Jun 2026 11:15:55 +0800
Subject: [PATCH 23/25] =?UTF-8?q?style:=20cargo=20fmt=20=E6=A0=BC=E5=BC=8F?=
 =?UTF-8?q?=E5=8C=96=20lsp/plugins=20=E7=9B=B8=E5=85=B3=20Rust=20=E6=96=87?=
 =?UTF-8?q?=E4=BB=B6?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src-tauri/src/lsp.rs             | 85 ++++++++++++++++++++++++++------
 src-tauri/src/plugins/manager.rs |  2 +-
 src-tauri/src/plugins/mod.rs     |  2 +-
 3 files changed, 73 insertions(+), 16 deletions(-)

diff --git a/src-tauri/src/lsp.rs b/src-tauri/src/lsp.rs
index a674184..04d79c1 100644
--- a/src-tauri/src/lsp.rs
+++ b/src-tauri/src/lsp.rs
@@ -57,19 +57,49 @@ fn server_cmd(language: &str) -> Option<(&'static str, Vec<&'static str>)> {
 /// (id, 展示名, 用于检测的可执行名, 安装命令)
 fn server_defs() -> Vec<(&'static str, &'static str, &'static str, &'static str)> {
     vec![
-        ("python", "Python (pyright)", "pyright-langserver", "npm i -g pyright"),
+        (
+            "python",
+            "Python (pyright)",
+            "pyright-langserver",
+            "npm i -g pyright",
+        ),
         (
             "typescript",
             "TypeScript / JavaScript",
             "typescript-language-server",
             "npm i -g typescript-language-server typescript",
         ),
-        ("rust", "Rust (rust-analyzer)", "rust-analyzer", "rustup component add rust-analyzer"),
-        ("go", "Go (gopls)", "gopls", "go install golang.org/x/tools/gopls@latest"),
+        (
+            "rust",
+            "Rust (rust-analyzer)",
+            "rust-analyzer",
+            "rustup component add rust-analyzer",
+        ),
+        (
+            "go",
+            "Go (gopls)",
+            "gopls",
+            "go install golang.org/x/tools/gopls@latest",
+        ),
         ("clangd", "C / C++ (clangd)", "clangd", "brew install llvm"),
-        ("lua", "Lua", "lua-language-server", "brew install lua-language-server"),
-        ("php", "PHP (intelephense)", "intelephense", "npm i -g intelephense"),
-        ("ruby", "Ruby (solargraph)", "solargraph", "gem install solargraph"),
+        (
+            "lua",
+            "Lua",
+            "lua-language-server",
+            "brew install lua-language-server",
+        ),
+        (
+            "php",
+            "PHP (intelephense)",
+            "intelephense",
+            "npm i -g intelephense",
+        ),
+        (
+            "ruby",
+            "Ruby (solargraph)",
+            "solargraph",
+            "gem install solargraph",
+        ),
         (
             "web",
             "HTML / CSS / JSON",
@@ -112,7 +142,11 @@ pub fn lsp_install(app: AppHandle, id: String) -> Result<(), String> {
         .ok_or_else(|| "未知的语言服务器".to_string())?;
     let cmd_str = def.3.to_string();
 
-    let (shell, flag) = if cfg!(windows) { ("cmd", "/C") } else { ("sh", "-c") };
+    let (shell, flag) = if cfg!(windows) {
+        ("cmd", "/C")
+    } else {
+        ("sh", "-c")
+    };
     let mut child = Command::new(shell)
         .arg(flag)
         .arg(&cmd_str)
@@ -142,8 +176,16 @@ pub fn lsp_install(app: AppHandle, id: String) -> Result<(), String> {
             });
         }
     };
-    emit_lines(app.clone(), id.clone(), stdout.map(|s| Box::new(s) as Box<dyn Read + Send>));
-    emit_lines(app.clone(), id.clone(), stderr.map(|s| Box::new(s) as Box<dyn Read + Send>));
+    emit_lines(
+        app.clone(),
+        id.clone(),
+        stdout.map(|s| Box::new(s) as Box<dyn Read + Send>),
+    );
+    emit_lines(
+        app.clone(),
+        id.clone(),
+        stderr.map(|s| Box::new(s) as Box<dyn Read + Send>),
+    );
 
     std::thread::spawn(move || {
         let success = child.wait().map(|s| s.success()).unwrap_or(false);
@@ -242,7 +284,11 @@ pub fn lsp_available(language: String) -> bool {
 
 /// 启动语言服务器；已启动则直接返回 true。
 #[tauri::command]
-pub fn lsp_start(app: AppHandle, state: State<'_, LspState>, language: String) -> Result<bool, String> {
+pub fn lsp_start(
+    app: AppHandle,
+    state: State<'_, LspState>,
+    language: String,
+) -> Result<bool, String> {
     {
         let servers = state.servers.lock().map_err(|e| e.to_string())?;
         if servers.contains_key(&language) {
@@ -250,7 +296,8 @@ pub fn lsp_start(app: AppHandle, state: State<'_, LspState>, language: String) -
         }
     }
     let (prog, args) = server_cmd(&language).ok_or_else(|| "该语言暂不支持 LSP".to_string())?;
-    let exe = find_in_path(prog).ok_or_else(|| format!("未找到语言服务器：{}（请先安装并确保在 PATH 中）", prog))?;
+    let exe = find_in_path(prog)
+        .ok_or_else(|| format!("未找到语言服务器：{}（请先安装并确保在 PATH 中）", prog))?;
 
     let mut cmd = Command::new(&exe);
     cmd.args(&args)
@@ -259,7 +306,9 @@ pub fn lsp_start(app: AppHandle, state: State<'_, LspState>, language: String) -
         .stdout(Stdio::piped())
         .stderr(Stdio::piped());
 
-    let mut child = cmd.spawn().map_err(|e| format!("启动 {} 失败: {}", prog, e))?;
+    let mut child = cmd
+        .spawn()
+        .map_err(|e| format!("启动 {} 失败: {}", prog, e))?;
     let stdin = child.stdin.take().ok_or("无法获取 stdin")?;
     let stdout = child.stdout.take().ok_or("无法获取 stdout")?;
     let stderr = child.stderr.take();
@@ -308,12 +357,20 @@ pub fn lsp_start(app: AppHandle, state: State<'_, LspState>, language: String) -
 
 /// 向语言服务器发送一条 JSON-RPC（已是完整 JSON 字符串）
 #[tauri::command]
-pub fn lsp_send(state: State<'_, LspState>, language: String, message: String) -> Result<(), String> {
+pub fn lsp_send(
+    state: State<'_, LspState>,
+    language: String,
+    message: String,
+) -> Result<(), String> {
     let mut servers = state.servers.lock().map_err(|e| e.to_string())?;
     let server = servers
         .get_mut(&language)
         .ok_or_else(|| "语言服务器未启动".to_string())?;
-    let frame = format!("Content-Length: {}\r\n\r\n{}", message.as_bytes().len(), message);
+    let frame = format!(
+        "Content-Length: {}\r\n\r\n{}",
+        message.as_bytes().len(),
+        message
+    );
     server
         .stdin
         .write_all(frame.as_bytes())
diff --git a/src-tauri/src/plugins/manager.rs b/src-tauri/src/plugins/manager.rs
index 994f9e8..53b9f55 100644
--- a/src-tauri/src/plugins/manager.rs
+++ b/src-tauri/src/plugins/manager.rs
@@ -36,9 +36,9 @@ use crate::plugins::swift::SwiftPlugin;
 use crate::plugins::text::TextPlugin;
 use crate::plugins::tsv::TsvPlugin;
 use crate::plugins::typescript::TypeScriptPlugin;
-use crate::plugins::xlsx::XlsxPlugin;
 use crate::plugins::typescript_browser::TypeScriptBrowserPlugin;
 use crate::plugins::typescript_nodejs::TypeScriptNodeJsPlugin;
+use crate::plugins::xlsx::XlsxPlugin;
 use crate::plugins::xml::XmlPlugin;
 use crate::plugins::yaml::YamlPlugin;
 use std::collections::HashMap;
diff --git a/src-tauri/src/plugins/mod.rs b/src-tauri/src/plugins/mod.rs
index 29fb884..8cdbca7 100644
--- a/src-tauri/src/plugins/mod.rs
+++ b/src-tauri/src/plugins/mod.rs
@@ -436,9 +436,9 @@ pub mod swift;
 pub mod text;
 pub mod tsv;
 pub mod typescript;
-pub mod xlsx;
 pub mod typescript_browser;
 pub mod typescript_nodejs;
+pub mod xlsx;
 pub mod xml;
 pub mod yaml;
 

From 4dd3917962033a6b4901ddab10cb47b5b92bc16b Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Mon, 8 Jun 2026 11:20:28 +0800
Subject: [PATCH 24/25] =?UTF-8?q?feat(lsp):=20=E7=8A=B6=E6=80=81=E6=A0=8F?=
 =?UTF-8?q?=E6=96=B0=E5=A2=9E=E3=80=8C=E7=B4=A2=E5=BC=95=E4=B8=AD=E3=80=8D?=
 =?UTF-8?q?=E5=8A=A0=E8=BD=BD=E7=8A=B6=E6=80=81?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 自建 LanguageServerClient, 用 onCapabilities/onError/onClose 驱动状态: connecting(索引中)→on(就绪)/off
- 状态栏: 启动/索引时显示旋转图标 + 「LSP 索引中」, 就绪后绿点「LSP」
- 避免从无提示突然跳到报错, 交互更清晰
---
 src/components/StatusBar.vue |  8 +++++---
 src/editor/lspExtension.ts   | 20 +++++++++++++++++---
 src/editor/lspStatus.ts      |  3 ++-
 3 files changed, 24 insertions(+), 7 deletions(-)

diff --git a/src/components/StatusBar.vue b/src/components/StatusBar.vue
index d9acbc4..ae03b36 100644
--- a/src/components/StatusBar.vue
+++ b/src/components/StatusBar.vue
@@ -23,9 +23,11 @@
 
     <div class="flex items-center space-x-4">
       <!-- LSP 状态 -->
-      <div v-if="lspState.status === 'on'" class="flex items-center space-x-1" :title="`语言服务已启用：${lspState.language}`">
-        <span class="w-1.5 h-1.5 rounded-full bg-emerald-300"/>
-        <span>LSP</span>
+      <div v-if="lspState.status !== 'off'" class="flex items-center space-x-1"
+           :title="lspState.status === 'connecting' ? `语言服务索引中：${lspState.language}` : `语言服务已就绪：${lspState.language}`">
+        <RefreshCw v-if="lspState.status === 'connecting'" class="w-3 h-3 animate-spin"/>
+        <span v-else class="w-1.5 h-1.5 rounded-full bg-emerald-300"/>
+        <span>{{ lspState.status === 'connecting' ? 'LSP 索引中' : 'LSP' }}</span>
       </div>
 
       <div class="flex items-center space-x-2">
diff --git a/src/editor/lspExtension.ts b/src/editor/lspExtension.ts
index 5e8d619..1050e73 100644
--- a/src/editor/lspExtension.ts
+++ b/src/editor/lspExtension.ts
@@ -1,6 +1,6 @@
 // 根据语言/文件构建 CodeMirror LSP 扩展（补全、悬浮、诊断、跳转、重命名）
 import {invoke} from '@tauri-apps/api/core'
-import {languageServerWithTransport} from 'codemirror-languageserver'
+import {LanguageServerClient, languageServerWithTransport} from 'codemirror-languageserver'
 import {TauriLspTransport} from './lspTransport'
 import {setLspState} from './lspStatus'
 import {lspCustomHover} from './lspHover'
@@ -71,7 +71,7 @@ export async function createLspExtensions(
     setLspState(language, 'off')
     return null
   }
-  setLspState(language, 'on')
+  setLspState(language, 'connecting')
   try {
     const transport = new TauriLspTransport(language)
     const rootUri = rootDir ? toUri(rootDir) : null
@@ -79,10 +79,24 @@ export async function createLspExtensions(
     const documentUri = filePath
       ? toUri(filePath)
       : `untitled:Untitled.${LANGUAGE_EXT[languageId] || 'txt'}`
+    const workspaceFolders = rootUri ? [{uri: rootUri, name: 'workspace'}] : null
+    // 自建 client 以获取初始化完成(capabilities)信号，驱动状态栏的"索引中→就绪"
+    const client = new LanguageServerClient({
+      transport,
+      rootUri,
+      workspaceFolders,
+      documentUri,
+      languageId,
+      autoClose: true,
+      onCapabilities: () => setLspState(language, 'on'),
+      onError: () => setLspState(language, 'off'),
+      onClose: () => setLspState(language, 'off')
+    })
     const base = languageServerWithTransport({
+      client,
       transport,
       rootUri,
-      workspaceFolders: rootUri ? [{uri: rootUri, name: 'workspace'}] : null,
+      workspaceFolders,
       documentUri,
       languageId,
       allowHTMLContent: true,
diff --git a/src/editor/lspStatus.ts b/src/editor/lspStatus.ts
index cfc05e3..c471144 100644
--- a/src/editor/lspStatus.ts
+++ b/src/editor/lspStatus.ts
@@ -1,7 +1,8 @@
 import {ref} from 'vue'
 
 // 当前编辑器语言的 LSP 状态（供状态栏显示）
-export type LspStatus = 'off' | 'on'
+// off=未启用 connecting=启动/索引中 on=就绪
+export type LspStatus = 'off' | 'connecting' | 'on'
 export const lspState = ref<{ language: string; status: LspStatus }>({language: '', status: 'off'})
 
 export const setLspState = (language: string, status: LspStatus) => {

From e2b88b585e4a15a1ec041041426d639555c78ba1 Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Mon, 8 Jun 2026 11:22:40 +0800
Subject: [PATCH 25/25] =?UTF-8?q?style(lsp):=20=E4=BF=AE=E5=A4=8D=20clippy?=
 =?UTF-8?q?=20=E8=AD=A6=E5=91=8A?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 两处 loop+match 改为 while let
- Content-Length 用 message.len()(字符串字节长度)替代 as_bytes().len()
---
 src-tauri/src/lsp.rs | 36 +++++++++++-------------------------
 1 file changed, 11 insertions(+), 25 deletions(-)

diff --git a/src-tauri/src/lsp.rs b/src-tauri/src/lsp.rs
index 04d79c1..233c87d 100644
--- a/src-tauri/src/lsp.rs
+++ b/src-tauri/src/lsp.rs
@@ -165,13 +165,8 @@ pub fn lsp_install(app: AppHandle, id: String) -> Result<(), String> {
         if let Some(r) = reader {
             std::thread::spawn(move || {
                 let mut buf = BufReader::new(r);
-                loop {
-                    match read_raw_line(&mut buf) {
-                        Some(line) => {
-                            let _ = app.emit("lsp:install", (id.clone(), line));
-                        }
-                        None => break,
-                    }
+                while let Some(line) = read_raw_line(&mut buf) {
+                    let _ = app.emit("lsp:install", (id.clone(), line));
                 }
             });
         }
@@ -318,19 +313,14 @@ pub fn lsp_start(
     let lang_reader = language.clone();
     std::thread::spawn(move || {
         let mut reader = BufReader::new(stdout);
-        loop {
-            match read_message(&mut reader) {
-                Some(body) => {
-                    let _ = app_reader.emit(
-                        "lsp:message",
-                        LspEvent {
-                            language: lang_reader.clone(),
-                            message: body,
-                        },
-                    );
-                }
-                None => break,
-            }
+        while let Some(body) = read_message(&mut reader) {
+            let _ = app_reader.emit(
+                "lsp:message",
+                LspEvent {
+                    language: lang_reader.clone(),
+                    message: body,
+                },
+            );
         }
         let _ = app_reader.emit("lsp:exit", lang_reader.clone());
     });
@@ -366,11 +356,7 @@ pub fn lsp_send(
     let server = servers
         .get_mut(&language)
         .ok_or_else(|| "语言服务器未启动".to_string())?;
-    let frame = format!(
-        "Content-Length: {}\r\n\r\n{}",
-        message.as_bytes().len(),
-        message
-    );
+    let frame = format!("Content-Length: {}\r\n\r\n{}", message.len(), message);
     server
         .stdin
         .write_all(frame.as_bytes())