MiQi Desktop¶
基于 Electron 的轻量级个人 AI 助手桌面应用
概述¶
MiQi Desktop 是一款基于 Electron 构建的桌面应用，为 MiQi AI 代理提供现代化的图形界面。它将强大的 Python AI Agent 引擎 与直观的 React + TypeScript 用户界面相结合。
核心定位¶
- 🎯 个人 AI 助手：非聊天机器人，而是一个有记忆、有技能、能操作文件的桌面 AI
- 🔧 高度可扩展：通过 MCP 协议集成外部工具，支持自定义技能和提供商
- 🖥️ 真实桌面体验：Electron 原生窗口，系统级集成（WSL2 沙箱、文件系统操作）
- 🔒 本地优先：所有数据本地存储，支持文件版本控制的非破坏性编辑
技术栈¶
| 层级 | 技术 | 版本 |
|---|---|---|
| 桌面框架 | Electron | 35.2 |
| 前端 UI | React + TypeScript | 19.1 / 5.8 |
| CSS | Tailwind CSS 4 | 4.x |
| 组件库 | Radix UI + Lucide Icons | - |
| 后端引擎 | Python (asyncio) | 3.11+ |
| CLI 框架 | Typer | 0.20+ |
| 数据模型 | Pydantic v2 | 2.12+ |
| 构建工具 | electron-vite + electron-builder | 3.1 / 26.0 |
| Python 打包 | PyInstaller + Hatchling | 6.20+ |
| 容器化 | Docker + docker-compose | - |