opencode-pollinations-plugin 6.4.9 → 6.5.0

package/README.de.md

@@ -1,23 +1,9 @@
-# 🌸 Pollinations AI Plugin für OpenCode (v6.4.9)
-
-## ✨ Neu in v6.4.9
-
-- 🎯 **Quests & Gamification**: `polli_quests` + `/poll quests`. Plugin-Nutzung erfüllt Quests **rückwirkend**.
-- 🆓 **Kostenlose Tools (kein Schlüssel)** — für **jedes** OpenCode-Modell:
-  - `gen_edit_image_free` — generieren **und** bearbeiten (~20/Tag)
-  - `gen_video_free` — Text→Video (~5/Tag)
-  - `object_remover` / `image_upscaler` / `image_enhancer` — kostenlose Bildverarbeitung
-  - `remove_background` — kostenloses KI-Freistellen (rmbg / bgeraser)
-- 🔐 **1-Klick-Login**: `/poll login` + `polli_login`. `/poll connect sk_...` bleibt verfügbar.
-- 🧊 **Vollständiger Modellkatalog**: text, image, video, audio, **3D**, **embeddings**, realtime.
-- 🧪 **CI + Packaging**: Node ≥ 18, CLI `npx opencode-pollinations-plugin`, Unit- + i18n-Tests.
-- 🌍 **6 Sprachen**: en, fr, es, de, it, zh — Onboarding und Commands ausgerichtet.
-
+# 🌸 Pollinations AI Plugin für OpenCode (v6.5.0)
 
 <div align="center">
   <img src="https://avatars.githubusercontent.com/u/88394740?s=400&v=4" alt="Pollinations.ai Logo" width="180">
   <h3>Die ultimative Brücke zwischen OpenCode und dem Pollinations.ai Ökosystem</h3>
-  <p><em>Greifen Sie auf ein kontinuierliches Universum kostenloser Basis-KI-Modelle zu oder nutzen Sie Premium-Enterprise-Modelle mit unseren großzügigen <b>Stündlichen Freikontingenten (Hourly Free Tiers)</b> direkt über Ihr lokales Terminal.</em></p>
+  <p><em>Greifen Sie auf ein kontinuierliches Universum kostenloser Basis-KI-Modelle zu oder nutzen Sie Premium-Enterprise-Modelle mit unserem <b>Quest- & Paid-Pollen</b>-System direkt über Ihr lokales Terminal.</em></p>
 </div>
 
 <div align="center">
@@ -34,19 +20,23 @@
 
 > **"Keine verschlossenen Türen, keine Unternehmenshürden — einfach gute Werkzeuge und gute Menschen."**
 
-**Pollinations.ai** ist eine Open-Source-Plattform von der Community für die Community. Wir bieten eine einheitliche, direkte API zur Generierung von Bildern, Text, Audio und Video.
+**Pollinations.ai** ist eine Open-Source-Plattform von der Community für die Community. Wir bieten eine einheitliche, direkte API zur Generierung von Bildern, Text, Audio, Video und 3D.
 
 - 🌍 **Transparent**: Unser Code, unsere Roadmap und unsere Diskussionen sind öffentlich.
 - ⚖️ **Faire Wirtschaft**: Eine einzige Währung (**Pollen 🌻**) für alle Medien und Modelle. Vorhersehbare und transparente Preise, keine Anbieterbindung (Vendor Lock-in).
 
 ---
 
-## ✨ Was ist neu in V6.4?
+## ✨ Neu in v6.5.0
 
-- ⏱️ **Stündliche Quoten**: Verabschieden Sie sich von täglichen Limits! Developer Tiers werden jetzt **jede Stunde** pünktlich um `:00` zurückgesetzt. So haben Sie bei langen Code-Sitzungen immer frische Credits.
-- ⚡ **100% Dynamische Engine**: Keine hartcodierten Modelllisten, festen Standardkonfigurationen und Preise mehr! In V6.2 ruft der KI-Agent von OpenCode dynamisch die neuesten LLMs, Parameter, Tags (`[💎 Paid]`, `[🌿 Free]`) und Kostenabschätzungen über die Pollinations-APIs ab.
-- 🛡️ **Robuste Sicherheit**: Schutz vor Path-Traversal-Angriffen und strenge URL-Überprüfungen sind vollständig integriert.
-- 🔍 **Verbesserte Websuche**: Die `polli_web_search`-Komponente wird an hochentwickelte, für das Web aktivierte Modelle wie Google Gemini Fast, Perplexity und spezielle Assistenten abgebildet.
+- 🧊 **3D-Generierung (`polli_gen_3d`)**: Erzeugung hochwertiger 3D-Assets (`trellis-2`, `hyper3d-rodin`) im Standardformat `.glb` mit Cost-Guard-Schutz und Cache-Recovery.
+- 🛡️ **Schutz vor Doppelabrechnung**: Chat-Wiederholungen sind strikt auf den HTTP-Code 429 beschränkt; Timeouts und Netzwerkunterbrechungen führen niemals zu doppelten Abbuchungen.
+- 🧠 **Saubere Reasoning-Normalisierung**: Automatisches Bereinigen von DeepSeek-, Kimi- und Qwen-Gedankenströmen — kein internes Denktext-Leck im Chat.
+- 💰 **Transparente Quest- & Paid-Semantik**: Moderne Abrechnungsmodi (`quest`, `quest_only`, `paid`, `manual`) mit absoluten Pollen-Schwellenwerten.
+- 📦 **Artifact Core (Magic Bytes)**: Echte Binärprüfung (JPEG, PNG, GLB, MP4, MP3, WebM) garantiert die korrekte Dateiendung auf der Festplatte.
+- ⏱️ **Konfigurierbare Timeout-Hierarchie**: Detaillierte Kontrolle der Wartezeiten pro Aufruf, pro Modell und pro Fähigkeit via `/poll config timeouts.*`.
+- 🎯 **Quests & 1-Klick-Login**: Automatische Quest-Erfassung (`/poll quests`) und sofortiges Browser-Login (`/poll login`).
+- 🆓 **6 kostenlose Creator-Tools (ohne Schlüssel)**: `gen_edit_image_free`, `gen_video_free`, `object_remover`, `image_upscaler`, `image_enhancer`, `remove_background`.
 
 ---
 
@@ -57,24 +47,33 @@ Mit der Einbindung Ihres API-Schlüssels erhalten OpenCode-Agenten Zugriff auf m
 ### 💎 Integrierte generative Werkzeuge (ENTER ONLY - API-Schlüssel erforderlich)
 - 🎨 `polli_gen_image` : Hochmoderne Bildmodelle (`Flux`, `Sana`, `Midjourney`, etc.).
 - 🎬 `polli_gen_video` : Starke Text-zu-Video- und Bild-zu-Video-Modelle (`Wan`, `Veo`, `LTX`, `Reveal`).
+- 🧊 `polli_gen_3d` : Erzeugung von 3D-Modellen (`trellis-2`, `hyper3d-rodin`) mit GLB-Ausgabe.
 - 🔊 `polli_gen_audio` & `polli_gen_music` : Magische Sprachsynthese (ElevenLabs, OpenAI TTS) und generative Musik.
 - 🎙️ `polli_stt` : Hochwertige Sprachumwandlung in Text (Whisper V3).
 - 🌐 `polli_web_search` : Vernetzte Websuche & Spezialkontexte (`gemini-search`, `perplexity...`).
 
-### 🧰 Kostenlose Bonus-Werkzeuge für Entwickler (Immer verfügbar)
-- ✂️ `remove_background` : Integrierte, blitzschnelle Entfernung von Bildhintergründen.
-- 🛠️ `gen_qrcode`, `gen_diagram`, `extract_frames`, `extract_audio`, `file_to_url` : Entwickler-Tools.
+### 🧰 Kostenlose Bonus-Werkzeuge für Entwickler (Immer verfügbar — kein Schlüssel nötig)
+- 🆓 `gen_edit_image_free` : Kostenlose Bildgenerierung und -bearbeitung (~20/Tag, jedes Modell, ohne Schlüssel).
+- 🆓 `gen_video_free` : Kostenloses Text-zu-Video mit optionalem Startbild & Audio (~5/Tag, ohne Schlüssel).
+- 🧹 `object_remover` : Objekte direkt per Prompt entfernen (30-120s, ohne Schlüssel).
+- 📐 `image_upscaler` : Bilder 2x/4x kostenlos vergrößern (30-120s, ohne Schlüssel).
+- ✨ `image_enhancer` : KI-Bildverbesserung — Rauschunterdrückung, Schärfe, Restaurierung (30-120s, ohne Schlüssel).
+- ✂️ `remove_background` : KI-Freistellen via rmbg (bgeraser.com) — kostenlos.
+- 🛠️ `gen_qrcode`, `gen_diagram`, `gen_palette`, `extract_frames`, `extract_audio`, `file_to_url` : Entwickler-Tools.
 
 ### 💻 Komplette Liste der Terminalbefehle
 Verwenden Sie jederzeit den Alias **`/poll`** oder **`/pollinations`** in Ihrem Konversations-Terminal:
 - `/poll help` : Zeigt die interaktive Hilfetabelle an.
-- `/poll connect` : Interaktive "Bring Your Own Key"-Konfiguration.
-- `/poll usage full` : Echtzeit-Dashboard (Statistiken), freie Kontingente und Wallet-Guthaben.
-- `/poll config` : Feinabstimmung von Cost Guards, Logs, Sprache und Anzeige.
+- `/poll login` : **1-Klick-Browser-Login** (Device Flow) — erstellt und verbindet einen Schlüssel automatisch.
+- `/poll connect <Schlüssel>` : Manuelle "Bring Your Own Key"-Konfiguration (`sk_...`).
+- `/poll quests` : Quests und verfügbares kostenloses Pollen einsehen. 🎯
+- `/poll usage full` : Echtzeit-Dashboard (Statistiken), Quests und Wallet-Guthaben.
+- `/poll config` : Feinabstimmung von Cost Guards, Timeouts, Logs, Sprache und Anzeige.
 - `/poll models` : Status der verfügbaren Modelle prüfen.
 - `/poll pricing` : Anzeige einheitlicher Preise in Echtzeit (Durchschnittskosten-Schätzung).
+- `/poll mode <mode>` : Wechseln zwischen Abrechnungsmodi (`quest`, `quest_only`, `paid`, `manual`).
 - `/poll fallback` : Definieren des "Safety Net"-Chatmodells.
-- `/poll infos` : Lernen Sie Community-Regeln und das Stufen-System (Leveling) kennen.
+- `/poll infos` : Übersicht über Funktionen und Nutzungsanleitung.
 
 ---
 
@@ -82,35 +81,39 @@ Verwenden Sie jederzeit den Alias **`/poll`** oder **`/pollinations`** in Ihrem
 
 Wir haben grundlegende Schutzmechanismen entwickelt, um zu garantieren, dass Ihr Workflow niemals unterbrochen wird und Ihr Budget in Ihrer Kontrolle bleibt:
 
-- 🛟 **Safety Net (Sicherheitsnetz)**: Wenn Sie Premium-Modelle verwenden und Ihre stündliche Pollen-Quote mitten in der Chat-Sitzung leer ist, wechselt das Plugin lautlos auf ein kostenloses Fallback-Modell. *Keine blockierenden Limits (429) mehr.*
-- 🚦 **Cost Guard für Tools**: OpenCode-Agenten können sehr eifrig sein. Möchte ein Agent zu viele Pollen (z. B. für lange Videos) ausgeben, schaltet sich das Plugin dazwischen. Ein asynchroner Vorgang fragt erst nach Ihrer manuellen Bestätigung. Sie behalten die Kontrolle.
+- 🛟 **Safety Net (Sicherheitsnetz)** : Wenn Sie Premium-Modelle verwenden und Ihr Quest-/Paid-Guthaben mitten in der Chat-Sitzung leer ist, wechselt das Plugin lautlos auf ein kostenloses Fallback-Modell. *Keine blockierenden Limits (429) mehr.*
+- 🚦 **Cost Guard für Tools** : OpenCode-Agenten können sehr eifrig sein. Möchte ein Agent zu viel Pollen für eine schwere Video- oder 3D-Generierung ausgeben, fängt das Plugin die Anfrage ab und fragt nach Ihrer manuellen Bestätigung (`polli_gen_confirm`).
 
 ---
 
-## 🐝 Pollen & "Free Tiers" verstehen
+## 🐝 Quest Pollen & Paid Pollen verstehen
+
+Das Pollinations-Pollen ist in zwei Konten getrennt:
+
+- **🎁 Quest Pollen** — kostenlos verdient durch das Abschließen von **Quests**. Vom Server auf regulären Modellen zuerst verbraucht.
+- **💎 Paid Pollen** — gekauft (Kreditkarte). Wird verwendet, wenn Quest nicht ausreicht, oder für `paid_only`-Modelle.
 
-Früher stützte sich Pollinations vor allem auf werbefinanzierten Traffic. Große Modelle (wie Claude 3.5 Sonnet, Flux Pro) kosten jedoch Geld. Das **Enter-Universum** verlangt daher nach einem API-Schlüssel für Top-Modelle.
+> ⚠️ Das Plugin kann die Aufteilung serverseitig nicht auslesen; es schätzt Quest/Paid lokal und liest die echte Aufteilung (`meter_source`) aus `/account/usage`.
 
-**Aber keine Sorge, Sie brauchen keine Kreditkarte!**
+### Abrechnungsmodi (v6.5)
 
-Das **Pollen 🌻** ist unser zentrales Kreditsystem (1$ ≈ 1 Pollen). Verbinden Sie einen einfachen, kostenfreien API-Schlüssel, und Sie schalten **stündliche** Pollen-Aufladungen je nach Entwicklerstufe frei:
+| Modus | Verhalten |
+| :--- | :--- |
+| `quest` (QUEST_PREFERRED, **Standard**) | Quest zuerst, Paid-Fallback erlaubt (Server-Standard). Fällt auf das Free Universe zurück, wenn beide erschöpft aussehen. |
+| `quest_only` (QUEST_ELIGIBLE_ONLY) | Blockiert `paid_only`-Modelle lokal; sendet nur Quest-berechtigte Aufrufe. **Best-effort** — eine Paid-Belastung kann im Wettlauf dennoch auftreten. |
+| `paid` (PAID_ALLOWED) | Paid erlaubt, `paid_only` laut Cost Guard erlaubt. Fällt auf Free zurück, wenn das Wallet niedrig ist. |
+| `manual` | Keine automatische Richtlinie — volle manuelle Kontrolle. |
 
-| Tier (Stufe) | Stündliche Aufladung ⏱️ | Schätzung Tag* | Voraussetzung |
-| :--- | :--- | :--- | :--- |
-| 🍄 **Spore** | **0.01 Pollen / Std.** | ~0.24 / Tag | Automatische Verifikation |
-| 🌱 **Seed** | **0.15 Pollen / Std.** | ~3.6 / Tag | Aktiver GitHub-Entwickler (8+ Punkte) |
-| 🌸 **Flower** | **0.40 Pollen / Std.** | ~9.6 / Tag | **Eine App veröffentlichen** (Wie dieses Plugin!) |
-| 🍯 **Nectar** | **0.80 Pollen / Std.** | ~19.2 / Tag | Demnächst 🔮 |
+Ändern mit `/poll mode <mode>` oder `/poll config mode <mode>`.
 
-_*Tägliche Schätzungen sind nur Näherungswerte (~24h × Stundenrate). Das Reset findet automatisch zur vollen Stunde (XX:00) statt._
+> 🎯 **Verdienen Sie kostenloses Pollen durch das Abschließen von Quests!** Allein die Nutzung dieses Plugins erfüllt mehrere Quests rückwirkend. Führen Sie `/poll quests` aus, um zu sehen, was Sie beanspruchen können.
 
-> 🎁 **Erhalten Sie Ihren kostenlosen persönlichen Schlüssel (BYOK) auf [Pollinations.ai](https://enter.pollinations.ai/authorize?redirect_url=https://github.com/fkom13/opencode-pollinations-plugin), um OpenCode zu boosten!**
+> 🎁 **Erhalten Sie Ihren kostenlosen persönlichen Schlüssel (BYOK) auf [enter.pollinations.ai](https://enter.pollinations.ai), um OpenCode zu boosten!**
 
 **Wie es funktioniert:**
-1. Zuerst wird Ihre kostenlose Quote verbraucht (z.B. 0.40 🌻/Std. für Flower).
-2. Ist die Quote ausgeschöpft, wechselt das Sicherheitsnetz sanft zu den Gratis-Modellen.
-3. Nur wenn der Account über bezahltes Guthaben (Wallet) verfügt, werden Premium-Modelle weiter bedient.
-4. Pünktlich zur Anbruch der nächsten Stunde wird die freie Quote komplett resettet! 💥
+1. Ihr Quest Pollen wird auf allen regulären Modellen zuerst verbraucht.
+2. 💎 Nur-Paid-Modelle verwenden immer gekauftes Pollen.
+3. Wenn beide Guthaben erschöpft sind, wechselt das Sicherheitsnetz sanft zu kostenlosen Fallback-Varianten.
 
 ---
 
@@ -125,30 +128,40 @@ Pollinations für OpenCode spricht Ihre Sprache nativ:
 ## 🚀 Installation & Onboarding
 
 ### 🐧 1. Plattformübergreifende Einrichtung (NPM-Installation)
-Dieses Plugin ist **komplett plattformunabhängig** (Windows, macOS, Linux) und erkennt OpenCode-Ports dynamisch.
+Dieses Plugin ist **komplett plattformunabhängig** (Windows, macOS, Linux ; Node **≥ 18**) und startet einen lokalen Proxy auf einem dynamischen Port.
 
-1. Globale Installation:
+1. Globale oder lokale Installation:
    ```bash
    npm install -g opencode-pollinations-plugin
    ```
 2. Auto-Konfiguration:
    ```bash
    npx opencode-pollinations-plugin
+   # oder: npx opencode-pollinations-plugin --check
    ```
-   *(Oder manuell in `~/.config/opencode/opencode.json` eintragen)*
+   *(Trägt `opencode-pollinations-plugin` automatisch in `~/.config/opencode/opencode.json` ein)*
 
 ### 🔑 2. Interaktives Onboarding
-Nachdem OpenCode gestartet ist, tippen Sie im Agent-Terminal einfach ab:
+
+Verbinden Sie Ihr Pollinations-Konto in OpenCode über **eine dieser Methoden**:
+
+**Option A — 1-Klick-Login (empfohlen):**
+```bash
+/poll login
+```
+Ihr Browser öffnet sich automatisch. Melden Sie sich mit GitHub an und klicken Sie auf **Authorize** — das Plugin verbindet sich automatisch ohne Copy-Paste.
+
+**Option B — Manueller Schlüssel:**
 ```bash
-/poll connect
+/poll connect sk_ihr_schluessel_hier
 ```
-Ein Assistent hilft Ihnen interaktiv bei der Erstellung des Schlüssels und der Workspace-Einrichtung. *(Starten Sie OpenCode neu, damit die neue Modellliste im UI erscheint).*
+Erstellen Sie selbst einen **Secret**-Schlüssel auf [enter.pollinations.ai](https://enter.pollinations.ai) und fügen Sie ihn ein. *(Starten Sie OpenCode neu, damit die neue Modellliste im UI erscheint).*
 
 ---
 
 ## 🔗 Links
 
-- **Pollen-API-Schlüssel holen**: [pollinations.ai](https://pollinations.ai)
+- **Dashboard & API-Schlüssel**: [enter.pollinations.ai](https://enter.pollinations.ai)
 - **Discord-Community**: [Mach mit!](https://discord.gg/pollinations-ai-885844321461485618)
 - **OpenCode-Ökosystem**: [opencode.ai](https://opencode.ai/docs/ecosystem#plugins)
 

package/README.es.md

@@ -1,23 +1,9 @@
-# 🌸 Pollinations AI Plugin para OpenCode (v6.4.9)
-
-## ✨ Novedades v6.4.9
-
-- 🎯 **Quests & Gamificación**: `polli_quests` + `/poll quests`. Usar el plugin completa quests **retroactivamente**.
-- 🆓 **Herramientas gratis (sin clave)** — para **cualquier** modelo OpenCode:
-  - `gen_edit_image_free` — generar **y** editar (~20/día)
-  - `gen_video_free` — texto→vídeo (~5/día)
-  - `object_remover` / `image_upscaler` / `image_enhancer` — procesado de imagen gratis
-  - `remove_background` — recorte IA gratis (rmbg / bgeraser)
-- 🔐 **Login en 1 clic**: `/poll login` + `polli_login`. `/poll connect sk_...` sigue disponible.
-- 🧊 **Catálogo completo**: text, image, video, audio, **3D**, **embeddings**, realtime.
-- 🧪 **CI + packaging**: Node ≥ 18, CLI `npx opencode-pollinations-plugin`, tests unit + i18n.
-- 🌍 **6 idiomas**: en, fr, es, de, it, zh — onboarding y comandos alineados.
-
+# 🌸 Pollinations AI Plugin para OpenCode (v6.5.0)
 
 <div align="center">
   <img src="https://avatars.githubusercontent.com/u/88394740?s=400&v=4" alt="Pollinations.ai Logo" width="180">
   <h3>El puente definitivo entre OpenCode y el ecosistema Pollinations.ai</h3>
-  <p><em>Accede a un universo continuo de modelos de IA básicos y gratuitos, o aprovecha modelos premium empresariales usando nuestras generosas <b>Cuotas Gratuitas por Hora (Hourly Free Tiers)</b> directamente en tu terminal.</em></p>
+  <p><em>Accede a un universo continuo de modelos de IA básicos y gratuitos, o aprovecha modelos premium empresariales usando nuestro sistema <b>Quest & Paid Pollen</b> directamente en tu terminal.</em></p>
 </div>
 
 <div align="center">
@@ -34,19 +20,23 @@
 
 > **"Sin puertas cerradas, sin bloqueos corporativos — simplemente buenas herramientas y buena gente."**
 
-**Pollinations.ai** es una plataforma de código abierto creada por y para la comunidad. Ofrecemos una API unificada y directa para generar imágenes, texto, audio y vídeo.
+**Pollinations.ai** es una plataforma de código abierto creada por y para la comunidad. Ofrecemos una API unificada y directa para generar imágenes, texto, audio, vídeo y 3D.
 
 - 🌍 **Transparente**: Nuestro código, hoja de ruta (roadmap) y discusiones son de acceso público.
 - ⚖️ **Economía Justa**: Una moneda única (**Pollen 🌻**) para todo tipo de archivos multimedia y modelos. Precios predecibles, transparentes y sin ataduras propietarias.
 
 ---
 
-## ✨ Novedades de la V6.4
+## ✨ Novedades v6.5.0
 
-- ⏱️ **Cuotas por Hora**: ¡Dile adiós a los límites diarios! Los Tiers de Desarrollador se recargan **cada hora** exacta (a la hora en punto `:00`), asegurando que siempre tengas créditos frescos para tus largas jornadas de código.
-- ⚡ **Motor 100% Dinámico**: ¡Se acabaron las listas de modelos quemadas en el código y los precios estáticos! En V6.2, el agente obtiene dinámicamente los últimos LLMs, parámetros, etiquetas (`[💎 Paid]`, `[🌿 Free]`) y costes aproximados conectándose continuamente a la API de Pollinations.
-- 🛡️ **Seguridad Robusta**: Completamente integradas las mitigaciones contra path traversal y una estricta validación de URLs.
-- 🔍 **Búsqueda Web Mejorada**: El componente `polli_web_search` accede directamente a las opciones modernas de indexación como Gemini Fast, Perplexity y otros asistentes personalizados por red.
+- 🧊 **Generación 3D (`polli_gen_3d`)**: Generación de modelos 3D (`trellis-2`, `hyper3d-rodin`) en formato estándar `.glb` con protección Cost Guard y recuperación desde caché.
+- 🛡️ **Cero Doble Facturación**: Reintentos de chat estrictamente limitados al error 429; los timeouts y cortes de red nunca vuelven a enviar peticiones de pago.
+- 🧠 **Normalización de Razonamiento**: Limpieza automática de flujos SSE en DeepSeek, Kimi y Qwen — sin filtraciones de pensamientos en el chat.
+- 💰 **Semántica Quest & Paid Transparente**: Nuevos modos de facturación (`quest`, `quest_only`, `paid`, `manual`) con límites de alerta en Pollen absoluto.
+- 📦 **Artifact Core (Magic Bytes)**: Verificación física binaria (JPEG, PNG, GLB, MP4, MP3, WebM) garantizando extensiones correctas en disco.
+- ⏱️ **Jerarquía de Timeouts Configurable**: Control detallado de tiempos de espera por llamada, por modelo y por capacidad con `/poll config timeouts.*`.
+- 🎯 **Quests y Login en 1 Clic**: Seguimiento retroactivo de misiones (`/poll quests`) e inicio de sesión automático en navegador (`/poll login`).
+- 🆓 **6 Herramientas de Creador Gratuitas (sin clave)**: `gen_edit_image_free`, `gen_video_free`, `object_remover`, `image_upscaler`, `image_enhancer`, `remove_background`.
 
 ---
 
@@ -57,24 +47,33 @@ Aparte de conversar, cuando conectas tu API Key, el Agente OpenCode adquiere sup
 ### 💎 Herramientas Generativas (ENTER ONLY - requiere API Key)
 - 🎨 `polli_gen_image` : Modelos creativos líderes (`Flux`, `Sana`, `Midjourney`, etc.).
 - 🎬 `polli_gen_video` : Modelos robustos de Texto-a-Vídeo e Imagen-a-Vídeo (`Wan`, `Veo`, `LTX`, `Reveal`).
+- 🧊 `polli_gen_3d` : Generación de activos 3D de alta fidelidad (`trellis-2`, `hyper3d-rodin`) en GLB.
 - 🔊 `polli_gen_audio` y `polli_gen_music` : Síntesis de voz mágica (ElevenLabs, OpenAI TTS) y Música de IA.
 - 🎙️ `polli_stt` : Alta eficiencia en el paso de voz a texto (Whisper V3).
 - 🌐 `polli_web_search` : Búsqueda web inteligente y conocimiento en tiempo real (`gemini-search`, `perplexity...`).
 
-### 🧰 Herramientas Integradas Gratuitas (Siempre disponibles)
-- ✂️ `remove_background` : Eliminación rápida del fondo de cualquier imagen de forma offline nativa.
-- 🛠️ Herramientas como `gen_qrcode`, `gen_diagram`, `extract_frames`, `extract_audio`, y `file_to_url` para mejorar el día a día.
+### 🧰 Herramientas de Creador Gratuitas (Siempre disponibles — sin clave API)
+- 🆓 `gen_edit_image_free` : Generación y edición de imágenes gratis (~20/día, cualquier modelo, sin clave).
+- 🆓 `gen_video_free` : Texto-a-vídeo gratis con imagen y audio de entrada opcionales (~5/día, sin clave).
+- 🧹 `object_remover` : Eliminación de objetos por prompt directamente (30-120s, sin clave).
+- 📐 `image_upscaler` : Aumento de resolución 2x/4x gratis (30-120s, sin clave).
+- ✨ `image_enhancer` : Mejora de imagen por IA — reducción de ruido, nitidez, restauración (30-120s, sin clave).
+- ✂️ `remove_background` : Eliminación de fondo mediante rmbg (bgeraser.com) — gratis.
+- 🛠️ `gen_qrcode`, `gen_diagram`, `gen_palette`, `extract_frames`, `extract_audio`, `file_to_url`: Utilidades para desarrolladores.
 
 ### 💻 Lista Completa de Comandos en Terminal
 Solo llama al bot usando los alias **`/poll`** o **`/pollinations`** en tu terminal:
 - `/poll help` : Muestra todo el cuadro de ayuda interactivo.
-- `/poll connect` : Interfaz de configuración "Bring Your Own Key" (Trae tu proipa Clave).
-- `/poll usage full` : Panel de control en tiempo real, recargas de saldo y uso del Tiers Gratuitos.
-- `/poll config` : Refinamiento de idiomas, alertas de costes (Cost Guards) y logs.
-- `/poll models` : Ver los modelos ahora viables y en línea.
-- `/poll pricing` : Mirar la lista de precios unificados de Pollen al día.
-- `/poll fallback` : Configurar tus redes de seguridad para las conversaciones y el Agente.
-- `/poll infos` : Información vital del ecosistema, sobre cómo funciona todo y formas de subir de nivel en los Roles.
+- `/poll login` : **Inicio de sesión en 1 clic** en el navegador (device flow) — conecta una clave automáticamente.
+- `/poll connect <clave>` : Configuración manual "Bring Your Own Key" (`sk_...`).
+- `/poll quests` : Mira tus misiones y el Pollen gratis disponible para reclamar. 🎯
+- `/poll usage full` : Panel de control en tiempo real, recargas de saldo y uso del Portafolio.
+- `/poll config` : Refinamiento de idiomas, límites de costes (Cost Guards), timeouts y logs.
+- `/poll models` : Ver los modelos actualmente disponibles y en línea.
+- `/poll pricing` : Consultar la lista de precios unificados de Pollen al día.
+- `/poll mode <mode>` : Cambiar entre modos de facturación (`quest`, `quest_only`, `paid`, `manual`).
+- `/poll fallback` : Configurar tus redes de seguridad para las conversaciones del chat.
+- `/poll infos` : Información del ecosistema y guía de uso.
 
 ---
 
@@ -82,76 +81,90 @@ Solo llama al bot usando los alias **`/poll`** o **`/pollinations`** en tu termi
 
 Nos preocupamos de tu cartera y de tu ritmo de trabajo, incluyendo barreras fundamentales que aseguran tu tranquilidad:
 
-- 🛟 **Red de Seguridad**: Al agotar tu saldo diario/por hora o si un error bloqueante 429 sucediese, el ecosistema transita suave y calladamente hacia modelos Free de seguridad. Tu chat jamás se cortará sin un aviso.
-- 🚦 **Cost Guard de Herramientas**: Ya que los modelos potentes de Audio o Video consumen bastante (y un agente podría sobrepasar ese límite por afición a resolver un problema a nivel visual), implementamos interceptores. Una parada asíncrona solicitará tu confirmación directa ante transacciones altas.
+- 🛟 **Red de Seguridad (Safety Net)** : Al agotar tu saldo Quest/Paid o si ocurriese un corte, el ecosistema transita suave y silenciosamente hacia modelos gratuitos de seguridad. *Tu chat jamás se cortará con errores 429.*
+- 🚦 **Cost Guard de Herramientas** : Los agentes pueden ser insistentes. Si un agente intenta gastar demasiado Pollen en una generación pesada de vídeo o 3D, el plugin interceptará la petición solicitando tu confirmación manual (`polli_gen_confirm`).
 
 ---
 
-## 🐝 Entendiendo el Pollen & "Free Tiers"
+## 🐝 Entendiendo el Quest Pollen & el Pollen de Pago
+
+El pollen de Pollinations se divide en dos columnas:
+
+- **🎁 Pollen Quest** — se gana gratis completando **Misiones**. El servidor lo consume primero en los modelos regulares.
+- **💎 Pollen de Pago** — comprado (tarjeta). Se usa cuando el Quest es insuficiente, o para modelos `paid_only`.
 
-Antes Pollinations se sustentaba de anuncios para todos. Hoy, correr grandes servidores y maravillas como Claude 3.5 Sonnet, cuestan dinero. El mundo llamado **Enter Universe** precisa entonces de tu propia APi Key.
+> ⚠️ El plugin no puede leer el desglose del servidor; estima Quest/Pago localmente y lee el desglose real (`meter_source`) desde `/account/usage`.
 
-**¡Pero espera que NO necesitas registrar una tarjeta bancaria!**
+### Modos de facturación (v6.5):
 
-El **Pollen 🌻** dicta la ley unificada del crédito (1$ ≈ 1 Pollen). Sólo vinculando una clave Key sencilla gratuita abres el camino hacia el **beneficio del sistema de recarga automática por hora**:
+| Modo | Comportamiento |
+| :--- | :--- |
+| `quest` (QUEST_PREFERRED, **por defecto**) | Quest primero, fallback a Pago permitido. Cae al universo gratuito cuando ambos parecen agotados. |
+| `quest_only` (QUEST_ELIGIBLE_ONLY) | Bloquea modelos `paid_only` localmente; solo envía llamadas elegibles para Quest. **Best-effort** — puede ocurrir un débito de Pago. |
+| `paid` (PAID_ALLOWED) | Pago permitido, `paid_only` según el Cost Guard. Cae al gratuito cuando el wallet está bajo. |
+| `manual` | Sin política automática — control total. |
 
-| Tier | Recarga Hora ⏱️ | Aprox Diario* | Requisito a Cumplir |
-| :--- | :--- | :--- | :--- |
-| 🍄 **Spore** | **0.01 Pollen / hora** | ~0.24 /día | Examen de perfil y verificación |
-| 🌱 **Seed** | **0.15 Pollen / hora** | ~3.6 /día | Desarrollador activo en Github (+8 pts) |
-| 🌸 **Flower** | **0.40 Pollen / hora** | ~9.6 /día | **Completar y Publicar una App** |
-| 🍯 **Nectar** | **0.80 Pollen / hora** | ~19.2 /día | Pendiente a futuras actualizaciones 🔮 |
+Cambia con `/poll mode <mode>` o `/poll config mode <mode>`.
 
-_*Los cálculos diarios solo son estimaciones teóricas (~24h × cuota/hora). El reinicio limpio sucede exacto en el minuto `:00` de las horas del reloj._
+> 🎯 **¡Gana pollen gratis completando Misiones!** Usar este plugin completa varias retroactivamente. Ejecuta `/poll quests`.
 
-> 🎁 **Obtén tu Clave Gratuita Personal (BYOK) desde [Pollinations.ai](https://enter.pollinations.ai/authorize?redirect_url=https://github.com/fkom13/opencode-pollinations-plugin) ¡Y dale alas a tu OpenCode!**
+> 🎁 **Obtén tu Clave Gratuita Personal (BYOK) desde [enter.pollinations.ai](https://enter.pollinations.ai) ¡Y dale alas a tu OpenCode!**
 
-**¿Cómo es el ciclo?**
-1. Lo que consumas lo deduce el plugin de tu cuota de Tier gratuita (ej: los 0.40 🌻/h si eres Flower).
-2. Si llegas al límite horario de gratis, bajará los procesos a modos pasivos y lentos del ecosistema Gratuito.
-3. Lo introducido en saldo comprado solo afectará la orden si fallan las vías de red anteriores.
-4. ¿Ha llegado la hora siguiente? 💥 Bam. Tus cuotas se resetean totalmente de nuevo.
+**¿Cómo funciona?**
+1. Tu Pollen Quest se consume primero en los modelos regulares.
+2. Los modelos `paid_only` 💎 consumen siempre Pollen comprado.
+3. Cuando ambos saldos se agotan, el plugin cambia suavemente a los modelos gratuitos de seguridad.
 
 ---
 
 ## 🌍 Soporte Nativo de Diversos Idiomas (i18n)
 
 Pollinations se comunica fluidamente en varios idiomas usando bases directas:
-- Interfaz del entorno, Alarmas Flotantes (Toasts), Notificaciones y Comandos vienen localizados a **Inglés**, **Francés**, **Español**, **Alemán**, **Italiano**, y **Chino**.
-- Ingresa el comando `/poll config lang <en|fr|es|de|it|zh>` para cambiar entre esquemas casi mágicamente.
+- Interfaz del entorno, Notificaciones Flotantes (Toasts), Respuestas de herramientas y Comandos vienen localizados a **Inglés**, **Francés**, **Español**, **Alemán**, **Italiano**, y **Chino**.
+- Ingresa el comando `/poll config lang <en|fr|es|de|it|zh>` para cambiar de idioma al instante.
 
 ---
 
 ## 🚀 Instalación y Emparejamiento
 
 ### 🐧 1. Soporte a Todas las Plataformas vía NPM CLI
-Este núcleo ha sido forjado para acoplarse y detectar con vida propia sobre (Windows, macOS, Linux).
+Este plugin es **totalmente multiplataforma** (Windows, macOS, Linux ; Node **≥ 18**) e inicia un proxy local en un puerto dinámico.
 
-1. Usando el ambiente general o nativo:
+1. Instalación global o local:
    ```bash
    npm install -g opencode-pollinations-plugin
    ```
-2. Auto-Configuración Dinámica de inyección:
+2. Auto-Configuración:
    ```bash
    npx opencode-pollinations-plugin
+   # o: npx opencode-pollinations-plugin --check
    ```
-   *(También tienes libertad de editar `~/.config/opencode/opencode.json` con cautela a mano)*
+   *(Inyecta automáticamente `opencode-pollinations-plugin` en `~/.config/opencode/opencode.json`)*
+
+### 🔑 2. Onboarding Interactivo
+
+Una vez dentro de OpenCode, conecta tu cuenta de Pollinations con **una de estas opciones**:
+
+**Opción A — Login en 1 clic (recomendado):**
+```bash
+/poll login
+```
+Tu navegador se abrirá automáticamente. Inicia sesión con GitHub y presiona **Authorize** — el plugin se conectará solo, sin necesidad de copiar y pegar.
 
-### 🔑 2. Proceso de Integración
-Estando conectado dentro de tu visualización OpenCode, abre la terminal al Agente escribiendo:
+**Opción B — Clave manual:**
 ```bash
-/poll connect
+/poll connect sk_tu_clave_aqui
 ```
-Sigue el simpático sistema base para inyectar y comprobar tu clave Pollinations personal. *(Nota: Haz el amago de cerrar OpenCode y ejecutarlo de nuevo para purgar el visor de modelos al instante).*
+Crea una clave **Secret** en [enter.pollinations.ai](https://enter.pollinations.ai) y pégala. *(Reinicia OpenCode para refrescar la lista de modelos de la interfaz).*
 
 ---
 
 ## 🔗 Enlaces Importantes
 
-- **Obtener tu Llave Master de la Red API**: [pollinations.ai](https://pollinations.ai)
-- **Nuestra Gran y Activa Familia Discord**: [¡Súmate Todos Mismos Aquí!](https://discord.gg/pollinations-ai-885844321461485618)
-- **Cosas Relacionadas Al Ecosistema Abierto**: [opencode.ai](https://opencode.ai/docs/ecosystem#plugins)
+- **Dashboard y Claves API**: [enter.pollinations.ai](https://enter.pollinations.ai)
+- **Comunidad Discord**: [¡Únete aquí!](https://discord.gg/pollinations-ai-885844321461485618)
+- **Ecosistema OpenCode**: [opencode.ai](https://opencode.ai/docs/ecosystem#plugins)
 
-## 📜 Licencia de Dominio Público
+## 📜 Licencia
 
-Licencia MIT otorgada. Hecho posible de principio a infinito por [fkom13](https://github.com/fkom13) & La Gran Comunidad Pollinations.
+Licencia MIT. Desarrollado por [fkom13](https://github.com/fkom13) y la Comunidad Pollinations.