feat(update): implement update check functionality and UI integration

Author: MidnightCrowing

electron/ipc/index.ts

@@ -6,3 +6,4 @@ import './path'
 import './project'
 import './settings'
 import './system'
+import './update'

electron/ipc/system.ts

@@ -5,14 +5,14 @@ import process from 'node:process'
 import { ipcMain, shell } from 'electron'
 
 // 在系统默认浏览器中打开链接
-ipcMain.handle('external:open', (_, url: string): void => {
+ipcMain.handle('external:open', async (_, url: string): Promise<void> => {
   shell.openExternal(url)
     .then(() => {})
     .catch(err => console.error('Failed to open link:', err))
 })
 
 // 使用资源管理器打开路径
-ipcMain.handle('explorer:open', (_, folderPath: string): void => {
+ipcMain.handle('explorer:open', async (_, folderPath: string): Promise<void> => {
   const resolvedPath = path.resolve(folderPath)
   // 使用系统默认的资源管理器打开文件夹
   shell.openPath(resolvedPath).catch((err) => {
@@ -21,7 +21,7 @@ ipcMain.handle('explorer:open', (_, folderPath: string): void => {
 })
 
 // 使用终端打开路径
-ipcMain.handle('terminal:open', (_, folderPath: string): void => {
+ipcMain.handle('terminal:open', async (_, folderPath: string): Promise<void> => {
   const resolvedPath = path.resolve(folderPath)
   // 根据操作系统选择合适的终端命令
   const isWindows = process.platform === 'win32'

electron/ipc/theme.ts

@@ -3,7 +3,7 @@ import { ipcMain } from 'electron'
 import { getMainWindow } from '../main'
 
 // 设置主题
-ipcMain.handle('theme:set', (event, theme: string): void => {
+ipcMain.handle('theme:set', async (_, theme: string): Promise<void> => {
   const colorSettings = theme === 'dark'
     ? { color: '#2B2D30', symbolColor: '#DFE1E5' }
     : { color: '#F2F2F2', symbolColor: '#222323' }

electron/ipc/update.ts

@@ -0,0 +1,80 @@
+import { app, ipcMain } from 'electron'
+
+interface CheckUpdateResult {
+  hasUpdate: boolean
+  currentVersion: string
+  latestVersion?: string
+  url?: string
+  name?: string
+  notes?: string
+  publishedAt?: string
+  error?: string
+}
+
+function normalizeVersion(v: string | undefined): string {
+  if (!v)
+    return '0.0.0'
+  // remove leading v/V and trim whitespace
+  const cleaned = v.trim().replace(/^v/i, '')
+  // drop pre-release/build metadata for comparison
+  return cleaned.split(/[+-]/)[0]
+}
+
+function compareSemver(a: string, b: string): number {
+  const pa = normalizeVersion(a).split('.').map(n => Number.parseInt(n, 10) || 0)
+  const pb = normalizeVersion(b).split('.').map(n => Number.parseInt(n, 10) || 0)
+  for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+    const na = pa[i] ?? 0
+    const nb = pb[i] ?? 0
+    if (na > nb)
+      return 1
+    if (na < nb)
+      return -1
+  }
+  return 0
+}
+
+ipcMain.handle('update:check', async (): Promise<CheckUpdateResult> => {
+  try {
+    // robust version source for dev and packaged
+    const currentVersion = app.getVersion() || '0.0.0'
+
+    // GitHub Releases API: latest (excludes drafts and prereleases)
+    const res = await fetch('https://api.github.com/repos/MidnightCrowing/CodeNest/releases/latest', {
+      headers: {
+        'Accept': 'application/vnd.github+json',
+        'User-Agent': 'CodeNest (Electron)',
+      },
+    })
+
+    if (!res.ok) {
+      // e.g. rate limited or not found
+      return { hasUpdate: false, currentVersion, error: `Request failed: ${res.status}` }
+    }
+
+    const json: any = await res.json()
+    const latestTag = json?.tag_name as string | undefined
+    const latestVersion = normalizeVersion(latestTag || json?.name)
+    const url: string | undefined = json?.html_url || 'https://github.com/MidnightCrowing/CodeNest/releases/latest'
+    const name: string | undefined = json?.name
+    const notes: string | undefined = json?.body
+    const publishedAt: string | undefined = json?.published_at
+
+    const cmp = compareSemver(currentVersion, latestVersion)
+    const hasUpdate = cmp < 0
+
+    return {
+      hasUpdate,
+      currentVersion,
+      latestVersion,
+      url,
+      name,
+      notes,
+      publishedAt,
+    }
+  }
+  catch (e: any) {
+    const currentVersion = app.getVersion() || '0.0.0'
+    return { hasUpdate: false, currentVersion, error: e?.message || String(e) }
+  }
+})

electron/preload.ts

@@ -32,6 +32,9 @@ contextBridge.exposeInMainWorld('api', {
   openInExplorer: (path: string) => ipcRenderer.invoke('explorer:open', path),
   openInTerminal: (path: string) => ipcRenderer.invoke('terminal:open', path),
 
+  // update
+  checkUpdate: () => ipcRenderer.invoke('update:check'),
+
   // theme
   setWindowTheme: (currentTheme: 'light' | 'dark') => ipcRenderer.invoke('theme:set', currentTheme),
 })

src/global.d.ts

@@ -35,6 +35,18 @@ declare global {
       openInExplorer: (path: string) => void
       openInTerminal: (path: string) => void
 
+      // update
+      checkUpdate: () => Promise<{
+        hasUpdate: boolean
+        currentVersion: string
+        latestVersion?: string
+        url?: string
+        name?: string
+        notes?: string
+        publishedAt?: string
+        error?: string
+      }>
+
       // theme
       setWindowTheme: (currentTheme: ThemeEnum) => void
     }

src/locales/en.yml

@@ -162,7 +162,12 @@ settings:
     cancel: No
   about:
     title: About
-    version: Version
+    version:
+      title: Version
+      check_update: Check for updates
+      checking_update: Checking for updates...
+      is_latest: You are on the latest version
+      found_new: New version available
     link: Link
     import_export:
       title: Import/Export

src/locales/zh-CN.yml

@@ -154,7 +154,12 @@ settings:
     cancel: 否
   about:
     title: 关于
-    version: 版本
+    version:
+      title: 版本
+      check_update: 检查更新
+      checking_update: 正在检查更新...
+      is_latest: 已是最新版本
+      found_new: 发现新版本
     link: 链接
     import_export:
       title: 导入/导出

src/views/ProjectConfig/ProjectConfigProvider.ts

@@ -5,7 +5,7 @@ import { ProjectKind } from '~/constants/localProject'
 type Nullable<T> = {
   [K in keyof T]: T[K] | null;
 }
-export type NullableLocalProject = Omit<Nullable<LocalProject>, 'kind' | 'license' | 'isTemporary'> & {
+export type NullableLocalProject = Nullable<LocalProject> & {
   kind: ProjectKind
   license: LicenseEnum | string
   isTemporary: boolean

src/views/Settings/pages/About.vue

@@ -1,5 +1,5 @@
 <script lang="ts" setup>
-import { JeTransparentButton } from 'jetv-ui'
+import { JeLink, JeLoader, JeTransparentButton } from 'jetv-ui'
 import { useI18n } from 'vue-i18n'
 
 import { useProjectsStore } from '~/stores/projectsStore'
@@ -9,10 +9,43 @@ import { version } from '../../../../package.json'
 const { t } = useI18n()
 const projects = useProjectsStore()
 
+const checking = ref(false)
+const updateInfo = ref<{
+  hasUpdate: boolean
+  currentVersion: string
+  latestVersion?: string
+  url?: string
+  name?: string
+  notes?: string
+  publishedAt?: string
+  error?: string
+} | null>(null)
+
 function openGithub() {
   window.api.openExternal('https://github.com/MidnightCrowing/CodeNest')
 }
 
+function openRelease(url?: string) {
+  const target = url || 'https://github.com/MidnightCrowing/CodeNest/releases/latest'
+  window.api.openExternal(target)
+}
+
+async function onCheckUpdate() {
+  if (checking.value)
+    return
+  checking.value = true
+  try {
+    const res = await window.api.checkUpdate()
+    updateInfo.value = res
+  }
+  catch (e) {
+    updateInfo.value = { hasUpdate: false, currentVersion: version, error: String(e) }
+  }
+  finally {
+    checking.value = false
+  }
+}
+
 async function importProjects() {
   await window.api.importProject()
   await projects.loadProjects()
@@ -32,9 +65,44 @@ function exportProjects() {
       {{ t('settings.about.title') }}
     </h3>
 
-    <div p="y-5px" flex="~ items-center" gap="5px">
-      <strong>{{ t('settings.about.version') }}: </strong>
-      <span> v{{ version }}</span>
+    <div p="y-5px" flex="~ row" gap="5px">
+      <strong>{{ t('settings.about.version.title') }}: </strong>
+
+      <div flex="~ col" gap="5px">
+        <span> v{{ version }}</span>
+
+        <div flex="~ row items-center" gap="8px">
+          <JeLink
+            type="internal"
+            :disabled="checking"
+            @click="onCheckUpdate"
+          >
+            {{ t('settings.about.version.check_update') }}
+          </JeLink>
+
+          <template v-if="checking">
+            <div flex="~ row items-center" gap="2px">
+              <JeLoader />
+              <span text="secondary">{{ t('settings.about.version.checking_update') }}</span>
+            </div>
+          </template>
+
+          <template v-else-if="updateInfo && !updateInfo.hasUpdate && !updateInfo.error">
+            <span text="secondary">{{ t('settings.about.version.is_latest') }}</span>
+          </template>
+
+          <template v-else-if="updateInfo && updateInfo.hasUpdate">
+            <JeLink type="internal" @click="openRelease(updateInfo.url)">
+              {{ t('settings.about.version.found_new') }}
+              <span v-if="updateInfo.latestVersion">: v{{ updateInfo.latestVersion }}</span>
+            </JeLink>
+          </template>
+
+          <template v-else-if="updateInfo && updateInfo.error">
+            <span text="light:$red-5 dark:$red-5">{{ updateInfo.error }}</span>
+          </template>
+        </div>
+      </div>
     </div>
 
     <div p="y-5px" flex="~ items-center" gap="5px">
@@ -44,7 +112,7 @@ function exportProjects() {
         flex="~ items-center" gap="5px"
         @click="openGithub"
       >
-        <span i-custom:github text="17px" />
+        <span class="i-custom:github" text="17px" />
         GitHub
       </JeTransparentButton>
     </div>
@@ -57,15 +125,15 @@ function exportProjects() {
           flex="~ items-center" gap="5px"
           @click="importProjects"
         >
-          <span i-custom:import text="17px" />
+          <span class="i-custom:import" text="17px" />
           {{ t('settings.about.import_export.import_desc') }}
         </JeTransparentButton>
         <JeTransparentButton
           type="subtle"
           flex="~ items-center" gap="5px"
           @click="exportProjects"
         >
-          <span i-custom:export text="17px" />
+          <span class="i-custom:export" text="17px" />
           {{ t('settings.about.import_export.export_desc') }}
         </JeTransparentButton>
       </div>