From c9000eb2821707aeec5be89756ee0e12962b776c Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Thu, 25 Jun 2026 17:06:22 +0800
Subject: [PATCH 01/20] =?UTF-8?q?feat(workspace):=20=E5=A4=9A=E6=A0=B9?=
 =?UTF-8?q?=E5=B7=A5=E4=BD=9C=E5=8C=BA=E6=94=AF=E6=8C=81=E6=8C=82=E8=BD=BD?=
 =?UTF-8?q?=E9=A2=9D=E5=A4=96=E6=96=87=E4=BB=B6=E5=A4=B9=20(E3=20phase=201?=
 =?UTF-8?q?)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

侧栏支持在主根之外挂载额外文件夹，各自独立展开/折叠并加载文件树；
头部新增添加文件夹按钮，挂载根可单独移除；额外根列表持久化到 KV。
Git/搜索仍以主根为准，后续阶段再扩展。
---
 src/App.vue                    | 21 ++++++++++++
 src/components/Sidebar.vue     | 59 +++++++++++++++++++++++++++++++++-
 src/components/setting/Lsp.vue |  2 +-
 src/i18n/locales/en.json       |  2 ++
 src/i18n/locales/zh-CN.json    |  2 ++
 5 files changed, 84 insertions(+), 2 deletions(-)

diff --git a/src/App.vue b/src/App.vue
index 69ad0a2e..2bad5c2a 100644
--- a/src/App.vue
+++ b/src/App.vue
@@ -53,6 +53,7 @@
       <!-- 左侧文件树侧栏 -->
       <template v-if="sidebarVisible">
         <Sidebar :root-dir="rootDir"
+                 :extra-roots="extraRoots"
                  :active-path="currentFilePath"
                  :recent-folders="recentFolders"
                  :git-status="gitStatus"
@@ -60,6 +61,8 @@
                  class="flex-shrink-0"
                  :style="{ width: `${sidebarWidth}px` }"
                  @open-folder="openFolder"
+                 @add-folder="addWorkspaceFolder"
+                 @remove-root="removeWorkspaceFolder"
                  @open-recent="openFolderPath"
                  @open-file="smartOpen"
                  @renamed="(from, to) => updateTabPath(from, to)"
@@ -708,6 +711,24 @@ const openFolderPath = (path: string) => {
   rootDir.value = path
   sidebarVisible.value = true
   rememberFolder(path)
+  // 打开新文件夹视为新工作区，清空额外挂载的根
+  extraRoots.value = []
+  kvSetJSON(WORKSPACE_EXTRA_KEY, extraRoots.value)
+}
+
+// ===== 多根工作区（E3，phase 1）：额外挂载的文件夹（Git/搜索仍走主根 rootDir）=====
+const WORKSPACE_EXTRA_KEY = 'workspace-extra-roots'
+const extraRoots = ref<string[]>(kvGetJSON<string[]>(WORKSPACE_EXTRA_KEY, []))
+const addWorkspaceFolder = async () => {
+  const selected = await openDialog({directory: true, multiple: false})
+  if (selected && typeof selected === 'string' && selected !== rootDir.value && !extraRoots.value.includes(selected)) {
+    extraRoots.value = [...extraRoots.value, selected]
+    kvSetJSON(WORKSPACE_EXTRA_KEY, extraRoots.value)
+  }
+}
+const removeWorkspaceFolder = (path: string) => {
+  extraRoots.value = extraRoots.value.filter(p => p !== path)
+  kvSetJSON(WORKSPACE_EXTRA_KEY, extraRoots.value)
 }
 
 // ===== 标签会话持久化 =====
diff --git a/src/components/Sidebar.vue b/src/components/Sidebar.vue
index 52174cf9..6007710d 100644
--- a/src/components/Sidebar.vue
+++ b/src/components/Sidebar.vue
@@ -8,6 +8,12 @@
                 @click="emit('open-folder')">
           <FolderOpen class="w-4 h-4"/>
         </button>
+        <button v-if="rootDir"
+                class="p-1 rounded text-gray-400 hover:text-gray-700 dark:hover:text-gray-200 hover:bg-gray-200 dark:hover:bg-gray-700 cursor-pointer"
+                :title="t('sidebar.addFolder')"
+                @click="emit('add-folder')">
+          <FolderPlus class="w-4 h-4"/>
+        </button>
         <button v-if="rootDir"
                 class="p-1 rounded text-gray-400 hover:text-gray-700 dark:hover:text-gray-200 hover:bg-gray-200 dark:hover:bg-gray-700 cursor-pointer"
                 :title="t('sidebar.refresh')"
@@ -45,6 +51,27 @@
            @contextmenu.prevent="onRootContext">
         <FileTreeNode v-for="node in rootNodes" :key="node.path" :node="node" :depth="0"/>
       </div>
+
+      <!-- 额外挂载的根（多根工作区 phase 1） -->
+      <div v-for="er in (rootDir ? (extraRoots || []) : [])"
+           :key="er"
+           class="mt-1 border-t border-gray-200 dark:border-gray-700">
+        <div class="group flex items-center gap-1 px-2 py-1 cursor-pointer hover:bg-gray-100 dark:hover:bg-gray-700"
+             @click="toggleExtra(er)">
+          <ChevronRight class="w-3 h-3 text-gray-400 transition-transform flex-shrink-0"
+                        :class="{'rotate-90': !extraCollapsed[er]}"/>
+          <Folder class="w-3.5 h-3.5 text-blue-500 flex-shrink-0"/>
+          <span class="flex-1 truncate text-xs font-semibold uppercase text-gray-600 dark:text-gray-300" :title="er">{{ folderName(er) }}</span>
+          <button class="p-0.5 rounded text-gray-400 hover:text-red-500 opacity-0 group-hover:opacity-100 cursor-pointer"
+                  :title="t('sidebar.removeFolder')"
+                  @click.stop="emit('remove-root', er)">
+            <X class="w-3 h-3"/>
+          </button>
+        </div>
+        <div v-show="!extraCollapsed[er]" class="w-max min-w-full">
+          <FileTreeNode v-for="node in (extraNodesMap[er] || [])" :key="node.path" :node="node" :depth="0"/>
+        </div>
+      </div>
     </div>
 
     <!-- 右键菜单 -->
@@ -161,7 +188,7 @@ import {computed, nextTick, onMounted, onUnmounted, provide, reactive, ref, watc
 import {invoke} from '@tauri-apps/api/core'
 import {open as openDialog} from '@tauri-apps/plugin-dialog'
 import {listen, type UnlistenFn} from '@tauri-apps/api/event'
-import {Folder, FolderOpen, RefreshCw} from 'lucide-vue-next'
+import {ChevronRight, Folder, FolderOpen, FolderPlus, RefreshCw, X} from 'lucide-vue-next'
 import Button from '../ui/Button.vue'
 import Modal from '../ui/Modal.vue'
 import Input from '../ui/Input.vue'
@@ -181,6 +208,7 @@ interface FileNode
 
 const props = defineProps<{
   rootDir: string | null
+  extraRoots?: string[]
   activePath?: string | null
   recentFolders?: string[]
   gitStatus?: Record<string, string>
@@ -189,6 +217,8 @@ const props = defineProps<{
 
 const emit = defineEmits<{
   'open-folder': []
+  'add-folder': []
+  'remove-root': [path: string]
   'open-recent': [path: string]
   'open-file': [path: string]
   'renamed': [from: string, to: string]
@@ -248,6 +278,33 @@ watch(() => props.rootDir, async () => {
   await startWatching()
 }, {immediate: true})
 
+// ===== 多根工作区（phase 1）：额外挂载的根，Git/搜索仍走主根 =====
+const extraNodesMap = reactive<Record<string, FileNode[]>>({})
+const extraCollapsed = reactive<Record<string, boolean>>({})
+const toggleExtra = (path: string) => {
+  extraCollapsed[path] = !extraCollapsed[path]
+}
+const loadExtraRoots = async () => {
+  for (const er of props.extraRoots || []) {
+    if (!(er in extraNodesMap)) {
+      try {
+        extraNodesMap[er] = await invoke<FileNode[]>('read_directory_tree', {path: er})
+        await invoke('watch_directory', {path: er}).catch(() => {})
+      }
+      catch {
+        extraNodesMap[er] = []
+      }
+    }
+  }
+  // 清理已移除的根
+  for (const k of Object.keys(extraNodesMap)) {
+    if (!(props.extraRoots || []).includes(k)) {
+      delete extraNodesMap[k]
+    }
+  }
+}
+watch(() => props.extraRoots, () => loadExtraRoots(), {immediate: true, deep: true})
+
 // ===== 刷新信号：变更后通知已展开目录刷新（保留展开状态）=====
 const refreshSignal = ref(0)
 provide('treeRefresh', refreshSignal)
diff --git a/src/components/setting/Lsp.vue b/src/components/setting/Lsp.vue
index 8db3dcb8..b3232725 100644
--- a/src/components/setting/Lsp.vue
+++ b/src/components/setting/Lsp.vue
@@ -1,5 +1,5 @@
 <template>
-  <Tabs v-model="tab" :tabs="tabDefs">
+  <Tabs v-model="tab" type="card" :tabs="tabDefs">
     <template #extra>
       <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' : ''"/>{{ t('settings.lsp.recheck') }}
diff --git a/src/i18n/locales/en.json b/src/i18n/locales/en.json
index a0aba794..bc4dd147 100644
--- a/src/i18n/locales/en.json
+++ b/src/i18n/locales/en.json
@@ -777,6 +777,8 @@
   "sidebar": {
     "explorer": "Explorer",
     "openFolder": "Open folder",
+    "addFolder": "Add folder to workspace",
+    "removeFolder": "Remove from workspace",
     "refresh": "Refresh",
     "noFolder": "No folder open",
     "recent": "Recent",
diff --git a/src/i18n/locales/zh-CN.json b/src/i18n/locales/zh-CN.json
index 14e7fae4..fd7f4b27 100644
--- a/src/i18n/locales/zh-CN.json
+++ b/src/i18n/locales/zh-CN.json
@@ -777,6 +777,8 @@
   "sidebar": {
     "explorer": "资源管理器",
     "openFolder": "打开文件夹",
+    "addFolder": "添加文件夹到工作区",
+    "removeFolder": "从工作区移除",
     "refresh": "刷新",
     "noFolder": "未打开文件夹",
     "recent": "最近打开",

From d899bf8797a6d1abe96e43da55bf842a4d4e44e6 Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Thu, 25 Jun 2026 17:19:56 +0800
Subject: [PATCH 02/20] =?UTF-8?q?fix(workspace):=20=E5=A4=9A=E6=A0=B9?=
 =?UTF-8?q?=E5=B7=A5=E4=BD=9C=E5=8C=BA=E5=90=84=E6=A0=B9=E6=94=B9=E4=B8=BA?=
 =?UTF-8?q?=E5=8F=AF=E6=8A=98=E5=8F=A0=E5=88=86=E5=8C=BA=EF=BC=8C=E6=A0=87?=
 =?UTF-8?q?=E9=A2=98=E5=90=B8=E9=A1=B6=E4=B8=8D=E5=86=8D=E8=A2=AB=E5=9F=8B?=
 =?UTF-8?q?=E5=9C=A8=E5=BA=95=E9=83=A8?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

多根时主根也作为可折叠分区呈现，折叠后即可看到其它挂载的根；
各根标题 sticky 吸顶，滚动时保持可见，避免新增的根被埋在长文件树下方。
---
 src/components/Sidebar.vue | 54 +++++++++++++++++++++++---------------
 1 file changed, 33 insertions(+), 21 deletions(-)

diff --git a/src/components/Sidebar.vue b/src/components/Sidebar.vue
index 6007710d..fd4df88c 100644
--- a/src/components/Sidebar.vue
+++ b/src/components/Sidebar.vue
@@ -47,31 +47,41 @@
       </div>
 
       <!-- w-max + min-w-full：长文件名时撑出横向滚动，同时高亮铺满整行 -->
-      <div v-else class="w-max min-w-full"
-           @contextmenu.prevent="onRootContext">
-        <FileTreeNode v-for="node in rootNodes" :key="node.path" :node="node" :depth="0"/>
-      </div>
-
-      <!-- 额外挂载的根（多根工作区 phase 1） -->
-      <div v-for="er in (rootDir ? (extraRoots || []) : [])"
-           :key="er"
-           class="mt-1 border-t border-gray-200 dark:border-gray-700">
-        <div class="group flex items-center gap-1 px-2 py-1 cursor-pointer hover:bg-gray-100 dark:hover:bg-gray-700"
-             @click="toggleExtra(er)">
+      <template v-else>
+        <!-- 主根：单根时不显示标题（保持原样）；多根时也作为可折叠分区，便于折叠后查看其它根 -->
+        <div v-if="hasExtra"
+             class="sticky top-0 z-10 bg-gray-50 dark:bg-gray-800 flex items-center gap-1 px-2 py-1 cursor-pointer hover:bg-gray-100 dark:hover:bg-gray-700"
+             @click="primaryCollapsed = !primaryCollapsed">
           <ChevronRight class="w-3 h-3 text-gray-400 transition-transform flex-shrink-0"
-                        :class="{'rotate-90': !extraCollapsed[er]}"/>
+                        :class="{'rotate-90': !primaryCollapsed}"/>
           <Folder class="w-3.5 h-3.5 text-blue-500 flex-shrink-0"/>
-          <span class="flex-1 truncate text-xs font-semibold uppercase text-gray-600 dark:text-gray-300" :title="er">{{ folderName(er) }}</span>
-          <button class="p-0.5 rounded text-gray-400 hover:text-red-500 opacity-0 group-hover:opacity-100 cursor-pointer"
-                  :title="t('sidebar.removeFolder')"
-                  @click.stop="emit('remove-root', er)">
-            <X class="w-3 h-3"/>
-          </button>
+          <span class="flex-1 truncate text-xs font-semibold uppercase text-gray-600 dark:text-gray-300" :title="rootDir || ''">{{ rootName }}</span>
         </div>
-        <div v-show="!extraCollapsed[er]" class="w-max min-w-full">
-          <FileTreeNode v-for="node in (extraNodesMap[er] || [])" :key="node.path" :node="node" :depth="0"/>
+        <div v-show="!hasExtra || !primaryCollapsed"
+             class="w-max min-w-full"
+             @contextmenu.prevent="onRootContext">
+          <FileTreeNode v-for="node in rootNodes" :key="node.path" :node="node" :depth="0"/>
         </div>
-      </div>
+
+        <!-- 额外挂载的根（多根工作区 phase 1） -->
+        <div v-for="er in (extraRoots || [])" :key="er">
+          <div class="group sticky top-0 z-10 bg-gray-50 dark:bg-gray-800 flex items-center gap-1 px-2 py-1 cursor-pointer border-t border-gray-200 dark:border-gray-700 hover:bg-gray-100 dark:hover:bg-gray-700"
+               @click="toggleExtra(er)">
+            <ChevronRight class="w-3 h-3 text-gray-400 transition-transform flex-shrink-0"
+                          :class="{'rotate-90': !extraCollapsed[er]}"/>
+            <Folder class="w-3.5 h-3.5 text-blue-500 flex-shrink-0"/>
+            <span class="flex-1 truncate text-xs font-semibold uppercase text-gray-600 dark:text-gray-300" :title="er">{{ folderName(er) }}</span>
+            <button class="p-0.5 rounded text-gray-400 hover:text-red-500 opacity-0 group-hover:opacity-100 cursor-pointer"
+                    :title="t('sidebar.removeFolder')"
+                    @click.stop="emit('remove-root', er)">
+              <X class="w-3 h-3"/>
+            </button>
+          </div>
+          <div v-show="!extraCollapsed[er]" class="w-max min-w-full">
+            <FileTreeNode v-for="node in (extraNodesMap[er] || [])" :key="node.path" :node="node" :depth="0"/>
+          </div>
+        </div>
+      </template>
     </div>
 
     <!-- 右键菜单 -->
@@ -279,6 +289,8 @@ watch(() => props.rootDir, async () => {
 }, {immediate: true})
 
 // ===== 多根工作区（phase 1）：额外挂载的根，Git/搜索仍走主根 =====
+const hasExtra = computed(() => !!(props.extraRoots && props.extraRoots.length))
+const primaryCollapsed = ref(false)
 const extraNodesMap = reactive<Record<string, FileNode[]>>({})
 const extraCollapsed = reactive<Record<string, boolean>>({})
 const toggleExtra = (path: string) => {

From 4731b847ed43584d861210d8ed9ad9d52a08b7d2 Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Thu, 25 Jun 2026 17:22:24 +0800
Subject: [PATCH 03/20] =?UTF-8?q?fix(workspace):=20=E6=B7=BB=E5=8A=A0?=
 =?UTF-8?q?=E6=96=87=E4=BB=B6=E5=A4=B9=E5=90=8E=E8=87=AA=E5=8A=A8=E6=BB=9A?=
 =?UTF-8?q?=E5=8A=A8=E5=88=B0=E8=AF=A5=E6=A0=B9=E5=88=86=E5=8C=BA=EF=BC=8C?=
 =?UTF-8?q?=E5=8F=82=E8=80=83=20VSCode=20=E6=97=A0=E9=9C=80=E6=89=8B?=
 =?UTF-8?q?=E5=8A=A8=E4=B8=8B=E6=BB=91?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/components/Sidebar.vue | 23 ++++++++++++++++++++---
 1 file changed, 20 insertions(+), 3 deletions(-)

diff --git a/src/components/Sidebar.vue b/src/components/Sidebar.vue
index fd4df88c..5b85a53f 100644
--- a/src/components/Sidebar.vue
+++ b/src/components/Sidebar.vue
@@ -23,7 +23,7 @@
       </div>
     </div>
 
-    <div class="flex-1 overflow-auto py-1">
+    <div ref="scrollContainer" class="flex-1 overflow-auto py-1">
       <div v-if="!rootDir" class="px-3 py-6">
         <div class="text-center">
           <p class="text-xs text-gray-400 mb-3">{{ t('sidebar.noFolder') }}</p>
@@ -64,7 +64,7 @@
         </div>
 
         <!-- 额外挂载的根（多根工作区 phase 1） -->
-        <div v-for="er in (extraRoots || [])" :key="er">
+        <div v-for="er in (extraRoots || [])" :key="er" :ref="setRootEl(er)">
           <div class="group sticky top-0 z-10 bg-gray-50 dark:bg-gray-800 flex items-center gap-1 px-2 py-1 cursor-pointer border-t border-gray-200 dark:border-gray-700 hover:bg-gray-100 dark:hover:bg-gray-700"
                @click="toggleExtra(er)">
             <ChevronRight class="w-3 h-3 text-gray-400 transition-transform flex-shrink-0"
@@ -293,6 +293,12 @@ const hasExtra = computed(() => !!(props.extraRoots && props.extraRoots.length))
 const primaryCollapsed = ref(false)
 const extraNodesMap = reactive<Record<string, FileNode[]>>({})
 const extraCollapsed = reactive<Record<string, boolean>>({})
+const scrollContainer = ref<HTMLElement | null>(null)
+const rootEls = new Map<string, HTMLElement>()
+const setRootEl = (path: string) => (el: unknown) => {
+  if (el) rootEls.set(path, el as HTMLElement)
+  else rootEls.delete(path)
+}
 const toggleExtra = (path: string) => {
   extraCollapsed[path] = !extraCollapsed[path]
 }
@@ -315,7 +321,18 @@ const loadExtraRoots = async () => {
     }
   }
 }
-watch(() => props.extraRoots, () => loadExtraRoots(), {immediate: true, deep: true})
+watch(() => props.extraRoots, async (next, prev) => {
+  await loadExtraRoots()
+  // 新增一个根时（非首次挂载），滚动到该分区，参考 VSCode 添加文件夹后即可见
+  if (prev !== undefined) {
+    const added = (next || []).find(p => !(prev || []).includes(p))
+    if (added) {
+      extraCollapsed[added] = false
+      await nextTick()
+      rootEls.get(added)?.scrollIntoView({block: 'nearest', behavior: 'smooth'})
+    }
+  }
+}, {immediate: true, deep: true})
 
 // ===== 刷新信号：变更后通知已展开目录刷新（保留展开状态）=====
 const refreshSignal = ref(0)

From 16e15c4030ae319313811d01bb85262b76e81233 Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Thu, 25 Jun 2026 17:37:53 +0800
Subject: [PATCH 04/20] =?UTF-8?q?fix(workspace):=20=E5=8E=BB=E9=99=A4?=
 =?UTF-8?q?=E6=96=87=E4=BB=B6=E6=A0=91=E5=AE=B9=E5=99=A8=E9=A1=B6=E9=83=A8?=
 =?UTF-8?q?=E5=86=85=E8=BE=B9=E8=B7=9D=EF=BC=8C=E6=B6=88=E9=99=A4=E5=90=B8?=
 =?UTF-8?q?=E9=A1=B6=E6=A0=B9=E6=A0=87=E9=A2=98=E4=B8=8A=E6=96=B9=E7=9A=84?=
 =?UTF-8?q?=E6=BB=9A=E5=8A=A8=E9=97=B4=E9=9A=99?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/components/Sidebar.vue | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/components/Sidebar.vue b/src/components/Sidebar.vue
index 5b85a53f..8c539514 100644
--- a/src/components/Sidebar.vue
+++ b/src/components/Sidebar.vue
@@ -23,7 +23,7 @@
       </div>
     </div>
 
-    <div ref="scrollContainer" class="flex-1 overflow-auto py-1">
+    <div ref="scrollContainer" class="flex-1 overflow-auto pb-1">
       <div v-if="!rootDir" class="px-3 py-6">
         <div class="text-center">
           <p class="text-xs text-gray-400 mb-3">{{ t('sidebar.noFolder') }}</p>

From 835c69f0cc4119c85dab789b5edce1fad5933096 Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Fri, 26 Jun 2026 10:55:49 +0800
Subject: [PATCH 05/20] =?UTF-8?q?feat(workspace):=20=E9=A2=9D=E5=A4=96?=
 =?UTF-8?q?=E6=A0=B9=E6=94=AF=E6=8C=81=E5=8F=B3=E9=94=AE=E8=8F=9C=E5=8D=95?=
 =?UTF-8?q?=EF=BC=88=E6=96=B0=E5=BB=BA/=E7=A7=BB=E9=99=A4=EF=BC=89?=
 =?UTF-8?q?=EF=BC=8C=E5=B9=B6=E4=BF=AE=E6=AD=A3=20Git=20=E8=8F=9C=E5=8D=95?=
 =?UTF-8?q?=E4=BB=85=E4=BD=9C=E7=94=A8=E4=BA=8E=E4=B8=BB=E4=BB=93=E5=BA=93?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

额外挂载根标题右键可新建文件/文件夹、在文件管理器显示、复制路径、从工作区移除（不删磁盘）；
修正额外根及其子节点不再暴露主仓库的 Git 暂存/对比/init 等操作（按节点是否位于主根判定）。
---
 src/components/Sidebar.vue | 38 ++++++++++++++++++++++++++++++--------
 1 file changed, 30 insertions(+), 8 deletions(-)

diff --git a/src/components/Sidebar.vue b/src/components/Sidebar.vue
index 8c539514..78f46de5 100644
--- a/src/components/Sidebar.vue
+++ b/src/components/Sidebar.vue
@@ -66,7 +66,8 @@
         <!-- 额外挂载的根（多根工作区 phase 1） -->
         <div v-for="er in (extraRoots || [])" :key="er" :ref="setRootEl(er)">
           <div class="group sticky top-0 z-10 bg-gray-50 dark:bg-gray-800 flex items-center gap-1 px-2 py-1 cursor-pointer border-t border-gray-200 dark:border-gray-700 hover:bg-gray-100 dark:hover:bg-gray-700"
-               @click="toggleExtra(er)">
+               @click="toggleExtra(er)"
+               @contextmenu.prevent.stop="onExtraRootContext(er, $event)">
             <ChevronRight class="w-3 h-3 text-gray-400 transition-transform flex-shrink-0"
                           :class="{'rotate-90': !extraCollapsed[er]}"/>
             <Folder class="w-3.5 h-3.5 text-blue-500 flex-shrink-0"/>
@@ -95,15 +96,19 @@
           <button class="w-full text-left px-3 py-1.5 hover:bg-gray-100 dark:hover:bg-gray-700 cursor-pointer" @click="promptCreate('folder')">{{ t('sidebar.newFolder') }}</button>
         </template>
         <template v-if="ctx.node">
-          <div v-if="!ctx.node || ctx.node.is_dir" class="border-t border-gray-100 dark:border-gray-700 my-1"></div>
-          <button class="w-full text-left px-3 py-1.5 hover:bg-gray-100 dark:hover:bg-gray-700 cursor-pointer" @click="promptRename">{{ t('sidebar.rename') }}</button>
-          <button class="w-full text-left px-3 py-1.5 hover:bg-gray-100 dark:hover:bg-gray-700 cursor-pointer text-red-600" @click="confirmDelete">{{ t('sidebar.delete') }}</button>
+          <div v-if="ctx.node.is_dir" class="border-t border-gray-100 dark:border-gray-700 my-1"></div>
+          <!-- 额外挂载的根：从工作区移除（不删除磁盘文件） -->
+          <button v-if="ctxExtraRoot" class="w-full text-left px-3 py-1.5 hover:bg-gray-100 dark:hover:bg-gray-700 cursor-pointer text-red-600" @click="removeExtraRoot">{{ t('sidebar.removeFolder') }}</button>
+          <template v-else>
+            <button class="w-full text-left px-3 py-1.5 hover:bg-gray-100 dark:hover:bg-gray-700 cursor-pointer" @click="promptRename">{{ t('sidebar.rename') }}</button>
+            <button class="w-full text-left px-3 py-1.5 hover:bg-gray-100 dark:hover:bg-gray-700 cursor-pointer text-red-600" @click="confirmDelete">{{ t('sidebar.delete') }}</button>
+          </template>
           <div class="border-t border-gray-100 dark:border-gray-700 my-1"></div>
           <button class="w-full text-left px-3 py-1.5 hover:bg-gray-100 dark:hover:bg-gray-700 cursor-pointer" @click="reveal">{{ t('sidebar.revealIn', { label: revealLabel }) }}</button>
           <button class="w-full text-left px-3 py-1.5 hover:bg-gray-100 dark:hover:bg-gray-700 cursor-pointer" @click="copyPath">{{ t('git.copyPath') }}</button>
 
-          <!-- Git 操作 -->
-          <template v-if="gitRepo">
+          <!-- Git 操作（仅作用于主仓库内的节点）-->
+          <template v-if="gitRepo && nodeInPrimary">
             <div class="border-t border-gray-100 dark:border-gray-700 my-1"></div>
             <template v-if="!ctx.node.is_dir">
               <template v-if="ctxChanged">
@@ -118,7 +123,7 @@
             </template>
             <button v-else class="w-full text-left px-3 py-1.5 hover:bg-gray-100 dark:hover:bg-gray-700 cursor-pointer" @click="gitStageDir">{{ t('git.stageDir') }}</button>
           </template>
-          <template v-else-if="ctx.node.is_dir && rootDir">
+          <template v-else-if="ctx.node.is_dir && rootDir && nodeInPrimary">
             <div class="border-t border-gray-100 dark:border-gray-700 my-1"></div>
             <button class="w-full text-left px-3 py-1.5 hover:bg-gray-100 dark:hover:bg-gray-700 cursor-pointer" @click="gitInit">{{ t('git.init') }}</button>
           </template>
@@ -364,8 +369,17 @@ onUnmounted(() => {
 const ctx = reactive<{ visible: boolean, x: number, y: number, node: FileNode | null }>({
   visible: false, x: 0, y: 0, node: null
 })
+// 右键目标若为某个额外挂载的根，记录其路径（菜单显示「从工作区移除」而非删除/重命名）
+const ctxExtraRoot = ref<string | null>(null)
+// 右键节点是否属于主仓库（额外根及其子节点不暴露主仓库的 Git 操作）
+const nodeInPrimary = computed(() => {
+  if (!ctx.node || !props.rootDir) return false
+  const root = props.rootDir.replace(/[\\/]+$/, '')
+  return ctx.node.path === root || ctx.node.path.startsWith(root + '/')
+})
 const menuRef = ref<HTMLElement | null>(null)
-const openCtx = async (node: FileNode | null, e: MouseEvent) => {
+const openCtx = async (node: FileNode | null, e: MouseEvent, extraRoot: string | null = null) => {
+  ctxExtraRoot.value = extraRoot
   ctx.node = node
   ctx.x = e.clientX
   ctx.y = e.clientY
@@ -394,6 +408,14 @@ const onRootContext = (e: MouseEvent) => {
     openCtx({name: rootName.value, path: props.rootDir, is_dir: true}, e)
   }
 }
+// 额外挂载根的标题右键菜单
+const onExtraRootContext = (er: string, e: MouseEvent) => {
+  openCtx({name: folderName(er), path: er, is_dir: true}, e, er)
+}
+const removeExtraRoot = () => {
+  if (ctxExtraRoot.value) emit('remove-root', ctxExtraRoot.value)
+  closeCtx()
+}
 
 const isMac = /Mac/i.test(navigator.platform)
 const revealLabel = computed(() => isMac ? t('sidebar.revealFinder') : (/Win/i.test(navigator.platform) ? t('sidebar.revealExplorer') : t('sidebar.revealManager')))

From c35fca8320b2cb4f204a47e3f2f2d59c5126105a Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Fri, 26 Jun 2026 11:00:35 +0800
Subject: [PATCH 06/20] =?UTF-8?q?feat(workspace):=20=E9=A2=9D=E5=A4=96?=
 =?UTF-8?q?=E6=A0=B9=E7=9A=84=20Git=20=E6=94=B9=E5=8A=A8=E5=BE=BD=E6=A0=87?=
 =?UTF-8?q?=EF=BC=88=E5=90=84=E6=A0=B9=E5=8F=AF=E4=B8=BA=E7=8B=AC=E7=AB=8B?=
 =?UTF-8?q?=E4=BB=93=E5=BA=93=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

刷新 Git 状态时合并每个额外挂载根的改动状态到同一张绝对路径表，
额外根若本身是 Git 仓库，其文件树同样显示新增/修改等徽标；挂载或移除根后自动刷新。
---
 src/App.vue | 33 ++++++++++++++++++++++-----------
 1 file changed, 22 insertions(+), 11 deletions(-)

diff --git a/src/App.vue b/src/App.vue
index 2bad5c2a..19f2c7bf 100644
--- a/src/App.vue
+++ b/src/App.vue
@@ -1562,31 +1562,42 @@ const openGit = () => {
 // 文件树徽标用：绝对路径 → 状态字母（M/A/D/U）
 const gitStatus = ref<Record<string, string>>({})
 const gitRepo = ref(false)
-const refreshGitStatus = async () => {
-  if (!rootDir.value) {
-    gitStatus.value = {}
-    return
-  }
+// 计算单个根的 Git 状态（路径用绝对路径作 key，便于多根合并到同一张表）
+const gitStatusFor = async (root: string): Promise<{ isRepo: boolean, map: Record<string, string> }> => {
   try {
     const s = await invoke<{ is_repo: boolean, files: { path: string, index: string, worktree: string }[] }>(
-        'git_status', {root: rootDir.value}
+        'git_status', {root}
     )
-    gitRepo.value = s.is_repo
     const map: Record<string, string> = {}
     if (s.is_repo) {
       for (const f of s.files) {
         const code = f.index === '?'
             ? 'U'
             : (f.worktree.trim() || f.index.trim() || 'M')
-        map[`${rootDir.value}/${f.path}`] = code
+        map[`${root}/${f.path}`] = code
       }
     }
-    gitStatus.value = map
+    return {isRepo: s.is_repo, map}
   }
   catch {
+    return {isRepo: false, map: {}}
+  }
+}
+const refreshGitStatus = async () => {
+  if (!rootDir.value) {
     gitStatus.value = {}
     gitRepo.value = false
+    return
+  }
+  const primary = await gitStatusFor(rootDir.value)
+  gitRepo.value = primary.isRepo
+  const map: Record<string, string> = {...primary.map}
+  // 额外挂载的根各自可为独立仓库，合并它们的状态徽标
+  if (extraRoots.value.length) {
+    const extra = await Promise.all(extraRoots.value.map(er => gitStatusFor(er)))
+    for (const e of extra) Object.assign(map, e.map)
   }
+  gitStatus.value = map
   // HEAD 可能因提交/切换分支变化，刷新编辑器行内差异基线
   fetchBaseline()
 }
@@ -1676,8 +1687,8 @@ watch(() => debug.reveal.value, async (loc) => {
   gotoLine(loc.line)
 })
 
-// 打开文件夹、保存文件后刷新文件树 Git 徽标与差异基线
-watch(rootDir, () => refreshGitStatus(), {immediate: true})
+// 打开文件夹、保存文件、挂载/移除额外根后刷新文件树 Git 徽标与差异基线
+watch([rootDir, extraRoots], () => refreshGitStatus(), {immediate: true, deep: true})
 watch(savedContent, () => refreshGitStatus())
 
 const closeViewer = () => {

From af06397e042ce000ccbc9e51e4d3cc70c71aeba0 Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Fri, 26 Jun 2026 11:24:12 +0800
Subject: [PATCH 07/20] =?UTF-8?q?feat(workspace):=20=E6=96=87=E4=BB=B6?=
 =?UTF-8?q?=E5=A4=B9=E5=86=85=E6=90=9C=E7=B4=A2/=E6=9B=BF=E6=8D=A2?=
 =?UTF-8?q?=E8=A6=86=E7=9B=96=E5=85=A8=E9=83=A8=E5=B7=A5=E4=BD=9C=E5=8C=BA?=
 =?UTF-8?q?=E6=A0=B9?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

搜索与全部替换并行查询主根及各额外挂载根并合并结果；
多根时结果路径前缀根名以区分来源（最长匹配定位归属根，避免嵌套误判）。
---
 src/App.vue                    |  2 +-
 src/components/SearchPanel.vue | 38 +++++++++++++++++++++++++++-------
 2 files changed, 31 insertions(+), 9 deletions(-)

diff --git a/src/App.vue b/src/App.vue
index 19f2c7bf..cf58e5cd 100644
--- a/src/App.vue
+++ b/src/App.vue
@@ -313,7 +313,7 @@
     <AiAssistant v-if="showAi" :code="code" :language="currentLanguage" :execution-id="aiExecutionId" :error-context="aiErrorContext" :initial-prompt="aiInitialPrompt" :root-dir="rootDir" @close="showAi = false" @insert-code="applyAiCode"/>
 
     <!-- 文件夹内全局搜索 -->
-    <SearchPanel v-if="showSearch && rootDir" :root-dir="rootDir" @open="openSearchResult" @replaced="reloadAffectedFiles" @close="showSearch = false"/>
+    <SearchPanel v-if="showSearch && rootDir" :root-dir="rootDir" :extra-roots="extraRoots" @open="openSearchResult" @replaced="reloadAffectedFiles" @close="showSearch = false"/>
 
     <!-- 快速打开文件 -->
     <QuickOpen v-if="showQuickOpen && rootDir"
diff --git a/src/components/SearchPanel.vue b/src/components/SearchPanel.vue
index 3177f7d2..59f93313 100644
--- a/src/components/SearchPanel.vue
+++ b/src/components/SearchPanel.vue
@@ -79,7 +79,9 @@ interface Match
   text: string
 }
 
-const props = defineProps<{ rootDir: string }>()
+const props = defineProps<{ rootDir: string, extraRoots?: string[] }>()
+// 主根 + 额外挂载的根，搜索/替换覆盖整个工作区
+const allRoots = computed(() => [props.rootDir, ...(props.extraRoots || [])])
 const emit = defineEmits<{
   open: [path: string, line: number]
   close: []
@@ -110,11 +112,17 @@ const replaceAll = async () => {
   const affected = Array.from(new Set(results.value.map(m => m.path)))
   replacing.value = true
   try {
-    const summary = await invoke<{ files_changed: number, replacements: number }>('replace_in_files', {
-      root: props.rootDir,
-      query: q,
-      replacement: replacement.value
-    })
+    const summaries = await Promise.all(allRoots.value.map(r =>
+        invoke<{ files_changed: number, replacements: number }>('replace_in_files', {
+          root: r,
+          query: q,
+          replacement: replacement.value
+        }).catch(() => ({files_changed: 0, replacements: 0}))
+    ))
+    const summary = summaries.reduce((a, b) => ({
+      files_changed: a.files_changed + b.files_changed,
+      replacements: a.replacements + b.replacements
+    }), {files_changed: 0, replacements: 0})
     toast.success(t('search.replacedSummary', { count: summary.replacements, files: summary.files_changed }))
     emit('replaced', affected)
     await search()
@@ -127,7 +135,18 @@ const replaceAll = async () => {
   }
 }
 
-const rel = (p: string) => p.startsWith(props.rootDir) ? p.slice(props.rootDir.length + 1) : p
+// 找到该路径所属的根（多根时取最长匹配，避免嵌套根误判）
+const ownerRoot = (p: string) => allRoots.value
+    .filter(r => p === r || p.startsWith(r + '/') || p.startsWith(r + '\\'))
+    .sort((a, b) => b.length - a.length)[0] || ''
+const folderName = (p: string) => p.split(/[\\/]/).filter(Boolean).pop() || p
+const rel = (p: string) => {
+  const root = ownerRoot(p)
+  let r = root && p.startsWith(root) ? p.slice(root.length).replace(/^[\\/]/, '') : p
+  // 多根时在相对路径前加上根名，便于区分来自哪个根
+  if (allRoots.value.length > 1 && root) r = `${folderName(root)}/${r}`
+  return r
+}
 
 const groups = computed(() => {
   const map = new Map<string, Match[]>()
@@ -153,7 +172,10 @@ const search = async () => {
   }
   loading.value = true
   try {
-    results.value = await invoke<Match[]>('search_in_files', {root: props.rootDir, query: q})
+    const perRoot = await Promise.all(
+        allRoots.value.map(r => invoke<Match[]>('search_in_files', {root: r, query: q}).catch(() => []))
+    )
+    results.value = perRoot.flat()
   }
   catch (error) {
     console.error('搜索失败:', error)

From 71c2be90251d26f496fcd846e38990a9d00bebba Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Fri, 26 Jun 2026 11:27:08 +0800
Subject: [PATCH 08/20] =?UTF-8?q?feat(sidebar):=20=E6=96=B0=E5=A2=9E?=
 =?UTF-8?q?=E3=80=8C=E6=8A=98=E5=8F=A0=E6=96=87=E4=BB=B6=E5=A4=B9=E3=80=8D?=
 =?UTF-8?q?=E6=8C=89=E9=92=AE=EF=BC=8C=E4=B8=80=E9=94=AE=E6=8A=98=E5=8F=A0?=
 =?UTF-8?q?=E6=96=87=E4=BB=B6=E6=A0=91=E6=89=80=E6=9C=89=E5=B1=95=E5=BC=80?=
 =?UTF-8?q?=E7=9B=AE=E5=BD=95?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

参考 VSCode 资源管理器：侧栏头部新增折叠按钮，通过折叠信号通知各 FileTreeNode 收起；
多根工作区下对所有根的文件树同时生效。
---
 src/components/FileTreeNode.vue | 10 ++++++++++
 src/components/Sidebar.vue      | 13 ++++++++++++-
 src/i18n/locales/en.json        |  1 +
 src/i18n/locales/zh-CN.json     |  1 +
 4 files changed, 24 insertions(+), 1 deletion(-)

diff --git a/src/components/FileTreeNode.vue b/src/components/FileTreeNode.vue
index 0a3c41be..22100eaa 100644
--- a/src/components/FileTreeNode.vue
+++ b/src/components/FileTreeNode.vue
@@ -50,6 +50,7 @@ const openFile = inject<(path: string) => void>('treeOpenFile')
 const activePath = inject<ComputedRef<string | null>>('treeActivePath')
 const contextMenu = inject<(node: FileNode, e: MouseEvent) => void>('treeContextMenu')
 const refreshSignal = inject<Ref<number>>('treeRefresh')
+const collapseSignal = inject<Ref<number>>('treeCollapseAll')
 const gitStatus = inject<ComputedRef<Record<string, string>>>('treeGitStatus')
 
 const isActive = computed(() => !props.node.is_dir && activePath?.value === props.node.path)
@@ -100,4 +101,13 @@ if (refreshSignal) {
     }
   })
 }
+
+// 「折叠文件夹」：收到信号即折叠（子节点已卸载，递归整棵树自然全部折叠）
+if (collapseSignal) {
+  watch(collapseSignal, () => {
+    if (props.node.is_dir) {
+      expanded.value = false
+    }
+  })
+}
 </script>
diff --git a/src/components/Sidebar.vue b/src/components/Sidebar.vue
index 78f46de5..6157edff 100644
--- a/src/components/Sidebar.vue
+++ b/src/components/Sidebar.vue
@@ -14,6 +14,12 @@
                 @click="emit('add-folder')">
           <FolderPlus class="w-4 h-4"/>
         </button>
+        <button v-if="rootDir"
+                class="p-1 rounded text-gray-400 hover:text-gray-700 dark:hover:text-gray-200 hover:bg-gray-200 dark:hover:bg-gray-700 cursor-pointer"
+                :title="t('sidebar.collapseFolders')"
+                @click="collapseAllFolders">
+          <ChevronsDownUp class="w-4 h-4"/>
+        </button>
         <button v-if="rootDir"
                 class="p-1 rounded text-gray-400 hover:text-gray-700 dark:hover:text-gray-200 hover:bg-gray-200 dark:hover:bg-gray-700 cursor-pointer"
                 :title="t('sidebar.refresh')"
@@ -203,7 +209,7 @@ import {computed, nextTick, onMounted, onUnmounted, provide, reactive, ref, watc
 import {invoke} from '@tauri-apps/api/core'
 import {open as openDialog} from '@tauri-apps/plugin-dialog'
 import {listen, type UnlistenFn} from '@tauri-apps/api/event'
-import {ChevronRight, Folder, FolderOpen, FolderPlus, RefreshCw, X} from 'lucide-vue-next'
+import {ChevronRight, ChevronsDownUp, Folder, FolderOpen, FolderPlus, RefreshCw, X} from 'lucide-vue-next'
 import Button from '../ui/Button.vue'
 import Modal from '../ui/Modal.vue'
 import Input from '../ui/Input.vue'
@@ -347,6 +353,11 @@ const triggerRefresh = () => {
   loadRoot()
 }
 
+// ===== 折叠所有文件夹（参考 VSCode 资源管理器）=====
+const collapseSignal = ref(0)
+provide('treeCollapseAll', collapseSignal)
+const collapseAllFolders = () => collapseSignal.value++
+
 // 文件系统变化（外部改动）防抖刷新
 let fsTimer: any = null
 let unlistenFs: UnlistenFn | null = null
diff --git a/src/i18n/locales/en.json b/src/i18n/locales/en.json
index bc4dd147..ba6e9f70 100644
--- a/src/i18n/locales/en.json
+++ b/src/i18n/locales/en.json
@@ -779,6 +779,7 @@
     "openFolder": "Open folder",
     "addFolder": "Add folder to workspace",
     "removeFolder": "Remove from workspace",
+    "collapseFolders": "Collapse folders",
     "refresh": "Refresh",
     "noFolder": "No folder open",
     "recent": "Recent",
diff --git a/src/i18n/locales/zh-CN.json b/src/i18n/locales/zh-CN.json
index fd7f4b27..9b1381b4 100644
--- a/src/i18n/locales/zh-CN.json
+++ b/src/i18n/locales/zh-CN.json
@@ -779,6 +779,7 @@
     "openFolder": "打开文件夹",
     "addFolder": "添加文件夹到工作区",
     "removeFolder": "从工作区移除",
+    "collapseFolders": "折叠文件夹",
     "refresh": "刷新",
     "noFolder": "未打开文件夹",
     "recent": "最近打开",

From e7ad64761e31b80dc1b92250340807c2a4498a97 Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Fri, 26 Jun 2026 11:31:28 +0800
Subject: [PATCH 09/20] =?UTF-8?q?feat(search):=20=E6=96=87=E4=BB=B6?=
 =?UTF-8?q?=E6=A0=91=E5=8F=B3=E9=94=AE=E6=94=AF=E6=8C=81=E3=80=8C=E5=9C=A8?=
 =?UTF-8?q?=E6=96=87=E4=BB=B6=E5=A4=B9=E4=B8=AD=E6=90=9C=E7=B4=A2=E3=80=8D?=
 =?UTF-8?q?=EF=BC=8C=E9=99=90=E5=AE=9A=E8=8C=83=E5=9B=B4=E6=A3=80=E7=B4=A2?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

目录右键新增「在文件夹中搜索」，打开搜索面板并将范围限定为该目录（含额外根子目录）；
搜索面板显示当前范围提示，无范围时仍覆盖整个工作区。
---
 src/App.vue                    | 13 ++++++++++++-
 src/components/SearchPanel.vue | 15 +++++++++++----
 src/components/Sidebar.vue     |  6 ++++++
 src/i18n/locales/en.json       |  2 ++
 src/i18n/locales/zh-CN.json    |  2 ++
 5 files changed, 33 insertions(+), 5 deletions(-)

diff --git a/src/App.vue b/src/App.vue
index cf58e5cd..e20c02ea 100644
--- a/src/App.vue
+++ b/src/App.vue
@@ -65,6 +65,7 @@
                  @remove-root="removeWorkspaceFolder"
                  @open-recent="openFolderPath"
                  @open-file="smartOpen"
+                 @search-in="openSearchInFolder"
                  @renamed="(from, to) => updateTabPath(from, to)"
                  @deleted="(p) => detachTabPath(p)"
                  @git-refresh="refreshGitStatus"/>
@@ -313,7 +314,7 @@
     <AiAssistant v-if="showAi" :code="code" :language="currentLanguage" :execution-id="aiExecutionId" :error-context="aiErrorContext" :initial-prompt="aiInitialPrompt" :root-dir="rootDir" @close="showAi = false" @insert-code="applyAiCode"/>
 
     <!-- 文件夹内全局搜索 -->
-    <SearchPanel v-if="showSearch && rootDir" :root-dir="rootDir" :extra-roots="extraRoots" @open="openSearchResult" @replaced="reloadAffectedFiles" @close="showSearch = false"/>
+    <SearchPanel v-if="showSearch && rootDir" :root-dir="rootDir" :extra-roots="extraRoots" :scope="searchScope" @open="openSearchResult" @replaced="reloadAffectedFiles" @close="showSearch = false"/>
 
     <!-- 快速打开文件 -->
     <QuickOpen v-if="showQuickOpen && rootDir"
@@ -1127,11 +1128,21 @@ const insertGeneratedCode = (text: string) => {
 
 // 文件夹内全局搜索（Cmd+Shift+F）
 const showSearch = ref(false)
+const searchScope = ref<string | null>(null)
 const openSearch = () => {
   if (!rootDir.value) {
     toast.info(t('app.openFolderFirst'))
     return
   }
+  searchScope.value = null
+  showSearch.value = true
+}
+// 来自文件树「在文件夹中搜索」：限定搜索范围为该目录
+const openSearchInFolder = (path: string) => {
+  if (!rootDir.value) {
+    return
+  }
+  searchScope.value = path
   showSearch.value = true
 }
 
diff --git a/src/components/SearchPanel.vue b/src/components/SearchPanel.vue
index 59f93313..c06018fd 100644
--- a/src/components/SearchPanel.vue
+++ b/src/components/SearchPanel.vue
@@ -30,6 +30,12 @@
         </button>
       </div>
 
+      <!-- 搜索范围（来自「在文件夹中搜索」）-->
+      <div v-if="scope" class="px-3 py-1.5 border-b border-gray-200 dark:border-gray-700 flex-shrink-0 flex items-center gap-1.5 text-xs text-gray-500 dark:text-gray-400">
+        <FolderSearch class="w-3.5 h-3.5 text-gray-400"/>
+        <span>{{ t('search.scopedTo', { folder: scopeName }) }}</span>
+      </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">
@@ -68,7 +74,7 @@
 <script setup lang="ts">
 import {computed, onMounted, ref} from 'vue'
 import {invoke} from '@tauri-apps/api/core'
-import {FileText, Replace, Search} from 'lucide-vue-next'
+import {FileText, FolderSearch, Replace, Search} from 'lucide-vue-next'
 import {useToast} from '../plugins/toast'
 import {useI18n} from 'vue-i18n'
 
@@ -79,9 +85,10 @@ interface Match
   text: string
 }
 
-const props = defineProps<{ rootDir: string, extraRoots?: string[] }>()
-// 主根 + 额外挂载的根，搜索/替换覆盖整个工作区
-const allRoots = computed(() => [props.rootDir, ...(props.extraRoots || [])])
+const props = defineProps<{ rootDir: string, extraRoots?: string[], scope?: string | null }>()
+// 有 scope 时只搜该文件夹；否则覆盖主根 + 全部额外挂载根
+const allRoots = computed(() => props.scope ? [props.scope] : [props.rootDir, ...(props.extraRoots || [])])
+const scopeName = computed(() => props.scope ? (props.scope.split(/[\\/]/).filter(Boolean).pop() || props.scope) : '')
 const emit = defineEmits<{
   open: [path: string, line: number]
   close: []
diff --git a/src/components/Sidebar.vue b/src/components/Sidebar.vue
index 6157edff..60c87449 100644
--- a/src/components/Sidebar.vue
+++ b/src/components/Sidebar.vue
@@ -110,6 +110,7 @@
             <button class="w-full text-left px-3 py-1.5 hover:bg-gray-100 dark:hover:bg-gray-700 cursor-pointer text-red-600" @click="confirmDelete">{{ t('sidebar.delete') }}</button>
           </template>
           <div class="border-t border-gray-100 dark:border-gray-700 my-1"></div>
+          <button v-if="ctx.node.is_dir" class="w-full text-left px-3 py-1.5 hover:bg-gray-100 dark:hover:bg-gray-700 cursor-pointer" @click="searchInFolder">{{ t('sidebar.searchInFolder') }}</button>
           <button class="w-full text-left px-3 py-1.5 hover:bg-gray-100 dark:hover:bg-gray-700 cursor-pointer" @click="reveal">{{ t('sidebar.revealIn', { label: revealLabel }) }}</button>
           <button class="w-full text-left px-3 py-1.5 hover:bg-gray-100 dark:hover:bg-gray-700 cursor-pointer" @click="copyPath">{{ t('git.copyPath') }}</button>
 
@@ -242,6 +243,7 @@ const emit = defineEmits<{
   'remove-root': [path: string]
   'open-recent': [path: string]
   'open-file': [path: string]
+  'search-in': [path: string]
   'renamed': [from: string, to: string]
   'deleted': [path: string]
   'git-refresh': []
@@ -427,6 +429,10 @@ const removeExtraRoot = () => {
   if (ctxExtraRoot.value) emit('remove-root', ctxExtraRoot.value)
   closeCtx()
 }
+const searchInFolder = () => {
+  if (ctx.node?.is_dir) emit('search-in', ctx.node.path)
+  closeCtx()
+}
 
 const isMac = /Mac/i.test(navigator.platform)
 const revealLabel = computed(() => isMac ? t('sidebar.revealFinder') : (/Win/i.test(navigator.platform) ? t('sidebar.revealExplorer') : t('sidebar.revealManager')))
diff --git a/src/i18n/locales/en.json b/src/i18n/locales/en.json
index ba6e9f70..93432262 100644
--- a/src/i18n/locales/en.json
+++ b/src/i18n/locales/en.json
@@ -780,6 +780,7 @@
     "addFolder": "Add folder to workspace",
     "removeFolder": "Remove from workspace",
     "collapseFolders": "Collapse folders",
+    "searchInFolder": "Search in folder",
     "refresh": "Refresh",
     "noFolder": "No folder open",
     "recent": "Recent",
@@ -809,6 +810,7 @@
   },
   "search": {
     "placeholder": "Search in folder…",
+    "scopedTo": "Searching in \"{folder}\"",
     "searching": "Searching…",
     "countSummary": "{count} matches / {files} files",
     "replacePlaceholder": "Replace with… (case-insensitive)",
diff --git a/src/i18n/locales/zh-CN.json b/src/i18n/locales/zh-CN.json
index 9b1381b4..052cc042 100644
--- a/src/i18n/locales/zh-CN.json
+++ b/src/i18n/locales/zh-CN.json
@@ -780,6 +780,7 @@
     "addFolder": "添加文件夹到工作区",
     "removeFolder": "从工作区移除",
     "collapseFolders": "折叠文件夹",
+    "searchInFolder": "在文件夹中搜索",
     "refresh": "刷新",
     "noFolder": "未打开文件夹",
     "recent": "最近打开",
@@ -809,6 +810,7 @@
   },
   "search": {
     "placeholder": "在文件夹内搜索…",
+    "scopedTo": "在「{folder}」中搜索",
     "searching": "搜索中…",
     "countSummary": "{count} 处 / {files} 文件",
     "replacePlaceholder": "替换为…（大小写不敏感）",

From a4650aeaf52fe17b8585305757552762a9e4d133 Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Fri, 26 Jun 2026 11:35:14 +0800
Subject: [PATCH 10/20] =?UTF-8?q?feat(outline):=20=E5=A4=A7=E7=BA=B2?=
 =?UTF-8?q?=E6=8C=89=E5=B1=82=E7=BA=A7=E7=BC=A9=E8=BF=9B=E6=98=BE=E7=A4=BA?=
 =?UTF-8?q?=EF=BC=8C=E5=B9=B6=E9=BB=98=E8=AE=A4=E9=80=89=E4=B8=AD=E5=85=89?=
 =?UTF-8?q?=E6=A0=87=E6=89=80=E5=9C=A8=E7=AC=A6=E5=8F=B7?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

依据源码缩进推断层级并缩进展示，嵌套方法/类一目了然；
打开大纲时自动定位并选中光标所在（或其上方最近）的符号，参考 VSCode 转到符号。
---
 src/App.vue                |  1 +
 src/components/Outline.vue | 33 ++++++++++++++++++++++++++-------
 2 files changed, 27 insertions(+), 7 deletions(-)

diff --git a/src/App.vue b/src/App.vue
index e20c02ea..68eb9207 100644
--- a/src/App.vue
+++ b/src/App.vue
@@ -338,6 +338,7 @@
     <Outline v-if="showOutline"
              :code="code"
              :language="currentLanguage"
+             :current-line="cursorInfo.line"
              @go="gotoLine"
              @close="showOutline = false"/>
 
diff --git a/src/components/Outline.vue b/src/components/Outline.vue
index b3fdc788..73384a84 100644
--- a/src/components/Outline.vue
+++ b/src/components/Outline.vue
@@ -27,7 +27,7 @@
                 @click="choose(s)"
                 @mousemove="activeIndex = i">
           <span class="w-12 flex-shrink-0 text-[10px] uppercase font-semibold" :class="kindColor(s.kind)">{{ s.kind }}</span>
-          <span class="text-sm text-gray-800 dark:text-gray-100 truncate font-mono">{{ s.name }}</span>
+          <span class="text-sm text-gray-800 dark:text-gray-100 truncate font-mono" :style="{ paddingLeft: `${s.depth * 14}px` }">{{ s.name }}</span>
           <span class="ml-auto pl-3 text-xs text-gray-400 flex-shrink-0">{{ s.line }}</span>
         </button>
       </div>
@@ -42,9 +42,9 @@ import {ListTree} from 'lucide-vue-next'
 
 const {t} = useI18n()
 
-interface Symbol { name: string; kind: string; line: number }
+interface Symbol { name: string; kind: string; line: number; depth: number }
 
-const props = defineProps<{ code: string; language?: string }>()
+const props = defineProps<{ code: string; language?: string; currentLine?: number }>()
 const emit = defineEmits<{ go: [line: number]; close: [] }>()
 
 const query = ref('')
@@ -56,7 +56,21 @@ const setItemRef = (el: any, i: number) => {
   if (el) itemRefs[i] = el
 }
 
-onMounted(() => inputRef.value?.focus())
+onMounted(() => {
+  inputRef.value?.focus()
+  // 预选：定位到光标所在（或其上方最近）的符号，打开即落在当前函数
+  if (props.currentLine && symbols.value.length) {
+    let idx = -1
+    for (let i = 0; i < symbols.value.length; i++) {
+      if (symbols.value[i].line <= props.currentLine) idx = i
+      else break
+    }
+    if (idx >= 0) {
+      activeIndex.value = idx
+      nextTick(() => itemRefs[idx]?.scrollIntoView({block: 'center'}))
+    }
+  }
+})
 
 // 控制关键字，避免把 if/for 等当成方法名
 const STOP = new Set(['if', 'for', 'while', 'switch', 'catch', 'return', 'else', 'do', 'foreach', 'with', 'when', 'match'])
@@ -137,18 +151,23 @@ const rulesFor = (fam: string): [RegExp, string, number][] => {
 const symbols = computed<Symbol[]>(() => {
   const lines = (props.code || '').split('\n')
   const rules = rulesFor(family.value)
-  const out: Symbol[] = []
+  const raw: { name: string; kind: string; line: number; indent: number }[] = []
   for (let i = 0; i < lines.length; i++) {
     const line = lines[i]
     for (const [re, kind, g] of rules) {
       const m = re.exec(line)
       if (m && m[g] && !STOP.has(m[g])) {
-        out.push({name: m[g], kind, line: i + 1})
+        // 缩进宽度（tab 记为 4），用于推断层级
+        const lead = line.slice(0, line.length - line.trimStart().length)
+        const indent = lead.replace(/\t/g, '    ').length
+        raw.push({name: m[g], kind, line: i + 1, indent})
         break
       }
     }
   }
-  return out
+  // 将出现过的缩进值排序后映射为层级，避免受具体缩进大小影响
+  const levels = Array.from(new Set(raw.map(s => s.indent))).sort((a, b) => a - b)
+  return raw.map(s => ({name: s.name, kind: s.kind, line: s.line, depth: levels.indexOf(s.indent)}))
 })
 
 const filtered = computed<Symbol[]>(() => {

From 2a017c166988d641305c67fe7ee9d3f46698a68e Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Fri, 26 Jun 2026 11:39:09 +0800
Subject: [PATCH 11/20] =?UTF-8?q?feat(editor):=20=E4=BF=9D=E5=AD=98?=
 =?UTF-8?q?=E6=97=B6=E6=8C=89=20.editorconfig=20=E5=8E=BB=E9=99=A4?=
 =?UTF-8?q?=E8=A1=8C=E5=B0=BE=E7=A9=BA=E7=99=BD=E5=B9=B6=E8=A1=A5=E6=9C=AB?=
 =?UTF-8?q?=E5=B0=BE=E6=8D=A2=E8=A1=8C?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

读取当前文件解析到的 trim_trailing_whitespace / insert_final_newline，
保存前对文档做相应清理（无 .editorconfig 则空操作）；保存、保存并运行、命令面板保存均生效。
---
 src/App.vue | 42 +++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 41 insertions(+), 1 deletion(-)

diff --git a/src/App.vue b/src/App.vue
index 68eb9207..297cbbde 100644
--- a/src/App.vue
+++ b/src/App.vue
@@ -1778,6 +1778,43 @@ const watchMode = ref(kvGet('watch-mode') === 'true')
 watch(watchMode, (v) => kvSet('watch-mode', String(v)))
 
 // 保存包装：保存后若开启监听模式则自动运行
+// 保存前按 .editorconfig 清理：去除行尾空白 / 补末尾换行（无 .editorconfig 时为空操作）
+const applyEditorconfigOnSave = async () => {
+  const view = editorView.value
+  if (!view || !currentFilePath.value) {
+    return
+  }
+  let r: { trim_trailing_whitespace?: boolean; insert_final_newline?: boolean } | null = null
+  try {
+    r = await invoke('resolve_editorconfig', {filePath: currentFilePath.value})
+  }
+  catch {
+    return
+  }
+  const trim = r?.trim_trailing_whitespace === true
+  const finalNl = r?.insert_final_newline === true
+  if (!trim && !finalNl) {
+    return
+  }
+  const text = view.state.doc.toString()
+  let next = text
+  if (trim) {
+    next = next.replace(/[ \t]+(\r?\n)/g, '$1').replace(/[ \t]+$/, '')
+  }
+  if (finalNl && next.length > 0 && !next.endsWith('\n')) {
+    next += '\n'
+  }
+  if (next === text) {
+    return
+  }
+  const head = view.state.selection.main.head
+  view.dispatch({
+    changes: {from: 0, to: view.state.doc.length, insert: next},
+    selection: {anchor: Math.min(head, next.length)}
+  })
+  await nextTick()
+}
+
 const handleSave = async () => {
   // 保存前格式化：仅当开启、编辑器就绪且当前语言支持 LSP；失败/无能力则静默跳过
   if (formatOnSave.value && editorView.value && lspSupportsLanguage(currentLanguage.value)) {
@@ -1787,6 +1824,7 @@ const handleSave = async () => {
     }
     catch { /* 格式化失败不阻断保存 */ }
   }
+  await applyEditorconfigOnSave()
   await saveFile()
   if (watchMode.value && currentFilePath.value && !isDirty.value) {
     handleRunCode()
@@ -2048,6 +2086,7 @@ const handleRunCode = async () => {
     showRunPrompt.value = true
   }
   else {
+    await applyEditorconfigOnSave()
     await saveFile()
     runCode({...buildRunBase(), filePath: currentFilePath.value})
   }
@@ -2055,6 +2094,7 @@ const handleRunCode = async () => {
 
 const promptSaveAndRun = async () => {
   showRunPrompt.value = false
+  await applyEditorconfigOnSave()
   await saveFile()
   runCode({...buildRunBase(), filePath: currentFilePath.value})
 }
@@ -2190,7 +2230,7 @@ const paletteCommands = computed<PaletteCommand[]>(() => [
   {id: 'formatOnSave', label: formatOnSave.value ? t('command.formatOnSaveOff') : t('command.formatOnSaveOn'), icon: Save, run: () => toggleFormatOnSave()},
   {id: 'open', label: t('command.open'), icon: FolderOpen, hint: hintOf('open'), run: () => handleOpenFileClick()},
   {id: 'openFolder', label: t('command.openFolder'), icon: FolderOpen, run: () => openFolder()},
-  {id: 'save', label: t('command.save'), icon: Save, hint: hintOf('save'), run: () => saveFile()},
+  {id: 'save', label: t('command.save'), icon: Save, hint: hintOf('save'), run: () => handleSave()},
   {id: 'saveAs', label: t('command.saveAs'), icon: Save, hint: hintOf('saveAs'), run: () => saveFileAs()},
   {id: 'newTab', label: t('command.newTab'), icon: Plus, hint: hintOf('newTab'), run: () => handleNewTab()},
   {id: 'closeTab', label: t('command.closeTab'), icon: X, hint: hintOf('closeTab'), run: () => handleCloseTab(activeTabId.value)},

From 8b9293736e95cde165445831d8b889c7b0865f50 Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Fri, 26 Jun 2026 12:56:12 +0800
Subject: [PATCH 12/20] =?UTF-8?q?feat(editor):=20=E6=96=B0=E5=A2=9E?=
 =?UTF-8?q?=E3=80=8C=E8=87=AA=E5=8A=A8=E6=8D=A2=E8=A1=8C=E3=80=8D=E5=BC=80?=
 =?UTF-8?q?=E5=85=B3=EF=BC=8C=E9=95=BF=E8=A1=8C=E6=8A=98=E8=A1=8C=E6=98=BE?=
 =?UTF-8?q?=E7=A4=BA?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

设置页可开关自动换行；开启时编辑器启用 lineWrapping，配置项前后端同步
（config.rs 结构体与默认值、types/app.ts），切换即时重建生效。
---
 src-tauri/src/config.rs                | 4 ++++
 src/components/setting/Editor.vue      | 4 ++++
 src/composables/useCodeMirrorEditor.ts | 9 +++++++++
 src/i18n/locales/en.json               | 1 +
 src/i18n/locales/zh-CN.json            | 1 +
 src/types/app.ts                       | 1 +
 6 files changed, 20 insertions(+)

diff --git a/src-tauri/src/config.rs b/src-tauri/src/config.rs
index 361f5f6b..e04a514e 100644
--- a/src-tauri/src/config.rs
+++ b/src-tauri/src/config.rs
@@ -22,6 +22,7 @@ pub struct EditorConfig {
     pub space_dot_omission: Option<bool>,  // 是否显示空格省略
     pub show_minimap: Option<bool>,        // 是否显示代码缩略图
     pub show_sticky_scroll: Option<bool>,  // 是否启用粘性滚动
+    pub word_wrap: Option<bool>,           // 是否自动换行
     pub layout: Option<String>,            // 编辑器/控制台布局: horizontal | vertical | editor
     pub last_direction: Option<String>,    // 仅编辑器模式下控制台弹出方向: horizontal | vertical
     pub max_open_file_size: Option<u32>,   // 打开文件大小上限(MB)，超过则拒绝打开
@@ -73,6 +74,7 @@ impl Default for AppConfig {
                 space_dot_omission: Some(false),
                 show_minimap: Some(false),
                 show_sticky_scroll: Some(false),
+                word_wrap: Some(false),
                 layout: Some("horizontal".to_string()),
                 last_direction: Some("horizontal".to_string()),
                 max_open_file_size: Some(5),
@@ -145,6 +147,7 @@ impl ConfigManager {
                                 space_dot_omission: Some(false),
                                 show_minimap: Some(false),
                                 show_sticky_scroll: Some(false),
+                                word_wrap: Some(false),
                                 layout: Some("horizontal".to_string()),
                                 last_direction: Some("horizontal".to_string()),
                                 max_open_file_size: Some(5),
@@ -270,6 +273,7 @@ impl ConfigManager {
                 space_dot_omission: Some(false),
                 show_minimap: Some(false),
                 show_sticky_scroll: Some(false),
+                word_wrap: Some(false),
                 layout: Some("horizontal".to_string()),
                 last_direction: Some("horizontal".to_string()),
                 max_open_file_size: Some(5),
diff --git a/src/components/setting/Editor.vue b/src/components/setting/Editor.vue
index 4f2bd564..b36bfbb6 100644
--- a/src/components/setting/Editor.vue
+++ b/src/components/setting/Editor.vue
@@ -24,6 +24,10 @@
       <Switch v-model="editorConfig.show_sticky_scroll"/>
     </Label>
 
+    <Label :label="t('settings.editor.wordWrap')">
+      <Switch v-model="editorConfig.word_wrap"/>
+    </Label>
+
     <Label :label="t('settings.editor.tabSize')">
       <Number v-model="editorConfig.tab_size" :min="1" :max="8" :placeholder="t('settings.editor.tabSize')"/>
     </Label>
diff --git a/src/composables/useCodeMirrorEditor.ts b/src/composables/useCodeMirrorEditor.ts
index dcd36104..ffb18070 100644
--- a/src/composables/useCodeMirrorEditor.ts
+++ b/src/composables/useCodeMirrorEditor.ts
@@ -692,6 +692,11 @@ export function useCodeMirrorEditor(props: Props)
             result.push(buildMinimapTheme(isDark.value))
         }
 
+        // 自动换行：超出视口宽度的长行折行显示，可在设置中开关
+        if (editorConfig.value?.word_wrap) {
+            result.push(EditorView.lineWrapping)
+        }
+
         // 断点 gutter + 调试悬停求值（仅可调试语言）
         if (dapSupportsLanguage(props.language)) {
             result.push(breakpointExtension((line) => debug.toggleBreakpoint(props.filePath ?? null, line)))
@@ -829,6 +834,10 @@ export function useCodeMirrorEditor(props: Props)
         await reRenderEditor()
     })
 
+    watch(() => editorConfig.value?.word_wrap, async () => {
+        await reRenderEditor()
+    })
+
     return {
         // 状态
         isReady,
diff --git a/src/i18n/locales/en.json b/src/i18n/locales/en.json
index 93432262..91ff731e 100644
--- a/src/i18n/locales/en.json
+++ b/src/i18n/locales/en.json
@@ -48,6 +48,7 @@
       "spaceDotOmission": "Show whitespace dots",
       "showMinimap": "Show minimap",
       "showStickyScroll": "Enable sticky scroll",
+      "wordWrap": "Word wrap",
       "tabSize": "Indent size",
       "font": "Editor font",
       "fontSize": "Font size",
diff --git a/src/i18n/locales/zh-CN.json b/src/i18n/locales/zh-CN.json
index 052cc042..f2ed1fb4 100644
--- a/src/i18n/locales/zh-CN.json
+++ b/src/i18n/locales/zh-CN.json
@@ -48,6 +48,7 @@
       "spaceDotOmission": "是否显示空格省略",
       "showMinimap": "显示代码缩略图 (minimap)",
       "showStickyScroll": "启用粘性滚动 (sticky scroll)",
+      "wordWrap": "自动换行",
       "tabSize": "缩进空格数",
       "font": "编辑器字体",
       "fontSize": "字体大小",
diff --git a/src/types/app.ts b/src/types/app.ts
index f9da7c2e..25f282c9 100644
--- a/src/types/app.ts
+++ b/src/types/app.ts
@@ -59,6 +59,7 @@ export interface EditorConfig
     space_dot_omission?: boolean
     show_minimap?: boolean
     show_sticky_scroll?: boolean
+    word_wrap?: boolean
     layout?: LayoutMode
     last_direction?: SplitDirection
     max_open_file_size?: number

From b2b2ecd894b027376b11cf7fd05207110a87b41a Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Fri, 26 Jun 2026 13:00:15 +0800
Subject: [PATCH 13/20] =?UTF-8?q?feat(editor):=20=E8=87=AA=E5=8A=A8?=
 =?UTF-8?q?=E6=8D=A2=E8=A1=8C=E6=94=AF=E6=8C=81=E5=BF=AB=E6=8D=B7=E9=94=AE?=
 =?UTF-8?q?(Alt+Z)=E4=B8=8E=E5=91=BD=E4=BB=A4=E9=9D=A2=E6=9D=BF=E5=88=87?=
 =?UTF-8?q?=E6=8D=A2?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

新增可自定义快捷键 toggleWordWrap(默认 Alt+Z)及命令面板「切换自动换行」，
即时翻转 word_wrap 并随编辑器配置持久化、toast 反馈。
---
 src/App.vue                     | 15 +++++++++++++--
 src/composables/useShortcuts.ts |  3 ++-
 src/i18n/locales/en.json        |  6 +++++-
 src/i18n/locales/zh-CN.json     |  6 +++++-
 4 files changed, 25 insertions(+), 5 deletions(-)

diff --git a/src/App.vue b/src/App.vue
index 297cbbde..500487d7 100644
--- a/src/App.vue
+++ b/src/App.vue
@@ -480,7 +480,7 @@ import {debounce} from 'lodash-es'
 import {formatDocument, formatSelection, renameSymbol} from 'codemirror-languageserver'
 import {runGotoDefinition, lspSupportsLanguage, triggerCodeActions, applyCodeAction, formatDocumentAsync} from './editor/lspExtension'
 import {dapSupportsLanguage} from './debug/dapClient'
-import {ChevronRight, Code2, CornerDownRight, Eye, FolderOpen, GitBranch, GitCompare, History, ListChecks, ListTree, Maximize2, Monitor, Moon, PanelBottom, PanelLeft, PanelRight, Play, Plus, Save, Search, Settings as SettingsIcon, Sparkles, Sun, Terminal as TerminalIcon, X} from 'lucide-vue-next'
+import {ChevronRight, Code2, CornerDownRight, Eye, FolderOpen, GitBranch, GitCompare, History, ListChecks, ListTree, Maximize2, Monitor, Moon, PanelBottom, PanelLeft, PanelRight, Play, Plus, Save, Search, Settings as SettingsIcon, Sparkles, Sun, Terminal as TerminalIcon, WrapText, X} from 'lucide-vue-next'
 import {ExecutionResult, LayoutMode, SplitDirection} from './types/app.ts'
 import AppHeader from './components/AppHeader.vue'
 import CodeEditor from './components/CodeEditor.vue'
@@ -2204,7 +2204,17 @@ const shortcutDispatch: Record<string, () => void> = {
   newTab: () => handleNewTab(),
   closeTab: () => handleCloseTab(activeTabId.value),
   toggleSidebar: () => toggleSidebar(),
-  toggleTerminal: () => toggleTerminal()
+  toggleTerminal: () => toggleTerminal(),
+  toggleWordWrap: () => toggleWordWrap()
+}
+
+// 切换自动换行（即时生效并随编辑器配置持久化）
+const toggleWordWrap = () => {
+  if (!editorConfig.value) {
+    return
+  }
+  editorConfig.value.word_wrap = !editorConfig.value.word_wrap
+  toast.info(editorConfig.value.word_wrap ? t('app.wordWrapOn') : t('app.wordWrapOff'))
 }
 
 // 切换并持久化外观主题
@@ -2255,6 +2265,7 @@ const paletteCommands = computed<PaletteCommand[]>(() => [
   {id: 'startDebug', label: t('command.startDebug'), icon: Play, run: () => startDebug()},
   {id: 'sendToTerminal', label: t('command.sendToTerminal'), icon: TerminalIcon, run: () => sendToTerminal()},
   {id: 'toggleSidebar', label: t('command.toggleSidebar'), icon: PanelLeft, hint: hintOf('toggleSidebar'), run: () => toggleSidebar()},
+  {id: 'toggleWordWrap', label: t('command.toggleWordWrap'), icon: WrapText, hint: hintOf('toggleWordWrap'), run: () => toggleWordWrap()},
   {id: 'layoutHorizontal', label: t('command.layoutHorizontal'), group: t('command.groupLayout'), icon: PanelRight, run: () => handleLayoutChange('horizontal')},
   {id: 'layoutVertical', label: t('command.layoutVertical'), group: t('command.groupLayout'), icon: PanelBottom, run: () => handleLayoutChange('vertical')},
   {id: 'layoutEditor', label: t('command.layoutEditor'), group: t('command.groupLayout'), icon: Maximize2, run: () => handleLayoutChange('editor')},
diff --git a/src/composables/useShortcuts.ts b/src/composables/useShortcuts.ts
index 5fc2a1fd..9f0aa9db 100644
--- a/src/composables/useShortcuts.ts
+++ b/src/composables/useShortcuts.ts
@@ -26,7 +26,8 @@ const SHORTCUT_DEFS: { id: string; default: string }[] = [
     {id: 'newTab', default: 'Mod+N'},
     {id: 'closeTab', default: 'Mod+W'},
     {id: 'toggleSidebar', default: 'Mod+B'},
-    {id: 'toggleTerminal', default: 'Mod+`'}
+    {id: 'toggleTerminal', default: 'Mod+`'},
+    {id: 'toggleWordWrap', default: 'Alt+Z'}
 ]
 
 const STORAGE_KEY = 'shortcuts'
diff --git a/src/i18n/locales/en.json b/src/i18n/locales/en.json
index 91ff731e..d3ff430d 100644
--- a/src/i18n/locales/en.json
+++ b/src/i18n/locales/en.json
@@ -686,6 +686,7 @@
     "startDebug": "Debug current file",
     "sendToTerminal": "Send selection to terminal",
     "toggleSidebar": "Toggle sidebar",
+    "toggleWordWrap": "Toggle word wrap",
     "layoutHorizontal": "Layout: side-by-side",
     "layoutVertical": "Layout: top-bottom",
     "layoutEditor": "Layout: editor only",
@@ -711,7 +712,8 @@
     "newTab": "New tab",
     "closeTab": "Close tab",
     "toggleSidebar": "Toggle sidebar",
-    "toggleTerminal": "Toggle terminal"
+    "toggleTerminal": "Toggle terminal",
+    "toggleWordWrap": "Toggle word wrap"
   },
   "view": {
     "clear": "Clear",
@@ -1299,6 +1301,8 @@
     "formatFailed": "Format failed: ",
     "formatOnSaveOn": "Format on save enabled",
     "formatOnSaveOff": "Format on save disabled",
+    "wordWrapOn": "Word wrap enabled",
+    "wordWrapOff": "Word wrap disabled",
     "aiPredictOff": "AI code prediction disabled",
     "aiPredictOnNoKey": "AI code prediction enabled, but no API Key is configured. Fill it in \"Settings → AI\"",
     "aiPredictOn": "AI code prediction enabled; pause typing to see the gray completion, press Tab to accept",
diff --git a/src/i18n/locales/zh-CN.json b/src/i18n/locales/zh-CN.json
index f2ed1fb4..28bd56a5 100644
--- a/src/i18n/locales/zh-CN.json
+++ b/src/i18n/locales/zh-CN.json
@@ -686,6 +686,7 @@
     "startDebug": "开始调试当前文件",
     "sendToTerminal": "发送选区到终端",
     "toggleSidebar": "切换侧栏",
+    "toggleWordWrap": "切换自动换行",
     "layoutHorizontal": "布局：左右",
     "layoutVertical": "布局：上下",
     "layoutEditor": "布局：仅编辑器",
@@ -711,7 +712,8 @@
     "newTab": "新建标签",
     "closeTab": "关闭标签",
     "toggleSidebar": "切换侧栏",
-    "toggleTerminal": "切换终端"
+    "toggleTerminal": "切换终端",
+    "toggleWordWrap": "切换自动换行"
   },
   "view": {
     "clear": "清空",
@@ -1299,6 +1301,8 @@
     "formatFailed": "格式化失败: ",
     "formatOnSaveOn": "已开启保存时格式化",
     "formatOnSaveOff": "已关闭保存时格式化",
+    "wordWrapOn": "已开启自动换行",
+    "wordWrapOff": "已关闭自动换行",
     "aiPredictOff": "AI 代码预测已关闭",
     "aiPredictOnNoKey": "AI 代码预测已开启，但尚未配置 API Key，请在「设置 → AI」中填写",
     "aiPredictOn": "AI 代码预测已开启，停顿打字即可看到灰色补全，Tab 接受",

From 9854d5f46db9cce2d7ad609d9e5ae3c0b4ec099a Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Fri, 26 Jun 2026 13:05:58 +0800
Subject: [PATCH 14/20] =?UTF-8?q?feat(tabs):=20=E6=94=AF=E6=8C=81=E9=87=8D?=
 =?UTF-8?q?=E6=96=B0=E6=89=93=E5=BC=80=E5=B7=B2=E5=85=B3=E9=97=AD=E6=A0=87?=
 =?UTF-8?q?=E7=AD=BE=20(Mod+Shift+T)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

关闭标签时记录快照栈（含未保存内容），可经快捷键/命令面板恢复最近关闭的标签；
关闭其它/关闭右侧也纳入记录；若文件已在其它标签打开则直接切过去。
---
 src/App.vue                     |  9 +++++++
 src/composables/useShortcuts.ts |  1 +
 src/composables/useWorkspace.ts | 44 +++++++++++++++++++++++++++++++++
 src/i18n/locales/en.json        |  3 +++
 src/i18n/locales/zh-CN.json     |  3 +++
 5 files changed, 60 insertions(+)

diff --git a/src/App.vue b/src/App.vue
index 500487d7..2ca2488c 100644
--- a/src/App.vue
+++ b/src/App.vue
@@ -619,6 +619,7 @@ const {
   closeTab,
   closeOthers,
   closeToRight,
+  reopenClosed,
   moveTab,
   updateTabPath,
   detachTabPath,
@@ -671,6 +672,12 @@ const onLanguageChange = (language: string) => {
 
 const handleNewTab = () => newTab({language: currentLanguage.value, code: ''})
 const handleCloseTab = (id: string) => closeTab(id, {language: currentLanguage.value})
+const handleReopenClosed = () => {
+  const reopened = reopenClosed()
+  if (!reopened) {
+    toast.info(t('app.noClosedTab'))
+  }
+}
 
 const handleCopyPath = async (path: string) => {
   try {
@@ -2203,6 +2210,7 @@ const shortcutDispatch: Record<string, () => void> = {
   open: () => handleOpenFileClick(),
   newTab: () => handleNewTab(),
   closeTab: () => handleCloseTab(activeTabId.value),
+  reopenClosed: () => handleReopenClosed(),
   toggleSidebar: () => toggleSidebar(),
   toggleTerminal: () => toggleTerminal(),
   toggleWordWrap: () => toggleWordWrap()
@@ -2244,6 +2252,7 @@ const paletteCommands = computed<PaletteCommand[]>(() => [
   {id: 'saveAs', label: t('command.saveAs'), icon: Save, hint: hintOf('saveAs'), run: () => saveFileAs()},
   {id: 'newTab', label: t('command.newTab'), icon: Plus, hint: hintOf('newTab'), run: () => handleNewTab()},
   {id: 'closeTab', label: t('command.closeTab'), icon: X, hint: hintOf('closeTab'), run: () => handleCloseTab(activeTabId.value)},
+  {id: 'reopenClosed', label: t('command.reopenClosed'), icon: Plus, hint: hintOf('reopenClosed'), run: () => handleReopenClosed()},
   {id: 'quickOpen', label: t('command.quickOpen'), icon: Search, hint: hintOf('quickOpen'), run: () => openQuickOpen()},
   {id: 'gotoLine', label: t('command.gotoLine'), icon: CornerDownRight, hint: hintOf('gotoLine'), run: () => openGoToLine()},
   {id: 'outline', label: t('command.outline'), icon: ListTree, hint: hintOf('outline'), run: () => openOutline()},
diff --git a/src/composables/useShortcuts.ts b/src/composables/useShortcuts.ts
index 9f0aa9db..c8b6a2cf 100644
--- a/src/composables/useShortcuts.ts
+++ b/src/composables/useShortcuts.ts
@@ -25,6 +25,7 @@ const SHORTCUT_DEFS: { id: string; default: string }[] = [
     {id: 'generate', default: 'Mod+K'},
     {id: 'newTab', default: 'Mod+N'},
     {id: 'closeTab', default: 'Mod+W'},
+    {id: 'reopenClosed', default: 'Mod+Shift+T'},
     {id: 'toggleSidebar', default: 'Mod+B'},
     {id: 'toggleTerminal', default: 'Mod+`'},
     {id: 'toggleWordWrap', default: 'Alt+Z'}
diff --git a/src/composables/useWorkspace.ts b/src/composables/useWorkspace.ts
index 54e07be7..1b292ed4 100644
--- a/src/composables/useWorkspace.ts
+++ b/src/composables/useWorkspace.ts
@@ -36,6 +36,20 @@ export function useWorkspace(deps: WorkspaceDeps)
     // 还原 tab 期间抑制同步 watch，避免把中间状态写错 tab
     let isRestoring = false
 
+    // 最近关闭的标签快照栈，供「重新打开已关闭标签」恢复
+    const closedStack = ref<WorkspaceTab[]>([])
+    const CLOSED_LIMIT = 20
+    const pushClosed = (t: WorkspaceTab) => {
+        // 空白草稿（无文件且无内容）不值得记录
+        if (t.filePath === null && (t.code ?? '') === '') {
+            return
+        }
+        closedStack.value.push({...t})
+        if (closedStack.value.length > CLOSED_LIMIT) {
+            closedStack.value.shift()
+        }
+    }
+
     const activeTab = computed(() => tabs.value.find(t => t.id === activeTabId.value) || null)
 
     const captureToActive = () => {
@@ -112,6 +126,11 @@ export function useWorkspace(deps: WorkspaceDeps)
             return
         }
         const wasActive = id === activeTabId.value
+        // 关闭前先把活动标签的实时内容落盘到快照，保证恢复的是最新内容
+        if (wasActive) {
+            captureToActive()
+        }
+        pushClosed(tabs.value[idx])
         tabs.value.splice(idx, 1)
 
         // 至少保留一个 tab
@@ -143,6 +162,11 @@ export function useWorkspace(deps: WorkspaceDeps)
         if (!keep) {
             return
         }
+        for (const t of tabs.value) {
+            if (t.id !== id) {
+                pushClosed(t)
+            }
+        }
         tabs.value = [keep]
         if (activeTabId.value !== id) {
             activeTabId.value = id
@@ -158,6 +182,9 @@ export function useWorkspace(deps: WorkspaceDeps)
         }
         captureToActive()
         const activeRemoved = tabs.value.slice(idx + 1).some(t => t.id === activeTabId.value)
+        for (const t of tabs.value.slice(idx + 1)) {
+            pushClosed(t)
+        }
         tabs.value = tabs.value.slice(0, idx + 1)
         if (activeRemoved) {
             activeTabId.value = id
@@ -219,6 +246,22 @@ export function useWorkspace(deps: WorkspaceDeps)
         }
     }
 
+    // 重新打开最近关闭的标签；若该文件已在其它标签打开则直接切过去
+    const reopenClosed = () => {
+        const t = closedStack.value.pop()
+        if (!t) {
+            return null
+        }
+        if (t.filePath) {
+            const existing = tabs.value.find(x => x.filePath === t.filePath)
+            if (existing) {
+                switchTab(existing.id)
+                return existing
+            }
+        }
+        return newTab({language: t.language, code: t.code, filePath: t.filePath, savedContent: t.savedContent})
+    }
+
     // 当前 tab 是否为可复用的空白草稿（未关联文件且内容为空）
     const isActiveReusableScratch = () => {
         const t = activeTab.value
@@ -235,6 +278,7 @@ export function useWorkspace(deps: WorkspaceDeps)
         closeTab,
         closeOthers,
         closeToRight,
+        reopenClosed,
         moveTab,
         updateTabPath,
         detachTabPath,
diff --git a/src/i18n/locales/en.json b/src/i18n/locales/en.json
index d3ff430d..cb2138b5 100644
--- a/src/i18n/locales/en.json
+++ b/src/i18n/locales/en.json
@@ -685,6 +685,7 @@
     "runTests": "Run tests (auto-detect)",
     "startDebug": "Debug current file",
     "sendToTerminal": "Send selection to terminal",
+    "reopenClosed": "Reopen closed tab",
     "toggleSidebar": "Toggle sidebar",
     "toggleWordWrap": "Toggle word wrap",
     "layoutHorizontal": "Layout: side-by-side",
@@ -711,6 +712,7 @@
     "generate": "AI generate code",
     "newTab": "New tab",
     "closeTab": "Close tab",
+    "reopenClosed": "Reopen closed tab",
     "toggleSidebar": "Toggle sidebar",
     "toggleTerminal": "Toggle terminal",
     "toggleWordWrap": "Toggle word wrap"
@@ -1303,6 +1305,7 @@
     "formatOnSaveOff": "Format on save disabled",
     "wordWrapOn": "Word wrap enabled",
     "wordWrapOff": "Word wrap disabled",
+    "noClosedTab": "No closed tab to reopen",
     "aiPredictOff": "AI code prediction disabled",
     "aiPredictOnNoKey": "AI code prediction enabled, but no API Key is configured. Fill it in \"Settings → AI\"",
     "aiPredictOn": "AI code prediction enabled; pause typing to see the gray completion, press Tab to accept",
diff --git a/src/i18n/locales/zh-CN.json b/src/i18n/locales/zh-CN.json
index 28bd56a5..b071d449 100644
--- a/src/i18n/locales/zh-CN.json
+++ b/src/i18n/locales/zh-CN.json
@@ -685,6 +685,7 @@
     "runTests": "运行测试（自动识别）",
     "startDebug": "开始调试当前文件",
     "sendToTerminal": "发送选区到终端",
+    "reopenClosed": "重新打开已关闭标签",
     "toggleSidebar": "切换侧栏",
     "toggleWordWrap": "切换自动换行",
     "layoutHorizontal": "布局：左右",
@@ -711,6 +712,7 @@
     "generate": "AI 生成代码",
     "newTab": "新建标签",
     "closeTab": "关闭标签",
+    "reopenClosed": "重新打开已关闭标签",
     "toggleSidebar": "切换侧栏",
     "toggleTerminal": "切换终端",
     "toggleWordWrap": "切换自动换行"
@@ -1303,6 +1305,7 @@
     "formatOnSaveOff": "已关闭保存时格式化",
     "wordWrapOn": "已开启自动换行",
     "wordWrapOff": "已关闭自动换行",
+    "noClosedTab": "没有可重新打开的标签",
     "aiPredictOff": "AI 代码预测已关闭",
     "aiPredictOnNoKey": "AI 代码预测已开启，但尚未配置 API Key，请在「设置 → AI」中填写",
     "aiPredictOn": "AI 代码预测已开启，停顿打字即可看到灰色补全，Tab 接受",

From df7d1287de2c113ddf7b03bc595060289cc85aa8 Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Fri, 26 Jun 2026 13:11:23 +0800
Subject: [PATCH 15/20] =?UTF-8?q?feat(sidebar):=20=E5=9C=A8=E6=96=87?=
 =?UTF-8?q?=E4=BB=B6=E6=A0=91=E4=B8=AD=E5=AE=9A=E4=BD=8D=E5=BD=93=E5=89=8D?=
 =?UTF-8?q?=E6=96=87=E4=BB=B6=20(Reveal=20in=20Explorer)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

命令面板「在文件树中定位」展开当前文件的祖先目录并滚动到该文件；
基于已知祖先目录集合，懒加载的子节点在挂载时自查并继续展开，适配深层路径与多根。
---
 src/App.vue                     | 14 +++++++++
 src/components/FileTreeNode.vue | 33 +++++++++++++++++++--
 src/components/Sidebar.vue      | 52 +++++++++++++++++++++++++++++++++
 src/i18n/locales/en.json        |  2 ++
 src/i18n/locales/zh-CN.json     |  2 ++
 5 files changed, 101 insertions(+), 2 deletions(-)

diff --git a/src/App.vue b/src/App.vue
index 2ca2488c..14b762d5 100644
--- a/src/App.vue
+++ b/src/App.vue
@@ -54,6 +54,7 @@
       <template v-if="sidebarVisible">
         <Sidebar :root-dir="rootDir"
                  :extra-roots="extraRoots"
+                 :reveal-request="revealRequest"
                  :active-path="currentFilePath"
                  :recent-folders="recentFolders"
                  :git-status="gitStatus"
@@ -1179,6 +1180,18 @@ const openOutline = () => {
   showOutline.value = true
 }
 
+// 在文件树中定位当前文件
+const revealRequest = ref<{ path: string, n: number } | null>(null)
+let revealSeq = 0
+const revealInTree = () => {
+  if (!currentFilePath.value) {
+    toast.info(t('app.noFileToReveal'))
+    return
+  }
+  sidebarVisible.value = true
+  revealRequest.value = {path: currentFilePath.value, n: ++revealSeq}
+}
+
 // 代码片段管理
 const showSnippets = ref(false)
 
@@ -2273,6 +2286,7 @@ const paletteCommands = computed<PaletteCommand[]>(() => [
   {id: 'runTests', label: t('command.runTests'), icon: ListChecks, run: () => runTests()},
   {id: 'startDebug', label: t('command.startDebug'), icon: Play, run: () => startDebug()},
   {id: 'sendToTerminal', label: t('command.sendToTerminal'), icon: TerminalIcon, run: () => sendToTerminal()},
+  {id: 'revealInTree', label: t('command.revealInTree'), icon: FolderOpen, run: () => revealInTree()},
   {id: 'toggleSidebar', label: t('command.toggleSidebar'), icon: PanelLeft, hint: hintOf('toggleSidebar'), run: () => toggleSidebar()},
   {id: 'toggleWordWrap', label: t('command.toggleWordWrap'), icon: WrapText, hint: hintOf('toggleWordWrap'), run: () => toggleWordWrap()},
   {id: 'layoutHorizontal', label: t('command.layoutHorizontal'), group: t('command.groupLayout'), icon: PanelRight, run: () => handleLayoutChange('horizontal')},
diff --git a/src/components/FileTreeNode.vue b/src/components/FileTreeNode.vue
index 22100eaa..09fe41ce 100644
--- a/src/components/FileTreeNode.vue
+++ b/src/components/FileTreeNode.vue
@@ -1,6 +1,7 @@
 <template>
   <div>
-    <div class="flex items-center py-1 pr-4 cursor-pointer text-sm select-none w-full whitespace-nowrap"
+    <div ref="rowEl"
+         class="flex items-center py-1 pr-4 cursor-pointer text-sm select-none w-full whitespace-nowrap"
          :class="isActive ? 'bg-blue-100 dark:bg-blue-900/40 text-blue-700 dark:text-blue-300' : 'text-gray-700 dark:text-gray-300 hover:bg-gray-100 dark:hover:bg-gray-700'"
          :style="{ paddingLeft: `${depth * 12 + 8}px` }"
          @click="onClick"
@@ -25,7 +26,7 @@
 </template>
 
 <script setup lang="ts">
-import {computed, inject, ref, watch, type ComputedRef, type Ref} from 'vue'
+import {computed, inject, nextTick, onMounted, ref, watch, type ComputedRef, type Ref} from 'vue'
 import {invoke} from '@tauri-apps/api/core'
 import {ChevronRight, File, Folder, FolderOpen} from 'lucide-vue-next'
 
@@ -44,6 +45,7 @@ const props = defineProps<{
 const expanded = ref(false)
 const children = ref<FileNode[]>([])
 const loaded = ref(false)
+const rowEl = ref<HTMLElement | null>(null)
 
 // 由 Sidebar 提供的注入项
 const openFile = inject<(path: string) => void>('treeOpenFile')
@@ -52,6 +54,9 @@ const contextMenu = inject<(node: FileNode, e: MouseEvent) => void>('treeContext
 const refreshSignal = inject<Ref<number>>('treeRefresh')
 const collapseSignal = inject<Ref<number>>('treeCollapseAll')
 const gitStatus = inject<ComputedRef<Record<string, string>>>('treeGitStatus')
+// 「在文件树中定位」：需展开的祖先目录集合 + 目标文件
+const revealDirs = inject<Ref<Set<string>>>('treeRevealDirs')
+const revealLeaf = inject<Ref<string | null>>('treeRevealLeaf')
 
 const isActive = computed(() => !props.node.is_dir && activePath?.value === props.node.path)
 
@@ -110,4 +115,28 @@ if (collapseSignal) {
     }
   })
 }
+
+// 「在文件树中定位」：祖先目录自动展开、目标文件滚动到视野。
+// 借助已知的祖先集合，新挂载的子节点会在自身 onMounted 时自查并继续展开，天然适配懒加载树。
+const maybeReveal = async () => {
+  if (props.node.is_dir && revealDirs?.value?.has(props.node.path)) {
+    if (!expanded.value) {
+      expanded.value = true
+      if (!loaded.value) {
+        await loadChildren()
+      }
+    }
+  }
+  if (!props.node.is_dir && revealLeaf?.value === props.node.path) {
+    await nextTick()
+    rowEl.value?.scrollIntoView({block: 'center'})
+  }
+}
+onMounted(maybeReveal)
+if (revealDirs) {
+  watch(revealDirs, maybeReveal)
+}
+if (revealLeaf) {
+  watch(revealLeaf, maybeReveal)
+}
 </script>
diff --git a/src/components/Sidebar.vue b/src/components/Sidebar.vue
index 60c87449..ac746bfe 100644
--- a/src/components/Sidebar.vue
+++ b/src/components/Sidebar.vue
@@ -235,6 +235,7 @@ const props = defineProps<{
   recentFolders?: string[]
   gitStatus?: Record<string, string>
   gitRepo?: boolean
+  revealRequest?: { path: string, n: number } | null
 }>()
 
 const emit = defineEmits<{
@@ -360,6 +361,57 @@ const collapseSignal = ref(0)
 provide('treeCollapseAll', collapseSignal)
 const collapseAllFolders = () => collapseSignal.value++
 
+// ===== 在文件树中定位当前文件（参考 VSCode Reveal in Explorer）=====
+const revealDirs = ref<Set<string>>(new Set())
+const revealLeaf = ref<string | null>(null)
+provide('treeRevealDirs', revealDirs)
+provide('treeRevealLeaf', revealLeaf)
+let revealTimer: ReturnType<typeof setTimeout> | null = null
+const revealInTree = (path: string) => {
+  const roots = [props.rootDir, ...(props.extraRoots || [])].filter(Boolean) as string[]
+  // 取最长匹配，定位文件归属的根
+  const root = roots
+      .filter(r => path === r || path.startsWith(r + '/') || path.startsWith(r + '\\'))
+      .sort((a, b) => b.length - a.length)[0]
+  if (!root) {
+    return
+  }
+  // 确保归属根所在分区已展开
+  if (root === props.rootDir) {
+    primaryCollapsed.value = false
+  }
+  else {
+    extraCollapsed[root] = false
+  }
+  // 收集 root 与 path 之间的所有祖先目录
+  const dirs = new Set<string>()
+  let cur = path
+  while (true) {
+    const parent = cur.replace(/[\\/][^\\/]*$/, '')
+    if (parent === cur || parent.length <= root.length) {
+      break
+    }
+    dirs.add(parent)
+    cur = parent
+  }
+  revealDirs.value = dirs
+  revealLeaf.value = path
+  // 定位完成后清除，避免后续无关重挂载再次触发滚动
+  if (revealTimer) {
+    clearTimeout(revealTimer)
+  }
+  revealTimer = setTimeout(() => {
+    revealDirs.value = new Set()
+    revealLeaf.value = null
+  }, 1500)
+}
+
+watch(() => props.revealRequest, (req) => {
+  if (req?.path) {
+    revealInTree(req.path)
+  }
+})
+
 // 文件系统变化（外部改动）防抖刷新
 let fsTimer: any = null
 let unlistenFs: UnlistenFn | null = null
diff --git a/src/i18n/locales/en.json b/src/i18n/locales/en.json
index cb2138b5..ea387571 100644
--- a/src/i18n/locales/en.json
+++ b/src/i18n/locales/en.json
@@ -686,6 +686,7 @@
     "startDebug": "Debug current file",
     "sendToTerminal": "Send selection to terminal",
     "reopenClosed": "Reopen closed tab",
+    "revealInTree": "Reveal in file tree",
     "toggleSidebar": "Toggle sidebar",
     "toggleWordWrap": "Toggle word wrap",
     "layoutHorizontal": "Layout: side-by-side",
@@ -1306,6 +1307,7 @@
     "wordWrapOn": "Word wrap enabled",
     "wordWrapOff": "Word wrap disabled",
     "noClosedTab": "No closed tab to reopen",
+    "noFileToReveal": "No file to reveal",
     "aiPredictOff": "AI code prediction disabled",
     "aiPredictOnNoKey": "AI code prediction enabled, but no API Key is configured. Fill it in \"Settings → AI\"",
     "aiPredictOn": "AI code prediction enabled; pause typing to see the gray completion, press Tab to accept",
diff --git a/src/i18n/locales/zh-CN.json b/src/i18n/locales/zh-CN.json
index b071d449..3dca1e25 100644
--- a/src/i18n/locales/zh-CN.json
+++ b/src/i18n/locales/zh-CN.json
@@ -686,6 +686,7 @@
     "startDebug": "开始调试当前文件",
     "sendToTerminal": "发送选区到终端",
     "reopenClosed": "重新打开已关闭标签",
+    "revealInTree": "在文件树中定位",
     "toggleSidebar": "切换侧栏",
     "toggleWordWrap": "切换自动换行",
     "layoutHorizontal": "布局：左右",
@@ -1306,6 +1307,7 @@
     "wordWrapOn": "已开启自动换行",
     "wordWrapOff": "已关闭自动换行",
     "noClosedTab": "没有可重新打开的标签",
+    "noFileToReveal": "当前没有可定位的文件",
     "aiPredictOff": "AI 代码预测已关闭",
     "aiPredictOnNoKey": "AI 代码预测已开启，但尚未配置 API Key，请在「设置 → AI」中填写",
     "aiPredictOn": "AI 代码预测已开启，停顿打字即可看到灰色补全，Tab 接受",

From a55b9094ba218278ed1eb77f351210feb0d66a09 Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Fri, 26 Jun 2026 13:14:06 +0800
Subject: [PATCH 16/20] =?UTF-8?q?feat(tabs):=20=E6=A0=87=E7=AD=BE=E5=8F=B3?=
 =?UTF-8?q?=E9=94=AE=E8=A1=A5=E5=85=85=E3=80=8C=E5=9C=A8=E6=96=87=E4=BB=B6?=
 =?UTF-8?q?=E6=A0=91=E4=B8=AD=E5=AE=9A=E4=BD=8D/=E5=9C=A8=E6=96=87?=
 =?UTF-8?q?=E4=BB=B6=E7=AE=A1=E7=90=86=E5=99=A8=E6=98=BE=E7=A4=BA/?=
 =?UTF-8?q?=E5=A4=8D=E5=88=B6=E7=9B=B8=E5=AF=B9=E8=B7=AF=E5=BE=84=E3=80=8D?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

标签右键菜单新增三项：定位到文件树、在系统文件管理器显示、复制相对工作区根的路径；
复用已有 Reveal in Tree 与 reveal_path 能力，对指定标签而非仅当前文件生效。
---
 src/App.vue                   | 20 +++++++++++++++-----
 src/components/EditorTabs.vue |  6 ++++++
 src/i18n/locales/en.json      |  3 +++
 src/i18n/locales/zh-CN.json   |  3 +++
 4 files changed, 27 insertions(+), 5 deletions(-)

diff --git a/src/App.vue b/src/App.vue
index 14b762d5..cf18cfd5 100644
--- a/src/App.vue
+++ b/src/App.vue
@@ -82,7 +82,8 @@
           <template #primary>
             <div class="h-full flex flex-col overflow-hidden">
               <EditorTabs :tabs="editorTabs" :active-id="activeTabId" @switch="switchTab" @close="handleCloseTab" @new="handleNewTab"
-                          @close-others="closeOthers" @close-right="closeToRight" @move="moveTab" @copy-path="handleCopyPath"/>
+                          @close-others="closeOthers" @close-right="closeToRight" @move="moveTab" @copy-path="handleCopyPath"
+                          @copy-relative="handleCopyRelativePath" @reveal-tree="revealInTree" @reveal-finder="revealInFinder"/>
               <div v-if="!showViewer" class="bg-gray-100 dark:bg-gray-800 px-4 py-2 border-b border-gray-200 dark:border-gray-700 flex items-center justify-between flex-shrink-0">
                 <div class="flex items-center space-x-3 min-w-0 flex-1 overflow-x-auto [&::-webkit-scrollbar]:hidden [-ms-overflow-style:none] [scrollbar-width:none]">
                   <img :src="`/icons/${currentLanguage.replace(/\d+$/, '')}.svg`" class="w-5 h-5 flex-shrink-0" :alt="currentLanguage" @error="onIconError"/>
@@ -222,7 +223,8 @@
       <!-- 仅编辑器：控制台未展开时占满 -->
       <div v-else class="h-full flex flex-col overflow-hidden">
         <EditorTabs :tabs="editorTabs" :active-id="activeTabId" @switch="switchTab" @close="handleCloseTab" @new="handleNewTab"
-                          @close-others="closeOthers" @close-right="closeToRight" @move="moveTab" @copy-path="handleCopyPath"/>
+                          @close-others="closeOthers" @close-right="closeToRight" @move="moveTab" @copy-path="handleCopyPath"
+                          @copy-relative="handleCopyRelativePath" @reveal-tree="revealInTree" @reveal-finder="revealInFinder"/>
         <div v-if="!showViewer" class="bg-gray-100 dark:bg-gray-800 px-4 py-2 border-b border-gray-200 dark:border-gray-700 flex items-center justify-between flex-shrink-0">
           <div class="flex items-center space-x-3 min-w-0 flex-1">
             <img :src="`/icons/${currentLanguage.replace(/\d+$/, '')}.svg`" class="w-5 h-5 flex-shrink-0" :alt="currentLanguage" @error="onIconError"/>
@@ -689,6 +691,13 @@ const handleCopyPath = async (path: string) => {
     toast.error(t('app.copyFailed') + error)
   }
 }
+const handleCopyRelativePath = (path: string) => {
+  const root = rootDir.value
+  const rel = root && (path === root || path.startsWith(root + '/') || path.startsWith(root + '\\'))
+      ? path.slice(root.length).replace(/^[\\/]/, '')
+      : path
+  handleCopyPath(rel)
+}
 
 // ===== 侧栏 / 文件夹 =====
 const rootDir = ref<string | null>(null)
@@ -1183,13 +1192,14 @@ const openOutline = () => {
 // 在文件树中定位当前文件
 const revealRequest = ref<{ path: string, n: number } | null>(null)
 let revealSeq = 0
-const revealInTree = () => {
-  if (!currentFilePath.value) {
+const revealInTree = (path?: string) => {
+  const target = path ?? currentFilePath.value
+  if (!target) {
     toast.info(t('app.noFileToReveal'))
     return
   }
   sidebarVisible.value = true
-  revealRequest.value = {path: currentFilePath.value, n: ++revealSeq}
+  revealRequest.value = {path: target, n: ++revealSeq}
 }
 
 // 代码片段管理
diff --git a/src/components/EditorTabs.vue b/src/components/EditorTabs.vue
index d10a8f6e..488501cf 100644
--- a/src/components/EditorTabs.vue
+++ b/src/components/EditorTabs.vue
@@ -46,7 +46,10 @@
       <button class="w-full text-left px-3 py-1.5 hover:bg-gray-100 dark:hover:bg-gray-700 cursor-pointer" @click="act(() => emit('close-right', menu.tabId!))">{{ t('tabs.closeRight') }}</button>
       <template v-if="menuTabPath">
         <div class="border-t border-gray-100 dark:border-gray-700 my-1"></div>
+        <button class="w-full text-left px-3 py-1.5 hover:bg-gray-100 dark:hover:bg-gray-700 cursor-pointer" @click="act(() => emit('reveal-tree', menuTabPath!))">{{ t('tabs.revealInTree') }}</button>
+        <button class="w-full text-left px-3 py-1.5 hover:bg-gray-100 dark:hover:bg-gray-700 cursor-pointer" @click="act(() => emit('reveal-finder', menuTabPath!))">{{ t('tabs.revealInFinder') }}</button>
         <button class="w-full text-left px-3 py-1.5 hover:bg-gray-100 dark:hover:bg-gray-700 cursor-pointer" @click="act(() => emit('copy-path', menuTabPath!))">{{ t('tabs.copyPath') }}</button>
+        <button class="w-full text-left px-3 py-1.5 hover:bg-gray-100 dark:hover:bg-gray-700 cursor-pointer" @click="act(() => emit('copy-relative', menuTabPath!))">{{ t('tabs.copyRelativePath') }}</button>
       </template>
     </div>
   </div>
@@ -72,6 +75,9 @@ const emit = defineEmits<{
   'close-others': [id: string]
   'close-right': [id: string]
   'copy-path': [path: string]
+  'copy-relative': [path: string]
+  'reveal-tree': [path: string]
+  'reveal-finder': [path: string]
   move: [fromId: string, toId: string]
 }>()
 
diff --git a/src/i18n/locales/en.json b/src/i18n/locales/en.json
index ea387571..ec41eead 100644
--- a/src/i18n/locales/en.json
+++ b/src/i18n/locales/en.json
@@ -647,7 +647,10 @@
     "newTab": "New tab",
     "closeOthers": "Close others",
     "closeRight": "Close to the right",
+    "revealInTree": "Reveal in file tree",
+    "revealInFinder": "Reveal in file manager",
     "copyPath": "Copy path",
+    "copyRelativePath": "Copy relative path",
     "untitled": "Untitled"
   },
   "command": {
diff --git a/src/i18n/locales/zh-CN.json b/src/i18n/locales/zh-CN.json
index 3dca1e25..8a2a05c9 100644
--- a/src/i18n/locales/zh-CN.json
+++ b/src/i18n/locales/zh-CN.json
@@ -647,7 +647,10 @@
     "newTab": "新建标签页",
     "closeOthers": "关闭其他",
     "closeRight": "关闭右侧",
+    "revealInTree": "在文件树中定位",
+    "revealInFinder": "在文件管理器中显示",
     "copyPath": "复制路径",
+    "copyRelativePath": "复制相对路径",
     "untitled": "未命名"
   },
   "command": {

From 015e713b5ce6e22e601dc21638614fa0f3c2b32e Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Fri, 26 Jun 2026 13:17:46 +0800
Subject: [PATCH 17/20] =?UTF-8?q?feat(breadcrumb):=20=E9=9D=A2=E5=8C=85?=
 =?UTF-8?q?=E5=B1=91=E5=88=86=E6=AE=B5=E7=82=B9=E5=87=BB=E5=B1=95=E5=BC=80?=
 =?UTF-8?q?=E7=9B=AE=E5=BD=95=E4=B8=8B=E6=8B=89=EF=BC=8C=E5=BF=AB=E9=80=9F?=
 =?UTF-8?q?=E5=88=87=E6=8D=A2=E5=90=8C=E7=BA=A7=E6=96=87=E4=BB=B6/?=
 =?UTF-8?q?=E9=92=BB=E5=85=A5=E5=AD=90=E7=9B=AE=E5=BD=95?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

点击面包屑分段弹出该层目录列表（文件段列同级、目录段列自身内容），
点文件直接打开、点目录原地钻入；目录优先排序，点击空白处关闭。
---
 src/App.vue                    |  4 +-
 src/components/Breadcrumbs.vue | 88 +++++++++++++++++++++++++++++++---
 src/i18n/locales/en.json       |  4 +-
 src/i18n/locales/zh-CN.json    |  4 +-
 4 files changed, 90 insertions(+), 10 deletions(-)

diff --git a/src/App.vue b/src/App.vue
index cf18cfd5..022edf22 100644
--- a/src/App.vue
+++ b/src/App.vue
@@ -91,7 +91,7 @@
                   <template v-if="currentFilePath">
                     <span class="text-gray-400 text-xs flex-shrink-0">·</span>
                     <div class="min-w-0 overflow-x-auto [&::-webkit-scrollbar]:hidden [-ms-overflow-style:none] [scrollbar-width:none]">
-                      <Breadcrumbs :path="currentFilePath" :root-dir="rootDir" :dirty="isDirty" @reveal="revealInFinder"/>
+                      <Breadcrumbs :path="currentFilePath" :root-dir="rootDir" :dirty="isDirty" @reveal="revealInFinder" @open="smartOpen"/>
                     </div>
                   </template>
                   <span v-else-if="currentFileName" class="text-xs text-gray-500 flex items-center whitespace-nowrap flex-shrink-0">
@@ -232,7 +232,7 @@
             <template v-if="currentFilePath">
               <span class="text-gray-400 text-xs flex-shrink-0">·</span>
               <div class="min-w-0 overflow-x-auto [&::-webkit-scrollbar]:hidden [-ms-overflow-style:none] [scrollbar-width:none]">
-                <Breadcrumbs :path="currentFilePath" :root-dir="rootDir" :dirty="isDirty" @reveal="revealInFinder"/>
+                <Breadcrumbs :path="currentFilePath" :root-dir="rootDir" :dirty="isDirty" @reveal="revealInFinder" @open="smartOpen"/>
               </div>
             </template>
             <span v-else-if="currentFileName" class="text-xs text-gray-500 flex items-center whitespace-nowrap flex-shrink-0">
diff --git a/src/components/Breadcrumbs.vue b/src/components/Breadcrumbs.vue
index ccc1dd59..b959023e 100644
--- a/src/components/Breadcrumbs.vue
+++ b/src/components/Breadcrumbs.vue
@@ -1,21 +1,44 @@
 <template>
-  <span class="flex items-center text-xs text-gray-500 w-max whitespace-nowrap">
+  <span class="relative flex items-center text-xs text-gray-500 w-max whitespace-nowrap">
     <template v-for="(seg, i) in segments" :key="i">
       <ChevronRight v-if="i > 0" class="w-3 h-3 mx-0.5 text-gray-300 dark:text-gray-600 flex-shrink-0"/>
       <button class="hover:text-blue-500 cursor-pointer flex-shrink-0"
-              :title="t('breadcrumb.revealIn', { path: seg.full })"
-              @click="emit('reveal', seg.full)">
+              :class="{ 'text-blue-500': dropdown.index === i }"
+              :title="seg.full"
+              @click.stop="toggleDropdown(i, seg, $event)">
         {{ seg.name }}
       </button>
     </template>
     <span v-if="dirty" class="ml-1 text-amber-500 flex-shrink-0" :title="t('breadcrumb.unsaved')">●</span>
+
+    <!-- 段落下拉：列出该层目录内容，便于快速切换同级文件/钻入子目录 -->
+    <div v-if="dropdown.index !== null"
+         class="fixed inset-0 z-40"
+         @click="closeDropdown"
+         @contextmenu.prevent="closeDropdown">
+      <div class="absolute bg-white dark:bg-gray-800 dark:text-gray-100 rounded-md shadow-lg border border-gray-200 dark:border-gray-700 py-1 text-sm min-w-[180px] max-h-[50vh] overflow-y-auto"
+           :style="{ top: `${dropdown.y}px`, left: `${dropdown.x}px` }"
+           @click.stop>
+        <div v-if="dropdown.loading" class="px-3 py-2 text-gray-400">{{ t('breadcrumb.loading') }}</div>
+        <div v-else-if="dropdown.entries.length === 0" class="px-3 py-2 text-gray-400">{{ t('breadcrumb.empty') }}</div>
+        <button v-for="e in dropdown.entries"
+                :key="e.path"
+                class="w-full flex items-center gap-1.5 px-3 py-1 text-left hover:bg-gray-100 dark:hover:bg-gray-700 cursor-pointer"
+                :class="{ 'text-blue-600 dark:text-blue-400': e.path === path }"
+                @click="pick(e)">
+          <component :is="e.is_dir ? Folder : File" class="w-3.5 h-3.5 flex-shrink-0" :class="e.is_dir ? 'text-blue-500' : 'text-gray-400'"/>
+          <span class="truncate">{{ e.name }}</span>
+        </button>
+      </div>
+    </div>
   </span>
 </template>
 
 <script setup lang="ts">
-import {computed} from 'vue'
+import {computed, reactive} from 'vue'
+import {invoke} from '@tauri-apps/api/core'
 import {useI18n} from 'vue-i18n'
-import {ChevronRight} from 'lucide-vue-next'
+import {ChevronRight, File, Folder} from 'lucide-vue-next'
 
 const {t} = useI18n()
 
@@ -24,9 +47,10 @@ const props = defineProps<{
   rootDir?: string | null
   dirty?: boolean
 }>()
-const emit = defineEmits<{ reveal: [path: string] }>()
+const emit = defineEmits<{ reveal: [path: string]; open: [path: string] }>()
 
 interface Seg { name: string; full: string }
+interface Entry { name: string; path: string; is_dir: boolean }
 
 const segments = computed<Seg[]>(() => {
   const p = props.path
@@ -55,4 +79,56 @@ const segments = computed<Seg[]>(() => {
   }
   return segs.length > 5 ? segs.slice(-4) : segs
 })
+
+const dirOf = (p: string) => p.replace(/[\\/][^\\/]*$/, '')
+
+const dropdown = reactive<{ index: number | null, x: number, y: number, loading: boolean, entries: Entry[] }>({
+  index: null, x: 0, y: 0, loading: false, entries: []
+})
+
+const isLastSeg = (i: number) => i === segments.value.length - 1
+
+const loadDir = async (dir: string) => {
+  dropdown.loading = true
+  try {
+    const all = await invoke<Entry[]>('read_directory_tree', {path: dir})
+    // 目录在前、各自按名排序
+    dropdown.entries = [...all].sort((a, b) =>
+        a.is_dir === b.is_dir ? a.name.localeCompare(b.name) : (a.is_dir ? -1 : 1))
+  }
+  catch {
+    dropdown.entries = []
+  }
+  finally {
+    dropdown.loading = false
+  }
+}
+
+const toggleDropdown = (i: number, seg: Seg, e: MouseEvent) => {
+  if (dropdown.index === i) {
+    closeDropdown()
+    return
+  }
+  const rect = (e.currentTarget as HTMLElement).getBoundingClientRect()
+  dropdown.x = rect.left
+  dropdown.y = rect.bottom + 2
+  dropdown.index = i
+  // 文件段落列出其同级（父目录内容）；目录段落列出自身内容
+  loadDir(isLastSeg(i) ? dirOf(seg.full) : seg.full)
+}
+
+const closeDropdown = () => {
+  dropdown.index = null
+}
+
+const pick = (e: Entry) => {
+  if (e.is_dir) {
+    // 钻入子目录：保持下拉打开并切换到该目录内容
+    loadDir(e.path)
+  }
+  else {
+    emit('open', e.path)
+    closeDropdown()
+  }
+}
 </script>
diff --git a/src/i18n/locales/en.json b/src/i18n/locales/en.json
index ec41eead..16b6ffcc 100644
--- a/src/i18n/locales/en.json
+++ b/src/i18n/locales/en.json
@@ -1062,7 +1062,9 @@
   },
   "breadcrumb": {
     "revealIn": "Reveal in file manager: {path}",
-    "unsaved": "Unsaved changes"
+    "unsaved": "Unsaved changes",
+    "loading": "Loading…",
+    "empty": "Empty folder"
   },
   "gitignore": {
     "title": ".gitignore templates",
diff --git a/src/i18n/locales/zh-CN.json b/src/i18n/locales/zh-CN.json
index 8a2a05c9..54e0e532 100644
--- a/src/i18n/locales/zh-CN.json
+++ b/src/i18n/locales/zh-CN.json
@@ -1062,7 +1062,9 @@
   },
   "breadcrumb": {
     "revealIn": "在访达中显示：{path}",
-    "unsaved": "有未保存的修改"
+    "unsaved": "有未保存的修改",
+    "loading": "加载中…",
+    "empty": "空目录"
   },
   "gitignore": {
     "title": ".gitignore 模板",

From 1a8b1569e6442ec7289ba99b27fae1cc01010ec5 Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Fri, 26 Jun 2026 13:37:18 +0800
Subject: [PATCH 18/20] =?UTF-8?q?feat(docs):=20=E6=96=87=E6=A1=A3=E7=AB=99?=
 =?UTF-8?q?=E6=94=B9=E7=94=A8=E8=87=AA=E5=BB=BA=20Vite+Vue3+TS=EF=BC=8C?=
 =?UTF-8?q?=E5=BC=83=E7=94=A8=20pageforge=EF=BC=8C=E9=83=A8=E7=BD=B2?=
 =?UTF-8?q?=E8=B5=B0=E5=AE=98=E6=96=B9=20Pages=20Actions?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 自建站壳：Vite + Vue3 + TS + Tailwind，vite-ssg 静态预渲染全部路由
- 发布日志 release/*.md 经 unplugin-vue-markdown 渲染，按文件名自动生成版本路由与侧栏
- 首页/下载页/发布日志均自写布局（顶栏公告条、暗色切换、页脚），自定义设计
- CNAME、logo 迁入 public；删除 pageforge.yaml 及旧首页 md
- docs.yml 改用 configure-pages + upload-pages-artifact + deploy-pages（push 到 main 触发，免 PAT/gh-pages 分支）
---
 .github/workflows/docs.yml               | 61 ++++++++++++++--------
 docs/.gitignore                          |  4 ++
 docs/content/download.md                 | 18 -------
 docs/content/index.md                    | 64 -----------------------
 docs/env.d.ts                            | 15 ++++++
 docs/index.html                          | 15 ++++++
 docs/pageforge.yaml                      | 54 --------------------
 docs/postcss.config.js                   |  6 +++
 docs/{ => public}/CNAME                  |  0
 docs/{assets => public}/logo.svg         |  0
 docs/src/App.vue                         | 20 ++++++++
 docs/src/components/SiteFooter.vue       | 19 +++++++
 docs/src/components/SiteHeader.vue       | 45 ++++++++++++++++
 docs/src/components/ThemeToggle.vue      | 35 +++++++++++++
 docs/{ => src}/content/release/25.0.0.md |  0
 docs/{ => src}/content/release/25.0.1.md |  0
 docs/{ => src}/content/release/25.0.2.md |  0
 docs/{ => src}/content/release/25.0.3.md |  0
 docs/{ => src}/content/release/25.0.4.md |  0
 docs/{ => src}/content/release/25.0.5.md |  0
 docs/{ => src}/content/release/26.0.0.md |  0
 docs/{ => src}/content/release/26.1.0.md |  0
 docs/{ => src}/content/release/26.2.0.md |  0
 docs/src/content/releases.ts             | 37 ++++++++++++++
 docs/src/layouts/DocLayout.vue           | 25 +++++++++
 docs/src/main.ts                         | 17 +++++++
 docs/src/pages/Download.vue              | 35 +++++++++++++
 docs/src/pages/Home.vue                  | 50 ++++++++++++++++++
 docs/src/pages/ReleaseList.vue           | 13 +++++
 docs/src/router.ts                       | 12 +++++
 docs/src/styles/main.css                 | 65 ++++++++++++++++++++++++
 docs/tailwind.config.js                  | 17 +++++++
 docs/vite.config.ts                      | 28 ++++++++++
 33 files changed, 498 insertions(+), 157 deletions(-)
 create mode 100644 docs/.gitignore
 delete mode 100644 docs/content/download.md
 delete mode 100644 docs/content/index.md
 create mode 100644 docs/env.d.ts
 create mode 100644 docs/index.html
 delete mode 100644 docs/pageforge.yaml
 create mode 100644 docs/postcss.config.js
 rename docs/{ => public}/CNAME (100%)
 rename docs/{assets => public}/logo.svg (100%)
 create mode 100644 docs/src/App.vue
 create mode 100644 docs/src/components/SiteFooter.vue
 create mode 100644 docs/src/components/SiteHeader.vue
 create mode 100644 docs/src/components/ThemeToggle.vue
 rename docs/{ => src}/content/release/25.0.0.md (100%)
 rename docs/{ => src}/content/release/25.0.1.md (100%)
 rename docs/{ => src}/content/release/25.0.2.md (100%)
 rename docs/{ => src}/content/release/25.0.3.md (100%)
 rename docs/{ => src}/content/release/25.0.4.md (100%)
 rename docs/{ => src}/content/release/25.0.5.md (100%)
 rename docs/{ => src}/content/release/26.0.0.md (100%)
 rename docs/{ => src}/content/release/26.1.0.md (100%)
 rename docs/{ => src}/content/release/26.2.0.md (100%)
 create mode 100644 docs/src/content/releases.ts
 create mode 100644 docs/src/layouts/DocLayout.vue
 create mode 100644 docs/src/main.ts
 create mode 100644 docs/src/pages/Download.vue
 create mode 100644 docs/src/pages/Home.vue
 create mode 100644 docs/src/pages/ReleaseList.vue
 create mode 100644 docs/src/router.ts
 create mode 100644 docs/src/styles/main.css
 create mode 100644 docs/tailwind.config.js
 create mode 100644 docs/vite.config.ts

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index b191c3a4..ef168e2b 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -1,8 +1,9 @@
-name: Publish docs via GitHub Pages
+name: Deploy docs to GitHub Pages
 
 on:
-  pull_request:
-    types: [ closed ]
+  push:
+    branches: [ main ]
+    paths: [ 'docs/**', '.github/workflows/docs.yml' ]
   workflow_dispatch:
 
 permissions:
@@ -10,32 +11,50 @@ permissions:
   pages: write
   id-token: write
 
+# 同一时间只跑一个部署，新提交自动取消进行中的旧部署
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
 jobs:
-  deploy:
+  build:
     runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        node-version: [ 22.x ]
-
+    defaults:
+      run:
+        working-directory: docs
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
+
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 10
 
-      - name: Use Node.js ${{ matrix.node-version }}
-        uses: actions/setup-node@v3
+      - uses: actions/setup-node@v4
         with:
-          node-version: ${{ matrix.node-version }}
+          node-version: 22
+          cache: pnpm
+          cache-dependency-path: docs/pnpm-lock.yaml
 
       - name: Install dependencies
-        run: npm install pageforge -g
+        run: pnpm install --frozen-lockfile
 
       - name: Build
-        run: |
-          cd docs
-          pageforge build
-          echo 'codeforge.devlive.org' > dist/CNAME
+        run: pnpm build
 
-      - name: Deploy
-        uses: peaceiris/actions-gh-pages@v3
+      - uses: actions/configure-pages@v5
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
         with:
-          github_token: ${{ secrets.GH_TOKEN }}
-          publish_dir: docs/dist
\ No newline at end of file
+          path: docs/dist
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
diff --git a/docs/.gitignore b/docs/.gitignore
new file mode 100644
index 00000000..1cf7629d
--- /dev/null
+++ b/docs/.gitignore
@@ -0,0 +1,4 @@
+node_modules
+dist
+.vite
+*.local
diff --git a/docs/content/download.md b/docs/content/download.md
deleted file mode 100644
index ece402d1..00000000
--- a/docs/content/download.md
+++ /dev/null
@@ -1,18 +0,0 @@
----
-title: 下载 CodeForge
-
-config:
-    sidebar: false
-    toc: false
----
-
-当前的 CodeForge 版本是 <img class="inline-flex" src="https://img.shields.io/github/v/release/devlive-community/codeforge.svg" />。有关详细信息，请参阅 [发行说明](/release/25.0.1.html)。
-
-<br />
-
-::: grid
-- 适配 Windows
-- 适配 macOS
-:::
-
-!btn[点我立即下载](https://github.com/devlive-community/codeforge/releases/){w-96 my-24 text-center text-white bg-green-500 hover:bg-green-600}
diff --git a/docs/content/index.md b/docs/content/index.md
deleted file mode 100644
index 3c0f5651..00000000
--- a/docs/content/index.md
+++ /dev/null
@@ -1,64 +0,0 @@
----
-title: 欢迎使用 CodeForge
-template: home
-
-config:
-  sidebar: false
-  toc: false
-
-hero:
-  title: 轻量级桌面代码执行器
-  description: 轻量级、高性能的桌面代码执行器，专为开发者、学生和编程爱好者设计。
-  primaryCta:
-    url: /download.html
-    text: 立即下载
-  secondaryCta:
-    url: https://github.com/devlive-community/codeforge
-    text: 了解更多
-
-features:
-  subtitle: 核心优势
-  title: 为什么选择我们
-  description: 轻量级、高性能，专为开发者、学生和编程爱好者设计。
-  items:
-    - icon: >-
-        <svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke="currentColor" class="w-6 h-6 text-indigo-600">
-          <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M13 10V3L4 14h7v7l9-11h-7z" />
-        </svg>
-      title: 高性能
-      description: 可扩展的语言支持系统
-
-    - icon: >-
-        <svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke="currentColor" class="w-6 h-6 text-indigo-600">
-          <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 15v2m-6 4h12a2 2 0 002-2v-6a2 2 0 00-2-2H6a2 2 0 00-2 2v6a2 2 0 002 2zm10-10V7a4 4 0 00-8 0v4h8z" />
-        </svg>
-      title: 操作简洁
-      description: 一键运行代码
-
-    - icon: >-
-        <svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke="currentColor" class="w-6 h-6 text-indigo-600">
-          <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2[...]
-        </svg>
-      title: 易于使用
-      description: 直观的界面设计，简单易上手
-
-stats:
-  title: 用数据说话
-  description: 我们取得的成就
-  items:
-    - label: GitHub Stars
-      value: 200+
-    - label: 跨平台性(Windows、macOS、Linux)
-      value: 3+
-    - label: 支持的语言
-      value: 38+
-    - label: 轻量级级别
-      value: 15 M+
-
-cta:
-  title: 准备好开始了吗？
-  description: 立即下载，开启您的技术创新之旅
-  button:
-    url: /download.html
-    text: 立即下载
----
diff --git a/docs/env.d.ts b/docs/env.d.ts
new file mode 100644
index 00000000..742973ee
--- /dev/null
+++ b/docs/env.d.ts
@@ -0,0 +1,15 @@
+/// <reference types="vite/client" />
+
+declare module '*.vue' {
+  import type {DefineComponent} from 'vue'
+  const component: DefineComponent<{}, {}, any>
+  export default component
+}
+
+// unplugin-vue-markdown：.md 作为 Vue 组件导入，并暴露 frontmatter
+declare module '*.md' {
+  import type {DefineComponent} from 'vue'
+  const component: DefineComponent<{}, {}, any>
+  export default component
+  export const frontmatter: Record<string, any>
+}
diff --git a/docs/index.html b/docs/index.html
new file mode 100644
index 00000000..78568e37
--- /dev/null
+++ b/docs/index.html
@@ -0,0 +1,15 @@
+<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+  <meta charset="UTF-8"/>
+  <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
+  <link rel="icon" type="image/svg+xml" href="/logo.svg"/>
+  <title>CodeForge — 轻量级桌面代码执行器</title>
+  <meta name="description" content="CodeForge 是一款轻量级、高性能的桌面代码执行器，专为开发者、学生和编程爱好者设计。"/>
+  <meta name="keywords" content="CodeForge, 代码执行器, 编辑器, Python, Rust, Git"/>
+</head>
+<body>
+<div id="app"></div>
+<script type="module" src="/src/main.ts"></script>
+</body>
+</html>
diff --git a/docs/pageforge.yaml b/docs/pageforge.yaml
deleted file mode 100644
index 34ab9e3a..00000000
--- a/docs/pageforge.yaml
+++ /dev/null
@@ -1,54 +0,0 @@
-site:
-  title: CodeForge
-  description: CodeForge 是一款轻量级、高性能的桌面代码执行器，专为开发者、学生和编程爱好者设计。
-  hiddenTitle: true
-  keywords: CodeForge, Markdown, Python 2, Python 3, Rust
-  logo: /assets/logo.svg
-  favicon: assets/logo.svg
-  baseUrl: https://codeforge.devlive.org
-
-repo:
-  owner: devlive-community
-  name: codeforge
-  url: https://github.com/devlive-community/codeforge
-  branch: dev
-
-banner:
-  content: 💗 <a href="https://github.com/devlive-community/codeforge" target="_blank">CodeForge <em>26.2.0</em> 已经发布, 如果喜欢我们的软件，请点击这里支持我们</a> ❤️
-
-feature:
-  lucide:
-    enable: true
-  grid:
-    enable: true
-  share:
-    enable: true
-    options:
-      qq: true
-      wechat: true
-      weibo: true
-  sitemap:
-    enable: true
-  fontSize:
-    enable: true
-  button:
-    enable: true
-
-footer:
-  copyright: © 2025 CodeForge All Rights Reserved.
-  social:
-    github:
-      title: GitHub
-      href: https://github.com/devlive-community/codeforge
-
-nav:
-  - 发布日志:
-      - /release/26.2.0.md
-      - /release/26.1.0.md
-      - /release/26.0.0.md
-      - /release/25.0.5.md
-      - /release/25.0.4.md
-      - /release/25.0.3.md
-      - /release/25.0.2.md
-      - /release/25.0.1.md
-      - /release/25.0.0.md
\ No newline at end of file
diff --git a/docs/postcss.config.js b/docs/postcss.config.js
new file mode 100644
index 00000000..2b75bd8a
--- /dev/null
+++ b/docs/postcss.config.js
@@ -0,0 +1,6 @@
+export default {
+  plugins: {
+    tailwindcss: {},
+    autoprefixer: {}
+  }
+}
diff --git a/docs/CNAME b/docs/public/CNAME
similarity index 100%
rename from docs/CNAME
rename to docs/public/CNAME
diff --git a/docs/assets/logo.svg b/docs/public/logo.svg
similarity index 100%
rename from docs/assets/logo.svg
rename to docs/public/logo.svg
diff --git a/docs/src/App.vue b/docs/src/App.vue
new file mode 100644
index 00000000..521b84cc
--- /dev/null
+++ b/docs/src/App.vue
@@ -0,0 +1,20 @@
+<template>
+  <div class="min-h-screen flex flex-col bg-white dark:bg-gray-900 text-gray-800 dark:text-gray-200">
+    <SiteHeader/>
+    <main class="flex-1">
+      <RouterView v-slot="{ Component, route }">
+        <DocLayout v-if="route.meta.doc">
+          <component :is="Component"/>
+        </DocLayout>
+        <component :is="Component" v-else/>
+      </RouterView>
+    </main>
+    <SiteFooter/>
+  </div>
+</template>
+
+<script setup lang="ts">
+import SiteHeader from './components/SiteHeader.vue'
+import SiteFooter from './components/SiteFooter.vue'
+import DocLayout from './layouts/DocLayout.vue'
+</script>
diff --git a/docs/src/components/SiteFooter.vue b/docs/src/components/SiteFooter.vue
new file mode 100644
index 00000000..2185115e
--- /dev/null
+++ b/docs/src/components/SiteFooter.vue
@@ -0,0 +1,19 @@
+<template>
+  <footer class="border-t border-gray-200 dark:border-gray-800 mt-20">
+    <div class="max-w-6xl mx-auto px-4 py-10 flex flex-col sm:flex-row items-center justify-between gap-4 text-sm text-gray-500 dark:text-gray-400">
+      <div class="flex items-center gap-2">
+        <img src="/logo.svg" alt="CodeForge" class="w-6 h-6"/>
+        <span>© {{ year }} CodeForge · All Rights Reserved.</span>
+      </div>
+      <div class="flex items-center gap-4">
+        <a class="hover:text-brand-600 dark:hover:text-brand-400" href="https://github.com/devlive-community/codeforge" target="_blank" rel="noopener">GitHub</a>
+        <RouterLink class="hover:text-brand-600 dark:hover:text-brand-400" to="/download">下载</RouterLink>
+        <RouterLink class="hover:text-brand-600 dark:hover:text-brand-400" to="/release">发布日志</RouterLink>
+      </div>
+    </div>
+  </footer>
+</template>
+
+<script setup lang="ts">
+const year = new Date().getFullYear()
+</script>
diff --git a/docs/src/components/SiteHeader.vue b/docs/src/components/SiteHeader.vue
new file mode 100644
index 00000000..3557a919
--- /dev/null
+++ b/docs/src/components/SiteHeader.vue
@@ -0,0 +1,45 @@
+<template>
+  <header class="sticky top-0 z-40 backdrop-blur bg-white/80 dark:bg-gray-900/80 border-b border-gray-200 dark:border-gray-800">
+    <!-- 公告条 -->
+    <div v-if="latestRelease" class="bg-brand-600 text-white text-center text-sm py-1.5 px-4">
+      💗 CodeForge <em class="not-italic font-semibold">{{ latestRelease.version }}</em> 已发布，
+      <a class="underline hover:text-brand-100" href="https://github.com/devlive-community/codeforge" target="_blank" rel="noopener">前往 GitHub 支持我们</a> ❤️
+    </div>
+
+    <nav class="max-w-6xl mx-auto px-4 h-14 flex items-center gap-6">
+      <RouterLink to="/" class="flex items-center gap-2 font-bold text-gray-900 dark:text-gray-100">
+        <img src="/logo.svg" alt="CodeForge" class="w-7 h-7"/>
+        <span>CodeForge</span>
+      </RouterLink>
+
+      <div class="flex items-center gap-1 text-sm ml-2">
+        <RouterLink v-for="l in links" :key="l.to" :to="l.to"
+                    class="px-3 py-1.5 rounded-lg text-gray-600 dark:text-gray-300 hover:bg-gray-100 dark:hover:bg-gray-800 transition-colors"
+                    active-class="text-brand-600 dark:text-brand-400 font-medium">
+          {{ l.text }}
+        </RouterLink>
+      </div>
+
+      <div class="ml-auto flex items-center gap-2">
+        <a href="https://github.com/devlive-community/codeforge" target="_blank" rel="noopener"
+           class="p-2 rounded-lg text-gray-500 hover:text-gray-900 dark:text-gray-400 dark:hover:text-gray-100 hover:bg-gray-100 dark:hover:bg-gray-800 transition-colors"
+           aria-label="GitHub">
+          <svg class="w-5 h-5" viewBox="0 0 24 24" fill="currentColor">
+            <path d="M12 2C6.48 2 2 6.58 2 12.26c0 4.5 2.87 8.32 6.84 9.67.5.1.68-.22.68-.49 0-.24-.01-.87-.01-1.71-2.78.62-3.37-1.37-3.37-1.37-.45-1.18-1.11-1.5-1.11-1.5-.91-.64.07-.62.07-.62 1 .07 1.53 1.06 1.53 1.06.89 1.56 2.34 1.11 2.91.85.09-.66.35-1.11.63-1.37-2.22-.26-4.56-1.14-4.56-5.07 0-1.12.39-2.03 1.03-2.75-.1-.26-.45-1.3.1-2.71 0 0 .84-.27 2.75 1.05A9.36 9.36 0 0 1 12 7.07c.85 0 1.71.12 2.51.34 1.91-1.32 2.75-1.05 2.75-1.05.55 1.41.2 2.45.1 2.71.64.72 1.03 1.63 1.03 2.75 0 3.94-2.34 4.81-4.57 5.06.36.32.68.94.68 1.9 0 1.37-.01 2.48-.01 2.82 0 .27.18.6.69.49A10.02 10.02 0 0 0 22 12.26C22 6.58 17.52 2 12 2z"/>
+          </svg>
+        </a>
+        <ThemeToggle/>
+      </div>
+    </nav>
+  </header>
+</template>
+
+<script setup lang="ts">
+import ThemeToggle from './ThemeToggle.vue'
+import {latestRelease} from '../content/releases'
+
+const links = [
+  {to: '/download', text: '下载'},
+  {to: '/release', text: '发布日志'}
+]
+</script>
diff --git a/docs/src/components/ThemeToggle.vue b/docs/src/components/ThemeToggle.vue
new file mode 100644
index 00000000..7f669a4a
--- /dev/null
+++ b/docs/src/components/ThemeToggle.vue
@@ -0,0 +1,35 @@
+<template>
+  <button class="p-2 rounded-lg text-gray-500 hover:text-gray-900 dark:text-gray-400 dark:hover:text-gray-100 hover:bg-gray-100 dark:hover:bg-gray-800 transition-colors"
+          :aria-label="isDark ? '切换到浅色' : '切换到深色'"
+          @click="toggle">
+    <svg v-if="isDark" class="w-5 h-5" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+      <circle cx="12" cy="12" r="5"/>
+      <path d="M12 1v2M12 21v2M4.2 4.2l1.4 1.4M18.4 18.4l1.4 1.4M1 12h2M21 12h2M4.2 19.8l1.4-1.4M18.4 5.6l1.4-1.4"/>
+    </svg>
+    <svg v-else class="w-5 h-5" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+      <path d="M21 12.79A9 9 0 1 1 11.21 3 7 7 0 0 0 21 12.79z"/>
+    </svg>
+  </button>
+</template>
+
+<script setup lang="ts">
+import {onMounted, ref} from 'vue'
+
+const isDark = ref(false)
+
+const apply = (dark: boolean) => {
+  isDark.value = dark
+  document.documentElement.classList.toggle('dark', dark)
+}
+
+onMounted(() => {
+  const saved = localStorage.getItem('theme')
+  const prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches
+  apply(saved ? saved === 'dark' : prefersDark)
+})
+
+const toggle = () => {
+  apply(!isDark.value)
+  localStorage.setItem('theme', isDark.value ? 'dark' : 'light')
+}
+</script>
diff --git a/docs/content/release/25.0.0.md b/docs/src/content/release/25.0.0.md
similarity index 100%
rename from docs/content/release/25.0.0.md
rename to docs/src/content/release/25.0.0.md
diff --git a/docs/content/release/25.0.1.md b/docs/src/content/release/25.0.1.md
similarity index 100%
rename from docs/content/release/25.0.1.md
rename to docs/src/content/release/25.0.1.md
diff --git a/docs/content/release/25.0.2.md b/docs/src/content/release/25.0.2.md
similarity index 100%
rename from docs/content/release/25.0.2.md
rename to docs/src/content/release/25.0.2.md
diff --git a/docs/content/release/25.0.3.md b/docs/src/content/release/25.0.3.md
similarity index 100%
rename from docs/content/release/25.0.3.md
rename to docs/src/content/release/25.0.3.md
diff --git a/docs/content/release/25.0.4.md b/docs/src/content/release/25.0.4.md
similarity index 100%
rename from docs/content/release/25.0.4.md
rename to docs/src/content/release/25.0.4.md
diff --git a/docs/content/release/25.0.5.md b/docs/src/content/release/25.0.5.md
similarity index 100%
rename from docs/content/release/25.0.5.md
rename to docs/src/content/release/25.0.5.md
diff --git a/docs/content/release/26.0.0.md b/docs/src/content/release/26.0.0.md
similarity index 100%
rename from docs/content/release/26.0.0.md
rename to docs/src/content/release/26.0.0.md
diff --git a/docs/content/release/26.1.0.md b/docs/src/content/release/26.1.0.md
similarity index 100%
rename from docs/content/release/26.1.0.md
rename to docs/src/content/release/26.1.0.md
diff --git a/docs/content/release/26.2.0.md b/docs/src/content/release/26.2.0.md
similarity index 100%
rename from docs/content/release/26.2.0.md
rename to docs/src/content/release/26.2.0.md
diff --git a/docs/src/content/releases.ts b/docs/src/content/releases.ts
new file mode 100644
index 00000000..05179e12
--- /dev/null
+++ b/docs/src/content/releases.ts
@@ -0,0 +1,37 @@
+// 发布日志：扫描 release/*.md，自动生成版本列表与路由组件。
+// 新发版只需往 release/ 丢一个 md 文件，无需改其它代码。
+
+// 懒加载的 Vue 组件（每个 md 经 unplugin-vue-markdown 转成组件）
+const componentLoaders = import.meta.glob('./release/*.md')
+
+export interface ReleaseMeta {
+  version: string
+  title: string
+}
+
+const versionFromPath = (p: string): string => (p.match(/([^/]+)\.md$/)?.[1]) ?? p
+
+// 形如 26.2.0 的版本号降序
+const compareVersionDesc = (a: string, b: string): number => {
+  const pa = a.split('.').map(Number)
+  const pb = b.split('.').map(Number)
+  for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+    const d = (pb[i] || 0) - (pa[i] || 0)
+    if (d !== 0) return d
+  }
+  return 0
+}
+
+const versions = Object.keys(componentLoaders)
+  .map(versionFromPath)
+  .sort(compareVersionDesc)
+
+export const releases: ReleaseMeta[] = versions.map(version => ({version, title: `v${version}`}))
+
+export const latestRelease = releases[0]
+
+// 路由：每个版本一个静态路由，便于 vite-ssg 全量预渲染
+export const releaseRoutes = Object.entries(componentLoaders).map(([path, loader]) => ({
+  path: `/release/${versionFromPath(path)}`,
+  component: loader
+}))
diff --git a/docs/src/layouts/DocLayout.vue b/docs/src/layouts/DocLayout.vue
new file mode 100644
index 00000000..4ae6f8c9
--- /dev/null
+++ b/docs/src/layouts/DocLayout.vue
@@ -0,0 +1,25 @@
+<template>
+  <div class="max-w-6xl mx-auto px-4 py-8 grid grid-cols-1 lg:grid-cols-[220px_minmax(0,1fr)] gap-8">
+    <!-- 版本侧栏 -->
+    <aside class="lg:sticky lg:top-24 lg:self-start">
+      <p class="px-3 text-xs font-semibold uppercase tracking-wide text-gray-400 mb-2">发布日志</p>
+      <nav class="space-y-0.5">
+        <RouterLink v-for="r in releases" :key="r.version"
+                    :to="`/release/${r.version}`"
+                    class="block px-3 py-1.5 rounded-lg text-sm text-gray-600 dark:text-gray-300 hover:bg-gray-100 dark:hover:bg-gray-800 transition-colors"
+                    active-class="bg-brand-50 dark:bg-brand-900/30 text-brand-700 dark:text-brand-300 font-medium">
+          {{ r.version }}
+        </RouterLink>
+      </nav>
+    </aside>
+
+    <!-- 正文 -->
+    <article class="prose-doc min-w-0">
+      <slot/>
+    </article>
+  </div>
+</template>
+
+<script setup lang="ts">
+import {releases} from '../content/releases'
+</script>
diff --git a/docs/src/main.ts b/docs/src/main.ts
new file mode 100644
index 00000000..a04e7681
--- /dev/null
+++ b/docs/src/main.ts
@@ -0,0 +1,17 @@
+import {ViteSSG} from 'vite-ssg'
+import App from './App.vue'
+import {routes} from './router'
+import './styles/main.css'
+
+// vite-ssg：开发用 SPA，构建时把每个路由预渲染成静态 HTML
+export const createApp = ViteSSG(
+  App,
+  {routes, scrollBehavior: () => ({top: 0})},
+  ({router}) => {
+    router.afterEach((to) => {
+      if (typeof document !== 'undefined' && to.meta?.title) {
+        document.title = String(to.meta.title)
+      }
+    })
+  }
+)
diff --git a/docs/src/pages/Download.vue b/docs/src/pages/Download.vue
new file mode 100644
index 00000000..54f897a5
--- /dev/null
+++ b/docs/src/pages/Download.vue
@@ -0,0 +1,35 @@
+<template>
+  <section class="max-w-3xl mx-auto px-4 py-16 text-center">
+    <h1 class="text-3xl font-bold text-gray-900 dark:text-gray-100">下载 CodeForge</h1>
+    <p class="mt-4 text-gray-600 dark:text-gray-400">
+      当前最新版本
+      <img class="inline-block align-middle" alt="latest release"
+           src="https://img.shields.io/github/v/release/devlive-community/codeforge.svg"/>
+      <template v-if="latestRelease">
+        ，详见 <RouterLink class="text-brand-600 dark:text-brand-400 hover:underline" :to="`/release/${latestRelease.version}`">发布说明</RouterLink>。
+      </template>
+    </p>
+
+    <div class="mt-10 grid grid-cols-1 sm:grid-cols-2 gap-4">
+      <div v-for="p in platforms" :key="p.name"
+           class="p-6 rounded-2xl border border-gray-200 dark:border-gray-800">
+        <div class="text-3xl mb-2">{{ p.icon }}</div>
+        <div class="font-semibold text-gray-900 dark:text-gray-100">{{ p.name }}</div>
+      </div>
+    </div>
+
+    <a href="https://github.com/devlive-community/codeforge/releases" target="_blank" rel="noopener"
+       class="inline-block mt-10 px-8 py-4 rounded-xl bg-green-500 hover:bg-green-600 text-white text-lg font-medium shadow-lg shadow-green-500/20 transition-colors">
+      点我前往下载
+    </a>
+  </section>
+</template>
+
+<script setup lang="ts">
+import {latestRelease} from '../content/releases'
+
+const platforms = [
+  {name: '适配 Windows', icon: '🪟'},
+  {name: '适配 macOS', icon: '🍎'}
+]
+</script>
diff --git a/docs/src/pages/Home.vue b/docs/src/pages/Home.vue
new file mode 100644
index 00000000..770f598d
--- /dev/null
+++ b/docs/src/pages/Home.vue
@@ -0,0 +1,50 @@
+<template>
+  <!-- Hero -->
+  <section class="relative overflow-hidden">
+    <div class="absolute inset-0 -z-10 bg-gradient-to-b from-brand-50/60 to-transparent dark:from-brand-900/20"></div>
+    <div class="max-w-6xl mx-auto px-4 pt-20 pb-16 text-center">
+      <img src="/logo.svg" alt="CodeForge" class="w-20 h-20 mx-auto mb-6"/>
+      <h1 class="text-4xl sm:text-5xl font-extrabold tracking-tight text-gray-900 dark:text-gray-100">
+        轻量级桌面代码执行器
+      </h1>
+      <p class="mt-5 max-w-2xl mx-auto text-lg text-gray-600 dark:text-gray-400">
+        轻量级、高性能的桌面代码执行器，专为开发者、学生和编程爱好者设计。
+      </p>
+      <div class="mt-8 flex items-center justify-center gap-3">
+        <RouterLink to="/download"
+                    class="px-6 py-3 rounded-xl bg-brand-600 hover:bg-brand-700 text-white font-medium shadow-lg shadow-brand-600/20 transition-colors">
+          立即下载
+        </RouterLink>
+        <a href="https://github.com/devlive-community/codeforge" target="_blank" rel="noopener"
+           class="px-6 py-3 rounded-xl border border-gray-300 dark:border-gray-700 text-gray-700 dark:text-gray-200 hover:bg-gray-50 dark:hover:bg-gray-800 font-medium transition-colors">
+          了解更多
+        </a>
+      </div>
+    </div>
+  </section>
+
+  <!-- 特性 -->
+  <section class="max-w-6xl mx-auto px-4 py-12">
+    <div class="text-center mb-12">
+      <p class="text-brand-600 dark:text-brand-400 font-semibold">核心优势</p>
+      <h2 class="mt-1 text-3xl font-bold text-gray-900 dark:text-gray-100">为什么选择我们</h2>
+      <p class="mt-3 text-gray-600 dark:text-gray-400">轻量级、高性能，专为开发者、学生和编程爱好者设计。</p>
+    </div>
+    <div class="grid grid-cols-1 md:grid-cols-3 gap-6">
+      <div v-for="f in features" :key="f.title"
+           class="p-6 rounded-2xl border border-gray-200 dark:border-gray-800 hover:border-brand-300 dark:hover:border-brand-700 hover:shadow-lg transition-all">
+        <div class="w-11 h-11 rounded-xl bg-brand-50 dark:bg-brand-900/40 flex items-center justify-center text-2xl mb-4">{{ f.icon }}</div>
+        <h3 class="font-semibold text-lg text-gray-900 dark:text-gray-100">{{ f.title }}</h3>
+        <p class="mt-2 text-gray-600 dark:text-gray-400">{{ f.desc }}</p>
+      </div>
+    </div>
+  </section>
+</template>
+
+<script setup lang="ts">
+const features = [
+  {icon: '⚡', title: '高性能', desc: '可扩展的语言支持系统，运行迅捷。'},
+  {icon: '🖱️', title: '操作简洁', desc: '一键运行代码，所见即所得。'},
+  {icon: '🧩', title: '功能丰富', desc: '内置编辑、调试、数据库与 Git 工作台。'}
+]
+</script>
diff --git a/docs/src/pages/ReleaseList.vue b/docs/src/pages/ReleaseList.vue
new file mode 100644
index 00000000..77722f21
--- /dev/null
+++ b/docs/src/pages/ReleaseList.vue
@@ -0,0 +1,13 @@
+<template>
+  <h1>发布日志</h1>
+  <p>选择一个版本查看详细更新内容。</p>
+  <ul>
+    <li v-for="r in releases" :key="r.version">
+      <RouterLink :to="`/release/${r.version}`">{{ r.title || r.version }}</RouterLink>
+    </li>
+  </ul>
+</template>
+
+<script setup lang="ts">
+import {releases} from '../content/releases'
+</script>
diff --git a/docs/src/router.ts b/docs/src/router.ts
new file mode 100644
index 00000000..02739605
--- /dev/null
+++ b/docs/src/router.ts
@@ -0,0 +1,12 @@
+import type {RouteRecordRaw} from 'vue-router'
+import Home from './pages/Home.vue'
+import Download from './pages/Download.vue'
+import ReleaseList from './pages/ReleaseList.vue'
+import {releaseRoutes} from './content/releases'
+
+export const routes: RouteRecordRaw[] = [
+  {path: '/', component: Home, meta: {title: 'CodeForge — 轻量级桌面代码执行器'}},
+  {path: '/download', component: Download, meta: {title: '下载 CodeForge'}},
+  {path: '/release', component: ReleaseList, meta: {title: '发布日志', doc: true}},
+  ...releaseRoutes.map(r => ({...r, meta: {doc: true}}))
+]
diff --git a/docs/src/styles/main.css b/docs/src/styles/main.css
new file mode 100644
index 00000000..327ce49b
--- /dev/null
+++ b/docs/src/styles/main.css
@@ -0,0 +1,65 @@
+@tailwind base;
+@tailwind components;
+@tailwind utilities;
+
+:root {
+  color-scheme: light dark;
+}
+
+html {
+  scroll-behavior: smooth;
+}
+
+/* 发布日志正文排版（Markdown 渲染结果）。设计阶段再细化。 */
+.prose-doc {
+  @apply text-gray-700 dark:text-gray-300 leading-7;
+}
+.prose-doc h1 {
+  @apply text-3xl font-bold text-gray-900 dark:text-gray-100 mt-2 mb-6 scroll-mt-24;
+}
+.prose-doc h2 {
+  @apply text-2xl font-semibold text-gray-900 dark:text-gray-100 mt-10 mb-4 pb-2 border-b border-gray-200 dark:border-gray-800 scroll-mt-24;
+}
+.prose-doc h3 {
+  @apply text-xl font-semibold text-gray-900 dark:text-gray-100 mt-8 mb-3 scroll-mt-24;
+}
+.prose-doc p {
+  @apply my-4;
+}
+.prose-doc a {
+  @apply text-brand-600 dark:text-brand-400 hover:underline;
+}
+.prose-doc ul {
+  @apply list-disc pl-6 my-4 space-y-1.5;
+}
+.prose-doc ol {
+  @apply list-decimal pl-6 my-4 space-y-1.5;
+}
+.prose-doc code {
+  @apply px-1.5 py-0.5 rounded bg-gray-100 dark:bg-gray-800 text-brand-600 dark:text-brand-300 text-[0.9em] font-mono;
+}
+.prose-doc pre {
+  @apply p-4 rounded-lg bg-gray-900 text-gray-100 overflow-x-auto my-5 text-sm;
+}
+.prose-doc pre code {
+  @apply bg-transparent text-gray-100 p-0;
+}
+.prose-doc blockquote {
+  @apply border-l-4 border-brand-300 dark:border-brand-700 pl-4 italic text-gray-500 dark:text-gray-400 my-4;
+}
+.prose-doc table {
+  @apply w-full my-5 text-sm border-collapse;
+}
+.prose-doc th,
+.prose-doc td {
+  @apply border border-gray-200 dark:border-gray-700 px-3 py-2 text-left;
+}
+.prose-doc th {
+  @apply bg-gray-50 dark:bg-gray-800 font-semibold;
+}
+.prose-doc hr {
+  @apply my-8 border-gray-200 dark:border-gray-800;
+}
+.prose-doc img {
+  @apply inline-block max-w-full;
+}
diff --git a/docs/tailwind.config.js b/docs/tailwind.config.js
new file mode 100644
index 00000000..eb196835
--- /dev/null
+++ b/docs/tailwind.config.js
@@ -0,0 +1,17 @@
+/** @type {import('tailwindcss').Config} */
+export default {
+  darkMode: 'class',
+  content: ['./index.html', './src/**/*.{vue,ts,md}'],
+  theme: {
+    extend: {
+      colors: {
+        brand: {
+          50: '#eef2ff', 100: '#e0e7ff', 200: '#c7d2fe', 300: '#a5b4fc',
+          400: '#818cf8', 500: '#6366f1', 600: '#4f46e5', 700: '#4338ca',
+          800: '#3730a3', 900: '#312e81'
+        }
+      }
+    }
+  },
+  plugins: []
+}
diff --git a/docs/vite.config.ts b/docs/vite.config.ts
new file mode 100644
index 00000000..35daf5c3
--- /dev/null
+++ b/docs/vite.config.ts
@@ -0,0 +1,28 @@
+import {defineConfig} from 'vite'
+import vue from '@vitejs/plugin-vue'
+import Markdown from 'unplugin-vue-markdown/vite'
+import anchor from 'markdown-it-anchor'
+import {fileURLToPath, URL} from 'node:url'
+
+// 自建文档站：Vue 单文件组件 + Markdown（发布日志）渲染为 Vue 组件
+export default defineConfig({
+  base: '/',
+  plugins: [
+    // 注意：Markdown 必须在 vue 之前，先把 .md 转成 SFC 再交给 vue 编译
+    Markdown({
+      exposeFrontmatter: true,
+      markdownItOptions: {html: true, linkify: true},
+      markdownItSetup(md) {
+        md.use(anchor, {permalink: anchor.permalink.headerLink()})
+      }
+    }),
+    vue({include: [/\.vue$/, /\.md$/]})
+  ],
+  resolve: {
+    alias: {'@': fileURLToPath(new URL('./src', import.meta.url))}
+  },
+  // vite-ssg：把所有路由静态预渲染为 HTML
+  ssgOptions: {
+    formatting: 'minify'
+  }
+})

From 937df9dd64ce898d5266377877971357a8534003 Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Fri, 26 Jun 2026 13:48:13 +0800
Subject: [PATCH 19/20] =?UTF-8?q?feat(docs):=20=E9=87=8D=E5=81=9A=E6=96=87?=
 =?UTF-8?q?=E6=A1=A3=E7=AB=99=E8=A7=86=E8=A7=89=EF=BC=8C=E5=8E=BB=E9=99=A4?=
 =?UTF-8?q?=E5=85=A8=E9=83=A8=20emoji=EF=BC=8C=E6=94=B9=E7=94=A8=E4=B8=93?=
 =?UTF-8?q?=E4=B8=9A=E7=BA=BF=E6=80=A7=E5=9B=BE=E6=A0=87=E4=B8=8E=E4=BB=A3?=
 =?UTF-8?q?=E7=A0=81=E7=AA=97=E5=8F=A3=E6=A0=B7=E6=9C=BA?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 首页改为左文案右代码窗口样机（手写 token 高亮），线性 SVG 特性图标取代 emoji
- 去掉花哨公告条，改为克制的版本徽标 pill；统一 slate 中性色 + 单一 brand 强调色
- 引入 Inter / JetBrains Mono 字体，细化阴影、边框、留白与暗色
- 下载页/页脚/发布日志侧栏与正文排版同步重做，移除所有表情
---
 .github/workflows/docs.yml         |   1 -
 docs/index.html                    |   3 +
 docs/src/App.vue                   |   2 +-
 docs/src/components/CodeWindow.vue |  43 +++++++++++
 docs/src/components/SiteFooter.vue |  17 +++--
 docs/src/components/SiteHeader.vue |  29 ++++---
 docs/src/layouts/DocLayout.vue     |  14 ++--
 docs/src/pages/Download.vue        |  58 ++++++++------
 docs/src/pages/Home.vue            | 118 +++++++++++++++++++++--------
 docs/src/pages/ReleaseList.vue     |  14 ++--
 docs/src/styles/main.css           |  57 +++++++++-----
 docs/tailwind.config.js            |   8 ++
 12 files changed, 256 insertions(+), 108 deletions(-)
 create mode 100644 docs/src/components/CodeWindow.vue

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index ef168e2b..72eff5be 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -2,7 +2,6 @@ name: Deploy docs to GitHub Pages
 
 on:
   push:
-    branches: [ main ]
     paths: [ 'docs/**', '.github/workflows/docs.yml' ]
   workflow_dispatch:
 
diff --git a/docs/index.html b/docs/index.html
index 78568e37..94db638d 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -4,6 +4,9 @@
   <meta charset="UTF-8"/>
   <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
   <link rel="icon" type="image/svg+xml" href="/logo.svg"/>
+  <link rel="preconnect" href="https://fonts.googleapis.com"/>
+  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin/>
+  <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700;800&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet"/>
   <title>CodeForge — 轻量级桌面代码执行器</title>
   <meta name="description" content="CodeForge 是一款轻量级、高性能的桌面代码执行器，专为开发者、学生和编程爱好者设计。"/>
   <meta name="keywords" content="CodeForge, 代码执行器, 编辑器, Python, Rust, Git"/>
diff --git a/docs/src/App.vue b/docs/src/App.vue
index 521b84cc..233bc8c2 100644
--- a/docs/src/App.vue
+++ b/docs/src/App.vue
@@ -1,5 +1,5 @@
 <template>
-  <div class="min-h-screen flex flex-col bg-white dark:bg-gray-900 text-gray-800 dark:text-gray-200">
+  <div class="min-h-screen flex flex-col font-sans antialiased bg-white dark:bg-slate-950 text-slate-800 dark:text-slate-200">
     <SiteHeader/>
     <main class="flex-1">
       <RouterView v-slot="{ Component, route }">
diff --git a/docs/src/components/CodeWindow.vue b/docs/src/components/CodeWindow.vue
new file mode 100644
index 00000000..3d09e206
--- /dev/null
+++ b/docs/src/components/CodeWindow.vue
@@ -0,0 +1,43 @@
+<template>
+  <div class="rounded-xl border border-slate-200 dark:border-slate-800 bg-white dark:bg-slate-900 shadow-soft overflow-hidden">
+    <!-- 标题栏 -->
+    <div class="flex items-center gap-2 px-4 h-10 border-b border-slate-200 dark:border-slate-800 bg-slate-50 dark:bg-slate-900/80">
+      <span class="w-3 h-3 rounded-full bg-red-400"></span>
+      <span class="w-3 h-3 rounded-full bg-amber-400"></span>
+      <span class="w-3 h-3 rounded-full bg-green-400"></span>
+      <span class="ml-3 text-xs text-slate-400 font-mono">main.py</span>
+    </div>
+    <!-- 代码区 -->
+    <div class="flex font-mono text-[13px] leading-6">
+      <div class="select-none px-3 py-4 text-right text-slate-300 dark:text-slate-600 bg-slate-50/60 dark:bg-slate-900/40">
+        <div v-for="n in lines.length" :key="n">{{ n }}</div>
+      </div>
+      <pre class="px-4 py-4 overflow-x-auto"><code><template v-for="(line, i) in lines" :key="i"><span v-html="line"></span>
+</template></code></pre>
+    </div>
+    <!-- 输出区 -->
+    <div class="border-t border-slate-200 dark:border-slate-800 px-4 py-3 bg-slate-50 dark:bg-slate-900/60 font-mono text-[13px]">
+      <span class="text-slate-400">$ </span><span class="text-slate-500 dark:text-slate-400">run main.py</span>
+      <div class="mt-1 text-emerald-600 dark:text-emerald-400">fib(10) = 55</div>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+// 简单的着色行（手写 token 高亮，避免引入运行时高亮库）
+const k = (s: string) => `<span class="text-violet-500 dark:text-violet-400">${s}</span>`
+const f = (s: string) => `<span class="text-blue-500 dark:text-blue-400">${s}</span>`
+const n = (s: string) => `<span class="text-amber-600 dark:text-amber-400">${s}</span>`
+const c = (s: string) => `<span class="text-slate-400">${s}</span>`
+const t = (s: string) => `<span class="text-slate-700 dark:text-slate-200">${s}</span>`
+
+const lines = [
+  c('# 计算斐波那契数列'),
+  `${k('def')} ${f('fib')}${t('(n):')}`,
+  `    ${k('if')} ${t('n &lt;')} ${n('2')}${t(':')}`,
+  `        ${k('return')} ${t('n')}`,
+  `    ${k('return')} ${f('fib')}${t('(n -')} ${n('1')}${t(') +')} ${f('fib')}${t('(n -')} ${n('2')}${t(')')}`,
+  '',
+  `${f('print')}${t('(')}${f('fib')}${t('(')}${n('10')}${t('))')}`
+]
+</script>
diff --git a/docs/src/components/SiteFooter.vue b/docs/src/components/SiteFooter.vue
index 2185115e..999cda50 100644
--- a/docs/src/components/SiteFooter.vue
+++ b/docs/src/components/SiteFooter.vue
@@ -1,14 +1,15 @@
 <template>
-  <footer class="border-t border-gray-200 dark:border-gray-800 mt-20">
-    <div class="max-w-6xl mx-auto px-4 py-10 flex flex-col sm:flex-row items-center justify-between gap-4 text-sm text-gray-500 dark:text-gray-400">
-      <div class="flex items-center gap-2">
+  <footer class="border-t border-slate-200 dark:border-slate-800 mt-24">
+    <div class="max-w-6xl mx-auto px-5 py-12 flex flex-col sm:flex-row items-center justify-between gap-5 text-sm text-slate-500 dark:text-slate-400">
+      <div class="flex items-center gap-2.5">
         <img src="/logo.svg" alt="CodeForge" class="w-6 h-6"/>
-        <span>© {{ year }} CodeForge · All Rights Reserved.</span>
+        <span class="font-medium text-slate-700 dark:text-slate-300">CodeForge</span>
+        <span class="text-slate-400 dark:text-slate-500">© {{ year }}</span>
       </div>
-      <div class="flex items-center gap-4">
-        <a class="hover:text-brand-600 dark:hover:text-brand-400" href="https://github.com/devlive-community/codeforge" target="_blank" rel="noopener">GitHub</a>
-        <RouterLink class="hover:text-brand-600 dark:hover:text-brand-400" to="/download">下载</RouterLink>
-        <RouterLink class="hover:text-brand-600 dark:hover:text-brand-400" to="/release">发布日志</RouterLink>
+      <div class="flex items-center gap-6">
+        <a class="hover:text-brand-600 dark:hover:text-brand-400 transition-colors" href="https://github.com/devlive-community/codeforge" target="_blank" rel="noopener">GitHub</a>
+        <RouterLink class="hover:text-brand-600 dark:hover:text-brand-400 transition-colors" to="/download">下载</RouterLink>
+        <RouterLink class="hover:text-brand-600 dark:hover:text-brand-400 transition-colors" to="/release">发布日志</RouterLink>
       </div>
     </div>
   </footer>
diff --git a/docs/src/components/SiteHeader.vue b/docs/src/components/SiteHeader.vue
index 3557a919..4df36614 100644
--- a/docs/src/components/SiteHeader.vue
+++ b/docs/src/components/SiteHeader.vue
@@ -1,34 +1,32 @@
 <template>
-  <header class="sticky top-0 z-40 backdrop-blur bg-white/80 dark:bg-gray-900/80 border-b border-gray-200 dark:border-gray-800">
-    <!-- 公告条 -->
-    <div v-if="latestRelease" class="bg-brand-600 text-white text-center text-sm py-1.5 px-4">
-      💗 CodeForge <em class="not-italic font-semibold">{{ latestRelease.version }}</em> 已发布，
-      <a class="underline hover:text-brand-100" href="https://github.com/devlive-community/codeforge" target="_blank" rel="noopener">前往 GitHub 支持我们</a> ❤️
-    </div>
-
-    <nav class="max-w-6xl mx-auto px-4 h-14 flex items-center gap-6">
-      <RouterLink to="/" class="flex items-center gap-2 font-bold text-gray-900 dark:text-gray-100">
+  <header class="sticky top-0 z-40 border-b border-slate-200/70 dark:border-slate-800/70 bg-white/70 dark:bg-slate-950/70 backdrop-blur-xl">
+    <nav class="max-w-6xl mx-auto px-5 h-16 flex items-center gap-8">
+      <RouterLink to="/" class="flex items-center gap-2.5 font-semibold text-slate-900 dark:text-white tracking-tight">
         <img src="/logo.svg" alt="CodeForge" class="w-7 h-7"/>
         <span>CodeForge</span>
       </RouterLink>
 
-      <div class="flex items-center gap-1 text-sm ml-2">
+      <div class="hidden sm:flex items-center gap-1 text-[15px]">
         <RouterLink v-for="l in links" :key="l.to" :to="l.to"
-                    class="px-3 py-1.5 rounded-lg text-gray-600 dark:text-gray-300 hover:bg-gray-100 dark:hover:bg-gray-800 transition-colors"
-                    active-class="text-brand-600 dark:text-brand-400 font-medium">
+                    class="px-3 py-2 rounded-lg text-slate-600 dark:text-slate-300 hover:text-slate-900 dark:hover:text-white hover:bg-slate-100 dark:hover:bg-slate-800/60 transition-colors"
+                    active-class="!text-brand-600 dark:!text-brand-400">
           {{ l.text }}
         </RouterLink>
       </div>
 
-      <div class="ml-auto flex items-center gap-2">
+      <div class="ml-auto flex items-center gap-1">
         <a href="https://github.com/devlive-community/codeforge" target="_blank" rel="noopener"
-           class="p-2 rounded-lg text-gray-500 hover:text-gray-900 dark:text-gray-400 dark:hover:text-gray-100 hover:bg-gray-100 dark:hover:bg-gray-800 transition-colors"
+           class="p-2 rounded-lg text-slate-500 hover:text-slate-900 dark:text-slate-400 dark:hover:text-white hover:bg-slate-100 dark:hover:bg-slate-800/60 transition-colors"
            aria-label="GitHub">
-          <svg class="w-5 h-5" viewBox="0 0 24 24" fill="currentColor">
+          <svg class="w-[18px] h-[18px]" viewBox="0 0 24 24" fill="currentColor">
             <path d="M12 2C6.48 2 2 6.58 2 12.26c0 4.5 2.87 8.32 6.84 9.67.5.1.68-.22.68-.49 0-.24-.01-.87-.01-1.71-2.78.62-3.37-1.37-3.37-1.37-.45-1.18-1.11-1.5-1.11-1.5-.91-.64.07-.62.07-.62 1 .07 1.53 1.06 1.53 1.06.89 1.56 2.34 1.11 2.91.85.09-.66.35-1.11.63-1.37-2.22-.26-4.56-1.14-4.56-5.07 0-1.12.39-2.03 1.03-2.75-.1-.26-.45-1.3.1-2.71 0 0 .84-.27 2.75 1.05A9.36 9.36 0 0 1 12 7.07c.85 0 1.71.12 2.51.34 1.91-1.32 2.75-1.05 2.75-1.05.55 1.41.2 2.45.1 2.71.64.72 1.03 1.63 1.03 2.75 0 3.94-2.34 4.81-4.57 5.06.36.32.68.94.68 1.9 0 1.37-.01 2.48-.01 2.82 0 .27.18.6.69.49A10.02 10.02 0 0 0 22 12.26C22 6.58 17.52 2 12 2z"/>
           </svg>
         </a>
         <ThemeToggle/>
+        <RouterLink to="/download"
+                    class="ml-2 hidden sm:inline-flex px-4 py-2 rounded-lg bg-slate-900 dark:bg-white text-white dark:text-slate-900 text-sm font-medium hover:opacity-90 transition-opacity">
+          下载
+        </RouterLink>
       </div>
     </nav>
   </header>
@@ -36,7 +34,6 @@
 
 <script setup lang="ts">
 import ThemeToggle from './ThemeToggle.vue'
-import {latestRelease} from '../content/releases'
 
 const links = [
   {to: '/download', text: '下载'},
diff --git a/docs/src/layouts/DocLayout.vue b/docs/src/layouts/DocLayout.vue
index 4ae6f8c9..39e3ca76 100644
--- a/docs/src/layouts/DocLayout.vue
+++ b/docs/src/layouts/DocLayout.vue
@@ -1,20 +1,20 @@
 <template>
-  <div class="max-w-6xl mx-auto px-4 py-8 grid grid-cols-1 lg:grid-cols-[220px_minmax(0,1fr)] gap-8">
+  <div class="max-w-6xl mx-auto px-5 py-10 grid grid-cols-1 lg:grid-cols-[200px_minmax(0,1fr)] gap-10">
     <!-- 版本侧栏 -->
     <aside class="lg:sticky lg:top-24 lg:self-start">
-      <p class="px-3 text-xs font-semibold uppercase tracking-wide text-gray-400 mb-2">发布日志</p>
-      <nav class="space-y-0.5">
+      <p class="px-3 text-xs font-semibold uppercase tracking-wider text-slate-400 mb-3">发布日志</p>
+      <nav class="space-y-0.5 lg:max-h-[70vh] lg:overflow-y-auto">
         <RouterLink v-for="r in releases" :key="r.version"
                     :to="`/release/${r.version}`"
-                    class="block px-3 py-1.5 rounded-lg text-sm text-gray-600 dark:text-gray-300 hover:bg-gray-100 dark:hover:bg-gray-800 transition-colors"
-                    active-class="bg-brand-50 dark:bg-brand-900/30 text-brand-700 dark:text-brand-300 font-medium">
-          {{ r.version }}
+                    class="block px-3 py-1.5 rounded-lg text-sm text-slate-600 dark:text-slate-400 hover:text-slate-900 dark:hover:text-white hover:bg-slate-100 dark:hover:bg-slate-800/60 transition-colors"
+                    active-class="!bg-brand-50 dark:!bg-brand-900/30 !text-brand-700 dark:!text-brand-300 font-medium">
+          v{{ r.version }}
         </RouterLink>
       </nav>
     </aside>
 
     <!-- 正文 -->
-    <article class="prose-doc min-w-0">
+    <article class="prose-doc min-w-0 max-w-3xl">
       <slot/>
     </article>
   </div>
diff --git a/docs/src/pages/Download.vue b/docs/src/pages/Download.vue
index 54f897a5..746bdc0f 100644
--- a/docs/src/pages/Download.vue
+++ b/docs/src/pages/Download.vue
@@ -1,35 +1,49 @@
 <template>
-  <section class="max-w-3xl mx-auto px-4 py-16 text-center">
-    <h1 class="text-3xl font-bold text-gray-900 dark:text-gray-100">下载 CodeForge</h1>
-    <p class="mt-4 text-gray-600 dark:text-gray-400">
-      当前最新版本
-      <img class="inline-block align-middle" alt="latest release"
-           src="https://img.shields.io/github/v/release/devlive-community/codeforge.svg"/>
-      <template v-if="latestRelease">
-        ，详见 <RouterLink class="text-brand-600 dark:text-brand-400 hover:underline" :to="`/release/${latestRelease.version}`">发布说明</RouterLink>。
-      </template>
-    </p>
+  <section class="max-w-3xl mx-auto px-5 py-20">
+    <div class="text-center">
+      <h1 class="text-4xl font-extrabold tracking-tight text-slate-900 dark:text-white">下载 CodeForge</h1>
+      <p class="mt-4 text-slate-600 dark:text-slate-400">
+        当前最新版本
+        <img class="inline-block align-middle h-5" alt="latest release"
+             src="https://img.shields.io/github/v/release/devlive-community/codeforge.svg"/>
+        <template v-if="latestRelease">
+          ，详见
+          <RouterLink class="text-brand-600 dark:text-brand-400 hover:underline" :to="`/release/${latestRelease.version}`">发布说明</RouterLink>。
+        </template>
+      </p>
+    </div>
 
-    <div class="mt-10 grid grid-cols-1 sm:grid-cols-2 gap-4">
-      <div v-for="p in platforms" :key="p.name"
-           class="p-6 rounded-2xl border border-gray-200 dark:border-gray-800">
-        <div class="text-3xl mb-2">{{ p.icon }}</div>
-        <div class="font-semibold text-gray-900 dark:text-gray-100">{{ p.name }}</div>
-      </div>
+    <div class="mt-12 grid sm:grid-cols-2 gap-4">
+      <a v-for="p in platforms" :key="p.name"
+         href="https://github.com/devlive-community/codeforge/releases/latest" target="_blank" rel="noopener"
+         class="group flex items-center gap-4 p-5 rounded-2xl border border-slate-200 dark:border-slate-800 bg-white dark:bg-slate-900/40 hover:border-brand-300 dark:hover:border-brand-600 hover:shadow-soft transition-all">
+        <div class="w-11 h-11 rounded-xl bg-slate-100 dark:bg-slate-800 flex items-center justify-center text-slate-700 dark:text-slate-200" v-html="p.icon"></div>
+        <div>
+          <div class="font-semibold text-slate-900 dark:text-white">{{ p.name }}</div>
+          <div class="text-sm text-slate-500 dark:text-slate-400">{{ p.note }}</div>
+        </div>
+        <span class="ml-auto text-slate-300 group-hover:text-brand-500 transition-colors">↓</span>
+      </a>
     </div>
 
-    <a href="https://github.com/devlive-community/codeforge/releases" target="_blank" rel="noopener"
-       class="inline-block mt-10 px-8 py-4 rounded-xl bg-green-500 hover:bg-green-600 text-white text-lg font-medium shadow-lg shadow-green-500/20 transition-colors">
-      点我前往下载
-    </a>
+    <div class="mt-10 text-center">
+      <a href="https://github.com/devlive-community/codeforge/releases" target="_blank" rel="noopener"
+         class="inline-flex items-center gap-2 text-sm text-slate-500 dark:text-slate-400 hover:text-brand-600 dark:hover:text-brand-400 transition-colors">
+        查看全部历史版本与安装包
+        <span>→</span>
+      </a>
+    </div>
   </section>
 </template>
 
 <script setup lang="ts">
 import {latestRelease} from '../content/releases'
 
+const win = `<svg class="w-6 h-6" viewBox="0 0 24 24" fill="currentColor"><path d="M3 5.6 10.2 4.6v6.7H3zM10.2 12v6.7L3 17.7V12zM11.1 4.5 21 3v8.3h-9.9zM21 12.7V21l-9.9-1.5V12.7z"/></svg>`
+const mac = `<svg class="w-6 h-6" viewBox="0 0 24 24" fill="currentColor"><path d="M16.3 1.4c.1 1-.3 2-.9 2.8-.7.8-1.7 1.4-2.7 1.3-.1-1 .4-2 .9-2.7.7-.8 1.8-1.4 2.7-1.4zM19 17.2c-.5 1.1-.7 1.6-1.3 2.6-.9 1.4-2.1 3.1-3.7 3.1-1.4 0-1.7-.9-3.6-.9s-2.3.9-3.6.9c-1.5 0-2.7-1.5-3.6-2.9C.7 16.3.4 12 2 9.5c.9-1.4 2.5-2.3 4-2.3 1.5 0 2.5 1 3.7 1 1.2 0 1.9-1 3.7-1 1.3 0 2.7.7 3.7 2-3.2 1.8-2.7 6.4.2 8z"/></svg>`
+
 const platforms = [
-  {name: '适配 Windows', icon: '🪟'},
-  {name: '适配 macOS', icon: '🍎'}
+  {name: 'Windows', note: '.msi / .exe 安装包', icon: win},
+  {name: 'macOS', note: 'Apple Silicon & Intel', icon: mac}
 ]
 </script>
diff --git a/docs/src/pages/Home.vue b/docs/src/pages/Home.vue
index 770f598d..40370f80 100644
--- a/docs/src/pages/Home.vue
+++ b/docs/src/pages/Home.vue
@@ -1,50 +1,108 @@
 <template>
   <!-- Hero -->
   <section class="relative overflow-hidden">
-    <div class="absolute inset-0 -z-10 bg-gradient-to-b from-brand-50/60 to-transparent dark:from-brand-900/20"></div>
-    <div class="max-w-6xl mx-auto px-4 pt-20 pb-16 text-center">
-      <img src="/logo.svg" alt="CodeForge" class="w-20 h-20 mx-auto mb-6"/>
-      <h1 class="text-4xl sm:text-5xl font-extrabold tracking-tight text-gray-900 dark:text-gray-100">
-        轻量级桌面代码执行器
-      </h1>
-      <p class="mt-5 max-w-2xl mx-auto text-lg text-gray-600 dark:text-gray-400">
-        轻量级、高性能的桌面代码执行器，专为开发者、学生和编程爱好者设计。
-      </p>
-      <div class="mt-8 flex items-center justify-center gap-3">
-        <RouterLink to="/download"
-                    class="px-6 py-3 rounded-xl bg-brand-600 hover:bg-brand-700 text-white font-medium shadow-lg shadow-brand-600/20 transition-colors">
-          立即下载
+    <!-- 背景装饰 -->
+    <div class="pointer-events-none absolute inset-0 -z-10">
+      <div class="absolute left-1/2 top-[-12rem] h-[34rem] w-[34rem] -translate-x-1/2 rounded-full bg-brand-400/15 blur-3xl"></div>
+      <div class="absolute inset-0 bg-[linear-gradient(to_right,rgba(148,163,184,.07)_1px,transparent_1px),linear-gradient(to_bottom,rgba(148,163,184,.07)_1px,transparent_1px)] bg-[size:40px_40px] [mask-image:radial-gradient(ellipse_at_center,black,transparent_75%)]"></div>
+    </div>
+
+    <div class="max-w-6xl mx-auto px-5 pt-20 pb-16 grid lg:grid-cols-2 gap-12 items-center">
+      <div>
+        <RouterLink v-if="latestRelease" :to="`/release/${latestRelease.version}`"
+                    class="inline-flex items-center gap-2 rounded-full border border-slate-200 dark:border-slate-700 bg-white/60 dark:bg-slate-900/60 px-3 py-1 text-sm text-slate-600 dark:text-slate-300 hover:border-brand-300 dark:hover:border-brand-600 transition-colors">
+          <span class="w-1.5 h-1.5 rounded-full bg-brand-500"></span>
+          v{{ latestRelease.version }} 已发布
+          <span class="text-slate-400">→</span>
         </RouterLink>
-        <a href="https://github.com/devlive-community/codeforge" target="_blank" rel="noopener"
-           class="px-6 py-3 rounded-xl border border-gray-300 dark:border-gray-700 text-gray-700 dark:text-gray-200 hover:bg-gray-50 dark:hover:bg-gray-800 font-medium transition-colors">
-          了解更多
-        </a>
+
+        <h1 class="mt-6 text-[2.75rem] leading-[1.1] sm:text-6xl font-extrabold tracking-tight text-slate-900 dark:text-white">
+          轻量级桌面<br/>代码执行器
+        </h1>
+        <p class="mt-6 max-w-md text-lg text-slate-600 dark:text-slate-400 leading-relaxed">
+          高性能、可扩展的桌面代码执行器，集编辑、运行、调试、数据库与 Git 工作台于一身，专为开发者、学生和编程爱好者打造。
+        </p>
+
+        <div class="mt-8 flex flex-wrap items-center gap-3">
+          <RouterLink to="/download"
+                      class="px-6 py-3 rounded-xl bg-slate-900 dark:bg-white text-white dark:text-slate-900 font-medium shadow-soft hover:opacity-90 transition-opacity">
+            立即下载
+          </RouterLink>
+          <a href="https://github.com/devlive-community/codeforge" target="_blank" rel="noopener"
+             class="px-6 py-3 rounded-xl border border-slate-300 dark:border-slate-700 text-slate-700 dark:text-slate-200 font-medium hover:bg-slate-50 dark:hover:bg-slate-800/60 transition-colors">
+            在 GitHub 查看
+          </a>
+        </div>
+
+        <div class="mt-10 flex flex-wrap items-center gap-x-5 gap-y-2 text-sm text-slate-400">
+          <span class="text-slate-400/80">支持</span>
+          <span v-for="lang in langs" :key="lang" class="text-slate-500 dark:text-slate-400">{{ lang }}</span>
+          <span class="text-slate-400/80">等数十种语言</span>
+        </div>
+      </div>
+
+      <div class="lg:pl-6">
+        <CodeWindow/>
       </div>
     </div>
   </section>
 
   <!-- 特性 -->
-  <section class="max-w-6xl mx-auto px-4 py-12">
-    <div class="text-center mb-12">
-      <p class="text-brand-600 dark:text-brand-400 font-semibold">核心优势</p>
-      <h2 class="mt-1 text-3xl font-bold text-gray-900 dark:text-gray-100">为什么选择我们</h2>
-      <p class="mt-3 text-gray-600 dark:text-gray-400">轻量级、高性能，专为开发者、学生和编程爱好者设计。</p>
+  <section class="max-w-6xl mx-auto px-5 py-16">
+    <div class="max-w-2xl mb-12">
+      <p class="text-sm font-semibold text-brand-600 dark:text-brand-400">核心优势</p>
+      <h2 class="mt-2 text-3xl font-bold tracking-tight text-slate-900 dark:text-white">一个应用，覆盖完整开发流</h2>
     </div>
-    <div class="grid grid-cols-1 md:grid-cols-3 gap-6">
+    <div class="grid sm:grid-cols-2 lg:grid-cols-3 gap-5">
       <div v-for="f in features" :key="f.title"
-           class="p-6 rounded-2xl border border-gray-200 dark:border-gray-800 hover:border-brand-300 dark:hover:border-brand-700 hover:shadow-lg transition-all">
-        <div class="w-11 h-11 rounded-xl bg-brand-50 dark:bg-brand-900/40 flex items-center justify-center text-2xl mb-4">{{ f.icon }}</div>
-        <h3 class="font-semibold text-lg text-gray-900 dark:text-gray-100">{{ f.title }}</h3>
-        <p class="mt-2 text-gray-600 dark:text-gray-400">{{ f.desc }}</p>
+           class="group p-6 rounded-2xl border border-slate-200 dark:border-slate-800 bg-white dark:bg-slate-900/40 hover:shadow-soft hover:border-slate-300 dark:hover:border-slate-700 transition-all">
+        <div class="w-10 h-10 rounded-xl bg-brand-50 dark:bg-brand-900/30 text-brand-600 dark:text-brand-400 flex items-center justify-center" v-html="f.icon"></div>
+        <h3 class="mt-4 font-semibold text-lg text-slate-900 dark:text-white">{{ f.title }}</h3>
+        <p class="mt-2 text-slate-600 dark:text-slate-400 leading-relaxed">{{ f.desc }}</p>
       </div>
     </div>
   </section>
 </template>
 
 <script setup lang="ts">
+import CodeWindow from '../components/CodeWindow.vue'
+import {latestRelease} from '../content/releases'
+
+const langs = ['Python', 'Rust', 'Go', 'JavaScript', 'Java', 'C/C++']
+
+const i = (path: string) =>
+  `<svg class="w-5 h-5" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round">${path}</svg>`
+
 const features = [
-  {icon: '⚡', title: '高性能', desc: '可扩展的语言支持系统，运行迅捷。'},
-  {icon: '🖱️', title: '操作简洁', desc: '一键运行代码，所见即所得。'},
-  {icon: '🧩', title: '功能丰富', desc: '内置编辑、调试、数据库与 Git 工作台。'}
+  {
+    title: '极速运行',
+    desc: '一键运行任意语言，可扩展的语言支持系统，启动与执行都很迅捷。',
+    icon: i('<path d="M13 2 4.5 13.5H11l-1 8.5 8.5-11.5H12z"/>')
+  },
+  {
+    title: '智能编辑',
+    desc: 'LSP 补全、跳转、诊断，符号大纲、面包屑、多光标与代码片段一应俱全。',
+    icon: i('<path d="m18 16 4-4-4-4"/><path d="m6 8-4 4 4 4"/><path d="m14.5 4-5 16"/>')
+  },
+  {
+    title: '可视化调试',
+    desc: '基于 DAP 的断点调试，变量、调用栈、监视与悬停求值，无需切到命令行。',
+    icon: i('<rect x="3" y="11" width="18" height="10" rx="2"/><path d="M7 11V7a5 5 0 0 1 10 0v4"/>')
+  },
+  {
+    title: '数据库工作台',
+    desc: '多数据源连接、SQL 执行与结果导出、ER 图与交互式事务，数据开发更顺手。',
+    icon: i('<ellipse cx="12" cy="5" rx="9" ry="3"/><path d="M3 5v14a9 3 0 0 0 18 0V5"/><path d="M3 12a9 3 0 0 0 18 0"/>')
+  },
+  {
+    title: 'Git 工作台',
+    desc: '暂存、提交、分支、分支图、变基、cherry-pick、子模块与工作树，全部图形化。',
+    icon: i('<circle cx="6" cy="6" r="3"/><circle cx="6" cy="18" r="3"/><circle cx="18" cy="8" r="3"/><path d="M6 9v6"/><path d="M18 11a6 6 0 0 1-6 6H9"/>')
+  },
+  {
+    title: 'AI 辅助',
+    desc: '代码预测、解释、生成测试与格式化，让常见任务交给 AI 一步完成。',
+    icon: i('<path d="M12 3v4"/><path d="M12 17v4"/><path d="m6 6 1.5 1.5"/><path d="M16.5 16.5 18 18"/><circle cx="12" cy="12" r="4"/>')
+  }
 ]
 </script>
diff --git a/docs/src/pages/ReleaseList.vue b/docs/src/pages/ReleaseList.vue
index 77722f21..b33ddfd0 100644
--- a/docs/src/pages/ReleaseList.vue
+++ b/docs/src/pages/ReleaseList.vue
@@ -1,11 +1,13 @@
 <template>
   <h1>发布日志</h1>
-  <p>选择一个版本查看详细更新内容。</p>
-  <ul>
-    <li v-for="r in releases" :key="r.version">
-      <RouterLink :to="`/release/${r.version}`">{{ r.title || r.version }}</RouterLink>
-    </li>
-  </ul>
+  <p>每个版本的更新内容如下，点击查看详情。</p>
+  <div class="not-prose mt-6 space-y-2">
+    <RouterLink v-for="r in releases" :key="r.version" :to="`/release/${r.version}`"
+                class="flex items-center justify-between px-4 py-3 rounded-xl border border-slate-200 dark:border-slate-800 hover:border-brand-300 dark:hover:border-brand-600 hover:shadow-soft transition-all">
+      <span class="font-medium text-slate-900 dark:text-white">v{{ r.version }}</span>
+      <span class="text-slate-400">→</span>
+    </RouterLink>
+  </div>
 </template>
 
 <script setup lang="ts">
diff --git a/docs/src/styles/main.css b/docs/src/styles/main.css
index 327ce49b..e25fdabf 100644
--- a/docs/src/styles/main.css
+++ b/docs/src/styles/main.css
@@ -10,56 +10,79 @@ html {
   scroll-behavior: smooth;
 }
 
-/* 发布日志正文排版（Markdown 渲染结果）。设计阶段再细化。 */
+body {
+  @apply font-sans antialiased;
+}
+
+/* 发布日志正文排版（Markdown 渲染结果） */
 .prose-doc {
-  @apply text-gray-700 dark:text-gray-300 leading-7;
+  @apply text-slate-700 dark:text-slate-300 leading-7 text-[15px];
 }
 .prose-doc h1 {
-  @apply text-3xl font-bold text-gray-900 dark:text-gray-100 mt-2 mb-6 scroll-mt-24;
+  @apply text-3xl font-bold tracking-tight text-slate-900 dark:text-white mt-2 mb-6 scroll-mt-24;
 }
 .prose-doc h2 {
-  @apply text-2xl font-semibold text-gray-900 dark:text-gray-100 mt-10 mb-4 pb-2 border-b border-gray-200 dark:border-gray-800 scroll-mt-24;
+  @apply text-xl font-semibold text-slate-900 dark:text-white mt-12 mb-4 pb-2 border-b border-slate-200 dark:border-slate-800 scroll-mt-24;
 }
 .prose-doc h3 {
-  @apply text-xl font-semibold text-gray-900 dark:text-gray-100 mt-8 mb-3 scroll-mt-24;
+  @apply text-lg font-semibold text-slate-900 dark:text-white mt-8 mb-3 scroll-mt-24;
 }
 .prose-doc p {
   @apply my-4;
 }
 .prose-doc a {
-  @apply text-brand-600 dark:text-brand-400 hover:underline;
+  @apply text-brand-600 dark:text-brand-400 font-medium hover:underline underline-offset-2;
+}
+.prose-doc strong {
+  @apply font-semibold text-slate-900 dark:text-slate-100;
 }
 .prose-doc ul {
-  @apply list-disc pl-6 my-4 space-y-1.5;
+  @apply list-disc pl-5 my-4 space-y-2 marker:text-slate-300 dark:marker:text-slate-600;
 }
 .prose-doc ol {
-  @apply list-decimal pl-6 my-4 space-y-1.5;
+  @apply list-decimal pl-5 my-4 space-y-2 marker:text-slate-400;
+}
+.prose-doc li > ul,
+.prose-doc li > ol {
+  @apply my-2;
 }
 .prose-doc code {
-  @apply px-1.5 py-0.5 rounded bg-gray-100 dark:bg-gray-800 text-brand-600 dark:text-brand-300 text-[0.9em] font-mono;
+  @apply px-1.5 py-0.5 rounded-md bg-slate-100 dark:bg-slate-800 text-brand-600 dark:text-brand-300 text-[0.85em] font-mono;
 }
 .prose-doc pre {
-  @apply p-4 rounded-lg bg-gray-900 text-gray-100 overflow-x-auto my-5 text-sm;
+  @apply p-4 rounded-xl bg-slate-900 dark:bg-slate-900 border border-slate-800 text-slate-100 overflow-x-auto my-5 text-sm leading-relaxed;
 }
 .prose-doc pre code {
-  @apply bg-transparent text-gray-100 p-0;
+  @apply bg-transparent text-slate-100 p-0 text-[0.85em];
 }
 .prose-doc blockquote {
-  @apply border-l-4 border-brand-300 dark:border-brand-700 pl-4 italic text-gray-500 dark:text-gray-400 my-4;
+  @apply border-l-2 border-brand-400 dark:border-brand-600 pl-4 my-5 text-slate-500 dark:text-slate-400;
 }
 .prose-doc table {
-  @apply w-full my-5 text-sm border-collapse;
+  @apply w-full my-6 text-sm border border-slate-200 dark:border-slate-800 rounded-lg overflow-hidden border-separate border-spacing-0;
+}
+.prose-doc thead {
+  @apply bg-slate-50 dark:bg-slate-800/60;
 }
 .prose-doc th,
 .prose-doc td {
-  @apply border border-gray-200 dark:border-gray-700 px-3 py-2 text-left;
+  @apply border-b border-slate-200 dark:border-slate-800 px-3.5 py-2.5 text-left;
+}
+.prose-doc tbody tr:last-child td {
+  @apply border-b-0;
 }
 .prose-doc th {
-  @apply bg-gray-50 dark:bg-gray-800 font-semibold;
+  @apply font-semibold text-slate-700 dark:text-slate-200;
 }
 .prose-doc hr {
-  @apply my-8 border-gray-200 dark:border-gray-800;
+  @apply my-10 border-slate-200 dark:border-slate-800;
 }
 .prose-doc img {
-  @apply inline-block max-w-full;
+  @apply inline-block max-w-full align-middle;
+}
+
+/* 锚点链接（markdown-it-anchor headerLink）：去掉默认下划线 */
+.prose-doc :where(h1, h2, h3) a {
+  @apply no-underline text-inherit;
+  font-weight: inherit;
 }
diff --git a/docs/tailwind.config.js b/docs/tailwind.config.js
index eb196835..c2f4de5e 100644
--- a/docs/tailwind.config.js
+++ b/docs/tailwind.config.js
@@ -4,12 +4,20 @@ export default {
   content: ['./index.html', './src/**/*.{vue,ts,md}'],
   theme: {
     extend: {
+      fontFamily: {
+        sans: ['Inter', 'system-ui', '-apple-system', 'Segoe UI', 'Roboto', '"PingFang SC"', '"Microsoft YaHei"', 'sans-serif'],
+        mono: ['"JetBrains Mono"', 'ui-monospace', 'SFMono-Regular', 'Menlo', 'monospace']
+      },
       colors: {
         brand: {
           50: '#eef2ff', 100: '#e0e7ff', 200: '#c7d2fe', 300: '#a5b4fc',
           400: '#818cf8', 500: '#6366f1', 600: '#4f46e5', 700: '#4338ca',
           800: '#3730a3', 900: '#312e81'
         }
+      },
+      boxShadow: {
+        soft: '0 1px 2px rgba(15,23,42,.04), 0 8px 24px rgba(15,23,42,.06)',
+        glow: '0 20px 60px -20px rgba(79,70,229,.35)'
       }
     }
   },

From c4cf94e0910e10c45319eb7f3450bcc7ab2708ef Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Fri, 26 Jun 2026 14:01:22 +0800
Subject: [PATCH 20/20] =?UTF-8?q?feat(docs):=20=E9=87=8D=E5=81=9A=E7=82=AB?=
 =?UTF-8?q?=E9=85=B7=E7=A7=91=E6=8A=80=E6=84=9F=E8=A7=86=E8=A7=89=E5=B9=B6?=
 =?UTF-8?q?=E6=8E=A5=E5=85=A5=20i18n=EF=BC=88=E4=B8=AD/=E8=8B=B1=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 深色发光 Hero：极光光晕、动态网格、渐变标题、玻璃拟态代码窗（旋转描边+悬浮动效）
- 渐变 CTA + shimmer、动画版本徽标、语言滚动条 marquee
- 特性卡渐变图标环 + 悬浮上移；统一深浅色科技风
- 接入 vue-i18n：导航/Hero/特性/下载/页脚全量中英文案，顶栏中英切换并持久化
- 新增 .claude/launch.json 便于本地预览 docs
---
 docs/src/components/CodeWindow.vue |  60 +++++++--------
 docs/src/components/LangToggle.vue |  18 +++++
 docs/src/components/SiteFooter.vue |  11 ++-
 docs/src/components/SiteHeader.vue |  21 +++---
 docs/src/i18n.ts                   | 100 +++++++++++++++++++++++++
 docs/src/main.ts                   |   4 +-
 docs/src/pages/Download.vue        |  25 ++++---
 docs/src/pages/Home.vue            | 116 +++++++++++++----------------
 docs/src/pages/ReleaseList.vue     |   9 ++-
 docs/src/styles/main.css           |  55 ++++++++++++++
 10 files changed, 294 insertions(+), 125 deletions(-)
 create mode 100644 docs/src/components/LangToggle.vue
 create mode 100644 docs/src/i18n.ts

diff --git a/docs/src/components/CodeWindow.vue b/docs/src/components/CodeWindow.vue
index 3d09e206..04da76f2 100644
--- a/docs/src/components/CodeWindow.vue
+++ b/docs/src/components/CodeWindow.vue
@@ -1,43 +1,45 @@
 <template>
-  <div class="rounded-xl border border-slate-200 dark:border-slate-800 bg-white dark:bg-slate-900 shadow-soft overflow-hidden">
-    <!-- 标题栏 -->
-    <div class="flex items-center gap-2 px-4 h-10 border-b border-slate-200 dark:border-slate-800 bg-slate-50 dark:bg-slate-900/80">
-      <span class="w-3 h-3 rounded-full bg-red-400"></span>
-      <span class="w-3 h-3 rounded-full bg-amber-400"></span>
-      <span class="w-3 h-3 rounded-full bg-green-400"></span>
-      <span class="ml-3 text-xs text-slate-400 font-mono">main.py</span>
-    </div>
-    <!-- 代码区 -->
-    <div class="flex font-mono text-[13px] leading-6">
-      <div class="select-none px-3 py-4 text-right text-slate-300 dark:text-slate-600 bg-slate-50/60 dark:bg-slate-900/40">
-        <div v-for="n in lines.length" :key="n">{{ n }}</div>
+  <div class="glow-border rounded-2xl animate-float">
+    <div class="rounded-2xl border border-white/10 bg-slate-900/80 backdrop-blur-xl shadow-2xl overflow-hidden">
+      <!-- 标题栏 -->
+      <div class="flex items-center gap-2 px-4 h-10 border-b border-white/10 bg-white/5">
+        <span class="w-3 h-3 rounded-full bg-red-400/90"></span>
+        <span class="w-3 h-3 rounded-full bg-amber-400/90"></span>
+        <span class="w-3 h-3 rounded-full bg-green-400/90"></span>
+        <span class="ml-3 text-xs text-slate-400 font-mono">main.py</span>
+        <span class="ml-auto text-[10px] uppercase tracking-wider text-brand-300/80">running</span>
       </div>
-      <pre class="px-4 py-4 overflow-x-auto"><code><template v-for="(line, i) in lines" :key="i"><span v-html="line"></span>
+      <!-- 代码区 -->
+      <div class="flex font-mono text-[13px] leading-6">
+        <div class="select-none px-3 py-4 text-right text-slate-600 bg-white/5">
+          <div v-for="n in lines.length" :key="n">{{ n }}</div>
+        </div>
+        <pre class="px-4 py-4 overflow-x-auto text-slate-200"><code><template v-for="(line, i) in lines" :key="i"><span v-html="line"></span>
 </template></code></pre>
-    </div>
-    <!-- 输出区 -->
-    <div class="border-t border-slate-200 dark:border-slate-800 px-4 py-3 bg-slate-50 dark:bg-slate-900/60 font-mono text-[13px]">
-      <span class="text-slate-400">$ </span><span class="text-slate-500 dark:text-slate-400">run main.py</span>
-      <div class="mt-1 text-emerald-600 dark:text-emerald-400">fib(10) = 55</div>
+      </div>
+      <!-- 输出区 -->
+      <div class="border-t border-white/10 px-4 py-3 bg-black/30 font-mono text-[13px]">
+        <span class="text-slate-500">$</span> <span class="text-slate-400">run main.py</span>
+        <div class="mt-1 text-emerald-400">fib(10) = 55</div>
+      </div>
     </div>
   </div>
 </template>
 
 <script setup lang="ts">
-// 简单的着色行（手写 token 高亮，避免引入运行时高亮库）
-const k = (s: string) => `<span class="text-violet-500 dark:text-violet-400">${s}</span>`
-const f = (s: string) => `<span class="text-blue-500 dark:text-blue-400">${s}</span>`
-const n = (s: string) => `<span class="text-amber-600 dark:text-amber-400">${s}</span>`
-const c = (s: string) => `<span class="text-slate-400">${s}</span>`
-const t = (s: string) => `<span class="text-slate-700 dark:text-slate-200">${s}</span>`
+// 手写 token 着色（暗色），避免引入运行时高亮库
+const k = (s: string) => `<span class="text-violet-400">${s}</span>`
+const f = (s: string) => `<span class="text-cyan-400">${s}</span>`
+const n = (s: string) => `<span class="text-amber-300">${s}</span>`
+const c = (s: string) => `<span class="text-slate-500">${s}</span>`
 
 const lines = [
   c('# 计算斐波那契数列'),
-  `${k('def')} ${f('fib')}${t('(n):')}`,
-  `    ${k('if')} ${t('n &lt;')} ${n('2')}${t(':')}`,
-  `        ${k('return')} ${t('n')}`,
-  `    ${k('return')} ${f('fib')}${t('(n -')} ${n('1')}${t(') +')} ${f('fib')}${t('(n -')} ${n('2')}${t(')')}`,
+  `${k('def')} ${f('fib')}(n):`,
+  `    ${k('if')} n &lt; ${n('2')}:`,
+  `        ${k('return')} n`,
+  `    ${k('return')} ${f('fib')}(n - ${n('1')}) + ${f('fib')}(n - ${n('2')})`,
   '',
-  `${f('print')}${t('(')}${f('fib')}${t('(')}${n('10')}${t('))')}`
+  `${f('print')}(${f('fib')}(${n('10')}))`
 ]
 </script>
diff --git a/docs/src/components/LangToggle.vue b/docs/src/components/LangToggle.vue
new file mode 100644
index 00000000..37fb8f82
--- /dev/null
+++ b/docs/src/components/LangToggle.vue
@@ -0,0 +1,18 @@
+<template>
+  <button class="px-2.5 py-2 rounded-lg text-sm font-medium text-slate-500 hover:text-slate-900 dark:text-slate-400 dark:hover:text-white hover:bg-slate-100 dark:hover:bg-slate-800/60 transition-colors"
+          :aria-label="locale === 'zh' ? 'Switch to English' : '切换到中文'"
+          @click="toggle">
+    {{ locale === 'zh' ? 'EN' : '中' }}
+  </button>
+</template>
+
+<script setup lang="ts">
+import {useI18n} from 'vue-i18n'
+import {setLocale, type Locale} from '../i18n'
+
+const {locale} = useI18n()
+
+const toggle = () => {
+  setLocale((locale.value === 'zh' ? 'en' : 'zh') as Locale)
+}
+</script>
diff --git a/docs/src/components/SiteFooter.vue b/docs/src/components/SiteFooter.vue
index 999cda50..d8a00b60 100644
--- a/docs/src/components/SiteFooter.vue
+++ b/docs/src/components/SiteFooter.vue
@@ -1,20 +1,23 @@
 <template>
-  <footer class="border-t border-slate-200 dark:border-slate-800 mt-24">
+  <footer class="border-t border-slate-200 dark:border-white/10 mt-24">
     <div class="max-w-6xl mx-auto px-5 py-12 flex flex-col sm:flex-row items-center justify-between gap-5 text-sm text-slate-500 dark:text-slate-400">
       <div class="flex items-center gap-2.5">
         <img src="/logo.svg" alt="CodeForge" class="w-6 h-6"/>
         <span class="font-medium text-slate-700 dark:text-slate-300">CodeForge</span>
-        <span class="text-slate-400 dark:text-slate-500">© {{ year }}</span>
+        <span class="text-slate-400 dark:text-slate-600">© {{ year }}</span>
       </div>
       <div class="flex items-center gap-6">
         <a class="hover:text-brand-600 dark:hover:text-brand-400 transition-colors" href="https://github.com/devlive-community/codeforge" target="_blank" rel="noopener">GitHub</a>
-        <RouterLink class="hover:text-brand-600 dark:hover:text-brand-400 transition-colors" to="/download">下载</RouterLink>
-        <RouterLink class="hover:text-brand-600 dark:hover:text-brand-400 transition-colors" to="/release">发布日志</RouterLink>
+        <RouterLink class="hover:text-brand-600 dark:hover:text-brand-400 transition-colors" to="/download">{{ t('footer.download') }}</RouterLink>
+        <RouterLink class="hover:text-brand-600 dark:hover:text-brand-400 transition-colors" to="/release">{{ t('footer.releases') }}</RouterLink>
       </div>
     </div>
   </footer>
 </template>
 
 <script setup lang="ts">
+import {useI18n} from 'vue-i18n'
+
+const {t} = useI18n()
 const year = new Date().getFullYear()
 </script>
diff --git a/docs/src/components/SiteHeader.vue b/docs/src/components/SiteHeader.vue
index 4df36614..30109ac4 100644
--- a/docs/src/components/SiteHeader.vue
+++ b/docs/src/components/SiteHeader.vue
@@ -1,5 +1,5 @@
 <template>
-  <header class="sticky top-0 z-40 border-b border-slate-200/70 dark:border-slate-800/70 bg-white/70 dark:bg-slate-950/70 backdrop-blur-xl">
+  <header class="sticky top-0 z-40 border-b border-slate-200/70 dark:border-white/10 bg-white/70 dark:bg-slate-950/70 backdrop-blur-xl">
     <nav class="max-w-6xl mx-auto px-5 h-16 flex items-center gap-8">
       <RouterLink to="/" class="flex items-center gap-2.5 font-semibold text-slate-900 dark:text-white tracking-tight">
         <img src="/logo.svg" alt="CodeForge" class="w-7 h-7"/>
@@ -7,11 +7,8 @@
       </RouterLink>
 
       <div class="hidden sm:flex items-center gap-1 text-[15px]">
-        <RouterLink v-for="l in links" :key="l.to" :to="l.to"
-                    class="px-3 py-2 rounded-lg text-slate-600 dark:text-slate-300 hover:text-slate-900 dark:hover:text-white hover:bg-slate-100 dark:hover:bg-slate-800/60 transition-colors"
-                    active-class="!text-brand-600 dark:!text-brand-400">
-          {{ l.text }}
-        </RouterLink>
+        <RouterLink to="/download" class="px-3 py-2 rounded-lg text-slate-600 dark:text-slate-300 hover:text-slate-900 dark:hover:text-white hover:bg-slate-100 dark:hover:bg-slate-800/60 transition-colors" active-class="!text-brand-600 dark:!text-brand-400">{{ t('nav.download') }}</RouterLink>
+        <RouterLink to="/release" class="px-3 py-2 rounded-lg text-slate-600 dark:text-slate-300 hover:text-slate-900 dark:hover:text-white hover:bg-slate-100 dark:hover:bg-slate-800/60 transition-colors" active-class="!text-brand-600 dark:!text-brand-400">{{ t('nav.releases') }}</RouterLink>
       </div>
 
       <div class="ml-auto flex items-center gap-1">
@@ -22,10 +19,11 @@
             <path d="M12 2C6.48 2 2 6.58 2 12.26c0 4.5 2.87 8.32 6.84 9.67.5.1.68-.22.68-.49 0-.24-.01-.87-.01-1.71-2.78.62-3.37-1.37-3.37-1.37-.45-1.18-1.11-1.5-1.11-1.5-.91-.64.07-.62.07-.62 1 .07 1.53 1.06 1.53 1.06.89 1.56 2.34 1.11 2.91.85.09-.66.35-1.11.63-1.37-2.22-.26-4.56-1.14-4.56-5.07 0-1.12.39-2.03 1.03-2.75-.1-.26-.45-1.3.1-2.71 0 0 .84-.27 2.75 1.05A9.36 9.36 0 0 1 12 7.07c.85 0 1.71.12 2.51.34 1.91-1.32 2.75-1.05 2.75-1.05.55 1.41.2 2.45.1 2.71.64.72 1.03 1.63 1.03 2.75 0 3.94-2.34 4.81-4.57 5.06.36.32.68.94.68 1.9 0 1.37-.01 2.48-.01 2.82 0 .27.18.6.69.49A10.02 10.02 0 0 0 22 12.26C22 6.58 17.52 2 12 2z"/>
           </svg>
         </a>
+        <LangToggle/>
         <ThemeToggle/>
         <RouterLink to="/download"
-                    class="ml-2 hidden sm:inline-flex px-4 py-2 rounded-lg bg-slate-900 dark:bg-white text-white dark:text-slate-900 text-sm font-medium hover:opacity-90 transition-opacity">
-          下载
+                    class="ml-2 hidden sm:inline-flex px-4 py-2 rounded-lg bg-gradient-to-r from-brand-600 to-violet-600 text-white text-sm font-medium shadow-glow hover:opacity-90 transition-opacity">
+          {{ t('nav.download') }}
         </RouterLink>
       </div>
     </nav>
@@ -33,10 +31,9 @@
 </template>
 
 <script setup lang="ts">
+import {useI18n} from 'vue-i18n'
 import ThemeToggle from './ThemeToggle.vue'
+import LangToggle from './LangToggle.vue'
 
-const links = [
-  {to: '/download', text: '下载'},
-  {to: '/release', text: '发布日志'}
-]
+const {t} = useI18n()
 </script>
diff --git a/docs/src/i18n.ts b/docs/src/i18n.ts
new file mode 100644
index 00000000..1d2ab237
--- /dev/null
+++ b/docs/src/i18n.ts
@@ -0,0 +1,100 @@
+import {createI18n} from 'vue-i18n'
+
+export const SUPPORTED_LOCALES = ['zh', 'en'] as const
+export type Locale = (typeof SUPPORTED_LOCALES)[number]
+
+const messages = {
+  zh: {
+    nav: {download: '下载', releases: '发布日志'},
+    hero: {
+      badge: 'v{version} 已发布',
+      title1: '轻量级桌面',
+      title2: '代码执行器',
+      subtitle: '高性能、可扩展的桌面代码执行器，集编辑、运行、调试、数据库与 Git 工作台于一身，专为开发者、学生和编程爱好者打造。',
+      download: '立即下载',
+      github: '在 GitHub 查看',
+      langsPrefix: '支持',
+      langsSuffix: '等数十种语言'
+    },
+    features: {
+      tag: '核心优势',
+      title: '一个应用，覆盖完整开发流',
+      items: {
+        run: {title: '极速运行', desc: '一键运行任意语言，可扩展的语言支持系统，启动与执行都很迅捷。'},
+        edit: {title: '智能编辑', desc: 'LSP 补全、跳转、诊断，符号大纲、面包屑、多光标与代码片段一应俱全。'},
+        debug: {title: '可视化调试', desc: '基于 DAP 的断点调试，变量、调用栈、监视与悬停求值，无需切到命令行。'},
+        db: {title: '数据库工作台', desc: '多数据源连接、SQL 执行与结果导出、ER 图与交互式事务，数据开发更顺手。'},
+        git: {title: 'Git 工作台', desc: '暂存、提交、分支、分支图、变基、cherry-pick、子模块与工作树，全部图形化。'},
+        ai: {title: 'AI 辅助', desc: '代码预测、解释、生成测试与格式化，让常见任务交给 AI 一步完成。'}
+      }
+    },
+    download: {
+      title: '下载 CodeForge',
+      latestPrefix: '当前最新版本',
+      latestSuffix: '，详见',
+      releaseNotes: '发布说明',
+      winNote: '.msi / .exe 安装包',
+      macNote: 'Apple Silicon 与 Intel',
+      allVersions: '查看全部历史版本与安装包'
+    },
+    releaseList: {title: '发布日志', intro: '每个版本的更新内容如下，点击查看详情。'},
+    footer: {download: '下载', releases: '发布日志'}
+  },
+  en: {
+    nav: {download: 'Download', releases: 'Releases'},
+    hero: {
+      badge: 'v{version} released',
+      title1: 'Lightweight desktop',
+      title2: 'code runner',
+      subtitle: 'A fast, extensible desktop code runner — editing, running, debugging, a database console and a full Git workbench in one app. Built for developers, students and coding enthusiasts.',
+      download: 'Download now',
+      github: 'View on GitHub',
+      langsPrefix: 'Supports',
+      langsSuffix: 'and dozens more'
+    },
+    features: {
+      tag: 'Why CodeForge',
+      title: 'One app for your entire workflow',
+      items: {
+        run: {title: 'Blazing fast', desc: 'Run any language with one click. An extensible language system keeps startup and execution snappy.'},
+        edit: {title: 'Smart editing', desc: 'LSP completion, go-to, diagnostics, symbol outline, breadcrumbs, multi-cursor and snippets.'},
+        debug: {title: 'Visual debugging', desc: 'DAP-based breakpoint debugging with variables, call stack, watches and hover evaluation — no terminal needed.'},
+        db: {title: 'Database console', desc: 'Multiple data sources, SQL execution and export, ER diagrams and interactive transactions.'},
+        git: {title: 'Git workbench', desc: 'Staging, commits, branches, branch graph, rebase, cherry-pick, submodules and worktrees — all graphical.'},
+        ai: {title: 'AI assistance', desc: 'Code prediction, explanation, test generation and formatting — common tasks in a single step.'}
+      }
+    },
+    download: {
+      title: 'Download CodeForge',
+      latestPrefix: 'Latest version',
+      latestSuffix: '. See the',
+      releaseNotes: 'release notes',
+      winNote: '.msi / .exe installers',
+      macNote: 'Apple Silicon & Intel',
+      allVersions: 'Browse all releases and installers'
+    },
+    releaseList: {title: 'Releases', intro: 'Update notes for each version. Click to view details.'},
+    footer: {download: 'Download', releases: 'Releases'}
+  }
+}
+
+const stored = (): Locale => {
+  if (typeof localStorage !== 'undefined') {
+    const v = localStorage.getItem('locale')
+    if (v === 'zh' || v === 'en') return v
+  }
+  return 'zh'
+}
+
+export const i18n = createI18n({
+  legacy: false,
+  locale: stored(),
+  fallbackLocale: 'zh',
+  messages
+})
+
+export const setLocale = (l: Locale) => {
+  i18n.global.locale.value = l
+  if (typeof localStorage !== 'undefined') localStorage.setItem('locale', l)
+  if (typeof document !== 'undefined') document.documentElement.lang = l === 'zh' ? 'zh-CN' : 'en'
+}
diff --git a/docs/src/main.ts b/docs/src/main.ts
index a04e7681..29756c7f 100644
--- a/docs/src/main.ts
+++ b/docs/src/main.ts
@@ -1,13 +1,15 @@
 import {ViteSSG} from 'vite-ssg'
 import App from './App.vue'
 import {routes} from './router'
+import {i18n} from './i18n'
 import './styles/main.css'
 
 // vite-ssg：开发用 SPA，构建时把每个路由预渲染成静态 HTML
 export const createApp = ViteSSG(
   App,
   {routes, scrollBehavior: () => ({top: 0})},
-  ({router}) => {
+  ({app, router}) => {
+    app.use(i18n)
     router.afterEach((to) => {
       if (typeof document !== 'undefined' && to.meta?.title) {
         document.title = String(to.meta.title)
diff --git a/docs/src/pages/Download.vue b/docs/src/pages/Download.vue
index 746bdc0f..e3152a39 100644
--- a/docs/src/pages/Download.vue
+++ b/docs/src/pages/Download.vue
@@ -1,14 +1,14 @@
 <template>
   <section class="max-w-3xl mx-auto px-5 py-20">
     <div class="text-center">
-      <h1 class="text-4xl font-extrabold tracking-tight text-slate-900 dark:text-white">下载 CodeForge</h1>
+      <h1 class="text-4xl font-extrabold tracking-tight text-slate-900 dark:text-white">{{ t('download.title') }}</h1>
       <p class="mt-4 text-slate-600 dark:text-slate-400">
-        当前最新版本
+        {{ t('download.latestPrefix') }}
         <img class="inline-block align-middle h-5" alt="latest release"
              src="https://img.shields.io/github/v/release/devlive-community/codeforge.svg"/>
         <template v-if="latestRelease">
-          ，详见
-          <RouterLink class="text-brand-600 dark:text-brand-400 hover:underline" :to="`/release/${latestRelease.version}`">发布说明</RouterLink>。
+          {{ t('download.latestSuffix') }}
+          <RouterLink class="text-brand-600 dark:text-brand-400 hover:underline" :to="`/release/${latestRelease.version}`">{{ t('download.releaseNotes') }}</RouterLink>。
         </template>
       </p>
     </div>
@@ -16,20 +16,20 @@
     <div class="mt-12 grid sm:grid-cols-2 gap-4">
       <a v-for="p in platforms" :key="p.name"
          href="https://github.com/devlive-community/codeforge/releases/latest" target="_blank" rel="noopener"
-         class="group flex items-center gap-4 p-5 rounded-2xl border border-slate-200 dark:border-slate-800 bg-white dark:bg-slate-900/40 hover:border-brand-300 dark:hover:border-brand-600 hover:shadow-soft transition-all">
-        <div class="w-11 h-11 rounded-xl bg-slate-100 dark:bg-slate-800 flex items-center justify-center text-slate-700 dark:text-slate-200" v-html="p.icon"></div>
+         class="group flex items-center gap-4 p-5 rounded-2xl border border-slate-200 dark:border-white/10 bg-white dark:bg-white/[.03] hover:border-brand-300 dark:hover:border-brand-500/60 hover:shadow-soft transition-all">
+        <div class="w-11 h-11 rounded-xl bg-slate-100 dark:bg-white/5 flex items-center justify-center text-slate-700 dark:text-slate-200" v-html="p.icon"></div>
         <div>
           <div class="font-semibold text-slate-900 dark:text-white">{{ p.name }}</div>
-          <div class="text-sm text-slate-500 dark:text-slate-400">{{ p.note }}</div>
+          <div class="text-sm text-slate-500 dark:text-slate-400">{{ t(p.note) }}</div>
         </div>
-        <span class="ml-auto text-slate-300 group-hover:text-brand-500 transition-colors">↓</span>
+        <span class="ml-auto text-slate-300 dark:text-slate-600 group-hover:text-brand-500 transition-colors">↓</span>
       </a>
     </div>
 
     <div class="mt-10 text-center">
       <a href="https://github.com/devlive-community/codeforge/releases" target="_blank" rel="noopener"
          class="inline-flex items-center gap-2 text-sm text-slate-500 dark:text-slate-400 hover:text-brand-600 dark:hover:text-brand-400 transition-colors">
-        查看全部历史版本与安装包
+        {{ t('download.allVersions') }}
         <span>→</span>
       </a>
     </div>
@@ -37,13 +37,16 @@
 </template>
 
 <script setup lang="ts">
+import {useI18n} from 'vue-i18n'
 import {latestRelease} from '../content/releases'
 
+const {t} = useI18n()
+
 const win = `<svg class="w-6 h-6" viewBox="0 0 24 24" fill="currentColor"><path d="M3 5.6 10.2 4.6v6.7H3zM10.2 12v6.7L3 17.7V12zM11.1 4.5 21 3v8.3h-9.9zM21 12.7V21l-9.9-1.5V12.7z"/></svg>`
 const mac = `<svg class="w-6 h-6" viewBox="0 0 24 24" fill="currentColor"><path d="M16.3 1.4c.1 1-.3 2-.9 2.8-.7.8-1.7 1.4-2.7 1.3-.1-1 .4-2 .9-2.7.7-.8 1.8-1.4 2.7-1.4zM19 17.2c-.5 1.1-.7 1.6-1.3 2.6-.9 1.4-2.1 3.1-3.7 3.1-1.4 0-1.7-.9-3.6-.9s-2.3.9-3.6.9c-1.5 0-2.7-1.5-3.6-2.9C.7 16.3.4 12 2 9.5c.9-1.4 2.5-2.3 4-2.3 1.5 0 2.5 1 3.7 1 1.2 0 1.9-1 3.7-1 1.3 0 2.7.7 3.7 2-3.2 1.8-2.7 6.4.2 8z"/></svg>`
 
 const platforms = [
-  {name: 'Windows', note: '.msi / .exe 安装包', icon: win},
-  {name: 'macOS', note: 'Apple Silicon & Intel', icon: mac}
+  {name: 'Windows', note: 'download.winNote', icon: win},
+  {name: 'macOS', note: 'download.macNote', icon: mac}
 ]
 </script>
diff --git a/docs/src/pages/Home.vue b/docs/src/pages/Home.vue
index 40370f80..9f6f139b 100644
--- a/docs/src/pages/Home.vue
+++ b/docs/src/pages/Home.vue
@@ -1,108 +1,94 @@
 <template>
-  <!-- Hero -->
-  <section class="relative overflow-hidden">
-    <!-- 背景装饰 -->
+  <!-- Hero（始终深色，营造科技感） -->
+  <section class="relative isolate overflow-hidden bg-slate-950 text-white">
+    <!-- 极光光晕 -->
     <div class="pointer-events-none absolute inset-0 -z-10">
-      <div class="absolute left-1/2 top-[-12rem] h-[34rem] w-[34rem] -translate-x-1/2 rounded-full bg-brand-400/15 blur-3xl"></div>
-      <div class="absolute inset-0 bg-[linear-gradient(to_right,rgba(148,163,184,.07)_1px,transparent_1px),linear-gradient(to_bottom,rgba(148,163,184,.07)_1px,transparent_1px)] bg-[size:40px_40px] [mask-image:radial-gradient(ellipse_at_center,black,transparent_75%)]"></div>
+      <div class="absolute -top-40 left-1/4 h-[28rem] w-[28rem] rounded-full bg-brand-600/30 blur-[120px] animate-blob"></div>
+      <div class="absolute top-10 right-1/4 h-[26rem] w-[26rem] rounded-full bg-cyan-500/20 blur-[120px] animate-blob" style="animation-delay:-5s"></div>
+      <div class="absolute bottom-[-10rem] left-1/3 h-[24rem] w-[24rem] rounded-full bg-fuchsia-600/20 blur-[120px] animate-blob" style="animation-delay:-9s"></div>
     </div>
+    <!-- 网格 -->
+    <div class="pointer-events-none absolute inset-0 -z-10 bg-[linear-gradient(to_right,rgba(255,255,255,.05)_1px,transparent_1px),linear-gradient(to_bottom,rgba(255,255,255,.05)_1px,transparent_1px)] bg-[size:44px_44px] [mask-image:radial-gradient(ellipse_at_50%_30%,black,transparent_70%)]"></div>
 
-    <div class="max-w-6xl mx-auto px-5 pt-20 pb-16 grid lg:grid-cols-2 gap-12 items-center">
+    <div class="max-w-6xl mx-auto px-5 pt-24 pb-28 grid lg:grid-cols-2 gap-14 items-center">
       <div>
         <RouterLink v-if="latestRelease" :to="`/release/${latestRelease.version}`"
-                    class="inline-flex items-center gap-2 rounded-full border border-slate-200 dark:border-slate-700 bg-white/60 dark:bg-slate-900/60 px-3 py-1 text-sm text-slate-600 dark:text-slate-300 hover:border-brand-300 dark:hover:border-brand-600 transition-colors">
-          <span class="w-1.5 h-1.5 rounded-full bg-brand-500"></span>
-          v{{ latestRelease.version }} 已发布
+                    class="inline-flex items-center gap-2 rounded-full border border-white/15 bg-white/5 px-3.5 py-1.5 text-sm text-slate-200 backdrop-blur hover:border-brand-400/60 transition-colors">
+          <span class="relative flex h-2 w-2">
+            <span class="absolute inline-flex h-full w-full animate-ping rounded-full bg-brand-400 opacity-75"></span>
+            <span class="relative inline-flex h-2 w-2 rounded-full bg-brand-400"></span>
+          </span>
+          {{ t('hero.badge', {version: latestRelease.version}) }}
           <span class="text-slate-400">→</span>
         </RouterLink>
 
-        <h1 class="mt-6 text-[2.75rem] leading-[1.1] sm:text-6xl font-extrabold tracking-tight text-slate-900 dark:text-white">
-          轻量级桌面<br/>代码执行器
+        <h1 class="mt-7 text-[3rem] leading-[1.05] sm:text-[4.25rem] font-extrabold tracking-tight">
+          <span class="text-white">{{ t('hero.title1') }}</span><br/>
+          <span class="bg-gradient-to-r from-brand-300 via-violet-300 to-cyan-300 bg-clip-text text-transparent">{{ t('hero.title2') }}</span>
         </h1>
-        <p class="mt-6 max-w-md text-lg text-slate-600 dark:text-slate-400 leading-relaxed">
-          高性能、可扩展的桌面代码执行器，集编辑、运行、调试、数据库与 Git 工作台于一身，专为开发者、学生和编程爱好者打造。
-        </p>
+        <p class="mt-6 max-w-lg text-lg text-slate-300/90 leading-relaxed">{{ t('hero.subtitle') }}</p>
 
-        <div class="mt-8 flex flex-wrap items-center gap-3">
+        <div class="mt-9 flex flex-wrap items-center gap-3">
           <RouterLink to="/download"
-                      class="px-6 py-3 rounded-xl bg-slate-900 dark:bg-white text-white dark:text-slate-900 font-medium shadow-soft hover:opacity-90 transition-opacity">
-            立即下载
+                      class="shimmer px-6 py-3 rounded-xl bg-gradient-to-r from-brand-500 to-violet-600 text-white font-medium shadow-glow hover:shadow-[0_24px_70px_-18px_rgba(99,102,241,.6)] transition-shadow">
+            {{ t('hero.download') }}
           </RouterLink>
           <a href="https://github.com/devlive-community/codeforge" target="_blank" rel="noopener"
-             class="px-6 py-3 rounded-xl border border-slate-300 dark:border-slate-700 text-slate-700 dark:text-slate-200 font-medium hover:bg-slate-50 dark:hover:bg-slate-800/60 transition-colors">
-            在 GitHub 查看
+             class="px-6 py-3 rounded-xl border border-white/15 bg-white/5 text-white font-medium backdrop-blur hover:bg-white/10 transition-colors">
+            {{ t('hero.github') }}
           </a>
         </div>
-
-        <div class="mt-10 flex flex-wrap items-center gap-x-5 gap-y-2 text-sm text-slate-400">
-          <span class="text-slate-400/80">支持</span>
-          <span v-for="lang in langs" :key="lang" class="text-slate-500 dark:text-slate-400">{{ lang }}</span>
-          <span class="text-slate-400/80">等数十种语言</span>
-        </div>
       </div>
 
-      <div class="lg:pl-6">
+      <div class="lg:pl-4">
         <CodeWindow/>
       </div>
     </div>
+
+    <!-- 语言滚动条 -->
+    <div class="relative border-t border-white/10 bg-white/[.02] py-4 overflow-hidden [mask-image:linear-gradient(to_right,transparent,black_10%,black_90%,transparent)]">
+      <div class="flex w-max animate-marquee gap-12 px-6 text-slate-400 font-mono text-sm">
+        <span v-for="(lang, idx) in marquee" :key="idx" class="whitespace-nowrap">{{ lang }}</span>
+      </div>
+    </div>
   </section>
 
   <!-- 特性 -->
-  <section class="max-w-6xl mx-auto px-5 py-16">
+  <section class="max-w-6xl mx-auto px-5 py-20">
     <div class="max-w-2xl mb-12">
-      <p class="text-sm font-semibold text-brand-600 dark:text-brand-400">核心优势</p>
-      <h2 class="mt-2 text-3xl font-bold tracking-tight text-slate-900 dark:text-white">一个应用，覆盖完整开发流</h2>
+      <p class="text-sm font-semibold tracking-wide text-brand-600 dark:text-brand-400">{{ t('features.tag') }}</p>
+      <h2 class="mt-2 text-3xl sm:text-4xl font-bold tracking-tight text-slate-900 dark:text-white">{{ t('features.title') }}</h2>
     </div>
     <div class="grid sm:grid-cols-2 lg:grid-cols-3 gap-5">
-      <div v-for="f in features" :key="f.title"
-           class="group p-6 rounded-2xl border border-slate-200 dark:border-slate-800 bg-white dark:bg-slate-900/40 hover:shadow-soft hover:border-slate-300 dark:hover:border-slate-700 transition-all">
-        <div class="w-10 h-10 rounded-xl bg-brand-50 dark:bg-brand-900/30 text-brand-600 dark:text-brand-400 flex items-center justify-center" v-html="f.icon"></div>
-        <h3 class="mt-4 font-semibold text-lg text-slate-900 dark:text-white">{{ f.title }}</h3>
-        <p class="mt-2 text-slate-600 dark:text-slate-400 leading-relaxed">{{ f.desc }}</p>
+      <div v-for="f in features" :key="f.key"
+           class="group relative p-6 rounded-2xl border border-slate-200 dark:border-white/10 bg-white dark:bg-white/[.03] hover:-translate-y-1 hover:shadow-soft dark:hover:bg-white/[.06] transition-all duration-300">
+        <div class="w-11 h-11 rounded-xl bg-gradient-to-br from-brand-500/15 to-violet-500/15 text-brand-600 dark:text-brand-300 flex items-center justify-center ring-1 ring-brand-500/20" v-html="f.icon"></div>
+        <h3 class="mt-4 font-semibold text-lg text-slate-900 dark:text-white">{{ t(`features.items.${f.key}.title`) }}</h3>
+        <p class="mt-2 text-slate-600 dark:text-slate-400 leading-relaxed">{{ t(`features.items.${f.key}.desc`) }}</p>
       </div>
     </div>
   </section>
 </template>
 
 <script setup lang="ts">
+import {useI18n} from 'vue-i18n'
 import CodeWindow from '../components/CodeWindow.vue'
 import {latestRelease} from '../content/releases'
 
-const langs = ['Python', 'Rust', 'Go', 'JavaScript', 'Java', 'C/C++']
+const {t} = useI18n()
+
+const langArr = ['Python', 'Rust', 'Go', 'JavaScript', 'TypeScript', 'Java', 'C', 'C++', 'Ruby', 'PHP', 'Kotlin', 'Swift']
+const marquee = [...langArr, ...langArr]
 
 const i = (path: string) =>
   `<svg class="w-5 h-5" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round">${path}</svg>`
 
 const features = [
-  {
-    title: '极速运行',
-    desc: '一键运行任意语言，可扩展的语言支持系统，启动与执行都很迅捷。',
-    icon: i('<path d="M13 2 4.5 13.5H11l-1 8.5 8.5-11.5H12z"/>')
-  },
-  {
-    title: '智能编辑',
-    desc: 'LSP 补全、跳转、诊断，符号大纲、面包屑、多光标与代码片段一应俱全。',
-    icon: i('<path d="m18 16 4-4-4-4"/><path d="m6 8-4 4 4 4"/><path d="m14.5 4-5 16"/>')
-  },
-  {
-    title: '可视化调试',
-    desc: '基于 DAP 的断点调试，变量、调用栈、监视与悬停求值，无需切到命令行。',
-    icon: i('<rect x="3" y="11" width="18" height="10" rx="2"/><path d="M7 11V7a5 5 0 0 1 10 0v4"/>')
-  },
-  {
-    title: '数据库工作台',
-    desc: '多数据源连接、SQL 执行与结果导出、ER 图与交互式事务，数据开发更顺手。',
-    icon: i('<ellipse cx="12" cy="5" rx="9" ry="3"/><path d="M3 5v14a9 3 0 0 0 18 0V5"/><path d="M3 12a9 3 0 0 0 18 0"/>')
-  },
-  {
-    title: 'Git 工作台',
-    desc: '暂存、提交、分支、分支图、变基、cherry-pick、子模块与工作树，全部图形化。',
-    icon: i('<circle cx="6" cy="6" r="3"/><circle cx="6" cy="18" r="3"/><circle cx="18" cy="8" r="3"/><path d="M6 9v6"/><path d="M18 11a6 6 0 0 1-6 6H9"/>')
-  },
-  {
-    title: 'AI 辅助',
-    desc: '代码预测、解释、生成测试与格式化，让常见任务交给 AI 一步完成。',
-    icon: i('<path d="M12 3v4"/><path d="M12 17v4"/><path d="m6 6 1.5 1.5"/><path d="M16.5 16.5 18 18"/><circle cx="12" cy="12" r="4"/>')
-  }
+  {key: 'run', icon: i('<path d="M13 2 4.5 13.5H11l-1 8.5 8.5-11.5H12z"/>')},
+  {key: 'edit', icon: i('<path d="m18 16 4-4-4-4"/><path d="m6 8-4 4 4 4"/><path d="m14.5 4-5 16"/>')},
+  {key: 'debug', icon: i('<rect x="3" y="11" width="18" height="10" rx="2"/><path d="M7 11V7a5 5 0 0 1 10 0v4"/>')},
+  {key: 'db', icon: i('<ellipse cx="12" cy="5" rx="9" ry="3"/><path d="M3 5v14a9 3 0 0 0 18 0V5"/><path d="M3 12a9 3 0 0 0 18 0"/>')},
+  {key: 'git', icon: i('<circle cx="6" cy="6" r="3"/><circle cx="6" cy="18" r="3"/><circle cx="18" cy="8" r="3"/><path d="M6 9v6"/><path d="M18 11a6 6 0 0 1-6 6H9"/>')},
+  {key: 'ai', icon: i('<path d="M12 3v4"/><path d="M12 17v4"/><path d="m6 6 1.5 1.5"/><path d="M16.5 16.5 18 18"/><circle cx="12" cy="12" r="4"/>')}
 ]
 </script>
diff --git a/docs/src/pages/ReleaseList.vue b/docs/src/pages/ReleaseList.vue
index b33ddfd0..a1dc3401 100644
--- a/docs/src/pages/ReleaseList.vue
+++ b/docs/src/pages/ReleaseList.vue
@@ -1,9 +1,9 @@
 <template>
-  <h1>发布日志</h1>
-  <p>每个版本的更新内容如下，点击查看详情。</p>
+  <h1>{{ t('releaseList.title') }}</h1>
+  <p>{{ t('releaseList.intro') }}</p>
   <div class="not-prose mt-6 space-y-2">
     <RouterLink v-for="r in releases" :key="r.version" :to="`/release/${r.version}`"
-                class="flex items-center justify-between px-4 py-3 rounded-xl border border-slate-200 dark:border-slate-800 hover:border-brand-300 dark:hover:border-brand-600 hover:shadow-soft transition-all">
+                class="flex items-center justify-between px-4 py-3 rounded-xl border border-slate-200 dark:border-white/10 hover:border-brand-300 dark:hover:border-brand-500/60 hover:shadow-soft transition-all">
       <span class="font-medium text-slate-900 dark:text-white">v{{ r.version }}</span>
       <span class="text-slate-400">→</span>
     </RouterLink>
@@ -11,5 +11,8 @@
 </template>
 
 <script setup lang="ts">
+import {useI18n} from 'vue-i18n'
 import {releases} from '../content/releases'
+
+const {t} = useI18n()
 </script>
diff --git a/docs/src/styles/main.css b/docs/src/styles/main.css
index e25fdabf..afdb0614 100644
--- a/docs/src/styles/main.css
+++ b/docs/src/styles/main.css
@@ -14,6 +14,61 @@ body {
   @apply font-sans antialiased;
 }
 
+/* ===== 科技感动效 ===== */
+@keyframes blob {
+  0%, 100% { transform: translate(0, 0) scale(1); }
+  33% { transform: translate(30px, -40px) scale(1.1); }
+  66% { transform: translate(-20px, 20px) scale(0.95); }
+}
+.animate-blob { animation: blob 14s ease-in-out infinite; }
+
+@keyframes float {
+  0%, 100% { transform: translateY(0); }
+  50% { transform: translateY(-12px); }
+}
+.animate-float { animation: float 6s ease-in-out infinite; }
+
+@keyframes spin-slow { to { transform: rotate(360deg); } }
+.animate-spin-slow { animation: spin-slow 6s linear infinite; }
+
+@keyframes marquee { from { transform: translateX(0); } to { transform: translateX(-50%); } }
+.animate-marquee { animation: marquee 28s linear infinite; }
+
+@keyframes shimmer { 100% { transform: translateX(200%); } }
+.shimmer { position: relative; overflow: hidden; }
+.shimmer::after {
+  content: '';
+  position: absolute;
+  inset: 0;
+  transform: translateX(-200%);
+  background: linear-gradient(110deg, transparent 30%, rgba(255, 255, 255, .35) 50%, transparent 70%);
+  animation: shimmer 3.5s ease-in-out infinite;
+}
+
+/* 渐变描边（旋转的 conic 光圈） */
+.glow-border { position: relative; }
+.glow-border::before {
+  content: '';
+  position: absolute;
+  inset: -1px;
+  border-radius: inherit;
+  padding: 1px;
+  background: conic-gradient(from var(--a, 0deg), #6366f1, #22d3ee, #a855f7, #6366f1);
+  -webkit-mask: linear-gradient(#000 0 0) content-box, linear-gradient(#000 0 0);
+  -webkit-mask-composite: xor;
+  mask-composite: exclude;
+  animation: spin-border 8s linear infinite;
+  opacity: .7;
+}
+@property --a { syntax: '<angle>'; initial-value: 0deg; inherits: false; }
+@keyframes spin-border { to { --a: 360deg; } }
+
+@media (prefers-reduced-motion: reduce) {
+  .animate-blob, .animate-float, .animate-spin-slow, .animate-marquee, .shimmer::after, .glow-border::before {
+    animation: none !important;
+  }
+}
+
 /* 发布日志正文排版（Markdown 渲染结果） */
 .prose-doc {
   @apply text-slate-700 dark:text-slate-300 leading-7 text-[15px];