59d7e0c41f
- Aggiornato il titolo e l'introduzione per riflettere le funzionalità. - Aggiunti badge per la versione (3.0) e .NET (8.0). - Riorganizzato il sommario e rinominato in "Indice". - Espansa la sezione "Caratteristiche principali" con nuovi dettagli. - Riformattati i requisiti di sistema per maggiore chiarezza. - Riscritta la guida "Installazione e avvio" con istruzioni dettagliate. - Aggiunta la sezione "Configurazione della sessione (cookie)". - Ampliata la gestione delle aste con dettagli su operazioni e griglia. - Inserite strategie consigliate per diversi scenari d'uso. - Arricchita la sezione tecnica con dettagli su polling e puntate HTTP. - Aggiunta descrizione su persistenza e diagnostica (es. esportazione CSV). - Espansa la sezione FAQ con nuovi scenari di risoluzione problemi. - Introdotte note su sicurezza e responsabilità nell'uso dell'app. - Semplificata la sezione "Supporto" rimuovendo riferimenti privati. - Aggiunte note tecniche per sviluppatori sui file principali del progetto. - Rimossa la sezione "Changelog sintetico" e integrati i dettagli altrove. - Riformattata la sezione "Licenza" per maggiore chiarezza.
148 lines
6.4 KiB
Markdown
148 lines
6.4 KiB
Markdown
# AutoBidder - Guida completa all'uso
|
|
|
|
> AutoBidder è un'app desktop per Windows (WPF, .NET 8) progettata per monitorare aste su Bidoo e inviare offerte automatiche tramite richieste HTTP.
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
Indice
|
|
- Panoramica
|
|
- Caratteristiche principali
|
|
- Requisiti di sistema
|
|
- Installazione e build
|
|
- Avvio e guida rapida
|
|
- Configurazione della sessione (cookie)
|
|
- Gestione aste e griglia principale
|
|
- Impostazioni e strategie consigliate
|
|
- Dettagli tecnici
|
|
- Persistenza, esportazione e diagnostica
|
|
- FAQ e risoluzione dei problemi
|
|
- Supporto
|
|
|
|
---
|
|
|
|
Panoramica
|
|
|
|
AutoBidder monitora e gestisce più aste simultaneamente tramite polling HTTP verso gli endpoint di Bidoo. L'app è pensata per offrire precisione nelle puntate minimizzando l'uso di risorse (CPU/RAM).
|
|
|
|
Caratteristiche principali
|
|
|
|
- Monitoraggio in tempo reale delle aste tramite griglia unica
|
|
- Polling HTTP adattivo per aggiornare timer e prezzo delle aste
|
|
- Invio delle puntate con richieste HTTP dirette (GET a endpoint bid)
|
|
- Inserimento manuale del cookie di sessione tramite dialog dedicato
|
|
- Persistenza della lista aste in `auctions.json` e esportazione CSV delle statistiche
|
|
- Interfaccia scura, log per-asta e contatori in tempo reale
|
|
|
|
Requisiti di sistema
|
|
|
|
- Windows 10 (1809+) o Windows 11
|
|
- .NET 8.0 Runtime
|
|
- RAM: 4 GB (consigliati 8 GB)
|
|
- Connessione Internet stabile
|
|
|
|
Installazione e build
|
|
|
|
1. Verificare il Runtime .NET 8.0: `dotnet --version` (output: 8.0.x)
|
|
2. Clonare il repository (privato):
|
|
- `git clone https://192.168.30.23/Alby96/Mimante`
|
|
3. Dal folder del progetto eseguire:
|
|
- `dotnet restore`
|
|
- `dotnet build --configuration Release`
|
|
4. Eseguire l'app:
|
|
- `dotnet run` oppure avviare `AutoBidder.exe` in `bin\Release\net8.0-windows`
|
|
|
|
Avvio e guida rapida
|
|
|
|
1. Avvia l'app: la finestra principale mostra la griglia delle aste monitorate.
|
|
2. Configura la sessione: apri il dialog `Configura Sessione` e incolla il cookie di sessione (vedi sezione sotto).
|
|
3. Aggiungi aste: clicca `+ Aggiungi` e inserisci l'URL o l'ID dell'asta.
|
|
4. Per ogni asta imposta `Timer Click`, `Min/Max Price`, `Max Clicks` e altre opzioni.
|
|
5. Premi `Avvia Tutti` per iniziare il monitoraggio e l'invio automatico delle puntate.
|
|
|
|
Configurazione della sessione (cookie)
|
|
|
|
Per inviare puntate HTTP è necessario fornire il cookie di sessione della tua istanza di Bidoo. L'app espone un dialog (`Configura Sessione`) con un campo multilinea in cui incollare il valore dell'header `Cookie` o i cookie rilevanti (es. `PHPSESSID`, `user_token`).
|
|
|
|
Come ottenere il cookie da Chrome:
|
|
- Apri Chrome, premi `F12` per aprire gli Strumenti per sviluppatori.
|
|
- Vai alla scheda `Application` ? `Storage` ? `Cookies` ? seleziona `bidoo.com`.
|
|
- Copia il valore del cookie di sessione oppure l'intero header cookie.
|
|
- Incollalo nel campo della finestra `Configura Sessione` e premi `OK`.
|
|
|
|
Note importanti sulla gestione cookie:
|
|
- I cookie inseriti vengono mantenuti solo in memoria durante l'esecuzione e **non** vengono salvati in chiaro su disco.
|
|
- Se il cookie scade è necessario copiarne uno nuovo tramite la stessa procedura.
|
|
|
|
Gestione aste e griglia principale
|
|
|
|
- La griglia mostra tutte le aste monitorate con colonne: nome, timer, prezzo, strategia, click, resets, ultimo bidder.
|
|
- Operazioni disponibili per ogni riga: Avvia/Pausa, Stop, Puntata manuale, Rimuovi.
|
|
- Selezionando una riga si aprono i dettagli per-asta: log, lista utenti e impostazioni dedicate.
|
|
|
|
Impostazioni e strategie consigliate
|
|
|
|
- `Timer Click` (0-8): secondo del countdown al quale inviare la puntata (0 = 0.0-0.9s)
|
|
- `Ritardo (ms)`: delay aggiuntivo prima di inviare il click
|
|
- `Multi-Click` (se disponibile): invia più tentativi paralleli per aumentare affidabilità
|
|
- Uso consigliato:
|
|
- Aste molteplici: impostare Timer basso e limiti di prezzo conservativi
|
|
- Asta ad alto valore: Timer 0-1, Ritardo 0ms, Multi-Click ON (se necessario)
|
|
|
|
Dettagli tecnici
|
|
|
|
Polling
|
|
- L'app utilizza polling HTTP adattivo: la frequenza delle richieste è regolata in base al timer dell'asta per bilanciare precisione e carico.
|
|
|
|
Invio puntate (Click HTTP)
|
|
- Le puntate sono effettuate tramite richieste HTTP GET verso l'endpoint di Bidoo (es.: `/bid.php?AID=...&sup=0&shock=0`).
|
|
- Le richieste includono il cookie di sessione fornito dall'utente.
|
|
- Latenza tipica: 10-30ms (variabile in base alla rete e al server remoto).
|
|
|
|
Fallback e WebView2
|
|
- La versione corrente si concentra su polling e click via HTTP. Se il progetto integra WebView2 per altre funzionalità, l'invio attivo delle puntate è gestito via HTTP e non dipende dal rendering del browser.
|
|
|
|
Persistenza, esportazione e diagnostica
|
|
|
|
- Aste aggiunte manualmente sono salvate in: `%AppData%\AutoBidder\auctions.json` e ricaricate all'avvio.
|
|
- `Export CSV` consente di esportare statistiche per ogni asta: nome, ID, URL, timer, prezzo, click, resets, impostazioni.
|
|
- Abilitare log dettagliato per indagare problemi: il log registra latenza, risposte server e errori per-asta.
|
|
|
|
FAQ e risoluzione dei problemi
|
|
|
|
- "Non vedo Click HTTP riuscito": verifica che il cookie sia corretto e la sessione valida.
|
|
- "Aste non rilevate": aggiungi gli URL o gli ID manualmente nella griglia.
|
|
- "Il programma non si avvia": assicurati che .NET 8.0 sia installato e che il build sia andato a buon fine.
|
|
- "Click non funzionano": verifica Timer Click, limiti di prezzo, connessione di rete e validità del cookie.
|
|
|
|
Sicurezza e responsabilità
|
|
|
|
- L'uso di strumenti automatici può violare i Termini di Servizio di Bidoo. L'utente è responsabile dell'uso che fa dell'app.
|
|
- L'app non salva credenziali su disco. Gestisci i cookie in modo sicuro e non condividerli.
|
|
|
|
Supporto
|
|
|
|
- Repository privato Gitea: `https://192.168.30.23/Alby96/Mimante`
|
|
- Per problemi tecnici aprire issue nel repository o contattare il manutentore del progetto.
|
|
|
|
Note per sviluppatori
|
|
|
|
- Progetto target: `.NET 8.0` (WPF)
|
|
- File e componenti principali:
|
|
- `Services\BidooApiClient.cs` — gestione Click HTTP e parsing risposte
|
|
- `Services\AuctionMonitor.cs` — loop di polling e logica di scheduling
|
|
- `Dialogs\SessionDialog.xaml` — dialog per l'inserimento manuale dei cookie
|
|
- `Utilities\PersistenceManager.cs` — gestione `auctions.json`
|
|
- `ViewModels\AuctionViewModel.cs` — binding e stato delle righe nella griglia
|
|
|
|
Contributi
|
|
|
|
- Repository privato: aprire PR verso `main` secondo le convenzioni del progetto.
|
|
|
|
Licenza
|
|
|
|
- Privato — non distribuire senza autorizzazione del proprietario.
|
|
|
|
Buona fortuna con le aste e usa AutoBidder responsabilmente. |