[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.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) · **Български** · [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

**Доставчик за DeepSeek Harness, който отговаря чрез вашия собствен браузър, на уеб акаунта, който вече имате, вместо чрез платения API.**

**Плъгинът за DeepSeek Harness, който управлява chat.deepseek.com в истински браузър — безплатната алтернатива на API на DeepSeek. Чат, DeepThink и търсене в мрежата върху вашия акаунт: без API ключ и без плащане на токен.**

**☕ [Купи ми кафе](https://revolut.me/operatingtag)** — пише го един човек, нощем, без финансиране. Друг модел на приходи няма. Една звезда или полезен доклад за грешка струват също толкова.

> **Този продукт се развива активно. Очаквайте грешки.**
>
> Работи, бърз е и се използва ежедневно от седмици — но се променя непрекъснато, а пътят през браузъра зависи от
> сайт, който се променя без предупреждение. Ако нещо се счупи, снимка на екрана и номер на версията струват повече
> от описание. Закрепете версия, ако разчитате на него.

```
доставчик    deepseek-web
модели       deepseek-chat · deepseek-chat-search · deepseek-reasoner · deepseek-reasoner-search
цена         нищо на токен — използва абонамента, който вече е отворен в браузъра ви
състояние    в разработка — очаквайте грешки
измерено     първи токен ~1,9 с · допълнително ~0,6 с · цял кръг ~2,5 с
```

Отговорите от уеб пътя са подписани с **🔴 Uncle Sam**. Това име е шега, не твърдение: то отбелязва кой път е
отговорил, а отговорите от API нямат никакъв подпис. Винаги знаете кой ви е отговорил.

---

## Какво ви спестява

API таксува на токен. Уеб продуктът не. Тази приставка регистрира `deepseek-web` като доставчик на модели и отговаря
на всяко извикване, като управлява `chat.deepseek.com` в истински браузър — страницата върши работата, браузърът
държи сесията и нищо не се измерва.

| | Път през API | Уеб път |
|---|---|---|
| Цена | на токен, завинаги | нищо над абонамента |
| Скорост | бързо | ~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 / уеб

**Изборът на модел е превключвателят.** Няма втори контрол, защото втори контрол, който също избира модел, би бил два
източника на истина за едно решение.

| Изберете този модел | Път | DeepThink | Търсене |
|---|---|---|---|
| `DeepSeek Chat (web)` | браузър | изкл | изкл |
| `DeepSeek Chat + Search (web)` | браузър | изкл | **вкл** |
| `DeepSeek Reasoner (web)` | браузър | **вкл** | изкл |
| `DeepSeek Reasoner + Search (web)` | браузър | **вкл** | **вкл** |
| всеки модел без `(web)` | API | — | — |

До името на модела се показва значка **WEB** или **API**, за да се вижда активният път с един поглед. Когато името не
се разпознае, значката не показва нищо, вместо да гадае — грешна значка е по-лоша от никаква.

Изборът ви се запазва между рестартиранията. **DeepThink** е проходът на разсъждение; **Търсене** му позволява да
чете живата мрежа.

### Търсенето се вижда в разговора

С модел за търсене един кръг произвежда **два блока** — заявката, с която е търсил, намерените източници и след това
отговорът, който ги е използвал:

```
Търсене в мрежата — „Кое е днешното технологично заглавие?“
Източници (4): yna.co.kr · fnnews.com · rthk.hk · sina.com.cn
Връзки: https://k.sina.com.cn/article_... http://www.21jingji.com/article_...
```

Страницата не разкрива заявката, която е въвела вътрешно, така че цитираната заявка е съобщението, което е
задействало търсенето. Източниците и връзките се четат от страницата, когато отговорът се установи. Понеже
източниците съществуват само накрая, **кръговете с търсене се натрупват вместо да се предават потоково**; обикновените
кръгове продължават да се предават токен по токен.

---

## Защо браузър, а не техния HTTP API

Очевидният път — извикване на собствения API на `chat.deepseek.com` — беше изпробван и изоставен. Сайтът принуждава
всяко съобщение да мине през две порти:

| Порта | Какво означава |
|---|---|
| `/api/v0/chat/create_pow_challenge` | **доказателство за работа** на всяко съобщение |
| `challenges.cloudflare.com/turnstile` | порта срещу ботове при източника |

Повторното реализиране на която и да е от тях е загубена игра: те са затъмнени, променят се и когато се променят,
отказът изглежда точно като мрежов отказ. **Страницата вече решава и двете за собствените си заявки.**

Затова адаптерът никога не говори HTTP със сайта. Той управлява страницата, а останалото прави страницата.
Удостоверяването, доказателството за работа и Turnstile престават да бъдат наш проблем и не могат да се повредят
независимо от самия сайт.

**Проверено:** обикновен `HEAD` към сайта връща `403`; пътят през браузъра връща отговори.

---

## Граници, казани честно

**Извикването на инструменти е емулирано.** Уеб чатът няма структуриран канал за инструменти: инструментите се
описват в подканата, а извикването се възстановява чрез извличане на JSON обект от отговора. Работи — проверено — но е
по-слабо от вграденото извикване: модел, който пренебрегне инструкцията, отговаря в проза и harness не вижда никакво
използване на инструмент в този кръг. **За тежка агентска работа пътят през API е по-надежден.** Уеб пътят е найдобър
за разговор, дълги отговори, подизпълнители, компресия и всеки кръг, в който моделът трябва да е уеб моделът.

**Зависи от сайт, който не контролирате.** Когато страницата смени формата си, приставката трябва да се промени с нея.
Това е предупреждението за разработка в началото на страницата, не формалност.

**Не е свързан с 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   какво ви спести уеб пътят, оценено спрямо API
lib/i18n.mjs      51 езика за панела
```

**Никакви зависимости.** Node 24 има глобални `WebSocket` и `fetch`, което е всичко, от което CDP се нуждае, така че
потокът от токени никога не напуска процеса домакин и няма скок през IPC за всяка делта.

---

## Подкрепа

Uncle Sam съществува, за да спрете да плащате на токен. Ако ви е спестил пари и бихте искали следващият да бъде
изграден на хардуер, на който паметта не свършва по средата:

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

Звезда в хранилището или полезен доклад за грешка струват също толкова.

---

## Лиценз

**CC BY-NC-ND 4.0** — Creative Commons Признание-Некомерсиално-Без производни 4.0 International.
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.3.5
Автор     Operating Tag
Лиценз    CC BY-NC-ND 4.0 — свободно за използване, не за промяна, споделяне или продажба
```
