Question 1

Why do concurrent GenericAgent `--func` or `run_subagents` tasks read another task's prompt, and how do I fix the temp-file collision?

Accepted Answer

This is a race condition in `agentmain.py` around line 148. Long prompts over 2000 characters are saved to `temp/user_prompt_{int(time.time())}.md`, but second-granularity timestamps can collide when multiple processes run in the same second. One process can overwrite another's prompt, causing agents to read the wrong file.

Fix it by making the filename unique with the PID and nanosecond timestamp:

```python
task_file = os.path.join(
    script_dir,
    'temp',
    f'user_prompt_{os.getpid()}_{time.time_ns()}.md'
)
```

Alternatively, use `tempfile.mkstemp()`:

```python
import tempfile

fd, task_file = tempfile.mkstemp(
    dir=os.path.join(script_dir, 'temp'),
    prefix='user_prompt_',
    suffix='.md'
)
with os.fdopen(fd, 'w', encoding='utf-8') as f:
    f.write(raw_query)
```

Update to a release containing the fix for issue #665, or apply the one-line filename change manually. As a temporary workaround, run long-prompt tasks serially or keep prompts below 2000 characters.

Question 2

How to fix TMWebDriver web_scan returning stale closed tabs while the Chrome extension WebSocket disconnects after about 1 second?

Accepted Answer

This is caused by the master process stdout/stderr being revoked on macOS. Every `print()` then raises `BrokenPipeError`, which aborts the WebSocket handler after `ext_ready`; the port still listens and the WS handshake still returns 101, so `web_scan` silently falls back to cached tab data.

Diagnose:
```bash
lsof -p <master_PID> -a -d 0,1,2
lsof -nP -iTCP:18765
```
If fd 0/1/2 show `(revoked)` and Chrome connections reset every second, this is the issue.

Permanent fix: update TMWebDriver to the release containing PR #673, which wraps master log output in `safe_print`, equivalent to:
```python
import os, sys

def safe_print(*args, **kwargs):
    try:
        print(*args, **kwargs)
    except BrokenPipeError:
        devnull = os.open(os.devnull, os.O_WRONLY)
        os.dup2(devnull, sys.stdout.fileno())
```
The WebSocket read loop should also handle `BrokenPipeError` separately so logging failures do not close the data connection.

Immediate workaround: start the master with stdout and stderr redirected to a real file and keep the main process alive:
```bash
nohup python -c "from TMWebDriver import TMWebDriver; import time; TMWebDriver();
while True: time.sleep(3600)" > /tmp/tmwd.log 2>&1 &
```
Do not rely only on instantiating `TMWebDriver()`; without a keep-alive loop the main process can exit and kill the daemon WebSocket thread.

Question 3

How to fix GenericAgent.exe not loading plugins from the plugins directory?

Accepted Answer

The `plugins/` directory is missing `__init__.py`, so Python does not recognize it as a package and `discover_and_load()` cannot import the registered plugins. Add an empty package marker file:

- Windows Command Prompt: `type nul > plugins\__init__.py`
- PowerShell: `New-Item -ItemType File -Path plugins\__init__.py -Force`
- Linux/macOS: `touch plugins/__init__.py`

If `GenericAgent.exe` is packaged with PyInstaller or a similar tool, rebuild/repackage the executable after adding the file, then restart the agent.

Question 4

GenericAgent 桌面版启动时总是强制最大化窗口，如何配置默认窗口大小？

Accepted Answer

升级到包含 PR `fix(desktop): respect configured window size` 的版本。该版本会在主窗口显示前读取 `~/.ga_desktop_settings.json`，并支持 `maximized`、`window_width`、`window_height`（兼容 `width`、`height`）。

配置示例（Windows 路径为 `%USERPROFILE%\.ga_desktop_settings.json`）：
```json
{
  "maximized": false,
  "window_width": 1280,
  "window_height": 800
}
```
保存后重启 GenericAgent.exe。

旧版本的临时解决方法：修改 `frontends/desktop/src-tauri/tauri.conf.json`，将 `"maximized": true` 改为 `"maximized": false`，然后重新编译桌面端。仅在旧版本中修改用户配置不会生效，因为配置读取发生在窗口初始化之后。

Question 5

How to fix repeated '!!!Error: ProxyError/ConnectionError/SSLError' messages appearing during LLM retries after a Wi-Fi, VPN, or proxy interruption?

Accepted Answer

Upgrade `llmcore` to the release containing the PR `fix(llmcore): suppress intermediate error yield during retry and handle ChunkedEncodingError`. The fix preserves exponential backoff retries—typically 1.5s, 3s, and 6s, up to 4 attempts—but stops sending raw `!!!Error: ...` strings to the UI on each failed attempt. Errors are only surfaced after retries are exhausted, and transient `ChunkedEncodingError` responses are also handled. On older versions, wait for the retry sequence to finish and reconnect to a stable Wi-Fi/VPN/proxy connection. If building from source, merge or cherry-pick that PR, then rebuild and redeploy.

GenericAgent

Core Features

What It Can't Do

Use Cases

Tags

Getting Started

Similar Projects