[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) · [Български](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** · [Filipino](README.tl.md) · [اردو](README.ur.md)

# Uncle Sam

**Mtoa huduma wa DeepSeek Harness anayejibu kupitia kivinjari chako mwenyewe, kwenye akaunti ya wavuti uliyo nayo tayari, badala ya API inayotoza malipo.**

**Programu-jalizi ya DeepSeek Harness inayoendesha chat.deepseek.com kwenye kivinjari halisi — mbadala wa bure kwa API ya DeepSeek. Gumzo, DeepThink na utafutaji wa wavuti kwenye akaunti yako: bila API key na bila kulipa kwa tokeni.**

**☕ [Ninunulie kahawa](https://revolut.me/operatingtag)** — imeandikwa na mtu mmoja, usiku, bila ufadhili. Hakuna mfumo mwingine wa mapato. Nyota moja au ripoti ya hitilafu yenye manufaa ina thamani sawa.

> **Bidhaa hii iko katika maendeleo hai. Tarajia hitilafu.**
>
> Inafanya kazi, ni haraka, na imetumika kila siku kwa wiki kadhaa — lakini inabadilika kila wakati, na njia ya kivinjari
> inategemea tovuti inayobadilika bila taarifa. Ikiwa kitu kitavunjika, picha ya skrini na nambari ya toleo zina
> thamani zaidi kuliko maelezo. Bandika toleo ikiwa unategemea hii.

```
mtoa huduma   deepseek-web
modeli         deepseek-chat · deepseek-chat-search · deepseek-reasoner · deepseek-reasoner-search
gharama        sifuri kwa kila tokeni — hutumia usajili uliofunguliwa tayari kwenye kivinjari chako
hali           katika maendeleo — tarajia hitilafu
ilipimwa       tokeni ya kwanza ~1.9 s · ziada ~0.6 s · mzunguko kamili ~2.5 s
```

Majibu ya njia ya wavuti yanasainiwa na **🔴 Uncle Sam**. Jina hilo ni mzaha, si dai: linaonyesha njia ipi ilijibu, na
majibu ya API hayana saini yoyote. Unajua kila wakati ni nani aliyekujibu.

---

## Inaokoa nini

API hutoza kwa kila tokeni. Bidhaa ya wavuti haitoi. Programu-jalizi hii inasajili `deepseek-web` kama mtoa huduma wa
modeli na inajibu kila simu kwa kuendesha `chat.deepseek.com` kwenye kivinjari halisi — ukurasa hufanya kazi,
kivinjari kinashikilia kipindi, na hakuna kinachopimwa.

| | Njia ya API | Njia ya wavuti |
|---|---|---|
| Gharama | kwa kila tokeni, milele | hakuna zaidi ya usajili |
| Kasi | haraka | ~2.5 s kwa mzunguko, imepimwa |
| Simu ya zana | asili na ya kuaminika | imeigwa, inafanya kazi lakini dhaifu zaidi |
| Inategemea | API | tovuti inayobadilika bila taarifa |

**Njia zote mbili zinabaki zimewekwa.** Kichaguzi cha modeli ni swichi: tumia njia nafuu kwa chaguo-msingi, na tumia API
wakati kazi inahitaji zana za kuaminika.

---

## Usakinishaji

Uncle Sam ni **programu-jalizi ya DeepSeek Harness**. Nje ya harness haifanyi chochote, kwa sababu inasajili mtoa
huduma wa modeli, njia kwenye mwenyeji na sehemu mbili kwenye kiolesura.

**Mahitaji**

| | |
|---|---|
| DeepSeek Harness | toleo jipya lolote lenye msimamizi wa programu-jalizi |
| Kivinjari | Brave inapendekezwa; Edge hutumika kiotomatiki ikiwa Brave haipo |
| Node | 22 au mpya zaidi |

**Kutoka npm**

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

**Kutoka hazina hii**

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

Kisha ongeza mstari wa kifurushi kwenye wasifu wako ili harness iipakie:

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

**Au kutoka folda:** Mipangilio → Programu-jalizi → sakinisha kutoka njia ya ndani, elekeza folda iliyo na
`package.json`.

### Uendeshaji wa kwanza

Bofya **Ingia / fungua gumzo**. Kivinjari kinafunguka na **kinabaki kionekana** hadi uingie kwenye chat.deepseek.com.
Baada ya hapo kinapungua chenyewe na hautakiona tena. Kipindi kinaishi katika wasifu wa kivinjari chako, kwa hivyo
**programu-jalizi haihifadhi nenosiri lolote** — hakuna cha kuvuja.

Kisha unapaswa kuona:

1. **Mipangilio → Uncle Sam** — ukurasa wenye mistari ya hali na kitufe cha kuingia.
2. **Chini ya kisanduku cha ujumbe** — `● DeepSeek Harness` au `● Uncle Sam`, bofya kubadilisha.
3. **Orodha ya modeli** — modeli nne za `(web)` kando ya modeli za API.

### Kuiondoa

Mipangilio → Programu-jalizi → Uncle Sam → Ondoa usakinishaji. Hakuna kinachoandikwa nje ya wasifu wa kivinjari
ulichoingia nacho.

---

## Swichi ya API / wavuti

**Kichaguzi cha modeli ni swichi.** Hakuna kitufe cha pili, kwa sababu kitufe cha pili ambacho pia kingechagua modeli
kingekuwa vyanzo viwili vya ukweli kwa uamuzi mmoja.

| Chagua modeli hii | Njia | DeepThink | Utafutaji |
|---|---|---|---|
| `DeepSeek Chat (web)` | kivinjari | imezimwa | imezimwa |
| `DeepSeek Chat + Search (web)` | kivinjari | imezimwa | **imewashwa** |
| `DeepSeek Reasoner (web)` | kivinjari | **imewashwa** | imezimwa |
| `DeepSeek Reasoner + Search (web)` | kivinjari | **imewashwa** | **imewashwa** |
| modeli yoyote isiyo na `(web)` | API | — | — |

Beji ya **WEB** au **API** inaonekana kando ya jina la modeli ili njia inayotumika ione kwa mtazamo mmoja. Jina
lisipotambulika, beji haionyeshi chochote badala ya kukisia — beji isiyo sahihi ni mbaya zaidi kuliko kutokuwa na beji.

Chaguo lako linabaki kati ya kuanzisha upya. **DeepThink** ni hatua ya kufikiri; **Utafutaji** huiwezesha kusoma wavuti
hai.

### Utafutaji unaonekana kwenye mazungumzo

Na modeli ya utafutaji, mzunguko mmoja hutoa **vizuizi viwili** — swali alilotumia kutafuta, vyanzo vilivyopatikana na
kisha jibu lililotumia hivyo:

```
Utafutaji wa wavuti — "Kichwa kimoja cha habari za teknolojia leo ni kipi?"
Vyanzo (4): yna.co.kr · fnnews.com · rthk.hk · sina.com.cn
Viungo: https://k.sina.com.cn/article_... http://www.21jingji.com/article_...
```

Ukurasa haufichui swali lililoandikwa ndani, kwa hivyo swali lililonukuliwa ni ujumbe ulioanzisha utafutaji. Vyanzo na
viungo husomwa kutoka ukurasa baada ya jibu kutulia. Kwa kuwa vyanzo vipo mwishoni tu, **mizunguko yenye utafutaji
hukusanywa badala ya kutiririshwa**; mizunguko ya kawaida bado hutiririka tokeni kwa tokeni.

---

## Kwa nini kivinjari na si HTTP API yao

Njia dhahiri — kuita API yao wenyewe ya `chat.deepseek.com` — ilijaribiwa na kuachwa. Tovuti inalazimisha kila ujumbe
kupita malango mawili:

| Lango | Maana |
|---|---|
| `/api/v0/chat/create_pow_challenge` | **uthibitisho wa kazi** kwa kila ujumbe |
| `challenges.cloudflare.com/turnstile` | lango la roboti kwenye chanzo |

Kujenga upya lolote kati ya haya ni mchezo uliopotea: yamefichwa, yanabadilika, na yanapobadilika kushindwa kunaonekana
sawa kabisa na hitilafu ya mtandao. **Ukurasa unatatua yote mawili kwa maombi yake mwenyewe.**

Kwa hivyo adapta haizungumzi HTTP na tovuti kamwe. Inaendesha ukurasa, na ukurasa hufanya mengine. Uthibitishaji,
uthibitisho wa kazi na Turnstile huacha kuwa tatizo letu na haziwezi kuvunjika kwa kujitegemea na tovuti yenyewe.

**Imethibitishwa:** `HEAD` rahisi kwa tovuti hurudisha `403`; njia ya kivinjari hurudisha majibu.

---

## Mipaka, iliyotajwa kwa uaminifu

**Simu ya zana imeigwa.** Gumzo la wavuti halina chaneli ya zana iliyoundwa: zana zinaelezwa kwenye ombi na simu
inapatikana kwa kutoa kitu cha JSON kutoka kwenye jibu. Inafanya kazi — imethibitishwa — lakini ni dhaifu kuliko simu ya
asili: modeli inayopuuza maagizo hujibu kwa nathari na harness haioni matumizi yoyote ya zana kwenye mzunguko huo. **Kwa
kazi nzito za wakala, njia ya API ni ya kuaminika zaidi.** Njia ya wavuti ni bora kwa mazungumzo, majibu marefu, wakala
wadogo, ukandamizaji na kila mzunguko ambapo modeli lazima iwe modeli ya wavuti.

**Inategemea tovuti usiyoikontrola.** Ukurasa unapobadilisha umbo, programu-jalizi lazima ibadilike nayo. Hiyo ni tahadhari
ya maendeleo juu ya ukurasa huu, si utaratibu.

**Haijahusishwa na DeepSeek.** Haijaidhinishwa wala kuungwa mkono nao, na haikupi haki yoyote kwa huduma yao. Matumizi
yako ya huduma hiyo yanasimamiwa na masharti yao.

---

## Usanidi

`cordis.patch.yml` huweka:

| ufunguo | chaguo-msingi | maana |
|---|---|---|
| `port` | `9222` | bandari ya utatuzi wa kivinjari |
| `defaultModel` | `deepseek-chat-search` | hutumika wakati simu haitaji modeli |
| `showBrowser` | `true` | ikiwa dirisha linaonekana wakati wa kufanya kazi |

Kivinjari lazima kiwe na kipindi kilichoingia kwenye `chat.deepseek.com`. Simu ya kwanza huanzisha Brave na wasifu
**Default** ikiwa bandari haijafunguliwa. Ikiwa Brave inaendesha tayari *bila* bandari ya utatuzi, adapta haiwezi
kuunganisha na inasema hivyo waziwazi badala ya kushindwa kimya.

---

## Muundo

```
index.js          adapta: StreamChunk ya harness  ←→  injini
lib/engine.mjs    kivinjari + ukurasa: andika, tuma, tiririsha, acha itulie
lib/cdp.mjs       mteja wa Chrome DevTools Protocol, bila vitegemezi
lib/prompt.mjs    hunyoosha ujumbe + zana kuwa ujumbe mmoja; hutoa simu kutoka jibu
lib/savings.mjs   kile njia ya wavuti ilichookoa, kikipimwa dhidi ya API
lib/i18n.mjs      lugha 51 kwa paneli
```

**Hakuna vitegemezi.** Node 24 ina `WebSocket` na `fetch` za kimataifa, ambayo ni yote CDP inahitaji, kwa hivyo mtiririko
wa tokeni hauachi kamwe mchakato wa mwenyeji na hakuna kuruka kwa IPC kwa kila delta.

---

## Msaada

Uncle Sam ipo ili uache kulipa kwa kila tokeni. Ikiwa ilikuokoa pesa na ungependa kuona inayofuata ikijengwa kwenye
vifaa visivyoishiwa kumbukumbu katikati ya njia:

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

Nyota kwenye hazina au ripoti ya hitilafu yenye manufaa ina thamani sawa.

---

## Leseni

**CC BY-NC-ND 4.0** — Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International.
Copyright (c) 2026 Darren T. Weldon, imechapishwa chini ya jina Operating Tag.

**Makubaliano yote kwa mstari mmoja: sakinisha na utumie kibinafsi, bila malipo. Usibadilishe, usishiriki, usiuze na
usitumie katika kampuni.**

Hii si chanzo huria, na haijifanyi kuwa hivyo.

```
unaweza       kusakinisha na kuiendesha · kuitumia kibinafsi, isiyo ya kibiashara
              kusoma msimbo chanzo ili kuielewa

hauwezi       kuibadilisha, kuirekebisha au kuunda kazi inayotokana nayo
              kuinakili, kuisambaza, kuichapisha, kuioanisha au
              kuifanya ipatikane kwa mtu mwingine yeyote
              kuipakia kwenye mwenyeji wowote wa msimbo, rejista, tovuti, jukwaa au gumzo
              kuiuza, kuiuza tena, kuikodisha au kutoza pesa kwa ajili yake au kwa ufikiaji wake
              kuiweka ndani ya kitu chochote unachompa mtu mwingine
              kuitumia kwa madhumuni yoyote ya kibiashara au katika biashara
```

**Vyanzo viwili halali tu ni hazina hii na kifurushi cha npm
[`@operatingtag/dsh-unclesam`](https://www.npmjs.com/package/@operatingtag/dsh-unclesam).** Nakala kutoka mahali
popote pengine haijapewa leseni, yeyote aliyekupa. Ukiiona programu hii ikizuwa, si mwandishi anaiuza.

**Matumizi ya kibiashara, pamoja na haki ya kubadilisha na kusambaza, yanapatikana chini ya leseni tofauti ya maandishi.**
Muulize Operating Tag — utapata jibu wazi na bei wazi.

Faili [LICENSE](LICENSE) ndiyo inayotumika, na inaanza na muhtasari huo huo kwa Kiingereza rahisi.

---

Uncle Sam ni programu-jalizi huru. Haijahusishwa na DeepSeek, haijaidhinishwa wala kuungwa mkono nao.

```
@operatingtag/dsh-unclesam   v1.3.5
Mwandishi  Operating Tag
Leseni     CC BY-NC-ND 4.0 — huru kutumika, si kubadilisha, kushiriki au kuuza
```