@operatingtag/dsh-unclesam 1.0.0 → 1.1.0

package/README.de.md

@@ -0,0 +1,274 @@
+[English](README.md) · [Español](README.es.md) · [Français](README.fr.md) · **Deutsch** · [Português](README.pt.md) · [Italiano](README.it.md) · [Türkçe](README.tr.md) · [한국어](README.ko.md) · [日本語](README.ja.md) · [简体中文](README.zh.md) · [Русский](README.ru.md) · [Polski](README.pl.md) · [हिन्दी](README.hi.md) · [Nederlands](README.nl.md) · [Українська](README.uk.md) · [Tiếng Việt](README.vi.md) · [Bahasa Indonesia](README.id.md) · [ไทย](README.th.md) · [فارسی](README.fa.md) · [Ελληνικά](README.el.md) · [עברית](README.he.md) · [Čeština](README.cs.md) · [Română](README.ro.md) · [Svenska](README.sv.md) · [Dansk](README.da.md) · [Suomi](README.fi.md) · [Magyar](README.hu.md)
+
+# Uncle Sam
+
+**Ein Anbieter für DeepSeek Harness, der über Ihren eigenen Browser antwortet — mit dem Web-Konto, das Sie schon haben, statt über die abgerechnete API.**
+
+**☕ [Kauf mir einen Kaffee](https://revolut.me/operatingtag)** — geschrieben von einer Person, nachts, ohne Finanzierung. Es gibt kein anderes Geschäftsmodell. Ein Stern oder ein guter Fehlerbericht ist genauso viel wert.
+
+> **Dieses Produkt wird aktiv weiterentwickelt. Rechnen Sie mit Fehlern.**
+>
+> Es funktioniert, es ist schnell, und es läuft seit Wochen täglich — aber es ändert sich ständig, und der
+> Browser-Weg hängt von einer Website ab, die sich ohne Vorwarnung ändert. Wenn etwas kaputtgeht, sind ein
+> Screenshot und die Versionsnummer mehr wert als eine Beschreibung. Legen Sie sich auf eine Version fest, wenn
+> Sie davon abhängen.
+
+```
+Anbieter  deepseek-web
+Modelle   deepseek-chat · deepseek-chat-search · deepseek-reasoner · deepseek-reasoner-search
+Kosten    nichts pro Token — es nutzt das Abonnement, das in Ihrem Browser bereits offen ist
+Status    in Entwicklung — mit Fehlern rechnen
+gemessen  erstes Token ~1,9 s · Overhead ~0,6 s · ein ganzer Zug in ~2,5 s
+```
+
+Antworten über den Web-Weg sind mit **🔴 Uncle Sam** signiert. Der Name ist ein Scherz, keine Behauptung: er
+zeigt, welcher Weg geantwortet hat, und API-Antworten tragen überhaupt keine Signatur. Sie wissen immer, wer
+Ihnen geantwortet hat.
+
+---
+
+## Was es Ihnen spart
+
+Die API rechnet pro Token ab. Das Web-Produkt nicht. Dieses Plugin registriert `deepseek-web` als
+Modellanbieter und beantwortet jeden Aufruf, indem es `chat.deepseek.com` in einem echten Browser steuert — die
+Seite erledigt die Arbeit, der Browser hält die Sitzung, und nichts wird gemessen.
+
+| | API-Weg | Web-Weg |
+|---|---|---|
+| Kosten | pro Token, dauerhaft | nichts über das Abonnement hinaus |
+| Tempo | schnell | ~2,5 s pro Zug, gemessen |
+| Werkzeugaufrufe | nativ und zuverlässig | emuliert, funktioniert, aber schwächer |
+| Hängt ab von | der API | einer Website, die sich ohne Vorwarnung ändert |
+
+**Beide Wege bleiben installiert.** Der Modellwähler ist der Schalter: Sie können den günstigen Weg als
+Standard nutzen und zur API greifen, wenn eine Aufgabe zuverlässige Werkzeuge braucht.
+
+---
+
+## Installation
+
+Uncle Sam ist ein **DeepSeek-Harness-Plugin**. Außerhalb des Harness tut es nichts, weil es einen
+Modellanbieter, eine Host-Route und zwei Oberflächenplätze registriert.
+
+**Voraussetzungen**
+
+| | |
+|---|---|
+| DeepSeek Harness | jede neuere Version mit Plugin-Manager |
+| Browser | Brave empfohlen, Edge wird automatisch genutzt, wenn Brave fehlt |
+| Node | 22 oder neuer |
+
+**Von npm**
+
+```bash
+pnpm add @operatingtag/dsh-unclesam
+```
+
+**Aus diesem Repository**
+
+```bash
+git clone https://github.com/operatingtag/dsh-unclesam
+cd dsh-unclesam
+pnpm install
+```
+
+Dann fügen Sie die Paketzeile zu Ihrem Profil hinzu, damit das Harness es lädt:
+
+```yaml
+# cordis.patch.yml
+- insert:
+    - id: dsh-unclesam
+      name: '@operatingtag/dsh-unclesam'
+      config:
+        port: 9222
+        defaultModel: deepseek-chat-search
+        autoMinimise: true
+```
+
+**Oder aus einem Ordner:** Einstellungen → Plugins → aus einem lokalen Pfad installieren, auf den Ordner mit
+der `package.json` zeigen.
+
+### Erster Start
+
+Klicken Sie auf **Anmelden / Chat öffnen**. Der Browser öffnet sich und **bleibt sichtbar**, bis Sie sich bei
+chat.deepseek.com angemeldet haben. Danach minimiert er sich selbst und Sie sehen ihn nicht wieder. Die Sitzung
+liegt in Ihrem Browser-Profil — **das Plugin speichert kein Passwort**, es gibt also nichts, was geleakt werden
+könnte.
+
+Danach sollten Sie sehen:
+
+1. **Einstellungen → Uncle Sam** — eine Seite mit Statuszeilen und einer Anmeldeschaltfläche.
+2. **Unter dem Eingabefeld** — `● DeepSeek Harness` oder `● Uncle Sam`, klicken zum Umschalten.
+3. **Die Modellliste** — vier `(web)`-Modelle neben denen der API.
+
+### Entfernen
+
+Einstellungen → Plugins → Uncle Sam → Deinstallieren. Außerhalb des Browser-Profils, mit dem Sie sich angemeldet
+haben, wird nichts geschrieben.
+
+---
+
+## Der Schalter API / Web
+
+**Der Modellwähler ist der Schalter.** Es gibt kein zweites Bedienelement, denn ein zweites Bedienelement, das
+auch das Modell wählt, wären zwei Wahrheiten für eine Entscheidung.
+
+| Wählen Sie dieses Modell | Weg | DeepThink | Suche |
+|---|---|---|---|
+| `DeepSeek Chat (web)` | Browser | aus | aus |
+| `DeepSeek Chat + Search (web)` | Browser | aus | **an** |
+| `DeepSeek Reasoner (web)` | Browser | **an** | aus |
+| `DeepSeek Reasoner + Search (web)` | Browser | **an** | **an** |
+| jedes Modell ohne `(web)` | API | — | — |
+
+Neben der Modellbezeichnung erscheint ein Abzeichen **WEB** oder **API**, damit der aktive Weg auf einen Blick
+sichtbar ist. Wird die Bezeichnung nicht erkannt, zeigt das Abzeichen nichts, statt zu raten — ein falsches
+Abzeichen wäre schlimmer als keins.
+
+Ihre Wahl bleibt über Neustarts erhalten. **DeepThink** ist der Denk-Durchlauf; **Suche** lässt es das live Netz
+lesen.
+
+### Die Suche ist im Verlauf sichtbar
+
+Mit einem Suchmodell erzeugt ein Zug **zwei Blöcke** — die Suchanfrage, die gefundenen Quellen und dann die
+Antwort, die sie nutzt:
+
+```
+Websuche — „Welche Technik-Schlagzeile gibt es heute?“
+Quellen (4): yna.co.kr · fnnews.com · rthk.hk · sina.com.cn
+Links: https://k.sina.com.cn/article_... http://www.21jingji.com/article_...
+```
+
+Die Seite gibt die intern eingegebene Suchanfrage nicht preis; die zitierte Anfrage ist also die Nachricht, die
+die Suche ausgelöst hat. Quellen und Links werden von der Seite gelesen, sobald die Antwort steht. Weil Quellen
+erst am Ende existieren, **puffern Suchzüge, statt zu streamen**; gewöhnliche Züge streamen weiterhin Token für
+Token.
+
+---
+
+## Warum ein Browser und nicht ihre HTTP-API
+
+Der naheliegende Weg — die eigene API von `chat.deepseek.com` aufrufen — wurde versucht und verworfen. Die
+Website lässt jede Nachricht durch zwei Tore:
+
+| Tor | Was es bedeutet |
+|---|---|
+| `/api/v0/chat/create_pow_challenge` | eine **Proof-of-Work**-Aufgabe pro Nachricht |
+| `challenges.cloudflare.com/turnstile` | eine Bot-Sperre am Ursprung |
+
+Beides nachzubauen ist ein verlorenes Spiel: es ist verschleiert, es ändert sich, und wenn es sich ändert, sieht
+der Fehler genau wie ein Netzwerkfehler aus. **Die Seite löst beides bereits für ihre eigenen Anfragen.**
+
+Der Adapter spricht also nie HTTP mit der Website. Er steuert die Seite, und die Seite macht den Rest.
+Anmeldung, Proof-of-Work und Turnstile sind nicht mehr unser Problem und können nicht unabhängig von der
+Website kaputtgehen.
+
+**Geprüft:** ein einfaches `HEAD` an die Website liefert `403`; der Browser-Weg liefert Antworten.
+
+---
+
+## Grenzen, ehrlich benannt
+
+**Werkzeugaufrufe sind emuliert.** Ein Web-Chat hat keinen strukturierten Werkzeugkanal: Werkzeuge werden im
+Prompt beschrieben, und ein Aufruf wird aus der Antwort als JSON-Objekt herausgelesen. Das funktioniert —
+geprüft —, ist aber schwächer als native Werkzeugaufrufe: ein Modell, das die Anweisung ignoriert, antwortet in
+Prosa, und das Harness sieht in diesem Zug keinen Werkzeugeinsatz. **Für schwere agentische Arbeit ist der
+API-Weg zuverlässiger.** Der Web-Weg eignet sich am besten für Unterhaltung, lange Antworten, Subagenten,
+Kompaktierung und jeden Zug, in dem das Modell das Web-Modell sein muss.
+
+**Es hängt von einer Website ab, die Sie nicht kontrollieren.** Ändert die Seite ihre Form, muss das Plugin
+mitgehen. Das ist die Warnung zur aktiven Entwicklung oben auf dieser Seite, keine Formalität.
+
+**Es ist nicht mit DeepSeek verbunden.** Es wird von ihnen weder unterstützt noch gefördert, und es gibt Ihnen
+keine Rechte an ihrem Dienst. Ihre Nutzung dieses Dienstes richtet sich nach deren Bedingungen.
+
+---
+
+## Konfiguration
+
+`cordis.patch.yml` setzt:
+
+| Schlüssel | Standard | Bedeutung |
+|---|---|---|
+| `port` | `9222` | der Debug-Port des Browsers |
+| `defaultModel` | `deepseek-chat-search` | wird benutzt, wenn ein Aufruf kein Modell nennt |
+| `showBrowser` | `true` | ob das Fenster während der Arbeit sichtbar ist |
+
+Der Browser muss eine angemeldete Sitzung bei `chat.deepseek.com` haben. Der erste Aufruf startet Brave mit dem
+Profil **Default**, wenn der Port noch nicht offen ist. Läuft Brave bereits *ohne* Debug-Port, kann der Adapter
+sich nicht verbinden und sagt das klar, statt still zu scheitern.
+
+---
+
+## Aufbau
+
+```
+index.js          der Adapter: Harness-StreamChunk  ←→  Engine
+lib/engine.mjs    Browser + Seite: tippen, senden, streamen, zur Ruhe kommen
+lib/cdp.mjs       Chrome-DevTools-Protocol-Client, ohne Abhängigkeiten
+lib/prompt.mjs    fasst Nachrichten + Werkzeuge zu einer Nachricht zusammen; holt Aufrufe aus der Antwort
+lib/savings.mjs   was Ihnen der Web-Weg gespart hat, gegen die API gerechnet
+lib/i18n.mjs      51 Sprachen für das Panel
+```
+
+**Keine Abhängigkeiten.** Node 24 bringt `WebSocket` und `fetch` global mit, mehr braucht CDP nicht: der
+Token-Stream verlässt also nie den Host-Prozess und es gibt keinen IPC-Sprung pro Delta.
+
+---
+
+## Unterstützung
+
+Uncle Sam gibt es, damit Sie aufhören, pro Token zu zahlen. Wenn es Ihnen Geld gespart hat und Sie den nächsten
+auf Hardware sehen möchten, die nicht auf halbem Weg der Speicher ausgeht:
+
+**[☕ revolut.me/operatingtag](https://revolut.me/operatingtag)**
+
+Ein Stern auf dem Repository oder ein brauchbarer Fehlerbericht ist genauso viel wert.
+
+---
+
+## Lizenz
+
+**CC BY-NC-ND 4.0** — Creative Commons Namensnennung — Nicht kommerziell — Keine Bearbeitungen 4.0
+International. Copyright (c) 2026 Darren T. Weldon, veröffentlicht unter dem Namen Operating Tag.
+
+**Der ganze Deal in einer Zeile: installieren und persönlich kostenlos nutzen. Nicht ändern, nicht
+weitergeben, nicht verkaufen und nicht in einem Unternehmen einsetzen.**
+
+Das ist kein Open Source, und es behauptet es auch nicht.
+
+```
+Sie dürfen     es installieren und ausführen · es persönlich und nicht kommerziell nutzen
+               den Quellcode lesen, um ihn zu verstehen
+
+Sie dürfen    es nicht ändern, anpassen oder ein abgeleitetes Werk daraus machen
+nicht         es nicht kopieren, verbreiten, veröffentlichen, spiegeln oder
+              irgendwem zugänglich machen
+              es nicht auf eine Code-Plattform, ein Register, eine Website,
+              ein Forum oder einen Chat hochladen
+              es nicht verkaufen, weiterverkaufen, vermieten oder dafür oder
+              für den Zugang dazu Geld verlangen
+              es nicht in etwas einbinden, das Sie anderen liefern
+              es nicht kommerziell oder im Rahmen einer Geschäftstätigkeit nutzen
+```
+
+**Die beiden einzigen legitimen Quellen sind dieses Repository und das npm-Paket
+[`@operatingtag/dsh-unclesam`](https://www.npmjs.com/package/@operatingtag/dsh-unclesam).** Eine Kopie von
+anderswo ist nicht lizenziert, egal wer sie bereitgestellt hat. Wenn Sie diese Software zum Verkauf sehen,
+verkauft sie nicht ihr Autor.
+
+**Kommerzielle Nutzung sowie das Recht zu ändern und zu verbreiten gibt es unter einer separaten schriftlichen
+Lizenz.** Fragen Sie Operating Tag — Sie bekommen eine klare Antwort und einen klaren Preis.
+
+Die Datei [LICENSE](LICENSE) ist maßgeblich, und sie beginnt mit derselben Zusammenfassung in einfachem
+Englisch.
+
+---
+
+Uncle Sam ist ein unabhängiges Plugin. Nicht mit DeepSeek verbunden, von ihnen weder unterstützt noch gefördert.
+
+```
+@operatingtag/dsh-unclesam   v1.1.0
+Autor     Operating Tag
+Lizenz    CC BY-NC-ND 4.0 — frei zur Nutzung, nicht zum Ändern, Weitergabe oder Verkauf
+```

package/README.el.md

@@ -0,0 +1,270 @@
+[English](README.md) · [Español](README.es.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [Português](README.pt.md) · [Italiano](README.it.md) · [Türkçe](README.tr.md) · [한국어](README.ko.md) · [日本語](README.ja.md) · [简体中文](README.zh.md) · [Русский](README.ru.md) · [Polski](README.pl.md) · [हिन्दी](README.hi.md) · [Nederlands](README.nl.md) · [Українська](README.uk.md) · [Tiếng Việt](README.vi.md) · [Bahasa Indonesia](README.id.md) · [ไทย](README.th.md) · [فارسی](README.fa.md) · **Ελληνικά** · [עברית](README.he.md) · [Čeština](README.cs.md) · [Română](README.ro.md) · [Svenska](README.sv.md) · [Dansk](README.da.md) · [Suomi](README.fi.md) · [Magyar](README.hu.md)
+
+# Uncle Sam
+
+**Ένας πάροχος για το DeepSeek Harness που απαντά μέσα από το δικό σας πρόγραμμα περιήγησης, στον λογαριασμό web που έχετε ήδη, αντί για το χρεωμένο API.**
+
+**☕ [Κεράστε με έναν καφέ](https://revolut.me/operatingtag)** — το γράφει ένας άνθρωπος, τη νύχτα, χωρίς χρηματοδότηση. Δεν υπάρχει άλλο μοντέλο εσόδων. Ένα αστέρι ή μια χρήσιμη αναφορά σφάλματος αξίζει το ίδιο.
+
+> **Αυτό το προϊόν βρίσκεται σε ενεργή ανάπτυξη. Περιμένετε σφάλματα.**
+>
+> Δουλεύει, είναι γρήγορο και χρησιμοποιείται καθημερινά εδώ και εβδομάδες — αλλά αλλάζει συνεχώς, και η διαδρομή
+> του προγράμματος περιήγησης εξαρτάται από έναν ιστότοπο που αλλάζει χωρίς προειδοποίηση. Αν κάτι χαλάσει, ένα
+> στιγμιότυπο οθόνης και ο αριθμός έκδοσης αξίζουν περισσότερο από μια περιγραφή. Καρφιτσώστε μια έκδοση αν
+> βασίζεστε σε αυτό.
+
+```
+πάροχος     deepseek-web
+μοντέλα     deepseek-chat · deepseek-chat-search · deepseek-reasoner · deepseek-reasoner-search
+κόστος      μηδέν ανά token — χρησιμοποιεί τη συνδρομή που είναι ήδη ανοιχτή στο πρόγραμμα περιήγησής σας
+κατάσταση   σε ανάπτυξη — περιμένετε σφάλματα
+μετρημένο   πρώτο token ~1,9 δλ · επιβάρυνση ~0,6 δλ · μια πλήρης σειρά σε ~2,5 δλ
+```
+
+Οι απαντήσεις από τη διαδρομή web υπογράφονται **🔴 Uncle Sam**. Το όνομα είναι αστείο, όχι ισχυρισμός: δείχνει
+ποια διαδρομή απάντησε, και οι απαντήσεις του API δεν φέρουν καμία υπογραφή. Ξέρετε πάντα ποιος σας απάντησε.
+
+---
+
+## Τι σας γλιτώνει
+
+Το API χρεώνει ανά token. Το προϊόν web δεν χρεώνει. Αυτό το πρόσθετο καταχωρεί το `deepseek-web` ως πάροχο
+μοντέλων και απαντά σε κάθε κλήση οδηγώντας το `chat.deepseek.com` σε πραγματικό πρόγραμμα περιήγησης — η σελίδα
+κάνει τη δουλειά, το πρόγραμμα περιήγησης κρατά τη συνεδρία, και τίποτα δεν μετριέται.
+
+| | Διαδρομή API | Διαδρομή web |
+|---|---|---|
+| Κόστος | ανά token, για πάντα | τίποτα πέρα από τη συνδρομή |
+| Ταχύτητα | γρήγορη | ~2,5 δλ ανά σειρά, μετρημένο |
+| Κλήση εργαλείων | εγγενής και αξιόπιστη | προσομοιωμένη, δουλεύει αλλά ασθενέστερη |
+| Εξαρτάται από | το API | έναν ιστότοπο που αλλάζει χωρίς προειδοποίηση |
+
+**Και οι δύο διαδρομές μένουν εγκατεστημένες.** Ο επιλογέας μοντέλου είναι ο διακόπτης: χρησιμοποιήστε την φθηνή
+διαδρομή ως προεπιλογή και καταφύγετε στο API όταν μια εργασία χρειάζεται αξιόπιστα εργαλεία.
+
+---
+
+## Εγκατάσταση
+
+Το Uncle Sam είναι **πρόσθετο του DeepSeek Harness**. Έξω από το harness δεν κάνει τίποτα, γιατί καταχωρεί έναν
+πάροχο μοντέλων, μια διαδρομή στον κεντρικό υπολογιστή και δύο θέσεις διεπαφής.
+
+**Απαιτήσεις**
+
+| | |
+|---|---|
+| DeepSeek Harness | οποιαδήποτε πρόσφατη έκδοση με διαχειριστή προσθέτων |
+| Πρόγραμμα περιήγησης | συνιστάται Brave· το Edge χρησιμοποιείται αυτόματα αν λείπει το Brave |
+| Node | 22 ή νεότερο |
+
+**Από το npm**
+
+```bash
+pnpm add @operatingtag/dsh-unclesam
+```
+
+**Από αυτό το αποθετήριο**
+
+```bash
+git clone https://github.com/operatingtag/dsh-unclesam
+cd dsh-unclesam
+pnpm install
+```
+
+Έπειτα προσθέστε τη γραμμή του πακέτου στο προφίλ σας ώστε να το φορτώσει το harness:
+
+```yaml
+# cordis.patch.yml
+- insert:
+    - id: dsh-unclesam
+      name: '@operatingtag/dsh-unclesam'
+      config:
+        port: 9222
+        defaultModel: deepseek-chat-search
+        autoMinimise: true
+```
+
+**Ή από έναν φάκελο:** Ρυθμίσεις → Πρόσθετα → εγκατάσταση από τοπική διαδρομή, δείχνοντας τον φάκελο με το
+`package.json`.
+
+### Πρώτη εκτέλεση
+
+Πατήστε **Σύνδεση / άνοιγμα συνομιλίας**. Το πρόγραμμα περιήγησης ανοίγει και **μένει ορατό** μέχρι να συνδεθείτε
+στο chat.deepseek.com. Μετά ελαχιστοποιείται μόνο του και δεν θα το ξαναδείτε. Η συνεδρία ζει στο προφίλ του
+προγράμματος περιήγησης, άρα **το πρόσθετο δεν αποθηκεύει κωδικό** — δεν υπάρχει τίποτα να διαρρεύσει.
+
+Θα πρέπει τότε να δείτε:
+
+1. **Ρυθμίσεις → Uncle Sam** — σελίδα με γραμμές κατάστασης και κουμπί σύνδεσης.
+2. **Κάτω από το πλαίσιο μηνύματος** — `● DeepSeek Harness` ή `● Uncle Sam`, κλικ για εναλλαγή.
+3. **Τη λίστα μοντέλων** — τέσσερα μοντέλα `(web)` δίπλα σε αυτά του API.
+
+### Αφαίρεση
+
+Ρυθμίσεις → Πρόσθετα → Uncle Sam → Απεγκατάσταση. Τίποτα δεν γράφεται έξω από το προφίλ περιήγησης με το οποίο
+συνδεθήκατε.
+
+---
+
+## Ο διακόπτης API / web
+
+**Ο επιλογέας μοντέλου είναι ο διακόπτης.** Δεν υπάρχει δεύτερο χειριστήριο, γιατί ένα δεύτερο χειριστήριο που θα
+επέλεγε και το μοντέλο θα ήταν δύο πηγές αλήθειας για μία απόφαση.
+
+| Επιλέξτε αυτό το μοντέλο | Διαδρομή | DeepThink | Αναζήτηση |
+|---|---|---|---|
+| `DeepSeek Chat (web)` | πρόγραμμα περιήγησης | κλειστό | κλειστό |
+| `DeepSeek Chat + Search (web)` | πρόγραμμα περιήγησης | κλειστό | **ανοιχτό** |
+| `DeepSeek Reasoner (web)` | πρόγραμμα περιήγησης | **ανοιχτό** | κλειστό |
+| `DeepSeek Reasoner + Search (web)` | πρόγραμμα περιήγησης | **ανοιχτό** | **ανοιχτό** |
+| οποιοδήποτε μοντέλο χωρίς `(web)` | το API | — | — |
+
+Ένα σήμα **WEB** ή **API** εμφανίζεται δίπλα στην ετικέτα του μοντέλου ώστε η ενεργή διαδρομή να φαίνεται με μια
+ματιά. Όταν η ετικέτα δεν αναγνωρίζεται, το σήμα δεν δείχνει τίποτα αντί να μαντέψει — ένα λάθος σήμα θα ήταν
+χειρότερο από κανένα.
+
+Η επιλογή σας διατηρείται μετά από επανεκκινήσεις. Το **DeepThink** είναι το πέρασμα συλλογισμού· η **Αναζήτηση**
+του επιτρέπει να διαβάζει τον ζωντανό ιστό.
+
+### Η αναζήτηση φαίνεται στη συνομιλία
+
+Με μοντέλο αναζήτησης, μια σειρά παράγει **δύο μπλοκ** — το ερώτημα με το οποίο έψαξε, τις πηγές που βρήκε και
+έπειτα την απάντηση που τις χρησιμοποίησε:
+
+```
+Αναζήτηση web — «Ποιος είναι ένας σημερινός τίτλος τεχνολογίας;»
+Πηγές (4): yna.co.kr · fnnews.com · rthk.hk · sina.com.cn
+Σύνδεσμοι: https://k.sina.com.cn/article_... http://www.21jingji.com/article_...
+```
+
+Η σελίδα δεν αποκαλύπτει το ερώτημα που πληκτρολόγησε εσωτερικά, άρα το ερώτημα που παρατίθεται είναι το μήνυμα
+που προκάλεσε την αναζήτηση. Οι πηγές και οι σύνδεσμοι διαβάζονται από τη σελίδα αφού η απάντηση ηρεμήσει. Επειδή
+οι πηγές υπάρχουν μόνο στο τέλος, **οι σειρές με αναζήτηση συσσωρεύονται αντί να μεταδίδονται σε ροή**· οι
+συνηθισμένες σειρές εξακολουθούν να ρέουν token προς token.
+
+---
+
+## Γιατί πρόγραμμα περιήγησης και όχι το HTTP API τους
+
+Η προφανής διαδρομή — να καλέσεις το δικό του API του `chat.deepseek.com` — δοκιμάστηκε και εγκαταλείφθηκε. Ο
+ιστότοπος κάνει κάθε μήνυμα να περνά δύο πύλες:
+
+| Πύλη | Τι σημαίνει |
+|---|---|
+| `/api/v0/chat/create_pow_challenge` | μια **απόδειξη εργασίας** ανά μήνυμα |
+| `challenges.cloudflare.com/turnstile` | μια πύλη κατά των bot στην προέλευση |
+
+Το να ξαναφτιάξεις οποιαδήποτε από τις δύο είναι χαμένο παιχνίδι: είναι συγκαλυμμένες, αλλάζουν, και όταν αλλάζουν
+η αποτυχία μοιάζει ακριβώς με βλάβη δικτύου. **Η σελίδα έχει ήδη λύσει και τις δύο για τα δικά της αιτήματα.**
+
+Έτσι ο προσαρμογέας δεν μιλά ποτέ HTTP με τον ιστότοπο. Οδηγεί τη σελίδα, και η σελίδα κάνει τα υπόλοιπα. Η
+ταυτοποίηση, η απόδειξη εργασίας και το Turnstile παύουν να είναι δικό μας πρόβλημα και δεν μπορούν να χαλάσουν
+ανεξάρτητα από τον ίδιο τον ιστότοπο.
+
+**Επαληθεύτηκε:** ένα απλό `HEAD` στον ιστότοπο επιστρέφει `403`· η διαδρομή μέσω προγράμματος περιήγησης
+επιστρέφει απαντήσεις.
+
+---
+
+## Όρια, ειπωμένα ειλικρινά
+
+**Η κλήση εργαλείων είναι προσομοιωμένη.** Μια συνομιλία web δεν έχει δομημένο κανάλι εργαλείων: τα εργαλεία
+περιγράφονται στο prompt και μια κλήση ανακτάται εξάγοντας ένα αντικείμενο JSON από την απάντηση. Δουλεύει —
+επαληθευμένο — αλλά είναι ασθενέστερη από την εγγενή κλήση: ένα μοντέλο που αγνοεί την οδηγία απαντά σε πεζό λόγο
+και το harness δεν βλέπει καμία χρήση εργαλείου εκείνη τη σειρά. **Για βαριά εργασία πρακτόρων η διαδρομή API είναι
+πιο αξιόπιστη.** Η διαδρομή web είναι καλύτερη για συνομιλία, μεγάλες απαντήσεις, υποπράκτορες, συμπίεση και κάθε
+σειρά όπου το μοντέλο πρέπει να είναι το μοντέλο web.
+
+**Εξαρτάται από έναν ιστότοπο που δεν ελέγχετε.** Όταν η σελίδα αλλάζει μορφή, το πρόσθετο πρέπει να αλλάξει μαζί
+της. Αυτή είναι η προειδοποίηση ανάπτυξης στην κορυφή αυτής της σελίδας, όχι τυπικότητα.
+
+**Δεν συνδέεται με τη DeepSeek.** Δεν εγκρίνεται ούτε υποστηρίζεται από αυτούς, και δεν σας δίνει κανένα δικαίωμα
+στην υπηρεσία τους. Η χρήση της υπηρεσίας εκείνης διέπεται από τους όρους τους.
+
+---
+
+## Ρύθμιση
+
+Το `cordis.patch.yml` ορίζει:
+
+| κλειδί | προεπιλογή | σημασία |
+|---|---|---|
+| `port` | `9222` | η θύρα εντοπισμού σφαλμάτων του προγράμματος περιήγησης |
+| `defaultModel` | `deepseek-chat-search` | χρησιμοποιείται όταν μια κλήση δεν ονομάζει μοντέλο |
+| `showBrowser` | `true` | αν το παράθυρο είναι ορατό όσο εργάζεται |
+
+Το πρόγραμμα περιήγησης πρέπει να έχει συνεδρία συνδεδεμένη στο `chat.deepseek.com`. Η πρώτη κλήση ξεκινά το Brave
+με το προφίλ **Default** αν η θύρα δεν είναι ήδη ανοιχτή. Αν το Brave τρέχει ήδη *χωρίς* θύρα εντοπισμού, ο
+προσαρμογέας δεν μπορεί να συνδεθεί και το λέει καθαρά αντί να αποτύχει σιωπηλά.
+
+---
+
+## Δομή
+
+```
+index.js          ο προσαρμογέας: StreamChunk του harness  ←→  μηχανή
+lib/engine.mjs    πρόγραμμα περιήγησης + σελίδα: γράψιμο, αποστολή, ροή, ηρεμία
+lib/cdp.mjs       πελάτης Chrome DevTools Protocol, χωρίς εξαρτήσεις
+lib/prompt.mjs    ισοπεδώνει μηνύματα + εργαλεία σε ένα μήνυμα· ανακτά κλήσεις από την απάντηση
+lib/savings.mjs   τι σας γλίτωσε η διαδρομή web, κοστολογημένο απέναντι στο API
+lib/i18n.mjs      51 γλώσσες για τον πίνακα
+```
+
+**Καμία εξάρτηση.** Το Node 24 έχει καθολικά `WebSocket` και `fetch`, που είναι ό,τι χρειάζεται το CDP, άρα η ροή
+των token δεν φεύγει ποτέ από τη διεργασία υποδοχής και δεν υπάρχει άλμα IPC ανά δέλτα.
+
+---
+
+## Υποστήριξη
+
+Το Uncle Sam υπάρχει για να σταματήσετε να πληρώνετε ανά token. Αν σας γλίτωσε χρήματα και θα θέλατε το επόμενο
+χτισμένο σε υλικό που δεν μένει από μνήμη στη μέση:
+
+**[☕ revolut.me/operatingtag](https://revolut.me/operatingtag)**
+
+Ένα αστέρι στο αποθετήριο ή μια χρήσιμη αναφορά σφάλματος αξίζει το ίδιο.
+
+---
+
+## Άδεια
+
+**CC BY-NC-ND 4.0** — Creative Commons Αναφορά-Μη Εμπορική Χρήση-Όχι Παράγωγα 4.0 Διεθνής.
+Copyright (c) 2026 Darren T. Weldon, δημοσιευμένο με το όνομα Operating Tag.
+
+**Όλη η συμφωνία σε μία γραμμή: εγκαταστήστε το και χρησιμοποιήστε το προσωπικά, δωρεάν. Μην το αλλάξετε, μην το
+μοιραστείτε, μην το πουλήσετε και μην το χρησιμοποιήσετε σε εταιρεία.**
+
+Αυτό δεν είναι ανοιχτός κώδικας, και δεν προσποιείται ότι είναι.
+
+```
+μπορείτε      να το εγκαταστήσετε και να το εκτελέσετε · να το χρησιμοποιήσετε προσωπικά, μη εμπορικά
+              να διαβάσετε τον πηγαίο κώδικα για να το καταλάβετε
+
+δεν μπορείτε  να το τροποποιήσετε, να το προσαρμόσετε ή να φτιάξετε παράγωγο έργο
+              να το αντιγράψετε, διανείμετε, δημοσιεύσετε, καθρεφτίσετε ή
+              να το κάνετε διαθέσιμο σε οποιονδήποτε
+              να το ανεβάσετε σε οποιαδήποτε φιλοξενία κώδικα, μητρώο, ιστότοπο, φόρουμ ή συνομιλία
+              να το πουλήσετε, μεταπουλήσετε, νοικιάσετε ή να χρεώσετε γι' αυτό ή για πρόσβαση σε αυτό
+              να το συμπεριλάβετε σε οτιδήποτε παραδίδετε σε άλλον
+              να το χρησιμοποιήσετε για οποιονδήποτε εμπορικό σκοπό ή στο πλαίσιο επιχειρηματικής δραστηριότητας
+```
+
+**Οι μόνες δύο νόμιμες πηγές είναι αυτό το αποθετήριο και το πακέτο npm
+[`@operatingtag/dsh-unclesam`](https://www.npmjs.com/package/@operatingtag/dsh-unclesam).** Ένα αντίγραφο από
+οπουδήποτε αλλού δεν είναι αδειοδοτημένο, όποιος κι αν το έδωσε. Αν δείτε αυτό το λογισμικό προς πώληση, δεν το
+πουλά ο δημιουργός του.
+
+**Η εμπορική χρήση, καθώς και το δικαίωμα τροποποίησης και διανομής, διατίθενται με ξεχωριστή γραπτή άδεια.**
+Ρωτήστε το Operating Tag — θα πάρετε καθαρή απάντηση και καθαρή τιμή.
+
+Το αρχείο [LICENSE](LICENSE) είναι το δεσμευτικό, και ξεκινά με την ίδια σύνοψη σε απλά αγγλικά.
+
+---
+
+Το Uncle Sam είναι ανεξάρτητο πρόσθετο. Δεν συνδέεται με τη DeepSeek, δεν εγκρίνεται ούτε υποστηρίζεται από αυτούς.
+
+```
+@operatingtag/dsh-unclesam   v1.1.0
+Δημιουργός   Operating Tag
+Άδεια        CC BY-NC-ND 4.0 — ελεύθερο για χρήση, όχι για αλλαγή, κοινή χρήση ή πώληση
+```