feat: MetonaAI Desktop 初始项目

- Electron + React + TypeScript 架构 - 三栏布局: Sidebar | ChatPanel | DetailPanel - 9 个内置工具 (文件系统/网络/记忆/命令) - SQLite 持久化 (better-sqlite3) - MUI 暗色/亮色主题系统 - Agent Loop ReAct 状态机引擎 - DeepSeek / Agnes AI / Ollama Provider 适配器 - MCP 协议集成 - 系统托盘 + 全局快捷键 - Tailwind CSS v4 + Tailwind Merge - 修复: Sidebar 缺失 TextField 导入导致黑屏
2026-06-27 21:33:27 +08:00
commit 1d185db6b3
109 changed files with 39155 additions and 0 deletions
@@ -0,0 +1,78 @@
+/**
+ * Update Service — 自动更新服务
+ *
+ * @see docs/生产级通用 AI Agent 智能体桌面应用：完整设计与构建指南.html — 第十二章
+ */
+
+import type { BrowserWindow } from 'electron';
+import log from 'electron-log';
+
+interface UpdateInfo {
+  version: string;
+  releaseNotes?: string;
+}
+
+interface DownloadProgress {
+  bytesPerSecond: number;
+  percent: number;
+  transferred: number;
+  total: number;
+}
+
+export class UpdateService {
+  private autoUpdater: {
+    checkForUpdates: () => void;
+    quitAndInstall: () => void;
+    on: (event: string, callback: (...args: unknown[]) => void) => void;
+    logger: unknown;
+    autoInstallOnAppQuit: boolean;
+    autoDownload: boolean;
+  } | null = null;
+
+  constructor(private mainWindow: BrowserWindow) {}
+
+  initialize(): void {
+    try {
+      // electron-updater 可能未安装
+      // eslint-disable-next-line @typescript-eslint/no-require-imports
+      const { autoUpdater } = require('electron-updater');
+      this.autoUpdater = autoUpdater;
+      if (!this.autoUpdater) return;
+      this.autoUpdater.logger = log;
+      this.autoUpdater.autoInstallOnAppQuit = true;
+      this.autoUpdater.autoDownload = true;
+
+      this.autoUpdater.on('checking-for-update', () => this.sendStatus('checking'));
+      this.autoUpdater.on('update-available', (info: unknown) => {
+        this.sendStatus('available', { version: (info as UpdateInfo).version });
+      });
+      this.autoUpdater.on('download-progress', (progress: unknown) => {
+        this.sendStatus('downloading', { progress });
+      });
+      this.autoUpdater.on('update-downloaded', (info: unknown) => {
+        this.sendStatus('downloaded', { version: (info as UpdateInfo).version });
+      });
+      this.autoUpdater.on('error', (err: unknown) => {
+        this.sendStatus('error', { error: (err as Error).message });
+      });
+
+      setTimeout(() => this.autoUpdater?.checkForUpdates(), 5_000);
+    } catch {
+      log.warn('electron-updater not available, auto-update disabled');
+    }
+  }
+
+  checkNow(): void {
+    this.autoUpdater?.checkForUpdates();
+  }
+
+  installAndRestart(): void {
+    this.autoUpdater?.quitAndInstall();
+  }
+
+  private sendStatus(stage: string, data?: Record<string, unknown>): void {
+    if (!this.mainWindow.isDestroyed()) {
+      this.mainWindow.webContents.send('update:status', { stage, ...data });
+    }
+  }
+}