@operatingtag/dsh-unclesam 0.0.0-stage → 1.0.1

package/LICENSE

@@ -0,0 +1,144 @@
+═══════════════════════════════════════════════════════════════════════════════
+FREE TO USE — NOT FREE TO CHANGE OR SHARE
+
+Uncle Sam (dsh-unclesam)
+Copyright (c) 2026 Darren T. Weldon — published under the Operating Tag name
+Contact: @operatingtag
+
+☕ Buy me a coffee: https://revolut.me/operatingtag
+   (a request, not a condition — see the note at the end)
+
+Resumen en español: README.es.md          English summary below
+
+═══════════════════════════════════════════════════════════════════════════════
+WHAT THIS MEANS, IN PLAIN ENGLISH
+═══════════════════════════════════════════════════════════════════════════════
+
+You may install it and use it. That is it, and that is free, forever, for anyone
+acting personally rather than commercially.
+
+You may not change it. You may not pass it on. You may not sell it. You may not
+use it in a business. You may not publish a fork of it anywhere.
+
+If you want any of those, ask. They are available, for a fee, from Operating Tag.
+
+═══════════════════════════════════════════════════════════════════════════════
+WHAT YOU MAY DO
+═══════════════════════════════════════════════════════════════════════════════
+
+    · install it from its official source and run it
+
+    · use it for personal, non-commercial purposes, as often as you like
+
+    · keep it installed for as long as you like
+
+    · read the source to understand how it works
+
+═══════════════════════════════════════════════════════════════════════════════
+WHAT YOU MAY NOT DO
+═══════════════════════════════════════════════════════════════════════════════
+
+    · modify it, adapt it, translate it, or create a derivative of it
+
+    · copy it, distribute it, publish it, mirror it, or make it available to
+      anybody else by any means, including over a network
+
+    · upload it to any code host, package registry, website, forum or chat
+
+    · sell it, resell it, rent it, charge for it, or charge for access to it
+
+    · bundle it into anything you supply to another person
+
+    · use it for any commercial purpose, or in the course of a business
+
+    · use the name "Uncle Sam" or "Operating Tag" to promote or endorse
+      anything, or to suggest a connection that does not exist
+
+═══════════════════════════════════════════════════════════════════════════════
+THE OFFICIAL SOURCES — ONE RULE THAT MATTERS
+═══════════════════════════════════════════════════════════════════════════════
+
+There are exactly two places where this software may legitimately be obtained:
+
+    1.  the GitHub repository operated by Operating Tag
+    2.  the npm package @operatingtag/dsh-unclesam
+
+A copy obtained anywhere else is not licensed, whoever supplied it and however
+it was described. If you see this software for sale, it is not being sold by its
+author.
+
+═══════════════════════════════════════════════════════════════════════════════
+THE LEGAL LICENCE
+═══════════════════════════════════════════════════════════════════════════════
+
+This work is licensed under the Creative Commons
+Attribution-NonCommercial-NoDerivatives 4.0 International Public License
+("CC BY-NC-ND 4.0").
+
+The summary above describes the intent. The licence text below is the binding
+agreement, and where the two appear to differ the licence text governs.
+
+Full licence, human-readable summary, and legal code:
+    https://creativecommons.org/licenses/by-nc-nd/4.0/
+
+Attribution Notice, as required by Section 3(a)(1)(A):
+
+    Title:   Uncle Sam (dsh-unclesam)
+    Creator: Darren T. Weldon, publishing as Operating Tag
+    Source:  the GitHub repository operated by Operating Tag
+    Licence: CC BY-NC-ND 4.0
+    Changes: none permitted — this is unadapted material
+
+═══════════════════════════════════════════════════════════════════════════════
+A NOTE ON WHAT THIS LICENCE DOES AND DOES NOT ALLOW
+═══════════════════════════════════════════════════════════════════════════════
+
+Two points are worth stating plainly, because they are where people get this
+wrong.
+
+Non-commercial means non-commercial. Under the licence, "NonCommercial" means
+not primarily intended for or directed towards commercial advantage or monetary
+compensation. A company using this in its business is not a non-commercial use,
+whatever it was told.
+
+No derivative works means no derivative works. Reading the source is permitted.
+Changing it is not, and neither is publishing a changed copy. The licence
+expressly withholds permission to share adapted material.
+
+If you need either of those rights — commercial use, or the right to modify and
+distribute — they are available under a separate written licence from Operating
+Tag. Ask, and you will get a straight answer and a clear price.
+
+═══════════════════════════════════════════════════════════════════════════════
+ONGOING DEVELOPMENT
+═══════════════════════════════════════════════════════════════════════════════
+
+This software is under active development and you should expect bugs. It drives
+a third-party website that changes without notice, and it is not affiliated
+with, endorsed by, or supported by that third party.
+
+It is provided as-is and as-available. The disclaimer of warranties in Section 5
+of the licence is not decoration — nothing here is promised to work, to keep
+working, or to be free of defects.
+
+═══════════════════════════════════════════════════════════════════════════════
+THE ASK
+═══════════════════════════════════════════════════════════════════════════════
+
+This is written by one person, at night, funded by nothing. Fifty-one languages
+were written out by hand and each was tested until it behaved.
+
+If it saved you money or an afternoon:
+
+    https://revolut.me/operatingtag
+
+That is a request. It carries no legal weight, it is not a condition of the
+licence, and ignoring it changes nothing about your rights.
+
+═══════════════════════════════════════════════════════════════════════════════
+
+Creative Commons is not a party to this licence and provides no legal services.
+The full text of CC BY-NC-ND 4.0 is published by Creative Commons at
+https://creativecommons.org/licenses/by-nc-nd/4.0/legalcode
+
+-- Operating Tag, October 2026

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)
+
+# 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.0.1
+Autor     Operating Tag
+Lizenz    CC BY-NC-ND 4.0 — frei zur Nutzung, nicht zum Ändern, Weitergabe oder Verkauf
+```

package/README.es.md

@@ -0,0 +1,268 @@
+[English](README.md) · **Español** · [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)
+
+# Uncle Sam
+
+**Un proveedor para DeepSeek Harness que responde a través de tu propio navegador, con la cuenta web que ya tienes, en lugar de la API de pago.**
+
+**☕ [Invítame a un café](https://revolut.me/operatingtag)** — lo escribe una persona, de noche, sin financiación. No hay otro modelo de ingresos. Una estrella o un informe de fallo vale lo mismo.
+
+> **Este producto está en desarrollo activo. Espera fallos.**
+>
+> Funciona, es rápido y se ha usado a diario durante semanas, pero cambia con frecuencia y la ruta del
+> navegador depende de un sitio web que cambia sin avisar. Si algo se rompe, una captura de pantalla y el
+> número de versión valen más que una descripción. Fija una versión si dependes de él.
+
+```
+proveedor  deepseek-web
+modelos    deepseek-chat · deepseek-chat-search · deepseek-reasoner · deepseek-reasoner-search
+coste      nada por token: usa la suscripción que ya tienes abierta en el navegador
+estado     en desarrollo — espera fallos
+medido     primer token ~1,9 s · sobrecoste ~0,6 s · un turno completo en ~2,5 s
+```
+
+Las respuestas de la ruta web van firmadas con **🔴 Uncle Sam**. El nombre es una broma, no una afirmación:
+marca qué ruta ha respondido, y las respuestas de la API no llevan firma. Siempre sabes cuál de las dos te ha
+contestado.
+
+---
+
+## Qué te ahorra
+
+La API cobra por token. El producto web no. Este plugin registra `deepseek-web` como proveedor de modelos y
+responde cada llamada conduciendo `chat.deepseek.com` en un navegador real: la página hace el trabajo, el
+navegador mantiene la sesión y no se factura nada.
+
+| | Ruta API | Ruta web |
+|---|---|---|
+| Coste | por token, siempre | nada más allá de la suscripción |
+| Velocidad | rápida | ~2,5 s por turno, medido |
+| Llamadas a herramientas | nativas y fiables | emuladas, funciona pero es más débil |
+| Depende de | la API | un sitio web que cambia sin avisar |
+
+**Las dos rutas quedan instaladas.** El selector de modelo es el interruptor, así que puedes usar la barata por
+defecto y recurrir a la API cuando una tarea necesite herramientas fiables.
+
+---
+
+## Instalación
+
+Uncle Sam es un **plugin de DeepSeek Harness**. No hace nada fuera del harness, porque registra un proveedor de
+modelos, una ruta del host y dos espacios de interfaz.
+
+**Requisitos**
+
+| | |
+|---|---|
+| DeepSeek Harness | cualquier versión reciente con gestor de plugins |
+| Navegador | Brave recomendado; Edge se usa automáticamente si falta Brave |
+| Node | 22 o superior |
+
+**Desde npm**
+
+```bash
+pnpm add @operatingtag/dsh-unclesam
+```
+
+**Desde este repositorio**
+
+```bash
+git clone https://github.com/operatingtag/dsh-unclesam
+cd dsh-unclesam
+pnpm install
+```
+
+Después añade la fila del paquete a tu perfil para que el harness lo cargue:
+
+```yaml
+# cordis.patch.yml
+- insert:
+    - id: dsh-unclesam
+      name: '@operatingtag/dsh-unclesam'
+      config:
+        port: 9222
+        defaultModel: deepseek-chat-search
+        autoMinimise: true
+```
+
+**O desde una carpeta:** Ajustes → Plugins → instalar desde una ruta local, apuntando a la carpeta que contiene
+`package.json`.
+
+### Primera ejecución
+
+Pulsa **Iniciar sesión / abrir el chat**. El navegador se abre y **permanece visible** hasta que hayas iniciado
+sesión en chat.deepseek.com. Después se minimiza solo y no lo volverás a ver. La sesión vive en tu perfil del
+navegador, así que **el plugin no guarda ninguna contraseña**: no hay nada que filtrar.
+
+Deberías ver entonces:
+
+1. **Ajustes → Uncle Sam** — una página con filas de estado y un botón de inicio de sesión.
+2. **Bajo la caja de chat** — `● DeepSeek Harness` o `● Uncle Sam`, pulsa para cambiar.
+3. **La lista de modelos** — cuatro modelos `(web)` junto a los de la API.
+
+### Desinstalarlo
+
+Ajustes → Plugins → Uncle Sam → Desinstalar. No se escribe nada fuera del perfil del navegador con el que
+iniciaste sesión.
+
+---
+
+## El interruptor API / web
+
+**El selector de modelo es el interruptor.** No hay un segundo control, porque un segundo control que además
+eligiera el modelo serían dos fuentes de verdad para una sola decisión.
+
+| Elige este modelo | Ruta | DeepThink | Búsqueda |
+|---|---|---|---|
+| `DeepSeek Chat (web)` | navegador | no | no |
+| `DeepSeek Chat + Search (web)` | navegador | no | **sí** |
+| `DeepSeek Reasoner (web)` | navegador | **sí** | no |
+| `DeepSeek Reasoner + Search (web)` | navegador | **sí** | **sí** |
+| cualquier modelo sin `(web)` | la API | — | — |
+
+Una insignia **WEB** o **API** aparece junto a la etiqueta del modelo para que la ruta activa se vea de un
+vistazo. Cuando la etiqueta no se reconoce, la insignia no muestra nada en lugar de adivinar: una insignia
+equivocada sería peor que ninguna.
+
+Tu elección se mantiene entre reinicios. **DeepThink** es la pasada de razonamiento; **Búsqueda** le permite
+leer la web en vivo.
+
+### La búsqueda se ve en la conversación
+
+Con un modelo de búsqueda, un turno produce **dos bloques**: la consulta con la que buscó, las fuentes que
+encontró y después la respuesta que las usó.
+
+```
+Búsqueda web — "¿Cuál es un titular tecnológico de hoy?"
+Fuentes (4): yna.co.kr · fnnews.com · rthk.hk · sina.com.cn
+Enlaces: https://k.sina.com.cn/article_... http://www.21jingji.com/article_...
+```
+
+La página no expone la consulta que escribió internamente, así que la consulta citada es el mensaje que
+provocó la búsqueda. Las fuentes y los enlaces se leen de la página cuando la respuesta se asienta. Como las
+fuentes solo existen al final, **los turnos con búsqueda se acumulan en lugar de emitirse en streaming**; los
+turnos normales siguen emitiéndose token a token.
+
+---
+
+## Por qué un navegador y no su API HTTP
+
+La ruta obvia —llamar a la API propia de `chat.deepseek.com`— se intentó y se abandonó. El sitio hace que cada
+mensaje pase dos puertas:
+
+| Puerta | Qué significa |
+|---|---|
+| `/api/v0/chat/create_pow_challenge` | un desafío de **prueba de trabajo** por mensaje |
+| `challenges.cloudflare.com/turnstile` | una barrera anti-bots en el origen |
+
+Reimplementar cualquiera de las dos es perder el tiempo: están ofuscadas, cambian, y cuando cambian el fallo
+parece exactamente un fallo de red. **La página ya resuelve ambas para sus propias peticiones.**
+
+Así que el adaptador nunca habla HTTP con el sitio. Conduce la página, y la página hace el resto. La
+autenticación, la prueba de trabajo y Turnstile dejan de ser nuestro problema y no pueden romperse de forma
+independiente al propio sitio.
+
+**Verificado:** un `HEAD` simple al sitio devuelve `403`; la ruta del navegador devuelve respuestas.
+
+---
+
+## Límites, dichos con honestidad
+
+**El uso de herramientas está emulado.** Un chat web no tiene canal estructurado de herramientas, así que las
+herramientas se describen en el mensaje y una llamada se recupera analizando un objeto JSON de la respuesta.
+Funciona —verificado— pero es más débil que las llamadas nativas: un modelo que ignora la instrucción responde
+en prosa y el harness no ve ninguna herramienta ese turno. **Para trabajo agéntico pesado, la ruta API es más
+fiable.** La ruta web es mejor para conversación, respuestas largas, subagentes, compactación y cualquier turno
+en el que el modelo deba ser el modelo web.
+
+**Depende de un sitio web que no controlas.** Cuando la página cambia de forma, el plugin tiene que cambiar con
+ella. Eso es la advertencia de desarrollo activo de arriba, no una formalidad.
+
+**No está afiliado a DeepSeek.** No está respaldado por ellos y no te da ningún derecho sobre su servicio. Tu
+uso de ese servicio se rige por sus términos.
+
+---
+
+## Configuración
+
+`cordis.patch.yml` define:
+
+| clave | por defecto | significado |
+|---|---|---|
+| `port` | `9222` | el puerto de depuración del navegador |
+| `defaultModel` | `deepseek-chat-search` | se usa cuando una llamada no indica modelo |
+| `showBrowser` | `true` | si la ventana es visible mientras trabaja |
+
+El navegador debe tener una sesión iniciada en `chat.deepseek.com`. La primera llamada abre Brave con el perfil
+**Default** si el puerto no está ya abierto. Si Brave ya se está ejecutando *sin* puerto de depuración, el
+adaptador no puede conectarse y lo dice claramente en lugar de fallar en silencio.
+
+---
+
+## Arquitectura
+
+```
+index.js          el adaptador: StreamChunk del harness  ←→  motor
+lib/engine.mjs    navegador + página: escribir, enviar, transmitir, asentar
+lib/cdp.mjs       cliente del Chrome DevTools Protocol, sin dependencias
+lib/prompt.mjs    aplana mensajes + herramientas en un mensaje; recupera llamadas de la respuesta
+lib/savings.mjs   lo que te ahorró la ruta web, valorado contra la API
+lib/i18n.mjs      51 idiomas para el panel
+```
+
+**Sin dependencias.** Node 24 incluye `WebSocket` y `fetch` globales, que es todo lo que CDP necesita, así que
+el flujo de tokens nunca sale del proceso host y no hay salto IPC por delta.
+
+---
+
+## Apoyo
+
+Uncle Sam existe para que dejes de pagar por token. Si te ha ahorrado dinero y te gustaría ver el siguiente
+construido sobre hardware que no se queda sin memoria a mitad de camino:
+
+**[☕ revolut.me/operatingtag](https://revolut.me/operatingtag)**
+
+Una estrella en el repositorio o un informe de fallo útil vale lo mismo.
+
+---
+
+## Licencia
+
+**CC BY-NC-ND 4.0** — Creative Commons Atribución-NoComercial-SinDerivadas 4.0 Internacional.
+Copyright (c) 2026 Darren T. Weldon, publicado bajo el nombre Operating Tag.
+
+**Todo el acuerdo, en una línea: instálalo y úsalo, personalmente, gratis. No lo cambies, no lo compartas, no
+lo vendas y no lo uses en una empresa.**
+
+Eso no es código abierto, y no pretende serlo.
+
+```
+puedes      instalarlo y ejecutarlo · usarlo personalmente, sin fines comerciales
+            leer el código para entenderlo
+
+no puedes   modificarlo, adaptarlo ni crear una obra derivada
+            copiarlo, distribuirlo, publicarlo, replicarlo ni ponerlo a disposición de nadie
+            subirlo a ningún alojamiento de código, registro, web, foro o chat
+            venderlo, revenderlo, alquilarlo ni cobrar por él o por acceder a él
+            incluirlo en cualquier cosa que entregues a otra persona
+            usarlo con cualquier fin comercial ni en el ejercicio de una actividad empresarial
+```
+
+**Las dos únicas fuentes legítimas son este repositorio y el paquete npm
+[`@operatingtag/dsh-unclesam`](https://www.npmjs.com/package/@operatingtag/dsh-unclesam).** Una copia que
+venga de cualquier otro sitio no está licenciada, sea quien sea que la haya facilitado. Si ves este software a
+la venta, no lo está vendiendo su autor.
+
+**El uso comercial, y el derecho a modificar y distribuir, están disponibles bajo una licencia escrita
+separada.** Pregunta a Operating Tag y recibirás una respuesta clara y un precio claro.
+
+El archivo [LICENSE](LICENSE) es el que rige, y abre con el mismo resumen en inglés sencillo.
+
+---
+
+Uncle Sam es un plugin independiente. No está afiliado, respaldado ni soportado por DeepSeek.
+
+```
+@operatingtag/dsh-unclesam   v1.0.1
+Autor    Operating Tag
+Licencia CC BY-NC-ND 4.0 — gratis para usar, no para cambiar, compartir o vender
+```