fef7b909e7
- Aggiornato il titolo e aggiunta una descrizione dettagliata. - Rimosso l'indice originale e aggiunto un sommario sintetico. - Introdotta una nuova sezione "Caratteristiche principali". - Rivisti e semplificati i requisiti di sistema. - Riorganizzata la sezione "Installazione e avvio" con istruzioni chiare. - Aggiunta una guida rapida per il primo utilizzo. - Dettagliate le modalità operative: Asta Singola e Multi-Asta. - Inserite strategie consigliate per diversi scenari d'uso. - Aggiunta una sezione tecnica su polling adattivo e click HTTP. - Descritte persistenza dei dati e gestione file locali. - Riviste e chiarite le impostazioni principali e per-asta. - Aggiunti dettagli sull'interfaccia utente e i controlli. - Introdotta una sezione per diagnostica ed esportazione. - Aggiunte FAQ e risoluzione dei problemi comuni. - Inserito un disclaimer sui rischi e responsabilità d'uso. - Creato un changelog sintetico con focus sulle novità della v2.10. - Fornite informazioni su supporto, contributi e note tecniche. - Ribadita la licenza privata del progetto.
158 lines
8.3 KiB
Markdown
158 lines
8.3 KiB
Markdown
# AutoBidder - Guida completa all'uso
|
|
|
|
> AutoBidder è uno strumento desktop per Windows (WPF, .NET 8) pensato per automatizzare le offerte sul sito Bidoo.com. Questa guida descrive caratteristiche, installazione, configurazione, modalità operative, strategie avanzate, dettagli tecnici e risoluzione dei problemi.
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
Sommario
|
|
- Caratteristiche principali
|
|
- Requisiti di sistema
|
|
- Installazione e avvio
|
|
- Guida rapida (primi passi)
|
|
- Modalità operative: Asta Singola e Multi-Asta
|
|
- Strategie e consigli pratici
|
|
- Dettagli tecnici: Polling, Click HTTP e sincronizzazione cookie
|
|
- Impostazioni e persistenza
|
|
- Esportazione e diagnostica
|
|
- FAQ e risoluzione problemi
|
|
- Changelog sintetico
|
|
|
|
---
|
|
|
|
## Caratteristiche principali
|
|
- Monitoraggio in tempo reale di singole aste o molte aste contemporaneamente
|
|
- Due modalità operative: `Asta Singola` (massima precisione) e `Multi-Asta` (monitoraggio e auto-switch)
|
|
- Polling adattivo (HTTP / WebView2 / Active) per ridurre uso di CPU e RAM
|
|
- Click HTTP diretto (reverse engineered) con sincronizzazione dei cookie dal WebView2
|
|
- Persistenza della lista aste (`auctions.json`) e esportazione CSV delle statistiche
|
|
- UI dark theme moderna con griglia in tempo reale, dettagli asta, log e contatori
|
|
|
|
## Requisiti di sistema
|
|
- Windows 10 (1809+) o Windows 11
|
|
- .NET 8.0 Runtime
|
|
- RAM: 4 GB (consigliati 8 GB)
|
|
- Connessione internet stabile
|
|
|
|
## Installazione e avvio
|
|
1. Assicurarsi di avere .NET 8.0 Runtime installato: `dotnet --version` (output: 8.0.x)
|
|
2. Clonare il repository (privato):
|
|
- `git clone https://192.168.30.23/Alby96/Mimante`
|
|
3. Costruire il progetto:
|
|
- `dotnet restore`
|
|
- `dotnet build --configuration Release`
|
|
4. Eseguire l'app:
|
|
- `dotnet run` (dalla cartella del progetto) oppure avviare `AutoBidder.exe` in `bin\\Release\\net8.0-windows`
|
|
|
|
## Guida rapida (primi passi)
|
|
1. Avvia l'app: l'interfaccia principale mostra due pannelli (controlli a sinistra, browser WebView2 a destra).
|
|
2. Login: accedi a `bidoo.com` tramite il browser integrato (se vuoi usare il Click HTTP diretto devi essere loggato).
|
|
3. Scegli modalità:
|
|
- `Asta Singola` per concentrarti su un solo oggetto
|
|
- `Multi-Asta` per monitorare più aste e lasciare che l'app esegua auto-switch
|
|
4. Aggiungi aste (Multi-Asta):
|
|
- Metodo Automatico: vai sulla pagina Preferiti e lascia che l'app rilevi le aste
|
|
- Metodo Manuale: clicca `+ URL` o `Pagina` e incolla/aggiungi l'URL dell'asta
|
|
5. Configura impostazioni globali o per-asta (Timer Click, Min/Max Price, Max Clicks, Max Resets, Ritardo, Multi-Click)
|
|
6. Premi `Avvia` per attivare il Click Loop; il background polling rimane sempre attivo anche senza Avvia.
|
|
|
|
## Modalità operative
|
|
|
|
### Asta Singola
|
|
- Ideale per oggetti di valore dove la precisione è critica.
|
|
- Monitoraggio intensivo del DOM tramite WebView2, contatori dettagliati, lista utenti e log dedicato.
|
|
- Supporta `Multi-Click` (click multipli paralleli) per aumentare probabilità in connessione instabile.
|
|
- Impostazioni consigliate per asta singola: `Timer Click` 0-1, `Multi-Click` ON, `Ritardo` 0ms.
|
|
|
|
### Multi-Asta
|
|
- Monitoraggio simultaneo di molte aste.
|
|
- L'app punta solo sull'asta con `timer` più basso (auto-switch) per evitare concorrere contro se stessa.
|
|
- Per ogni asta è possibile impostare opzioni indipendenti (Timer Click, Min/Max Price, Pausa/Riprendi).
|
|
- Metodo manuale (URL diretto) è raccomandato per monitoraggi massivi (consumo risorse minimo).
|
|
|
|
## Strategie consigliate
|
|
- Monitoraggio massivo (50+ aste): usa `URL Manuale`, `Timer Click` 0, limiti di prezzo bassi.
|
|
- Asta singola ad alto valore: `Timer Click` 0-1, `Multi-Click` ON, `Ritardo` 0ms.
|
|
- Caccia all'affare: `Max Price` molto basso, monitora molte aste con Timer Click 0.
|
|
|
|
## Approfondimento tecnico
|
|
|
|
### Polling adattivo (Dual-Track)
|
|
- Track 1 — Background Polling: esegue richieste HTTP ogni ~5s per aggiornare timer, prezzo e ultimo bidder. Mantiene uso CPU/RAM minimo.
|
|
- Track 2 — Click Loop: attivo solo dopo `Avvia`. Polling dinamico 20-400ms per aste critiche e invio dei click (HTTP diretto o WebView2 fallback).
|
|
|
|
### Click HTTP diretto
|
|
- Al momento dell'azione, il client costruisce una GET verso l'endpoint reverse engineered di Bidoo tipo:
|
|
`GET https://it.bidoo.com/bid.php?AID=81204347&sup=0&shock=0`
|
|
- Richiede i cookie di sessione (PHPSESSID, user_token, ecc.) che vengono sincronizzati dal WebView2.
|
|
- Latenza tipica: 10-30ms (molto più veloce del click via WebView2 che può impiegare 50-100ms)
|
|
- Se il Click HTTP fallisce, l'app esegue fallback automatico con `ExecuteScript` su WebView2.
|
|
|
|
### Sincronizzazione cookie
|
|
- Al primo `Avvia` viene letto il `CookieManager` di `CoreWebView2`, copiato in un `CookieContainer` per l'`HttpClient` utilizzato dai Click HTTP.
|
|
- I cookie sono conservati solo in memoria, mai su disco. Devono essere rinfrescati ri-effettuando il login nel WebView2 se scadono.
|
|
|
|
## Persistenza e file locali
|
|
- Lista aste manuali salvata in:
|
|
`%AppData%\\AutoBidder\\auctions.json`
|
|
- La lista viene ricaricata automaticamente all'avvio dell'app.
|
|
- Esportazione CSV: la funzionalità `Export CSV` genera un file contenente statistiche per ogni asta (nome, ID, URL, timer, prezzo, strategy, click/resets, impostazioni per-asta).
|
|
|
|
## Impostazioni principali
|
|
- `Timer Click` (0-8): secondo del countdown al quale si desidera effettuare il click (0 = 0.0-0.9s)
|
|
- `Max Clicks` / `Max Resets`: limiti operativi (0 = illimitato)
|
|
- `Min/Max Price`: evita puntate fuori dal range desiderato
|
|
- `Ritardo (ms)`: delay aggiuntivo prima di inviare il click
|
|
- `Multi-Click`: invia più click paralleli (utile su connessioni con jitter)
|
|
|
|
## Interfaccia e controlli
|
|
- Pannello sinistro: controlli principali (modalità, Avvia, Pausa, Stop, aggiungi/rimuovi aste, esporta CSV)
|
|
- Pannello destro: browser integrato (WebView2) + dettagli asta quando selezionata
|
|
- Griglia aste (multi-asta): mostra Timer, Prezzo, Strategia, Clicks, Resets, Ultimo bidder
|
|
- Log in tempo reale per ogni asta con dettagli di latenza, risposta server e fallimenti
|
|
|
|
## Diagnostica ed esportazione
|
|
- Abilita log dettagliato prima di aprire issue o per analisi locali
|
|
- Usa `Export CSV` per conservare storici e confrontare strategie
|
|
- Mantieni screenshot del pannello log per report più chiari
|
|
|
|
## FAQ e risoluzione dei problemi
|
|
- "Non vedo Click HTTP riuscito": assicurati di essere loggato nel WebView2 e che la sincronizzazione cookie sia avvenuta (vedi log "Cookie sincronizzati (X cookie)"). Premi `Avvia` dopo il login.
|
|
- "Aste non rilevate": assicurati di essere nella pagina Preferiti per il metodo automatico oppure aggiungi gli URL manualmente.
|
|
- "Il programma non si avvia": verifica .NET 8.0 Runtime installato e che il build sia andato a buon fine.
|
|
- "Click non funzionano": verifica Timer Click, limiti di prezzo e connessione internet. Controlla se il fallback WebView è attivo nei log.
|
|
|
|
## Avvisi e responsabilità
|
|
- L'automazione potrebbe violare i Termini di Servizio di Bidoo. L'uso è a rischio e responsabilità dell'utente.
|
|
- Non salvare credenziali su disco: l'app non memorizza login, usa il WebView2 per la sessione.
|
|
- Cookie e dati di sessione rimangono in memoria e vengono rimossi alla chiusura dell'app.
|
|
|
|
## Changelog sintetico (ultime versioni)
|
|
- v2.10: Click HTTP diretto, sincronizzazione cookie automatica, miglioramenti prestazionali
|
|
- v2.9: Persistenza automatica, UI improvements, export CSV
|
|
- v2.8: Polling adattivo e strategie ibride
|
|
|
|
## Supporto
|
|
- Repository privato Gitea: `https://192.168.30.23/Alby96/Mimante`
|
|
- Per problemi tecnici aprire issue nel repository privato (se abilitato) o contattare il manutentore del progetto.
|
|
|
|
---
|
|
|
|
Note tecniche per sviluppatori
|
|
- Progetto target: `.NET 8.0` (WPF + WebView2)
|
|
- Aree chiave del codice:
|
|
- `Services\\BidooApiClient.cs` — gestione Click HTTP e parsing risposte
|
|
- `Services\\AuctionMonitor.cs` — loop di polling e logica auto-switch
|
|
- `Services\\SessionManager.cs` — sincronizzazione cookie e HttpClient creation
|
|
- `Utilities\\PersistenceManager.cs` — salvataggio/ricaricamento `auctions.json`
|
|
- `ViewModels\\AuctionViewModel.cs` + XAML corrispondenti — visualizzazione e binding UI
|
|
|
|
## Contributi
|
|
- Questo repository è privato. Per contribuire, aprire PR verso branch `main` e seguire le convenzioni del progetto.
|
|
|
|
## Licenza
|
|
- Privato — non distribuire senza autorizzazione del proprietario.
|
|
|
|
Buona fortuna con le aste e usa AutoBidder responsabilmente. |