mirror of
https://github.com/zhayujie/chatgpt-on-wechat.git
synced 2026-07-17 11:07:11 +08:00
ec4c36f450
Introduce get_data_root() driven by the COW_DATA_DIR env var so the packaged desktop build stores config.json, run.log, user data and WeChat credentials under ~/.cow — surviving app updates and keeping the app bundle read-only. Source deployments leave COW_DATA_DIR unset and fall back to the repo root, so existing behavior is unchanged.
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