[English](README.md) · [Español](README.es.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · **Português** · [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) · [العربية](README.ar.md) · [Oʻzbekcha](README.uz.md) · [Azərbaycan](README.az.md) · [Български](README.bg.md) · [Hrvatski](README.hr.md) · [Қазақша](README.kk.md) · [ქართული](README.ka.md) · [नेपाली](README.ne.md) · [සිංහල](README.si.md) · [தமிழ்](README.ta.md) · [తెలుగు](README.te.md) · [मराठी](README.mr.md) · [বাংলা](README.bn.md) · [ខ្មែរ](README.km.md) · [Lietuvių](README.lt.md) · [Bahasa Melayu](README.ms.md) · [မြန်မာ](README.my.md) · [Norsk](README.no.md) · [Slovenčina](README.sk.md) · [Slovenščina](README.sl.md) · [Српски](README.sr.md) · [Kiswahili](README.sw.md) · [Filipino](README.tl.md) · [اردو](README.ur.md)

# Uncle Sam

**Um provedor para o DeepSeek Harness que responde pelo seu próprio navegador, na conta web que você já tem, em vez da API cobrada por token.**

**O plugin do DeepSeek Harness que conduz o chat.deepseek.com num navegador de verdade: a alternativa gratuita à API do DeepSeek. Chat, DeepThink e busca na web na sua própria conta, sem chave de API e sem pagar por token.**

**☕ [Pague-me um café](https://revolut.me/operatingtag)** — escrito por uma pessoa, à noite, sem financiamento. Não há outro modelo de receita. Uma estrela ou um relato de bug vale o mesmo.

> **Este produto está em desenvolvimento ativo. Espere bugs.**
>
> Funciona, é rápido e roda diariamente há semanas — mas muda o tempo todo, e a rota do navegador depende de um
> site que muda sem avisar. Se algo quebrar, uma captura de tela e o número da versão valem mais do que uma
> descrição. Fixe uma versão se você depender dele.

```
provedor   deepseek-web
modelos    deepseek-chat · deepseek-chat-search · deepseek-reasoner · deepseek-reasoner-search
custo      nada por token — usa a assinatura que já está aberta no seu navegador
estado     em desenvolvimento — espere bugs
medido     primeiro token ~1,9 s · sobrecarga ~0,6 s · um turno completo em ~2,5 s
```

As respostas da rota web vêm assinadas com **🔴 Uncle Sam**. O nome é uma piada, não uma afirmação: ele marca
qual rota respondeu, e as respostas da API não levam assinatura nenhuma. Você sempre sabe qual das duas falou
com você.

---

## O que ele economiza

A API cobra por token. O produto web não. Este plugin registra `deepseek-web` como provedor de modelos e responde
cada chamada conduzindo o `chat.deepseek.com` em um navegador de verdade — a página faz o trabalho, o navegador
guarda a sessão, e nada é medido.

| | Rota API | Rota web |
|---|---|---|
| Custo | por token, para sempre | nada além da assinatura |
| Velocidade | rápida | ~2,5 s por turno, medido |
| Chamada de ferramentas | nativa e confiável | emulada, funciona mas é mais frágil |
| Depende de | a API | um site que muda sem avisar |

**As duas rotas ficam instaladas.** O seletor de modelo é o interruptor: use a rota barata por padrão e recorra à
API quando a tarefa exigir ferramentas confiáveis.

---

## Instalação

O Uncle Sam é um **plugin do DeepSeek Harness**. Fora do harness ele não faz nada, porque registra um provedor de
modelos, uma rota no host e dois espaços de interface.

**Requisitos**

| | |
|---|---|
| DeepSeek Harness | qualquer versão recente com gerenciador de plugins |
| Navegador | Brave recomendado; o Edge é usado automaticamente se o Brave não estiver presente |
| Node | 22 ou mais novo |

**Pelo npm**

```bash
pnpm add @operatingtag/dsh-unclesam
```

**Por este repositório**

```bash
git clone https://github.com/operatingtag/dsh-unclesam
cd dsh-unclesam
pnpm install
```

Depois acrescente a linha do pacote ao seu perfil para o harness carregá-lo:

```yaml
# cordis.patch.yml
- insert:
    - id: dsh-unclesam
      name: '@operatingtag/dsh-unclesam'
      config:
        port: 9222
        defaultModel: deepseek-chat-search
        autoMinimise: true
```

**Ou por uma pasta:** Configurações → Plugins → instalar de um caminho local, apontando para a pasta que tem o
`package.json`.

### Primeira execução

Clique em **Entrar / abrir o chat**. O navegador abre e **fica visível** até você entrar no chat.deepseek.com.
Depois disso ele se minimiza sozinho e você não o vê mais. A sessão fica no seu perfil do navegador, então **o
plugin não guarda nenhuma senha** — não há nada para vazar.

Você deve ver então:

1. **Configurações → Uncle Sam** — uma página com linhas de status e um botão de login.
2. **Abaixo da caixa de mensagem** — `● DeepSeek Harness` ou `● Uncle Sam`, clique para alternar.
3. **A lista de modelos** — quatro modelos `(web)` ao lado dos da API.

### Removê-lo

Configurações → Plugins → Uncle Sam → Desinstalar. Nada é gravado fora do perfil de navegador em que você entrou.

---

## O interruptor API / web

**O seletor de modelo é o interruptor.** Não há um segundo controle, porque um segundo controle que também
escolhesse o modelo seriam duas fontes de verdade para uma única decisão.

| Escolha este modelo | Rota | DeepThink | Busca |
|---|---|---|---|
| `DeepSeek Chat (web)` | navegador | desligado | desligado |
| `DeepSeek Chat + Search (web)` | navegador | desligado | **ligado** |
| `DeepSeek Reasoner (web)` | navegador | **ligado** | desligado |
| `DeepSeek Reasoner + Search (web)` | navegador | **ligado** | **ligado** |
| qualquer modelo sem `(web)` | a API | — | — |

Um selo **WEB** ou **API** aparece ao lado do nome do modelo para a rota ativa ficar visível de relance. Quando o
nome não é reconhecido, o selo não mostra nada em vez de adivinhar — um selo errado seria pior que nenhum.

Sua escolha permanece entre reinícios. **DeepThink** é a passada de raciocínio; **Busca** permite ler a web ao
vivo.

### A busca aparece na conversa

Com um modelo de busca, um turno produz **dois blocos** — a consulta usada, as fontes encontradas e então a
resposta que se serviu delas:

```
Busca na web — "Qual é uma manchete de tecnologia de hoje?"
Fontes (4): yna.co.kr · fnnews.com · rthk.hk · sina.com.cn
Links: https://k.sina.com.cn/article_... http://www.21jingji.com/article_...
```

A página não expõe a consulta que digitou internamente, então a consulta citada é a mensagem que disparou a
busca. As fontes e os links são lidos da página quando a resposta se assenta. Como as fontes só existem no fim,
**turnos com busca acumulam em vez de transmitir em fluxo**; turnos comuns continuam transmitindo token a token.

---

## Por que um navegador, e não a API HTTP deles

A rota óbvia — chamar a API própria do `chat.deepseek.com` — foi tentada e abandonada. O site faz cada mensagem
passar por dois portões:

| Portão | O que significa |
|---|---|
| `/api/v0/chat/create_pow_challenge` | um desafio de **prova de trabalho** por mensagem |
| `challenges.cloudflare.com/turnstile` | uma barreira anti-bot na origem |

Reimplementar qualquer um dos dois é jogo perdido: são ofuscados, mudam, e quando mudam a falha parece
exatamente uma falha de rede. **A página já resolve os dois para as próprias requisições.**

Então o adaptador nunca fala HTTP com o site. Ele conduz a página, e a página faz o resto. Autenticação, prova de
trabalho e Turnstile deixam de ser problema nosso e não podem quebrar independentemente do próprio site.

**Verificado:** um `HEAD` simples para o site devolve `403`; a rota do navegador devolve respostas.

---

## Limites, ditos com honestidade

**O uso de ferramentas é emulado.** Um chat web não tem canal estruturado de ferramentas: elas são descritas no
prompt, e uma chamada é recuperada analisando um objeto JSON na resposta. Funciona — verificado —, mas é mais
frágil que a chamada nativa: um modelo que ignora a instrução responde em prosa e o harness não vê ferramenta
naquele turno. **Para trabalho agêntico pesado, a rota API é mais confiável.** A rota web é melhor para conversa,
respostas longas, subagentes, compactação e qualquer turno em que o modelo precise ser o modelo web.

**Depende de um site que você não controla.** Quando a página muda de forma, o plugin tem que mudar junto. É o
aviso de desenvolvimento ativo no topo desta página, não uma formalidade.

**Não é afiliado ao DeepSeek.** Não é endossado nem apoiado por eles, e não dá a você nenhum direito sobre o
serviço deles. Seu uso desse serviço é regido pelos termos deles.

---

## Configuração

O `cordis.patch.yml` define:

| chave | padrão | significado |
|---|---|---|
| `port` | `9222` | a porta de depuração do navegador |
| `defaultModel` | `deepseek-chat-search` | usado quando a chamada não nomeia um modelo |
| `showBrowser` | `true` | se a janela é visível enquanto trabalha |

O navegador precisa ter uma sessão aberta no `chat.deepseek.com`. A primeira chamada abre o Brave no perfil
**Default** se a porta ainda não estiver aberta. Se o Brave já estiver rodando *sem* porta de depuração, o
adaptador não consegue se conectar e diz isso claramente em vez de falhar em silêncio.

---

## Arquitetura

```
index.js          o adaptador: StreamChunk do harness  ←→  motor
lib/engine.mjs    navegador + página: digitar, enviar, transmitir, assentar
lib/cdp.mjs       cliente do Chrome DevTools Protocol, sem dependências
lib/prompt.mjs    achata mensagens + ferramentas em uma mensagem; recupera chamadas da resposta
lib/savings.mjs   o que a rota web economizou, precificado contra a API
lib/i18n.mjs      51 idiomas para o painel
```

**Sem dependências.** O Node 24 traz `WebSocket` e `fetch` globais, que é tudo de que o CDP precisa: o fluxo de
tokens nunca sai do processo host e não há salto de IPC por delta.

---

## Apoio

O Uncle Sam existe para você parar de pagar por token. Se ele economizou seu dinheiro e você gostaria de ver o
próximo construído em hardware que não fica sem memória no meio do caminho:

**[☕ revolut.me/operatingtag](https://revolut.me/operatingtag)**

Uma estrela no repositório ou um relato de bug útil vale o mesmo.

---

## Licença

**CC BY-NC-ND 4.0** — Creative Commons Atribuição-NãoComercial-SemDerivações 4.0 Internacional.
Copyright (c) 2026 Darren T. Weldon, publicado sob o nome Operating Tag.

**O acordo inteiro em uma linha: instale e use, pessoalmente, de graça. Não altere, não compartilhe, não venda e
não use numa empresa.**

Isso não é software livre, e não finge ser.

```
você pode      instalá-lo e executá-lo · usá-lo pessoalmente, sem fins comerciais
               ler o código-fonte para entendê-lo

você não pode  modificá-lo, adaptá-lo ou criar uma obra derivada
               copiá-lo, distribuí-lo, publicá-lo, espelhá-lo ou
               disponibilizá-lo a qualquer pessoa
               enviá-lo a qualquer hospedagem de código, registro, site,
               fórum ou chat
               vendê-lo, revendê-lo, alugá-lo ou cobrar por ele ou pelo acesso a ele
               incluí-lo em qualquer coisa que você entregue a outra pessoa
               usá-lo para qualquer fim comercial ou no exercício de uma atividade empresarial
```

**As duas únicas fontes legítimas são este repositório e o pacote npm
[`@operatingtag/dsh-unclesam`](https://www.npmjs.com/package/@operatingtag/dsh-unclesam).** Uma cópia vinda de
qualquer outro lugar não é licenciada, seja quem for que a forneceu. Se você vir este software à venda, não é o
autor que está vendendo.

**O uso comercial, e o direito de modificar e distribuir, estão disponíveis sob uma licença escrita separada.**
Pergunte ao Operating Tag e você terá uma resposta clara e um preço claro.

O arquivo [LICENSE](LICENSE) é o que vale, e ele abre com o mesmo resumo em inglês simples.

---

O Uncle Sam é um plugin independente. Não afiliado ao DeepSeek, nem endossado nem apoiado por ele.

```
@operatingtag/dsh-unclesam   v1.3.5
Autor     Operating Tag
Licença   CC BY-NC-ND 4.0 — livre para usar, não para alterar, compartilhar ou vender
```
