@operatingtag/dsh-unclesam 1.0.0 → 1.0.1

package/README.vi.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** · [Bahasa Indonesia](README.id.md)
+
+# Uncle Sam
+
+**Một nhà cung cấp cho DeepSeek Harness, trả lời qua chính trình duyệt của bạn — trên tài khoản web bạn đã có — thay vì API tính tiền.**
+
+**☕ [Mời tôi một ly cà phê](https://revolut.me/operatingtag)** — viết bởi một người, về đêm, không có tài trợ. Không có nguồn thu nào khác. Một ngôi sao hay một báo lỗi hữu ích cũng quý như vậy.
+
+> **Sản phẩm này đang được phát triển liên tục. Hãy chờ đợi lỗi.**
+>
+> Nó chạy được, nó nhanh, và nó đã được dùng hằng ngày suốt nhiều tuần — nhưng nó luôn thay đổi, và đường đi
+> qua trình duyệt phụ thuộc vào một trang web thay đổi không báo trước. Nếu có gì hỏng, một ảnh chụp màn hình và
+> số phiên bản có giá trị hơn một đoạn mô tả. Hãy ghim một phiên bản nếu bạn phụ thuộc vào nó.
+
+```
+nhà cung cấp  deepseek-web
+mô hình       deepseek-chat · deepseek-chat-search · deepseek-reasoner · deepseek-reasoner-search
+chi phí       không đồng nào mỗi token — dùng gói đăng ký đã mở sẵn trong trình duyệt của bạn
+trạng thái    đang phát triển — hãy chờ đợi lỗi
+đo được       token đầu ~1,9 giây · chi phí phụ ~0,6 giây · một lượt hoàn chỉnh ~2,5 giây
+```
+
+Câu trả lời từ đường web được ký **🔴 Uncle Sam**. Cái tên đó là một câu đùa, không phải một tuyên bố: nó đánh
+dấu đường nào đã trả lời, còn câu trả lời của API không hề có chữ ký. Bạn luôn biết ai đã trả lời mình.
+
+---
+
+## Nó tiết kiệm cho bạn điều gì
+
+API tính tiền theo token. Sản phẩm web thì không. Plugin này đăng ký `deepseek-web` làm nhà cung cấp mô hình và
+trả lời mọi lệnh gọi bằng cách điều khiển `chat.deepseek.com` trong một trình duyệt thật — trang làm việc, trình
+duyệt giữ phiên, và không có gì bị tính tiền.
+
+| | Đường API | Đường web |
+|---|---|---|
+| Chi phí | theo token, mãi mãi | không gì ngoài gói đăng ký |
+| Tốc độ | nhanh | ~2,5 giây mỗi lượt, đã đo |
+| Gọi công cụ | gốc và đáng tin | mô phỏng, chạy được nhưng yếu hơn |
+| Phụ thuộc vào | API | một trang web thay đổi không báo trước |
+
+**Cả hai đường đều được cài sẵn.** Bộ chọn mô hình chính là công tắc: mặc định dùng đường rẻ, và chuyển sang API
+khi công việc cần công cụ đáng tin.
+
+---
+
+## Cài đặt
+
+Uncle Sam là một **plugin của DeepSeek Harness**. Ngoài harness nó không làm gì, vì nó đăng ký một nhà cung cấp mô
+hình, một tuyến trên host và hai chỗ trong giao diện.
+
+**Yêu cầu**
+
+| | |
+|---|---|
+| DeepSeek Harness | bản dựng gần đây có trình quản lý plugin |
+| Trình duyệt | khuyến nghị Brave; Edge được dùng tự động nếu không có Brave |
+| Node | 22 trở lên |
+
+**Từ npm**
+
+```bash
+pnpm add @operatingtag/dsh-unclesam
+```
+
+**Từ kho này**
+
+```bash
+git clone https://github.com/operatingtag/dsh-unclesam
+cd dsh-unclesam
+pnpm install
+```
+
+Rồi thêm dòng gói vào hồ sơ của bạn để harness nạp nó:
+
+```yaml
+# cordis.patch.yml
+- insert:
+    - id: dsh-unclesam
+      name: '@operatingtag/dsh-unclesam'
+      config:
+        port: 9222
+        defaultModel: deepseek-chat-search
+        autoMinimise: true
+```
+
+**Hoặc từ một thư mục:** Cài đặt → Plugin → cài từ đường dẫn cục bộ, trỏ tới thư mục có `package.json`.
+
+### Lần chạy đầu tiên
+
+Bấm **Đăng nhập / mở trò chuyện**. Trình duyệt mở ra và **vẫn hiện** cho tới khi bạn đăng nhập xong trên
+chat.deepseek.com. Sau đó nó tự thu nhỏ và bạn sẽ không thấy nó nữa. Phiên nằm trong hồ sơ trình duyệt, nên
+**plugin không lưu mật khẩu nào** — không có gì để lộ.
+
+Sau đó bạn sẽ thấy:
+
+1. **Cài đặt → Uncle Sam** — một trang có các dòng trạng thái và một nút đăng nhập.
+2. **Dưới ô nhập** — `● DeepSeek Harness` hoặc `● Uncle Sam`, bấm để chuyển.
+3. **Danh sách mô hình** — bốn mô hình `(web)` bên cạnh các mô hình API.
+
+### Gỡ bỏ
+
+Cài đặt → Plugin → Uncle Sam → Gỡ cài đặt. Không ghi gì ra ngoài hồ sơ trình duyệt mà bạn đã đăng nhập.
+
+---
+
+## Công tắc API / web
+
+**Bộ chọn mô hình chính là công tắc.** Không có điều khiển thứ hai, vì một điều khiển thứ hai mà cũng chọn mô hình
+thì sẽ là hai nguồn sự thật cho một quyết định.
+
+| Chọn mô hình này | Đường | DeepThink | Tìm kiếm |
+|---|---|---|---|
+| `DeepSeek Chat (web)` | trình duyệt | tắt | tắt |
+| `DeepSeek Chat + Search (web)` | trình duyệt | tắt | **bật** |
+| `DeepSeek Reasoner (web)` | trình duyệt | **bật** | tắt |
+| `DeepSeek Reasoner + Search (web)` | trình duyệt | **bật** | **bật** |
+| mọi mô hình không có `(web)` | API | — | — |
+
+Cạnh tên mô hình có huy hiệu **WEB** hoặc **API**, để đường đang dùng thấy được ngay. Khi không nhận ra tên,
+huy hiệu không hiện gì thay vì đoán — huy hiệu sai còn tệ hơn không có.
+
+Lựa chọn của bạn được giữ qua các lần khởi động lại. **DeepThink** là lượt suy luận; **Tìm kiếm** cho phép nó đọc
+web trực tiếp.
+
+### Tìm kiếm hiện ra trong cuộc trò chuyện
+
+Với một mô hình tìm kiếm, một lượt tạo ra **hai khối** — câu truy vấn nó đã dùng, các nguồn tìm được, rồi câu
+trả lời đã dùng chúng:
+
+```
+Tìm kiếm web — "Hôm nay có tiêu đề công nghệ nào?"
+Nguồn (4): yna.co.kr · fnnews.com · rthk.hk · sina.com.cn
+Liên kết: https://k.sina.com.cn/article_... http://www.21jingji.com/article_...
+```
+
+Trang không để lộ truy vấn nó đã gõ bên trong, nên truy vấn được trích dẫn chính là tin nhắn đã kích hoạt việc tìm
+kiếm. Nguồn và liên kết được đọc từ trang sau khi câu trả lời đã ổn định. Vì các nguồn chỉ tồn tại ở cuối, **lượt
+có tìm kiếm được gom lại thay vì phát trực tiếp**; lượt thường vẫn phát từng token.
+
+---
+
+## Vì sao là trình duyệt, chứ không phải HTTP API của họ
+
+Cách hiển nhiên — gọi API riêng của `chat.deepseek.com` — đã được thử và bị bỏ. Trang web bắt mọi tin nhắn đi qua
+hai cửa:
+
+| Cửa | Ý nghĩa |
+|---|---|
+| `/api/v0/chat/create_pow_challenge` | một **bằng chứng công việc** cho mỗi tin nhắn |
+| `challenges.cloudflare.com/turnstile` | một cổng chặn bot ở nguồn gốc |
+
+Làm lại một trong hai là một cuộc chơi thua: chúng bị làm rối mã, chúng thay đổi, và khi chúng thay đổi thì lỗi
+trông y hệt một sự cố mạng. **Trang đã tự giải quyết cả hai cho các yêu cầu của chính nó.**
+
+Nên bộ chuyển không bao giờ nói HTTP với trang web. Nó điều khiển trang, và trang làm phần còn lại. Xác thực, bằng
+chứng công việc và Turnstile không còn là vấn đề của chúng ta và không thể hỏng độc lập với chính trang web.
+
+**Đã kiểm chứng:** một `HEAD` đơn giản tới trang trả về `403`; đường trình duyệt trả về câu trả lời.
+
+---
+
+## Giới hạn, nói thẳng
+
+**Việc gọi công cụ là mô phỏng.** Một cuộc trò chuyện web không có kênh công cụ có cấu trúc: công cụ được mô tả
+trong lời nhắc, và một lệnh gọi được phục hồi bằng cách lấy ra một đối tượng JSON từ câu trả lời. Nó chạy được —
+đã kiểm chứng — nhưng yếu hơn gọi công cụ gốc: một mô hình bỏ qua chỉ dẫn sẽ trả lời bằng văn xuôi, và harness
+không thấy việc dùng công cụ nào trong lượt đó. **Với công việc tác tử nặng, đường API đáng tin hơn.** Đường web
+phù hợp nhất cho trò chuyện, câu trả lời dài, tác tử con, nén ngữ cảnh, và mọi lượt mà mô hình buộc phải là mô hình
+web.
+
+**Nó phụ thuộc vào một trang web bạn không kiểm soát.** Khi trang đổi hình dạng, plugin phải đổi theo. Đó chính là
+cảnh báo ở đầu trang này, không phải thủ tục.
+
+**Nó không liên kết với DeepSeek.** Không được họ chứng thực hay hỗ trợ, và không cho bạn quyền gì với dịch vụ của
+họ. Việc bạn dùng dịch vụ đó do điều khoản của họ quy định.
+
+---
+
+## Cấu hình
+
+`cordis.patch.yml` đặt:
+
+| khóa | mặc định | ý nghĩa |
+|---|---|---|
+| `port` | `9222` | cổng gỡ lỗi của trình duyệt |
+| `defaultModel` | `deepseek-chat-search` | dùng khi lệnh gọi không nêu mô hình |
+| `showBrowser` | `true` | cửa sổ có hiện ra trong lúc làm việc không |
+
+Trình duyệt phải có phiên `chat.deepseek.com` đã đăng nhập. Lệnh gọi đầu tiên sẽ mở Brave với hồ sơ **Default**
+nếu cổng chưa mở. Nếu Brave đang chạy *không* có cổng gỡ lỗi, bộ chuyển không thể bám vào và nói rõ điều đó thay vì
+hỏng trong im lặng.
+
+---
+
+## Cấu trúc
+
+```
+index.js          bộ chuyển: StreamChunk của harness  ←→  engine
+lib/engine.mjs    trình duyệt + trang: gõ, gửi, phát, lắng xuống
+lib/cdp.mjs       client Chrome DevTools Protocol, không phụ thuộc gì
+lib/prompt.mjs    duỗi tin nhắn + công cụ thành một tin nhắn; lấy lại lệnh gọi từ câu trả lời
+lib/savings.mjs   đường web đã tiết kiệm bao nhiêu, tính theo giá API
+lib/i18n.mjs      51 ngôn ngữ cho bảng điều khiển
+```
+
+**Không có phụ thuộc.** Node 24 có sẵn `WebSocket` và `fetch` toàn cục, CDP chỉ cần thế, nên luồng token không bao
+giờ rời khỏi tiến trình host và không có bước nhảy IPC cho mỗi delta.
+
+---
+
+## Ủng hộ
+
+Uncle Sam tồn tại để bạn thôi trả tiền theo token. Nếu nó đã tiết kiệm tiền cho bạn và bạn muốn thấy bản tiếp theo
+trên phần cứng không hết bộ nhớ giữa đường:
+
+**[☕ revolut.me/operatingtag](https://revolut.me/operatingtag)**
+
+Một ngôi sao trên kho hay một báo lỗi hữu ích cũng quý như vậy.
+
+---
+
+## Giấy phép
+
+**CC BY-NC-ND 4.0** — Creative Commons Ghi công-Phi thương mại-Không phái sinh 4.0 Quốc tế.
+Copyright (c) 2026 Darren T. Weldon, công bố dưới tên Operating Tag.
+
+**Toàn bộ thỏa thuận trong một dòng: cài đặt và dùng cho cá nhân, miễn phí. Không sửa, không chia sẻ, không bán và
+không dùng trong doanh nghiệp.**
+
+Đây không phải mã nguồn mở, và nó không giả vờ là như vậy.
+
+```
+được phép   cài đặt và chạy · dùng cho cá nhân, phi thương mại
+            đọc mã nguồn để hiểu nó
+
+không được  sửa, chuyển thể hoặc tạo ra tác phẩm phái sinh
+            sao chép, phân phối, công bố, nhân bản hoặc
+            cung cấp cho bất kỳ ai khác
+            tải lên bất kỳ nơi lưu trữ mã, sổ đăng ký, trang web, diễn đàn hay trò chuyện nào
+            bán, bán lại, cho thuê, hoặc thu tiền cho chính nó hay cho việc truy cập nó
+            đưa vào bất cứ thứ gì bạn giao cho người khác
+            dùng cho bất kỳ mục đích thương mại nào hoặc trong hoạt động kinh doanh
+```
+
+**Chỉ có hai nguồn hợp pháp: kho này và gói npm
+[`@operatingtag/dsh-unclesam`](https://www.npmjs.com/package/@operatingtag/dsh-unclesam).** Một bản sao từ bất
+kỳ nơi nào khác đều không có giấy phép, dù ai đã đưa cho bạn. Nếu bạn thấy phần mềm này được bán, người bán không
+phải tác giả.
+
+**Dùng thương mại, và quyền sửa đổi cùng phân phối, có được theo một giấy phép bằng văn bản riêng.** Hỏi Operating
+Tag — bạn sẽ nhận được câu trả lời rõ ràng và một mức giá rõ ràng.
+
+Tệp [LICENSE](LICENSE) là văn bản có hiệu lực, và nó mở đầu bằng cùng bản tóm tắt đó bằng tiếng Anh đơn giản.
+
+---
+
+Uncle Sam là một plugin độc lập. Không liên kết với DeepSeek, không được họ chứng thực hay hỗ trợ.
+
+```
+@operatingtag/dsh-unclesam   v1.0.1
+Tác giả   Operating Tag
+Giấy phép CC BY-NC-ND 4.0 — miễn phí để dùng, không được sửa, chia sẻ hay bán
+```

package/README.zh.md

@@ -0,0 +1,248 @@
+[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.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（山姆大叔）
+
+**一个 DeepSeek Harness 提供方：不用按量计费的 API，而是通过你自己的浏览器、用你已有的网页账号来回答。**
+
+**☕ [请我喝杯咖啡](https://revolut.me/operatingtag)** — 一个人、在夜里、没有任何资助地写出来。没有别的收入来源。一个星标或一份有用的缺陷报告，价值是一样的。
+
+> **这个产品仍在持续开发中。请预期有 bug。**
+>
+> 它能跑、很快，也已经每天用了好几周 —— 但它一直在变，而且浏览器这条路依赖一个会在毫无预告的情况下
+> 改动的网站。如果哪里坏了，一张截图加版本号，比一段描述有用得多。如果你要依赖它，就固定一个版本。
+
+```
+提供方    deepseek-web
+模型      deepseek-chat · deepseek-chat-search · deepseek-reasoner · deepseek-reasoner-search
+成本      每个 token 零费用 —— 用的是你浏览器里已经开着的那个订阅
+状态      开发中 —— 请预期有 bug
+实测      首个 token 约 1.9 秒 · 额外开销约 0.6 秒 · 一整轮约 2.5 秒
+```
+
+网页路线的回答会带 **🔴 Uncle Sam** 署名。这个名字是个玩笑，不是声明：它标记的是哪条路线回答的，而 API
+的回答完全没有署名。你永远知道是谁回答的。
+
+---
+
+## 它替你省下什么
+
+API 按 token 计费，网页版不计费。这个插件把 `deepseek-web` 注册成模型提供方，每次调用都在真实浏览器里
+操作 `chat.deepseek.com` 来回答 —— 页面干活，浏览器保存会话，没有任何东西被计量。
+
+| | API 路线 | 网页路线 |
+|---|---|---|
+| 成本 | 按 token，永远 | 订阅之外不再花钱 |
+| 速度 | 快 | 每轮约 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_...
+```
+
+页面不会公开它内部输入的查询，所以引用的查询就是触发搜索的那条消息。来源和链接是在回答稳定之后从页面上
+读出来的。因为来源只在最后才存在，**搜索轮会把内容攒起来一次性输出，而不是流式输出**；普通轮仍然一个
+token 一个 token 地流。
+
+---
+
+## 为什么用浏览器，而不是它们自己的 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` 会话。第一次调用时如果端口没开，它会用 **Default** 配置
+启动 Brave。如果 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 需要的就这些，所以 token 流从不离开宿主机
+进程，每个增量也没有一次 IPC 往返。
+
+---
+
+## 支持
+
+Uncle Sam 的存在就是为了让你不再按 token 付钱。如果它替你省了钱，而你也想看到下一个版本建在不会做到一半
+就内存不够的硬件上：
+
+**[☕ revolut.me/operatingtag](https://revolut.me/operatingtag)**
+
+给仓库点个星标，或者报一个有用的 bug，价值是一样的。
+
+---
+
+## 许可
+
+**CC BY-NC-ND 4.0** —— 知识共享 署名-非商业性使用-禁止演绎 4.0 国际。
+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.0.1
+作者      Operating Tag
+许可      CC BY-NC-ND 4.0 —— 可免费使用，不可修改、共享或出售
+```

package/index.js

@@ -6,7 +6,7 @@
  * @file    index.js
  * @version 3.9.11
  * @author  Operating Tag (@operatingtag)
- * @license CC-BY-NC-ND-4.0
+ * @license CC-BY-NC-ND-4.0
  *
  * WHY THIS PROVIDER EXISTS
  *     A harness can only talk to a provider it has an adapter for, and an adapter is allowed to be slow
@@ -536,8 +536,11 @@ export function apply(ctx, config = {}) {
           // The tool preamble on its own, so a person can see exactly what the page was told about tools
           // without hunting for it inside the message. A prompt without a blank line has no separate
           // preamble, so it is reported in full rather than with its last character cut off.
+          //
+          // The marker is "tools available", not the old "Tools: " - the preamble no longer names any tool,
+          // so it had to stop claiming to be a list.
           preamble:
-            prompt.text.includes('Tools: ')
+            prompt.text.includes('tools available')
               ? prompt.text.slice(0, Math.max(0, prompt.text.indexOf('\n\n')))
               : prompt.text.slice(0, 400),
         };

package/lib/prompt.mjs

@@ -106,59 +106,39 @@ export function isOnlyGreeting(text) {
 }
 
 /**
- * Describe the available tools, within a fixed budget.
+ * Describe the available tools WITHOUT NAMING THEM.
  *
- * Tools are taken in the order given, because the harness lists the most relevant first; when the budget
- * runs out the rest are named but not described, so the model still knows they exist without paying for
- * every schema. The truncation is stated in the preamble itself rather than hidden, so the model can say
- * "I could not see the details of that tool" instead of inventing an argument shape.
+ * WHY NO NAMES
+ *     Every word typed into this box is sent to a third-party website. The earlier version wrote the first
+ *     twelve tool names into that box on every turn, and this session carries 283 - so a chat turn told
+ *     chat.deepseek.com the name of every tool installed on the machine. Seen on screen by the person using
+ *     it: `demergo_brave, demergo_click, cordis_inspect_query, +282 more` sitting above their own sentence.
+ *
+ *     That is an inventory of a private machine leaving the machine. The model does not need it. It needs to
+ *     know that tools EXIST and how to call one; the exact name it must call arrives in the prompt whenever
+ *     a tool is genuinely being offered for that turn. Naming all 283 bought nothing and cost privacy.
+ *
+ * WHAT THIS GIVES UP, HONESTLY
+ *     A model can no longer browse the catalogue and pick a tool it was not told about. On a turn where the
+ *     harness attaches tools, their names still have to be sent - a model cannot call a tool it was never
+ *     told exists. This function only covers the turn where no particular tool is being offered.
  */
 export function toolPreamble(tools) {
   if (!tools?.length) return '';
-  /**
-   * Names only, and hard-capped.
-   *
-   * The first version carried a "NEVER do this" list plus a schema dump per tool. The second cut that to
-   * descriptions - which was fine for three tools and produced ONE ENORMOUS LINE for this session's thirty,
-   * because every description was still there. Recorded on screen: a paragraph of tool names and blurbs
-   * sitting above the person's own message, which is exactly the "gobbly goop" complaint.
-   *
-   * So: names only. A model does not need the description to call a tool - it needs to know the tool
-   * exists and what it is called. Arguments come from understanding, and the harness validates them.
-   */
-  const names = tools.map((t) => t.name);
+
+  const count = tools.length;
 
   /**
-   * One line, not a paraffle.
-   *
-   * The first version printed a dozen names AND a two-line call format above every single message. What
-   * the person saw in their own chat box was a wall of tool names before their own sentence - reported,
-   * correctly, as looking broken.
+   * One short clause.
    *
-   * The names have to stay: a model cannot call a tool it was never told exists. The call format has to
-   * stay too, because without it the model answers in prose instead of calling anything. What goes is the
-   * repetition - the format is one short clause on the same line, not a second block.
+   * The person's own sentence must stay visible and first in their mind; scaffolding above it reads as
+   * something having broken. So: a count, the call format, and nothing else. The call format has to stay,
+   * because without it the model answers in prose instead of emitting a call when one is asked for.
    *
-   * The full text is still visible in the panel's "last thing sent" view, which is where a person looks
-   * when something goes wrong.
+   * The full text is still shown in the panel's "last thing sent" view, which is where a person looks when
+   * something is wrong.
    */
-  const HEAD = 'Tools: ';
-  const TAIL = ' · to call one reply only with {"tool":"name","arguments":{}}';
-  const MAX_VISIBLE_NAMES = 12;
-  const budget = MAX_TOOL_PREAMBLE_CHARS - HEAD.length - TAIL.length;
-  const kept = [];
-  let used = 0;
-  for (const name of names) {
-    if (kept.length >= MAX_VISIBLE_NAMES) break;
-    const add = (kept.length ? 2 : 0) + name.length;
-    if (used + add > budget) break;
-    kept.push(name);
-    used += add;
-  }
-  const omitted = names.length - kept.length;
-  const list = kept.join(', ') + (omitted > 0 ? `, +${omitted} more` : '');
-
-  return `${HEAD}${list}${TAIL}`;
+  return `[${count} tools available · to call one reply only with {"tool":"name","arguments":{}}]`;
 }
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@operatingtag/dsh-unclesam",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "private": false,
   "type": "module",
   "description": "Uncle Sam — answers through chat.deepseek.com in a real browser tab instead of the metered API. Switch between the API and the web account from the composer; web replies are signed so you always know which route answered.",
@@ -37,7 +37,23 @@
     "install.cmd",
     "lib/savings.mjs",
     "lib/i18n.mjs",
-    "lib/prefs.mjs"
+    "lib/prefs.mjs",
+    "README.es.md",
+    "README.fr.md",
+    "README.de.md",
+    "README.pt.md",
+    "README.ja.md",
+    "README.zh.md",
+    "README.ru.md",
+    "README.it.md",
+    "README.tr.md",
+    "README.ko.md",
+    "README.pl.md",
+    "README.hi.md",
+    "README.nl.md",
+    "README.uk.md",
+    "README.vi.md",
+    "README.id.md"
   ],
   "engines": {
     "node": ">=22"