mirror of
https://github.com/zhayujie/chatgpt-on-wechat.git
synced 2026-07-17 11:07:11 +08:00
49452e035d
- Add a minimal application menu with common items and shortcuts: New Chat (Cmd+N), Settings (Cmd+,), Reload, etc. - Add system tray with show window, new chat, and quit; click icon to restore - Add single-instance lock so relaunching focuses the existing window - Implement close-to-tray: closing the window hides it; only a real quit destroys it - Explicitly define Window menu's Close Window bound to Cmd+W / Ctrl+W to reliably trigger hide-to-tray - Listen for menu-action in the renderer to handle menu-triggered new chat / open settings
CowAgent Desktop
Cross-platform desktop client for CowAgent, built with Electron + React + TypeScript.
Development
Prerequisites
- Node.js 18+
- npm or yarn
- Python 3.7+ (for the backend)
Setup
cd desktop
npm install
Run in Development
Start the renderer dev server and Electron together:
npm run dev
Or run them separately:
# Terminal 1: Start Vite dev server
npm run dev:renderer
# Terminal 2: Start Electron (after renderer is ready)
npm run dev:main
The app will automatically start the Python backend from the parent directory.
Build
# Build for current platform
npm run dist
# Build for macOS only
npm run dist:mac
# Build for Windows only
npm run dist:win
Build outputs are placed in the release/ directory.
Architecture
desktop/
├── src/
│ ├── main/ # Electron main process
│ │ ├── index.ts # Window management, IPC
│ │ ├── python-manager.ts # Python backend lifecycle
│ │ └── preload.ts # Context bridge for renderer
│ └── renderer/ # React UI (Vite)
│ └── src/
│ ├── api/ # HTTP client for backend APIs
│ ├── components/ # Reusable UI components
│ ├── hooks/ # React hooks
│ ├── pages/ # Page components
│ └── types.ts # TypeScript types
├── resources/ # App icons
├── package.json # Dependencies and build config
└── vite.config.ts # Vite config
How it Works
- Electron main process starts and creates the app window
- It spawns the Python backend (
app.py) as a child process - The React UI communicates with the Python backend via HTTP APIs
- SSE (Server-Sent Events) is used for streaming chat responses and live logs