max / balanced_breakfast
1 file changed,
+4 insertions,
-4 deletions
| @@ -1,4 +1,4 @@ | |||
| 1 | - | # Troubleshooting — Balanced Breakfast | |
| 1 | + | # Troubleshooting: Balanced Breakfast | |
| 2 | 2 | ||
| 3 | 3 | ## Plugin Fetch Failures | |
| 4 | 4 | ||
| @@ -44,7 +44,7 @@ | |||
| 44 | 44 | |---------|-------|-----| | |
| 45 | 45 | | "Invalid OPML: ..." | Malformed XML | Validate OPML syntax (must be valid XML with `<outline>` elements) | | |
| 46 | 46 | | URLs skipped | Non-http/https URLs in OPML | Edit OPML to use only http/https URLs | | |
| 47 | - | | Feeds already exist | Duplicate URLs | Expected — `skipped` counter shows how many were duplicates | | |
| 47 | + | | Feeds already exist | Duplicate URLs | Expected: `skipped` counter shows how many were duplicates | | |
| 48 | 48 | | Import result shows errors | Database or URL validation failures | Check error messages in import result, fix individual URLs | | |
| 49 | 49 | ||
| 50 | 50 | **Import result format:** `{ imported: N, skipped: N, errors: [...] }` | |
| @@ -75,7 +75,7 @@ | |||
| 75 | 75 | | "Max recursion level exceeded" | 32 call levels | Refactor plugin to iterative approach | | |
| 76 | 76 | | "HTTP request limit exceeded" | 100 requests per fetch | Plugin making too many HTTP calls | | |
| 77 | 77 | | "Fetch timeout exceeded" | 60s aggregate per fetch | Plugin spending too long overall | | |
| 78 | - | | "Blocked request to internal address" | localhost/private IPs blocked | Plugin trying SSRF — use public URLs only | | |
| 78 | + | | "Blocked request to internal address" | localhost/private IPs blocked | Plugin trying SSRF. Use public URLs only | | |
| 79 | 79 | ||
| 80 | 80 | **Per-request timeout:** 15 seconds. **Response size limit:** 2 MB. | |
| 81 | 81 | ||
| @@ -94,7 +94,7 @@ | |||
| 94 | 94 | Same SyncKit integration as GoingsOn: | |
| 95 | 95 | - Credentials stored in OS keychain | |
| 96 | 96 | - Push/pull with changelog triggers | |
| 97 | - | - `applying_remote` flag can get stuck — restart app to clear | |
| 97 | + | - `applying_remote` flag can get stuck; restart app to clear | |
| 98 | 98 | - Sync interval: 15 minutes (configurable) | |
| 99 | 99 | ||
| 100 | 100 | **What syncs:** Feed subscriptions, feed tags, user config, query feeds, item read/star state. Item content does NOT sync (fetched independently per device). |