@operatingtag/dsh-unclesam 1.1.0 → 1.3.0

package/README.ka.md

@@ -0,0 +1,263 @@
+[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.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-ს რეალურ ბრაუზერში მართავს — DeepSeek API-ის უფასო ალტერნატივა. ჩატი, 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; Brave-ის არარსებობისას ავტომატურად გამოიყენება Edge |
+| 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
+
+თვალსაჩინო გზა — `chat.deepseek.com`-ის საკუთარი API-ის გამოძახება — გამოიცადა და მიტოვდა. საიტი ყოველ
+შეტყობინებას ორ კარიბჭეში ატარებს:
+
+| კარიბჭე | რას ნიშნავს |
+|---|---|
+| `/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          ადაპტერი: harness StreamChunk  ←→  ძრავა
+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 Attribution-NonCommercial-NoDerivatives 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.0
+ავტორი     Operating Tag
+ლიცენზია   CC BY-NC-ND 4.0 — თავისუფალი გამოსაყენებლად, არა შესაცვლელად, გასაზიარებლად ან გასაყიდად
+```

package/README.kk.md

@@ -0,0 +1,264 @@
+[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.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 орнына өз браузеріңіз арқылы, сізде бұрыннан бар веб-аккаунтпен жауап береді.**
+
+**chat.deepseek.com-ты нақты браузерде басқаратын DeepSeek Harness плагині — DeepSeek API үшін тегін балама. Өз аккаунтыңызда чат, 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 ұсынылады; Brave болмаса Edge автоматты қолданылады |
+| 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. **Модельдер тізімі** — API модельдерінің қасында төрт `(web)` моделі.
+
+### Жою
+
+Параметрлер → Плагиндер → 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-ы емес
+
+Көзге түсетін жол — `chat.deepseek.com`-ның өз API-ын шақыру — сыналып, тасталды. Сайт әр хабарды екі қақпадан
+өткізеді:
+
+| Қақпа | Мағынасы |
+|---|---|
+| `/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          адаптер: harness StreamChunk  ←→  қозғалтқыш
+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 Attribution-NonCommercial-NoDerivatives 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.0
+Авторы     Operating Tag
+Лицензия   CC BY-NC-ND 4.0 — пайдалануға тегін, өзгертуге, бөлісуге немесе сатуға емес
+```