Files
SOLO-WEB-DESKTOP-ELECTRON/README.md

54 lines
2.6 KiB
Markdown

# Solo Trae Desktop Installers
### Code Mode
![Solo in Code Mode](assets/windows-screenshot.png)
This repository contains native desktop installers for **Solo Trae** (https://solo.trae.ai) on both **Windows** and **Linux**.
### Work Mode
![Solo in Work Mode](assets/linux-screenshot.png)
The installers are built using a wrapper around the official Electron runtime and bundled with a Go-based self-extracting deployment tool. They provide a seamless native application experience without requiring standard browsers or manual configuration.
## Files Provided
### 1. `SoloInstaller.exe` (Windows)
A completely silent, self-extracting native installer for Windows (x64).
- **How to Use:** Download and double-click `SoloInstaller.exe`.
- **What it Does:**
- Extracts the pre-configured Electron app silently to your `%APPDATA%\SoloApp` directory.
- Automatically creates a desktop shortcut (`Solo.lnk`).
- Immediately launches the Solo application.
### 2. `SoloInstaller-Linux` (Linux)
A native executable installer for Linux (x64).
- **How to Use:**
1. Download the file.
2. Make it executable: `chmod +x SoloInstaller-Linux`
3. Run it: `./SoloInstaller-Linux`
- **What it Does:**
- Extracts the Linux Electron app silently to your `~/.config/SoloAppLinux` (or a fallback temp directory).
- Sets the correct execution permissions.
- Creates a `.desktop` shortcut on your Desktop for easy access.
- Launches the Solo application.
## Development Details
- **Runtime:** Built around Electron v41.1.1
- **Packaging:** Bundled using Go `embed` to bypass traditional deployment toolchain limitations (like Wine).
- **Silent Mode:** Installers execute completely in the background without requiring user interaction (No Next/Finish wizards).
## OpenClaw Automated Self-Healing Engine
Included in this repository is `openclaw-healer.sh`, a robust background daemon script designed to mitigate headless browser crashes and port deadlocks commonly encountered when automating OpenClaw or Puppeteer.
### What it does:
1. **Zombie Reaping:** Continuously scans for and aggressively reaps `[Z] Defunct` instances of Chrome, Chromium, and Puppeteer by terminating their deadlocked parent processes.
2. **Port Mitigation:** Monitors target ports (default `18800`) for stalled processes. If a process holds the port for longer than 120 seconds, the healer executes a forced termination (`kill -15` then `kill -9`) to guarantee the port is released for the next automation task.
### How to run it:
```bash
chmod +x openclaw-healer.sh
nohup bash -c "while true; do ./openclaw-healer.sh; sleep 60; done" > /var/log/openclaw-healer.log 2>&1 &
```