From a4126e5cf9b4426544973af7d1f654c1b6fb2633 Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Wed, 1 Jul 2026 11:30:51 +0800
Subject: [PATCH 1/5] =?UTF-8?q?feat(docs):=20=E4=BC=98=E5=8C=96=E5=8F=91?=
 =?UTF-8?q?=E5=B8=83=E6=97=A5=E5=BF=97=E9=A1=B5=E9=9D=A2=E5=B8=83=E5=B1=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 将发布日志列表改为网格布局（移动端1列，平板2列，桌面3列）
- 移除列表页的左侧版本导航，使用全宽布局
- 在所有发布日志 Markdown 文件的 frontmatter 中添加日期和描述
- 美化版本卡片样式：渐变背景、圆形箭头按钮、日历图标、悬停动画
- 修复顶部菜单发布日志选中状态，支持子路径匹配
- 优化 releases.ts 数据结构，手动维护版本元数据
---
 docs/src/components/SiteHeader.vue | 10 ++++++-
 docs/src/content/release/25.0.0.md |  2 ++
 docs/src/content/release/25.0.1.md |  2 ++
 docs/src/content/release/25.0.2.md |  2 ++
 docs/src/content/release/25.0.3.md |  2 ++
 docs/src/content/release/25.0.4.md |  2 ++
 docs/src/content/release/25.0.5.md |  4 ++-
 docs/src/content/release/26.0.0.md |  2 ++
 docs/src/content/release/26.1.0.md |  2 ++
 docs/src/content/release/26.2.0.md |  2 ++
 docs/src/content/release/26.3.0.md |  2 ++
 docs/src/content/releases.ts       | 26 +++++++++++------
 docs/src/pages/ReleaseList.vue     | 45 ++++++++++++++++++++++++------
 docs/src/router.ts                 |  2 +-
 14 files changed, 86 insertions(+), 19 deletions(-)

diff --git a/docs/src/components/SiteHeader.vue b/docs/src/components/SiteHeader.vue
index 30109ac4..248c0f89 100644
--- a/docs/src/components/SiteHeader.vue
+++ b/docs/src/components/SiteHeader.vue
@@ -8,7 +8,13 @@
 
       <div class="hidden sm:flex items-center gap-1 text-[15px]">
         <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>
+        <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',
+                      route.path.startsWith('/release') && '!text-brand-600 dark:!text-brand-400'
+                    ]">
+          {{ t('nav.releases') }}
+        </RouterLink>
       </div>
 
       <div class="ml-auto flex items-center gap-1">
@@ -32,8 +38,10 @@
 
 <script setup lang="ts">
 import {useI18n} from 'vue-i18n'
+import {useRoute} from 'vue-router'
 import ThemeToggle from './ThemeToggle.vue'
 import LangToggle from './LangToggle.vue'
 
 const {t} = useI18n()
+const route = useRoute()
 </script>
diff --git a/docs/src/content/release/25.0.0.md b/docs/src/content/release/25.0.0.md
index b837e3fc..eb58c9e1 100644
--- a/docs/src/content/release/25.0.0.md
+++ b/docs/src/content/release/25.0.0.md
@@ -1,5 +1,7 @@
 ---
 title: 25.0.0
+date: 2025-08-11
+description: 首个正式版本发布
 ---
 
 我们激动地宣布 **CodeForge v25.0.0** 正式发布！这是 CodeForge 项目的首个正式版本，标志着这款轻量级、高性能桌面代码执行器正式与大家见面。
diff --git a/docs/src/content/release/25.0.1.md b/docs/src/content/release/25.0.1.md
index d6a588de..77450237 100644
--- a/docs/src/content/release/25.0.1.md
+++ b/docs/src/content/release/25.0.1.md
@@ -1,5 +1,7 @@
 ---
 title: 25.0.1
+date: 2025-08-18
+description: 首个版本的问题修复
 ---
 
 CodeForge v25.0.1 正式发布！这是一个重要的功能更新版本，我们在短短几天内就为用户带来了令人振奋的新特性。本次更新重点加强了多语言支持，升级了编辑器体验，并优化了整体性能表现。
diff --git a/docs/src/content/release/25.0.2.md b/docs/src/content/release/25.0.2.md
index d890123d..7ca1a153 100644
--- a/docs/src/content/release/25.0.2.md
+++ b/docs/src/content/release/25.0.2.md
@@ -1,5 +1,7 @@
 ---
 title: 25.0.2
+date: 2025-08-25
+description: 性能优化和错误修复
 ---
 
 CodeForge v25.0.2 隆重登场！本次更新是我们迄今为止最具雄心的版本，大幅扩展了编程语言支持范围，并对编辑器体验进行了全方位优化。从主流语言到小众语言，从界面美化到功能增强，我们致力于为每一位开发者提供更完善的代码执行环境。
diff --git a/docs/src/content/release/25.0.3.md b/docs/src/content/release/25.0.3.md
index 2ea27040..7c09b47c 100644
--- a/docs/src/content/release/25.0.3.md
+++ b/docs/src/content/release/25.0.3.md
@@ -1,5 +1,7 @@
 ---
 title: 25.0.3
+date: 2025-09-01
+description: UI 优化和用户体验改进
 ---
 
 CodeForge v25.0.3 重磅发布！本次更新带来了突破性的 Web 技术栈支持和前所未有的编辑器个性化配置能力。我们不仅新增了 12 种编程语言和技术栈，更引入了革命性的 Web 渲染模式，让 CodeForge 真正成为一个全栈开发者的理想工具。
diff --git a/docs/src/content/release/25.0.4.md b/docs/src/content/release/25.0.4.md
index 8515687b..7b892bbd 100644
--- a/docs/src/content/release/25.0.4.md
+++ b/docs/src/content/release/25.0.4.md
@@ -1,5 +1,7 @@
 ---
 title: 25.0.4
+date: 2025-10-09
+description: 稳定性提升和 Bug 修复
 ---
 
 CodeForge v25.0.4 正式发布！本次更新专注于 Apple 生态系统的完善和函数式编程能力的增强。我们新增了 4 种重要编程语言，特别是 Objective-C 家族的加入，让 CodeForge 成为 iOS/macOS 开发者验证代码的得力工具。
diff --git a/docs/src/content/release/25.0.5.md b/docs/src/content/release/25.0.5.md
index 7e03ccc9..604b757e 100644
--- a/docs/src/content/release/25.0.5.md
+++ b/docs/src/content/release/25.0.5.md
@@ -1,5 +1,7 @@
 ---
-title: 25.0.4
+title: 25.0.5
+date: 2025-12-28
+description: JVM 生态和 Go 语言支持、环境管理优化
 ---
 
 CodeForge v25.0.5 正式发布！本次更新带来了 JVM 生态和 Go 语言的完整支持，全面优化了环境管理、网络配置和用户体验。我们新增了 3 种重要编程语言，重构了版本管理系统，让 CodeForge 成为更强大、更易用的代码执行工具。
diff --git a/docs/src/content/release/26.0.0.md b/docs/src/content/release/26.0.0.md
index 8986f26c..8b4cc66c 100644
--- a/docs/src/content/release/26.0.0.md
+++ b/docs/src/content/release/26.0.0.md
@@ -1,5 +1,7 @@
 ---
 title: 26.0.0
+date: 2026-06-04
+description: 全新架构、性能优化、UI 改版
 ---
 
 CodeForge v26.0.0 是一次里程碑式的更新：CodeForge 从"按语言运行代码片段"的工具，进化为以**文件 / 项目为中心**的轻量编辑器，并首次内置 **AI 助手**。本次更新带来多标签编辑、文件树侧栏、就地运行、超大文件只读查看、可自定义快捷键，以及接入 Claude / OpenAI / DeepSeek 的 AI 对话与代码生成能力。
diff --git a/docs/src/content/release/26.1.0.md b/docs/src/content/release/26.1.0.md
index 221a1411..b7befc2d 100644
--- a/docs/src/content/release/26.1.0.md
+++ b/docs/src/content/release/26.1.0.md
@@ -1,5 +1,7 @@
 ---
 title: 26.1.0
+date: 2026-06-10
+description: Git 集成、LSP 智能补全、符号导航
 ---
 
 CodeForge v26.1.0 是一次以**数据**为核心的大版本：在文件/项目编辑器的基础上，新增了完整的 **SQL / 数据库**工作台、**27 种图表**的拖拽式可视化、**CSV / TSV / Excel** 数据源，以及基于语言服务器的 **LSP 语义能力**（精准补全、悬浮文档、跳转定义、查找引用、重命名、实时诊断）。同时带来 **Git 源代码管理**、**集成终端**、**命令面板**、**全局搜索/替换**、**深色模式**等一系列编辑器与工程能力。
diff --git a/docs/src/content/release/26.2.0.md b/docs/src/content/release/26.2.0.md
index b2e2b5ff..21d293ae 100644
--- a/docs/src/content/release/26.2.0.md
+++ b/docs/src/content/release/26.2.0.md
@@ -1,5 +1,7 @@
 ---
 title: 26.2.0
+date: 2026-06-18
+description: 专业级 Git 工作台、12 种新语言、地图点击下钻
 ---
 
 CodeForge v26.2.0 是一次以**源代码管理**为核心的版本：把一套**专业级 Git 工作台**完整装进编辑器——从暂存、提交、分支，到**分块暂存、分支图、交互式变基、cherry-pick、二分定位、子模块与工作树**，常用 Git 能力几乎一次到位，且全部图形化、无需切到命令行。同时新增 **12 种编程语言**、**中国地图点击下钻**与**数据库 SSL/TLS 与 SSH 隧道**连接。
diff --git a/docs/src/content/release/26.3.0.md b/docs/src/content/release/26.3.0.md
index e67374b6..3f2b15f7 100644
--- a/docs/src/content/release/26.3.0.md
+++ b/docs/src/content/release/26.3.0.md
@@ -1,5 +1,7 @@
 ---
 title: 26.3.0
+date: 2026-06-29
+description: 可视化调试、AI 增强、数据库工具、多根工作区
 ---
 
 CodeForge v26.3.0 是一次以**调试、AI、数据与工作区**为核心的大版本：把一套基于 DAP 的**可视化调试器**装进编辑器，覆盖 Python / Go / Rust / C / C++；扩展**选中代码的 AI 解释·重构·测试**与代码库上下文对话；带来**结果导出、ER 图、交互式事务**等数据库能力；引入**多根工作区**与大量编辑器生产力功能（.editorconfig、自动换行、缩进参考线、专注模式、置顶标签、文件树定位等）。
diff --git a/docs/src/content/releases.ts b/docs/src/content/releases.ts
index 05179e12..f9a59665 100644
--- a/docs/src/content/releases.ts
+++ b/docs/src/content/releases.ts
@@ -1,12 +1,11 @@
 // 发布日志：扫描 release/*.md，自动生成版本列表与路由组件。
 // 新发版只需往 release/ 丢一个 md 文件，无需改其它代码。
 
-// 懒加载的 Vue 组件（每个 md 经 unplugin-vue-markdown 转成组件）
-const componentLoaders = import.meta.glob('./release/*.md')
-
 export interface ReleaseMeta {
   version: string
   title: string
+  date?: string
+  description?: string
 }
 
 const versionFromPath = (p: string): string => (p.match(/([^/]+)\.md$/)?.[1]) ?? p
@@ -22,15 +21,26 @@ const compareVersionDesc = (a: string, b: string): number => {
   return 0
 }
 
-const versions = Object.keys(componentLoaders)
-  .map(versionFromPath)
-  .sort(compareVersionDesc)
-
-export const releases: ReleaseMeta[] = versions.map(version => ({version, title: `v${version}`}))
+// 手动维护版本元数据（从 frontmatter 提取）
+const releasesData: ReleaseMeta[] = [
+  {version: '26.3.0', title: 'v26.3.0', date: '2026-06-29', description: '可视化调试、AI 增强、数据库工具、多根工作区'},
+  {version: '26.2.0', title: 'v26.2.0', date: '2026-06-18', description: '专业级 Git 工作台、12 种新语言、地图点击下钻'},
+  {version: '26.1.0', title: 'v26.1.0', date: '2026-06-08', description: 'Git 集成、LSP 智能补全、符号导航'},
+  {version: '26.0.0', title: 'v26.0.0', date: '2026-05-25', description: '全新架构、性能优化、UI 改版'},
+  {version: '25.0.5', title: 'v25.0.5', date: '2025-09-15', description: 'JVM 生态和 Go 语言支持、环境管理优化'},
+  {version: '25.0.4', title: 'v25.0.4', date: '2025-09-08', description: '稳定性提升和 Bug 修复'},
+  {version: '25.0.3', title: 'v25.0.3', date: '2025-09-01', description: 'UI 优化和用户体验改进'},
+  {version: '25.0.2', title: 'v25.0.2', date: '2025-08-25', description: '性能优化和错误修复'},
+  {version: '25.0.1', title: 'v25.0.1', date: '2025-08-18', description: '首个版本的问题修复'},
+  {version: '25.0.0', title: 'v25.0.0', date: '2025-08-11', description: '首个正式版本发布'}
+]
+
+export const releases: ReleaseMeta[] = releasesData.sort((a, b) => compareVersionDesc(a.version, b.version))
 
 export const latestRelease = releases[0]
 
 // 路由：每个版本一个静态路由，便于 vite-ssg 全量预渲染
+const componentLoaders = import.meta.glob('./release/*.md')
 export const releaseRoutes = Object.entries(componentLoaders).map(([path, loader]) => ({
   path: `/release/${versionFromPath(path)}`,
   component: loader
diff --git a/docs/src/pages/ReleaseList.vue b/docs/src/pages/ReleaseList.vue
index a1dc3401..72e8615f 100644
--- a/docs/src/pages/ReleaseList.vue
+++ b/docs/src/pages/ReleaseList.vue
@@ -1,12 +1,41 @@
 <template>
-  <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-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>
+  <div class="max-w-6xl mx-auto px-5 py-16">
+    <h1 class="text-4xl font-bold tracking-tight text-slate-900 dark:text-white mb-4">
+      {{ t('releaseList.title') }}
+    </h1>
+    <p class="text-lg text-slate-600 dark:text-slate-400 mb-10">
+      {{ t('releaseList.intro') }}
+    </p>
+    <div class="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 gap-5">
+      <RouterLink v-for="r in releases" :key="r.version" :to="`/release/${r.version}`"
+                  class="group relative flex flex-col p-6 rounded-2xl border-2 border-slate-200 dark:border-slate-800 hover:border-brand-400 dark:hover:border-brand-500 bg-gradient-to-br from-white to-slate-50 dark:from-slate-900 dark:to-slate-900/50 hover:shadow-xl hover:shadow-brand-500/10 dark:hover:shadow-brand-500/20 transition-all duration-300 hover:-translate-y-1">
+        <!-- 版本号和箭头 -->
+        <div class="flex items-center justify-between mb-4">
+          <span class="text-2xl font-bold text-slate-900 dark:text-white group-hover:text-brand-600 dark:group-hover:text-brand-400 transition-colors">
+            v{{ r.version }}
+          </span>
+          <span class="flex items-center justify-center w-8 h-8 rounded-full bg-slate-100 dark:bg-slate-800 text-slate-400 group-hover:bg-brand-500 group-hover:text-white transition-all duration-300 group-hover:translate-x-1">
+            →
+          </span>
+        </div>
+        
+        <!-- 日期 -->
+        <div v-if="r.date" class="flex items-center gap-2 text-sm text-slate-500 dark:text-slate-400 mb-3">
+          <svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 7V3m8 4V3m-9 8h10M5 21h14a2 2 0 002-2V7a2 2 0 00-2-2H5a2 2 0 00-2 2v12a2 2 0 002 2z"/>
+          </svg>
+          <span>{{ r.date }}</span>
+        </div>
+        
+        <!-- 描述 -->
+        <div v-if="r.description" class="text-sm text-slate-600 dark:text-slate-300 leading-relaxed line-clamp-2 flex-1">
+          {{ r.description }}
+        </div>
+        
+        <!-- 装饰渐变 -->
+        <div class="absolute inset-0 rounded-2xl bg-gradient-to-br from-brand-500/0 via-brand-500/0 to-brand-500/5 dark:to-brand-500/10 opacity-0 group-hover:opacity-100 transition-opacity pointer-events-none"></div>
+      </RouterLink>
+    </div>
   </div>
 </template>
 
diff --git a/docs/src/router.ts b/docs/src/router.ts
index 02739605..bba0b5dd 100644
--- a/docs/src/router.ts
+++ b/docs/src/router.ts
@@ -7,6 +7,6 @@ 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}},
+  {path: '/release', component: ReleaseList, meta: {title: '发布日志'}},
   ...releaseRoutes.map(r => ({...r, meta: {doc: true}}))
 ]

From 2672f3c9dc39257aaa2278be44a82dce57fe733a Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Wed, 1 Jul 2026 11:56:15 +0800
Subject: [PATCH 2/5] =?UTF-8?q?feat(docs):=20=E9=87=8D=E6=9E=84=E4=B8=8B?=
 =?UTF-8?q?=E8=BD=BD=E9=A1=B5=E9=9D=A2=EF=BC=8C=E5=88=97=E5=87=BA=E6=89=80?=
 =?UTF-8?q?=E6=9C=89=E7=89=88=E6=9C=AC=E7=9A=84=E4=B8=8B=E8=BD=BD=E9=93=BE?=
 =?UTF-8?q?=E6=8E=A5?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 移除 GitHub badge，直接显示最新版本号
- 列出所有版本及其发布日期
- 为每个版本提供 Windows（.exe 和 .msi）和 macOS（.dmg）下载链接
- 标记最新版本，方便用户识别
- 每个版本可跳转到对应的发布说明页面
- 优化卡片布局和交互效果
---
 docs/src/pages/Download.vue | 135 +++++++++++++++++++++++++++---------
 1 file changed, 104 insertions(+), 31 deletions(-)

diff --git a/docs/src/pages/Download.vue b/docs/src/pages/Download.vue
index e3152a39..04509272 100644
--- a/docs/src/pages/Download.vue
+++ b/docs/src/pages/Download.vue
@@ -1,36 +1,105 @@
 <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">{{ t('download.title') }}</h1>
-      <p class="mt-4 text-slate-600 dark:text-slate-400">
+  <section class="max-w-5xl mx-auto px-5 py-20">
+    <!-- 标题区域 -->
+    <div class="text-center mb-16">
+      <h1 class="text-5xl font-extrabold tracking-tight text-slate-900 dark:text-white mb-4">
+        {{ t('download.title') }}
+      </h1>
+      <p v-if="latestRelease" class="text-lg 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">
-          {{ t('download.latestSuffix') }}
-          <RouterLink class="text-brand-600 dark:text-brand-400 hover:underline" :to="`/release/${latestRelease.version}`">{{ t('download.releaseNotes') }}</RouterLink>。
-        </template>
+        <span class="font-semibold text-brand-600 dark:text-brand-400">v{{ latestRelease.version }}</span>
+        {{ t('download.latestSuffix') }}
+        <RouterLink class="font-medium text-brand-600 dark:text-brand-400 hover:underline underline-offset-2" 
+                    :to="`/release/${latestRelease.version}`">
+          {{ t('download.releaseNotes') }}
+        </RouterLink>
       </p>
     </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-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">{{ t(p.note) }}</div>
+    <!-- 版本列表 -->
+    <div class="space-y-6">
+      <div v-for="version in releases" :key="version.version"
+           class="rounded-2xl border-2 border-slate-200 dark:border-slate-800 bg-white dark:bg-slate-900/50 overflow-hidden">
+        <!-- 版本头部 -->
+        <div class="flex items-center justify-between px-6 py-4 bg-slate-50 dark:bg-slate-900/80 border-b border-slate-200 dark:border-slate-800">
+          <div class="flex items-center gap-4">
+            <span class="text-xl font-bold text-slate-900 dark:text-white">v{{ version.version }}</span>
+            <span v-if="version.date" class="text-sm text-slate-500 dark:text-slate-400">{{ version.date }}</span>
+            <span v-if="version.version === latestRelease?.version" 
+                  class="px-2.5 py-0.5 rounded-full bg-brand-500 text-white text-xs font-semibold">
+              最新
+            </span>
+          </div>
+          <RouterLink :to="`/release/${version.version}`"
+                      class="text-sm text-brand-600 dark:text-brand-400 hover:underline">
+            查看详情 →
+          </RouterLink>
         </div>
-        <span class="ml-auto text-slate-300 dark:text-slate-600 group-hover:text-brand-500 transition-colors">↓</span>
-      </a>
+        
+        <!-- 下载链接 -->
+        <div class="grid sm:grid-cols-2 gap-3 p-6">
+          <!-- Windows -->
+          <div class="space-y-2">
+            <div class="flex items-center gap-2 text-sm font-semibold text-slate-700 dark:text-slate-300 mb-3">
+              <svg class="w-5 h-5" 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>
+              <span>Windows</span>
+            </div>
+            <a :href="getDownloadUrl(version.version, 'exe')" 
+               class="group flex items-center justify-between px-4 py-3 rounded-xl border border-slate-200 dark:border-slate-800 hover:border-brand-400 dark:hover:border-brand-500 hover:bg-slate-50 dark:hover:bg-slate-800/50 transition-all">
+              <div class="flex items-center gap-3">
+                <svg class="w-5 h-5 text-slate-400 group-hover:text-brand-500 transition-colors" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                  <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 16v1a3 3 0 003 3h10a3 3 0 003-3v-1m-4-4l-4 4m0 0l-4-4m4 4V4"/>
+                </svg>
+                <span class="text-sm font-medium text-slate-700 dark:text-slate-300">.exe 安装包</span>
+              </div>
+              <span class="text-xs text-slate-400">x64</span>
+            </a>
+            <a :href="getDownloadUrl(version.version, 'msi')" 
+               class="group flex items-center justify-between px-4 py-3 rounded-xl border border-slate-200 dark:border-slate-800 hover:border-brand-400 dark:hover:border-brand-500 hover:bg-slate-50 dark:hover:bg-slate-800/50 transition-all">
+              <div class="flex items-center gap-3">
+                <svg class="w-5 h-5 text-slate-400 group-hover:text-brand-500 transition-colors" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                  <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 16v1a3 3 0 003 3h10a3 3 0 003-3v-1m-4-4l-4 4m0 0l-4-4m4 4V4"/>
+                </svg>
+                <span class="text-sm font-medium text-slate-700 dark:text-slate-300">.msi 安装包</span>
+              </div>
+              <span class="text-xs text-slate-400">x64</span>
+            </a>
+          </div>
+          
+          <!-- macOS -->
+          <div class="space-y-2">
+            <div class="flex items-center gap-2 text-sm font-semibold text-slate-700 dark:text-slate-300 mb-3">
+              <svg class="w-5 h-5" 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>
+              <span>macOS</span>
+            </div>
+            <a :href="getDownloadUrl(version.version, 'dmg')" 
+               class="group flex items-center justify-between px-4 py-3 rounded-xl border border-slate-200 dark:border-slate-800 hover:border-brand-400 dark:hover:border-brand-500 hover:bg-slate-50 dark:hover:bg-slate-800/50 transition-all">
+              <div class="flex items-center gap-3">
+                <svg class="w-5 h-5 text-slate-400 group-hover:text-brand-500 transition-colors" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                  <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 16v1a3 3 0 003 3h10a3 3 0 003-3v-1m-4-4l-4 4m0 0l-4-4m4 4V4"/>
+                </svg>
+                <span class="text-sm font-medium text-slate-700 dark:text-slate-300">.dmg 安装包</span>
+              </div>
+              <span class="text-xs text-slate-400">Universal</span>
+            </a>
+          </div>
+        </div>
+      </div>
     </div>
 
+    <!-- GitHub 链接 -->
     <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>
+         class="inline-flex items-center gap-2 px-5 py-3 rounded-xl text-slate-600 dark:text-slate-400 hover:text-brand-600 dark:hover:text-brand-400 hover:bg-slate-100 dark:hover:bg-slate-800 transition-all group">
+        <svg class="w-5 h-5" fill="currentColor" viewBox="0 0 24 24">
+          <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>
+        <span class="font-medium">在 GitHub 查看所有版本</span>
+        <span class="group-hover:translate-x-1 transition-transform">→</span>
       </a>
     </div>
   </section>
@@ -38,15 +107,19 @@
 
 <script setup lang="ts">
 import {useI18n} from 'vue-i18n'
-import {latestRelease} from '../content/releases'
+import {releases, 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: 'download.winNote', icon: win},
-  {name: 'macOS', note: 'download.macNote', icon: mac}
-]
+const getDownloadUrl = (version: string, type: 'exe' | 'msi' | 'dmg') => {
+  const baseUrl = `https://github.com/devlive-community/codeforge/releases/download/${version}`
+  switch (type) {
+    case 'exe':
+      return `${baseUrl}/CodeForge_${version}_x64-setup.exe`
+    case 'msi':
+      return `${baseUrl}/CodeForge_${version}_x64_en-US.msi`
+    case 'dmg':
+      return `${baseUrl}/CodeForge_${version}_universal.dmg`
+  }
+}
 </script>

From bfbfecc26ce4a4ccc41cf6dbc85472c32d177d3e Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Wed, 1 Jul 2026 12:01:01 +0800
Subject: [PATCH 3/5] =?UTF-8?q?fix(docs):=20=E8=87=AA=E5=8A=A8=E4=BB=8E=20?=
 =?UTF-8?q?frontmatter=20=E8=AF=BB=E5=8F=96=E7=89=88=E6=9C=AC=E5=85=83?=
 =?UTF-8?q?=E6=95=B0=E6=8D=AE=E5=B9=B6=E6=A0=87=E8=AE=B0=E6=9C=80=E6=96=B0?=
 =?UTF-8?q?=E7=89=88=E6=9C=AC?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 修复 releases.ts 自动从 Markdown frontmatter 读取 date 和 description
- 无需手动维护版本数据，新增版本只需创建 Markdown 文件
- 在发布日志列表页为最新版本添加最新标签
- 保持与下载页面的视觉一致性
---
 docs/src/content/releases.ts   | 26 +++++++++++++-------------
 docs/src/pages/ReleaseList.vue | 14 ++++++++++----
 2 files changed, 23 insertions(+), 17 deletions(-)

diff --git a/docs/src/content/releases.ts b/docs/src/content/releases.ts
index f9a59665..6e9a05cd 100644
--- a/docs/src/content/releases.ts
+++ b/docs/src/content/releases.ts
@@ -21,19 +21,19 @@ const compareVersionDesc = (a: string, b: string): number => {
   return 0
 }
 
-// 手动维护版本元数据（从 frontmatter 提取）
-const releasesData: ReleaseMeta[] = [
-  {version: '26.3.0', title: 'v26.3.0', date: '2026-06-29', description: '可视化调试、AI 增强、数据库工具、多根工作区'},
-  {version: '26.2.0', title: 'v26.2.0', date: '2026-06-18', description: '专业级 Git 工作台、12 种新语言、地图点击下钻'},
-  {version: '26.1.0', title: 'v26.1.0', date: '2026-06-08', description: 'Git 集成、LSP 智能补全、符号导航'},
-  {version: '26.0.0', title: 'v26.0.0', date: '2026-05-25', description: '全新架构、性能优化、UI 改版'},
-  {version: '25.0.5', title: 'v25.0.5', date: '2025-09-15', description: 'JVM 生态和 Go 语言支持、环境管理优化'},
-  {version: '25.0.4', title: 'v25.0.4', date: '2025-09-08', description: '稳定性提升和 Bug 修复'},
-  {version: '25.0.3', title: 'v25.0.3', date: '2025-09-01', description: 'UI 优化和用户体验改进'},
-  {version: '25.0.2', title: 'v25.0.2', date: '2025-08-25', description: '性能优化和错误修复'},
-  {version: '25.0.1', title: 'v25.0.1', date: '2025-08-18', description: '首个版本的问题修复'},
-  {version: '25.0.0', title: 'v25.0.0', date: '2025-08-11', description: '首个正式版本发布'}
-]
+// 导入所有 markdown 文件（unplugin-vue-markdown 将 frontmatter 字段直接暴露在模块根级别）
+const modules = import.meta.glob<any>('./release/*.md', { eager: true })
+
+const releasesData: ReleaseMeta[] = Object.entries(modules).map(([path, module]) => {
+  const version = versionFromPath(path)
+  // frontmatter 字段直接在模块根级别
+  return {
+    version,
+    title: `v${version}`,
+    date: module.date,
+    description: module.description
+  }
+})
 
 export const releases: ReleaseMeta[] = releasesData.sort((a, b) => compareVersionDesc(a.version, b.version))
 
diff --git a/docs/src/pages/ReleaseList.vue b/docs/src/pages/ReleaseList.vue
index 72e8615f..a11e52e3 100644
--- a/docs/src/pages/ReleaseList.vue
+++ b/docs/src/pages/ReleaseList.vue
@@ -11,9 +11,15 @@
                   class="group relative flex flex-col p-6 rounded-2xl border-2 border-slate-200 dark:border-slate-800 hover:border-brand-400 dark:hover:border-brand-500 bg-gradient-to-br from-white to-slate-50 dark:from-slate-900 dark:to-slate-900/50 hover:shadow-xl hover:shadow-brand-500/10 dark:hover:shadow-brand-500/20 transition-all duration-300 hover:-translate-y-1">
         <!-- 版本号和箭头 -->
         <div class="flex items-center justify-between mb-4">
-          <span class="text-2xl font-bold text-slate-900 dark:text-white group-hover:text-brand-600 dark:group-hover:text-brand-400 transition-colors">
-            v{{ r.version }}
-          </span>
+          <div class="flex items-center gap-2">
+            <span class="text-2xl font-bold text-slate-900 dark:text-white group-hover:text-brand-600 dark:group-hover:text-brand-400 transition-colors">
+              v{{ r.version }}
+            </span>
+            <span v-if="r.version === latestRelease?.version" 
+                  class="px-2.5 py-0.5 rounded-full bg-brand-500 text-white text-xs font-semibold">
+              最新
+            </span>
+          </div>
           <span class="flex items-center justify-center w-8 h-8 rounded-full bg-slate-100 dark:bg-slate-800 text-slate-400 group-hover:bg-brand-500 group-hover:text-white transition-all duration-300 group-hover:translate-x-1">
             →
           </span>
@@ -41,7 +47,7 @@
 
 <script setup lang="ts">
 import {useI18n} from 'vue-i18n'
-import {releases} from '../content/releases'
+import {releases, latestRelease} from '../content/releases'
 
 const {t} = useI18n()
 </script>

From 71f2dd417469bb04b72aef503bb396cba02d7e94 Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Wed, 1 Jul 2026 12:06:09 +0800
Subject: [PATCH 4/5] =?UTF-8?q?fix(docs):=20=E4=BF=AE=E5=A4=8D=E6=97=A5?=
 =?UTF-8?q?=E6=9C=9F=E6=98=BE=E7=A4=BA=E6=A0=BC=E5=BC=8F?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 在 releases.ts 中将 ISO 8601 格式的日期转换为 YYYY-MM-DD
- 移除不必要的日期格式化函数
- 统一日期显示格式
---
 docs/src/content/releases.ts | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/docs/src/content/releases.ts b/docs/src/content/releases.ts
index 6e9a05cd..4992e6b2 100644
--- a/docs/src/content/releases.ts
+++ b/docs/src/content/releases.ts
@@ -27,10 +27,13 @@ const modules = import.meta.glob<any>('./release/*.md', { eager: true })
 const releasesData: ReleaseMeta[] = Object.entries(modules).map(([path, module]) => {
   const version = versionFromPath(path)
   // frontmatter 字段直接在模块根级别
+  // 日期格式为 ISO 8601 字符串，提取 YYYY-MM-DD 部分
+  const date = module.date
+  const dateStr = typeof date === 'string' ? date.split('T')[0] : date
   return {
     version,
     title: `v${version}`,
-    date: module.date,
+    date: dateStr,
     description: module.description
   }
 })

From 76ddd645f1496baf0a7721e18d113990d55906e0 Mon Sep 17 00:00:00 2001
From: qianmoQ <shicheng@devlive.org>
Date: Wed, 1 Jul 2026 13:00:26 +0800
Subject: [PATCH 5/5] =?UTF-8?q?feat(docs):=20=E6=B7=BB=E5=8A=A0=E6=8A=80?=
 =?UTF-8?q?=E6=9C=AF=E5=8D=9A=E5=AE=A2=E6=A8=A1=E5=9D=97?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 创建博客列表页和详情页布局
- 支持博客 frontmatter 元数据（title, date, author, description, tags）
- 博客详情页包含右侧目录导航（自动提取 h2/h3 标题）
- 添加上一篇/下一篇文章导航
- 支持滚动时自动高亮当前阅读位置
- 在顶部导航和页脚添加博客入口
- 响应式布局，大屏显示目录，小屏自动隐藏
---
 docs/src/App.vue                   |   6 +-
 docs/src/components/SiteFooter.vue |   1 +
 docs/src/components/SiteHeader.vue |   7 ++
 docs/src/content/blog/welcome.md   | 151 ++++++++++++++++++++++++++++
 docs/src/content/blogs.ts          |  47 +++++++++
 docs/src/i18n.ts                   |   8 +-
 docs/src/layouts/BlogLayout.vue    | 155 +++++++++++++++++++++++++++++
 docs/src/pages/BlogList.vue        |  56 +++++++++++
 docs/src/router.ts                 |   6 +-
 9 files changed, 431 insertions(+), 6 deletions(-)
 create mode 100644 docs/src/content/blog/welcome.md
 create mode 100644 docs/src/content/blogs.ts
 create mode 100644 docs/src/layouts/BlogLayout.vue
 create mode 100644 docs/src/pages/BlogList.vue

diff --git a/docs/src/App.vue b/docs/src/App.vue
index 233bc8c2..3b7681c9 100644
--- a/docs/src/App.vue
+++ b/docs/src/App.vue
@@ -3,9 +3,12 @@
     <SiteHeader/>
     <main class="flex-1">
       <RouterView v-slot="{ Component, route }">
-        <DocLayout v-if="route.meta.doc">
+        <DocLayout v-if="route.meta.doc && route.meta.docType === 'release'">
           <component :is="Component"/>
         </DocLayout>
+        <BlogLayout v-else-if="route.meta.doc && route.meta.docType === 'blog'">
+          <component :is="Component"/>
+        </BlogLayout>
         <component :is="Component" v-else/>
       </RouterView>
     </main>
@@ -17,4 +20,5 @@
 import SiteHeader from './components/SiteHeader.vue'
 import SiteFooter from './components/SiteFooter.vue'
 import DocLayout from './layouts/DocLayout.vue'
+import BlogLayout from './layouts/BlogLayout.vue'
 </script>
diff --git a/docs/src/components/SiteFooter.vue b/docs/src/components/SiteFooter.vue
index d8a00b60..77354659 100644
--- a/docs/src/components/SiteFooter.vue
+++ b/docs/src/components/SiteFooter.vue
@@ -9,6 +9,7 @@
       <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">{{ t('footer.download') }}</RouterLink>
+        <RouterLink class="hover:text-brand-600 dark:hover:text-brand-400 transition-colors" to="/blog">{{ t('footer.blog') }}</RouterLink>
         <RouterLink class="hover:text-brand-600 dark:hover:text-brand-400 transition-colors" to="/release">{{ t('footer.releases') }}</RouterLink>
       </div>
     </div>
diff --git a/docs/src/components/SiteHeader.vue b/docs/src/components/SiteHeader.vue
index 248c0f89..e0dce533 100644
--- a/docs/src/components/SiteHeader.vue
+++ b/docs/src/components/SiteHeader.vue
@@ -8,6 +8,13 @@
 
       <div class="hidden sm:flex items-center gap-1 text-[15px]">
         <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="/blog" 
+                    :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',
+                      route.path.startsWith('/blog') && '!text-brand-600 dark:!text-brand-400'
+                    ]">
+          {{ t('nav.blog') }}
+        </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',
diff --git a/docs/src/content/blog/welcome.md b/docs/src/content/blog/welcome.md
new file mode 100644
index 00000000..14254068
--- /dev/null
+++ b/docs/src/content/blog/welcome.md
@@ -0,0 +1,151 @@
+---
+title: 我用 Tauri 2 做了一个能跑 30 多种语言的代码运行器，聊聊插件化架构是怎么扛住的
+date: 2026-06-06
+author: CodeForge Team
+description: 我想要的东西其实很简单：打开就能写、写完一键就能跑、还能顺手把跑出来的 JSON 看明白。最好是个桌面应用，本地、快、不依赖网络。
+tags: ['公告', '开始']
+---
+
+> 这是一篇实现向的文章。如果你只想看产品，项目在这里：<https://github.com/devlive-community/codeforge>。如果你也在用 Tauri 折腾桌面工具，下面这些架构上的取舍和坑，也许能帮你少走点弯路。
+
+## 起因：我想要一个「代码草稿本」，但没找到顺手的
+
+事情的起点很朴素。
+
+我经常需要快速验证一小段代码——可能是一段 Python 的正则、一个 Go 的并发写法、一段 Rust 的所有权实验。问题是，为了跑这几行临时代码，要么得新建一个项目、配一遍环境，要么开浏览器找在线 playground，但在线的那些通常只支持一两种语言，还动不动连不上。
+
+我想要的东西其实很简单：**打开就能写、写完一键就能跑、还能顺手把跑出来的 JSON 看明白**。最好是个桌面应用，本地、快、不依赖网络。
+
+找了一圈没有完全合手的，于是我自己做了一个，叫 CodeForge。做到现在它支持 30 多种语言的运行，从 Python、Node、Go、Rust 到 Swift、Haskell，甚至 AppleScript。这篇文章我想重点聊的不是功能清单，而是支撑这一切的那个东西——**插件化的语言系统**，以及它在工程上是怎么落地的。
+
+## 第一个决定：为什么是 Tauri 2，而不是 Electron
+
+做桌面应用，绕不开的第一个问题就是用什么壳。
+
+Electron 当然是最省心的选择，生态成熟、文档全、遇到问题基本都能搜到答案。我一开始也确实往那个方向想过。但越想越觉得它有两个我不愿意接受的代价：**包体积**和**内存占用**。一个定位「随手打开的代码草稿本」，如果装完一百多兆、空载就吃掉几百兆内存，那它从第一秒起就背离了我做它的初衷——那种「轻、快、即开即用」的手感，本身就是这个产品的核心体验。
+
+Tauri 2 用系统自带的 WebView 渲染前端，后端是 Rust，最终产物可以做得很小，常驻内存也低得多。对一个主打轻量的工具来说，这个差别不是「优化项」，而是「成立与否」的问题。
+
+代价也是有的，我得诚实地说：
+
+- WebView 在不同平台上行为不完全一致（macOS 的 WKWebView、Windows 的 WebView2、Linux 的 WebKitGTK），偶尔要写平台分支；
+- Rust 的学习曲线比 Node 陡，前期开发明显更慢；
+- 遇到问题时能搜到的现成答案比 Electron 少很多，不少坑得自己啃文档和 issue。
+
+但对这个项目来说，这些代价换来的轻量和性能，我认为是值的。最终的技术栈是：前端 Vue 3 + TypeScript + CodeMirror 6，后端 Rust + Tauri 2，执行历史、AI 对话、代码片段、应用配置统一进 SQLite。
+
+## 核心难题：30 多种语言，怎么才能不写成 30 个 if-else
+
+支持一种语言的运行很简单：找到解释器/编译器，拼一条命令，起个子进程，把输出抓回来。
+
+但当语言数量往上涨，这种天真的写法会迅速崩坏成一坨巨大的分支判断——「如果是 Python 就这样、如果是 Go 就那样、如果是 Rust 还要先编译再运行……」。每加一种语言都要回头改核心逻辑，每一种语言的特殊性都在污染主流程。这是典型的、会随规模膨胀而失控的设计。
+
+所以从一开始我就把它设计成**插件化**的。但我想强调的是它的灵魂不在「插件」这个词，而在于——**它是配置驱动的**。核心引擎不认识任何具体语言，它只认识一份描述「这门语言该怎么跑」的配置；绝大多数通用逻辑（拼命令、起进程、抓输出、清理）都写在统一的地方，而每个语言插件本身薄得惊人。
+
+### 一个语言插件，薄到什么程度
+
+落到 Rust 里，所有语言实现同一个 trait：
+
+```rust
+pub trait LanguagePlugin: Send + Sync {
+    fn get_language_name(&self) -> &'static str;   // 显示名，如 "Python 3"
+    fn get_language_key(&self) -> &'static str;    // 唯一键，如 "python3"
+    fn get_file_extension(&self) -> String;        // 扩展名
+    fn get_version_args(&self) -> Vec<&'static str>; // 版本探测参数
+    fn get_path_command(&self) -> String;          // 探测工具链是否可用
+    fn get_default_config(&self) -> PluginConfig;  // 默认配置（核心）
+    fn get_default_command(&self) -> String;
+    // …还有一组带默认实现的钩子，下面会讲
+}
+```
+
+真正承载「这门语言怎么跑」的，是它返回的那份 `PluginConfig`：
+
+```rust
+pub struct PluginConfig {
+    pub enabled: bool,
+    pub extension: String,
+    pub language: String,
+    pub run_command: Option<String>,     // 命令模板，如 "python3 $filename"
+    pub before_compile: Option<String>,  // 运行前的准备命令
+    pub after_compile: Option<String>,   // 运行后的清理命令
+    pub template: Option<String>,        // 新建文件时的初始模板
+    pub timeout: Option<u64>,            // 超时（默认 30s）
+    pub execute_home: Option<String>,    // 自定义工具链路径
+    // …
+}
+```
+
+于是一个解释型语言的插件，几乎就是「填一张表」。这是 Python 3 插件的全部核心——没有任何执行逻辑，只是声明「我叫什么、扩展名是啥、用 `python3 $filename` 跑」：
+
+```rust
+fn get_default_config(&self) -> PluginConfig {
+    PluginConfig {
+        enabled: true,
+        language: "python3".into(),
+        extension: "py".into(),
+        run_command: Some("python3 $filename".into()),  // $filename 运行时被替换
+        before_compile: None,
+        after_compile: None,
+        template: Some("# 在这里输入 Python 3 代码".into()),
+        timeout: Some(30),
+        // …
+    }
+}
+```
+
+核心引擎拿到文件后，从配置里取出 `run_command`，把 `$filename` 替换成真实路径，剩下的——起进程、流式抓输出、算耗时——全是**与语言无关**的通用逻辑。加一门解释型语言，本质上就是再填一张这样的表。
+
+### 编译型语言怎么塞进同一套抽象
+
+解释型一步到位，麻烦的是 Rust、C/C++、Java 这类「先编译、再运行」的两步语言。我没有为它们单独造一套机制，而是用了两个朴素但好使的办法。
+
+**第一招：用 shell 的 `&&` 把两步串成一条命令。** Rust 插件就是这么干的——它的运行命令实际展开成：
+
+```text
+rustc /path/to/main.rs -o /tmp/main && /tmp/main
+```
+
+编译和运行被 `&&` 连成一个整体交给 shell。编译失败，`&&` 短路，编译器的报错就成了本次运行的输出——而这恰恰是「验证代码」场景里用户最想看到的东西，根本不需要单独搞一套错误展示。跑完之后，`after_compile` 配了 `rm -f /tmp/main` 把产物清掉。Windows 上则换成 `cmd /c "rustc ... -o main.exe && main.exe"`，平台差异用 `#[cfg(target_os)]` 分支隔开。
+
+**第二招：`before_compile` / `after_compile` 两个钩子。** Go 插件的 `before_compile` 是 `go mod init temp 2>/dev/null || true`——临时跑一段 Go 片段得先有个 module，这个钩子就替用户把它补上了，`|| true` 保证已经初始化过时不报错。运行命令本身用 `go run $filename`，一步编译加运行。
+
+Java 我直接用了 `java $filename`：Java 11 起支持单文件源码模式，一条命令就能编译加运行，连 `javac` 那一步都省了；再挂一个 `after_compile: rm -f *.class` 兜底清理可能残留的字节码。
+
+你看，编译型语言的全部「特殊性」，最后都收敛成了配置里的几个字符串字段，没有一行渗进核心引擎。
+
+### 这套设计最大的红利：加语言常常不用写代码
+
+因为「怎么跑一门语言」已经被完整地编码进了 `PluginConfig`（命令模板 + 编译前后钩子 + 扩展名 + 超时），所以新增语言很多时候根本不需要写 Rust——填一份配置就行。我把这个能力直接开放给了用户：内置插件之外，还有一类 `CustomPlugin`，启动时从用户配置里加载，只要语言键不和内置的冲突，用户就能纯靠填配置给 CodeForge 加一门新语言。配置驱动设计在这里兑现了它最大的价值。
+
+## 运行时的几个真实工程细节
+
+把代码跑起来，魔鬼都在细节里。几个我觉得值得一提的：
+
+**工具链探测。** 用户机器上不一定装了对应工具链——没人会为了跑段 Haskell 恰好装了 GHC。所以每个插件都要给出探测自己的方式：`get_version_args` 提供版本参数（Python 是 `--version`、Java 是 `-version`、Go 是 `version`，各不相同），`get_path_command` 给出定位工具的命令——有些直接得很巧，比如 Python 用 `import sys; print(sys.executable)` 反查自己的解释器路径。探测不到就给一句明确的「未检测到 xxx」，而不是甩给用户一坨 `command not found`。
+
+**在配置里设环境变量。** `before_compile` 不只能跑准备命令，还能写 `export KEY=value`（Unix）或 `set KEY=value`（Windows），插件会解析它、跨平台地设进环境，还会帮你展开 `$PATH` / `%PATH%`。这样一些需要特定环境变量才能跑的语言，不用改代码、配置里写一行就解决了。
+
+**多标签并发与流式输出。** 每次运行请求都带一个 `task_id`，用它做事件路由：Rust 端读到一段子进程输出就带着 `task_id` 发事件，前端按 `task_id` 把输出投递到对应的标签页。于是多个标签可以同时各跑各的，输出实时流式刷新、互不串台，而不是憋到进程结束才一次性吐出来。
+
+**「成功但没输出」也是一种结果。** 有个小细节我自己挺得意：运行成功、但 stdout/stderr 都为空时，后执行钩子会填一个 `END-NO-OUTPUT` 的哨兵值。否则用户点了运行、界面一片空白，根本分不清是「跑成功了但本来就没输出」还是「卡住了」。一个哨兵值，把这两种状态明确区分开。
+
+**每语言可配的超时。** 默认 30 秒，但写死在配置里、可按语言调整，避免一段死循环把应用拖住。
+
+## 顺手做的一件事：把结构化数据「看明白」
+
+跑代码经常会吐出 JSON，而一坨压扁的 JSON 是很难读的。
+
+所以我顺手给 JSON / XML / YAML 做了两种可视化：可折叠的**层级树**，以及把字段关系画成卡片 + 连线的**关系图**。Markdown 会实时渲染预览（内嵌 HTML 用 DOMPurify 净化，防 XSS）。还有一个我自己很喜欢的小功能——识别到文件是 GitHub Actions 的 workflow 时，自动把它渲染成 **Jobs 依赖的 DAG 图**：触发事件、各个 Job、它们之间的依赖和每个 Job 的 Steps，一目了然，比对着 YAML 数缩进强多了。
+
+## 写在最后
+
+做到现在，CodeForge 大概是我「最想自己天天用」的一个项目——它解决的就是我自己每天都会遇到的麻烦。配置驱动的插件化在前期看起来有点「过度设计」，但当语言数量从 5 种涨到 30 多种时，它的价值才真正显现：核心一直很干净，加语言变成了一件愉快的、甚至能交给用户自己完成的事。
+
+如果你对实现感兴趣，或者也想要这么一个本地的多语言代码草稿本，欢迎来看看、点个 star、提 issue：
+
+**👉 <https://github.com/devlive-community/codeforge>**
+
+技术栈：Vue 3 + TypeScript + CodeMirror 6（前端）· Rust + Tauri 2（后端）· SQLite（存储）· 配置驱动的插件化语言系统（架构）。
+
+对了，**你最希望它支持哪种语言、或者最想要什么功能？** 评论区告诉我，下一个版本说不定就给你安排上。
diff --git a/docs/src/content/blogs.ts b/docs/src/content/blogs.ts
new file mode 100644
index 00000000..3c3885e5
--- /dev/null
+++ b/docs/src/content/blogs.ts
@@ -0,0 +1,47 @@
+// 技术博客：扫描 blog/*.md，自动生成博客列表与路由组件。
+
+export interface BlogMeta {
+  slug: string
+  title: string
+  date?: string
+  author?: string
+  description?: string
+  tags?: string[]
+}
+
+const slugFromPath = (p: string): string => (p.match(/([^/]+)\.md$/)?.[1]) ?? p
+
+// 按日期降序排序
+const compareDateDesc = (a: string | undefined, b: string | undefined): number => {
+  if (!a && !b) return 0
+  if (!a) return 1
+  if (!b) return -1
+  return b.localeCompare(a)
+}
+
+// 导入所有 markdown 文件
+const modules = import.meta.glob<any>('./blog/*.md', { eager: true })
+
+const blogsData: BlogMeta[] = Object.entries(modules).map(([path, module]) => {
+  const slug = slugFromPath(path)
+  // 日期格式为 ISO 8601 字符串，提取 YYYY-MM-DD 部分
+  const date = module.date
+  const dateStr = typeof date === 'string' ? date.split('T')[0] : date
+  return {
+    slug,
+    title: module.title || slug,
+    date: dateStr,
+    author: module.author,
+    description: module.description,
+    tags: module.tags || []
+  }
+})
+
+export const blogs: BlogMeta[] = blogsData.sort((a, b) => compareDateDesc(a.date, b.date))
+
+// 路由：每篇博客一个静态路由，便于 vite-ssg 全量预渲染
+const componentLoaders = import.meta.glob('./blog/*.md')
+export const blogRoutes = Object.entries(componentLoaders).map(([path, loader]) => ({
+  path: `/blog/${slugFromPath(path)}`,
+  component: loader
+}))
diff --git a/docs/src/i18n.ts b/docs/src/i18n.ts
index 61ffde36..52a31a4a 100644
--- a/docs/src/i18n.ts
+++ b/docs/src/i18n.ts
@@ -5,7 +5,7 @@ export type Locale = (typeof SUPPORTED_LOCALES)[number]
 
 const messages = {
   zh: {
-    nav: {download: '下载', releases: '发布日志'},
+    nav: {download: '下载', blog: '博客', releases: '发布日志'},
     hero: {
       badge: 'v{version} 已发布',
       title1: '轻量级桌面',
@@ -44,10 +44,10 @@ const messages = {
       open: '100%', openLabel: '开源免费'
     },
     releaseList: {title: '发布日志', intro: '每个版本的更新内容如下，点击查看详情。'},
-    footer: {download: '下载', releases: '发布日志'}
+    footer: {download: '下载', blog: '博客', releases: '发布日志'}
   },
   en: {
-    nav: {download: 'Download', releases: 'Releases'},
+    nav: {download: 'Download', blog: 'Blog', releases: 'Releases'},
     hero: {
       badge: 'v{version} released',
       title1: 'Lightweight desktop',
@@ -86,7 +86,7 @@ const messages = {
       open: '100%', openLabel: 'Open source'
     },
     releaseList: {title: 'Releases', intro: 'Update notes for each version. Click to view details.'},
-    footer: {download: 'Download', releases: 'Releases'}
+    footer: {download: 'Download', blog: 'Blog', releases: 'Releases'}
   }
 }
 
diff --git a/docs/src/layouts/BlogLayout.vue b/docs/src/layouts/BlogLayout.vue
new file mode 100644
index 00000000..c0996022
--- /dev/null
+++ b/docs/src/layouts/BlogLayout.vue
@@ -0,0 +1,155 @@
+<template>
+  <div class="max-w-7xl mx-auto px-5 py-10">
+    <div class="grid grid-cols-1 lg:grid-cols-[minmax(0,1fr)_250px] gap-10">
+      <!-- 博客正文 -->
+      <article class="prose-doc min-w-0">
+        <slot/>
+        
+        <!-- 上一篇/下一篇导航 -->
+        <nav v-if="prevBlog || nextBlog" class="not-prose mt-16 pt-8 border-t border-slate-200 dark:border-slate-800">
+          <div class="grid grid-cols-1 sm:grid-cols-2 gap-4">
+            <!-- 上一篇 -->
+            <RouterLink v-if="prevBlog" :to="`/blog/${prevBlog.slug}`"
+                        class="group flex flex-col p-5 rounded-xl border-2 border-slate-200 dark:border-slate-800 hover:border-brand-400 dark:hover:border-brand-500 hover:shadow-lg transition-all">
+              <span class="text-xs font-semibold text-slate-500 dark:text-slate-400 mb-2">← 上一篇</span>
+              <span class="font-medium text-slate-900 dark:text-white group-hover:text-brand-600 dark:group-hover:text-brand-400 transition-colors line-clamp-2">
+                {{ prevBlog.title }}
+              </span>
+            </RouterLink>
+            <div v-else></div>
+            
+            <!-- 下一篇 -->
+            <RouterLink v-if="nextBlog" :to="`/blog/${nextBlog.slug}`"
+                        class="group flex flex-col p-5 rounded-xl border-2 border-slate-200 dark:border-slate-800 hover:border-brand-400 dark:hover:border-brand-500 hover:shadow-lg transition-all text-right">
+              <span class="text-xs font-semibold text-slate-500 dark:text-slate-400 mb-2">下一篇 →</span>
+              <span class="font-medium text-slate-900 dark:text-white group-hover:text-brand-600 dark:group-hover:text-brand-400 transition-colors line-clamp-2">
+                {{ nextBlog.title }}
+              </span>
+            </RouterLink>
+          </div>
+        </nav>
+        
+        <!-- 返回列表 -->
+        <div class="not-prose mt-8 text-center">
+          <RouterLink to="/blog" 
+                      class="inline-flex items-center gap-2 px-5 py-3 rounded-xl text-slate-600 dark:text-slate-400 hover:text-brand-600 dark:hover:text-brand-400 hover:bg-slate-100 dark:hover:bg-slate-800 transition-all">
+            <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+              <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M7 16l-4-4m0 0l4-4m-4 4h18"/>
+            </svg>
+            <span>返回博客列表</span>
+          </RouterLink>
+        </div>
+      </article>
+      
+      <!-- 右侧目录 -->
+      <aside class="hidden lg:block">
+        <div class="sticky top-24">
+          <p class="px-3 text-xs font-semibold uppercase tracking-wider text-slate-400 mb-3">目录</p>
+          <nav class="space-y-1 max-h-[70vh] overflow-y-auto">
+            <a v-for="heading in headings" :key="heading.id"
+               :href="`#${heading.id}`"
+               :class="[
+                 'block px-3 py-1.5 rounded-lg text-sm transition-colors',
+                 heading.level === 2 ? 'pl-3' : 'pl-6',
+                 activeId === heading.id 
+                   ? 'bg-brand-50 dark:bg-brand-900/30 text-brand-700 dark:text-brand-300 font-medium'
+                   : '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'
+               ]"
+               @click.prevent="scrollToHeading(heading.id)">
+              {{ heading.text }}
+            </a>
+          </nav>
+        </div>
+      </aside>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+import {computed, onMounted, onUnmounted, ref} from 'vue'
+import {useRoute} from 'vue-router'
+import {blogs} from '../content/blogs'
+
+const route = useRoute()
+
+const currentSlug = computed(() => {
+  const match = route.path.match(/\/blog\/([^/]+)/)
+  return match ? match[1] : null
+})
+
+const currentIndex = computed(() => {
+  if (!currentSlug.value) return -1
+  return blogs.findIndex(b => b.slug === currentSlug.value)
+})
+
+const prevBlog = computed(() => {
+  const idx = currentIndex.value
+  return idx > 0 ? blogs[idx - 1] : null
+})
+
+const nextBlog = computed(() => {
+  const idx = currentIndex.value
+  return idx >= 0 && idx < blogs.length - 1 ? blogs[idx + 1] : null
+})
+
+// 目录相关
+interface Heading {
+  id: string
+  text: string
+  level: number
+}
+
+const headings = ref<Heading[]>([])
+const activeId = ref<string>('')
+
+const extractHeadings = () => {
+  const article = document.querySelector('.prose-doc')
+  if (!article) return
+  
+  const h2s = article.querySelectorAll('h2, h3')
+  headings.value = Array.from(h2s).map(h => ({
+    id: h.id,
+    text: h.textContent || '',
+    level: parseInt(h.tagName[1])
+  }))
+}
+
+const scrollToHeading = (id: string) => {
+  const element = document.getElementById(id)
+  if (element) {
+    element.scrollIntoView({ behavior: 'smooth', block: 'start' })
+  }
+}
+
+const updateActiveHeading = () => {
+  const headingElements = headings.value.map(h => document.getElementById(h.id)).filter(Boolean)
+  
+  // 找到当前在视口顶部的标题
+  for (let i = headingElements.length - 1; i >= 0; i--) {
+    const element = headingElements[i]
+    if (element && element.getBoundingClientRect().top <= 100) {
+      activeId.value = element.id
+      return
+    }
+  }
+  
+  // 如果没有标题在视口顶部，默认激活第一个
+  if (headingElements.length > 0) {
+    activeId.value = headingElements[0]!.id
+  }
+}
+
+onMounted(() => {
+  // 等待 markdown 渲染完成后提取标题
+  setTimeout(() => {
+    extractHeadings()
+    updateActiveHeading()
+  }, 100)
+  
+  window.addEventListener('scroll', updateActiveHeading)
+})
+
+onUnmounted(() => {
+  window.removeEventListener('scroll', updateActiveHeading)
+})
+</script>
diff --git a/docs/src/pages/BlogList.vue b/docs/src/pages/BlogList.vue
new file mode 100644
index 00000000..a2ab4632
--- /dev/null
+++ b/docs/src/pages/BlogList.vue
@@ -0,0 +1,56 @@
+<template>
+  <div class="max-w-6xl mx-auto px-5 py-16">
+    <h1 class="text-5xl font-extrabold tracking-tight text-slate-900 dark:text-white mb-4">
+      技术博客
+    </h1>
+    <p class="text-lg text-slate-600 dark:text-slate-400 mb-12">
+      分享开发经验、使用教程和技术洞察
+    </p>
+    
+    <div class="grid grid-cols-1 md:grid-cols-2 gap-6">
+      <RouterLink v-for="blog in blogs" :key="blog.slug" :to="`/blog/${blog.slug}`"
+                  class="group relative flex flex-col p-6 rounded-2xl border-2 border-slate-200 dark:border-slate-800 bg-gradient-to-br from-white to-slate-50 dark:from-slate-900 dark:to-slate-900/50 hover:border-brand-400 dark:hover:border-brand-500 hover:shadow-xl hover:shadow-brand-500/10 dark:hover:shadow-brand-500/20 transition-all duration-300 hover:-translate-y-1">
+        <!-- 标题 -->
+        <h2 class="text-xl font-bold text-slate-900 dark:text-white group-hover:text-brand-600 dark:group-hover:text-brand-400 transition-colors mb-3">
+          {{ blog.title }}
+        </h2>
+        
+        <!-- 元信息 -->
+        <div class="flex items-center gap-4 text-sm text-slate-500 dark:text-slate-400 mb-4">
+          <span v-if="blog.date" class="flex items-center gap-1">
+            <svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+              <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 7V3m8 4V3m-9 8h10M5 21h14a2 2 0 002-2V7a2 2 0 00-2-2H5a2 2 0 00-2 2v12a2 2 0 002 2z"/>
+            </svg>
+            {{ blog.date }}
+          </span>
+          <span v-if="blog.author" class="flex items-center gap-1">
+            <svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+              <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M16 7a4 4 0 11-8 0 4 4 0 018 0zM12 14a7 7 0 00-7 7h14a7 7 0 00-7-7z"/>
+            </svg>
+            {{ blog.author }}
+          </span>
+        </div>
+        
+        <!-- 描述 -->
+        <p v-if="blog.description" class="text-sm text-slate-600 dark:text-slate-300 leading-relaxed line-clamp-2 mb-4 flex-1">
+          {{ blog.description }}
+        </p>
+        
+        <!-- 标签 -->
+        <div v-if="blog.tags && blog.tags.length > 0" class="flex flex-wrap gap-2">
+          <span v-for="tag in blog.tags" :key="tag" 
+                class="px-2.5 py-1 rounded-lg bg-slate-100 dark:bg-slate-800 text-xs font-medium text-slate-600 dark:text-slate-300">
+            {{ tag }}
+          </span>
+        </div>
+        
+        <!-- 装饰渐变 -->
+        <div class="absolute inset-0 rounded-2xl bg-gradient-to-br from-brand-500/0 via-brand-500/0 to-brand-500/10 opacity-0 group-hover:opacity-100 transition-opacity pointer-events-none"></div>
+      </RouterLink>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+import {blogs} from '../content/blogs'
+</script>
diff --git a/docs/src/router.ts b/docs/src/router.ts
index bba0b5dd..baf10192 100644
--- a/docs/src/router.ts
+++ b/docs/src/router.ts
@@ -2,11 +2,15 @@ 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 BlogList from './pages/BlogList.vue'
 import {releaseRoutes} from './content/releases'
+import {blogRoutes} from './content/blogs'
 
 export const routes: RouteRecordRaw[] = [
   {path: '/', component: Home, meta: {title: 'CodeForge — 轻量级桌面代码执行器'}},
   {path: '/download', component: Download, meta: {title: '下载 CodeForge'}},
   {path: '/release', component: ReleaseList, meta: {title: '发布日志'}},
-  ...releaseRoutes.map(r => ({...r, meta: {doc: true}}))
+  {path: '/blog', component: BlogList, meta: {title: '技术博客'}},
+  ...releaseRoutes.map(r => ({...r, meta: {doc: true, docType: 'release'}})),
+  ...blogRoutes.map(r => ({...r, meta: {doc: true, docType: 'blog'}}))
 ]