dsh-Go: chạy DeepSeek Harness trên Android
Tóm tắt nhanh dsh-Go là client Android không chính thức do cộng đồng phát triển cho DeepSeek Harness (DSH). Nó không chạy mô hình — nó chạy harness. Bạn có thể chạy engine DSH ngay trong điện thoại (môi trường Ubuntu + Node.js tích hợp), hoặc kết nối qua SSH / DSH Remote tới DSH trên máy tính, máy chủ. Suy luận luôn đi tới nhà cung cấp API mà bạn cấu hình. Phiên bản đã kiểm tra: v1.1.0 (phát hành 2026-11-15). Bài viết dựa trên tài liệu chính thức, README và trang Releases; không test bên trong dsh-Go, mọi chi tiết giao diện đều ghi nguồn. Ngày đối chiếu: 2026-11-17.
Nghe "biến điện thoại thành máy chủ AI lập trình", phản xạ đầu tiên là lo về sức mạnh tính toán. Đó là lo sai chỗ. dsh-Go không bao giờ tải trọng số mô hình về máy. Thứ nó đưa lên di động là điểm vào và khâu phê duyệt — phần cần con người, không cần GPU. Hiểu điểm này rồi thì phần còn lại khá dễ.
1. dsh-Go là gì và phân biệt các project trùng tên
Tìm "dshgo" sẽ ra nhiều repo trùng tên. Cài nhầm là lỗi hay gặp nhất:
| Repo | Là gì |
|---|---|
| ccch1mneyyy/dsh-go | Client Android nói trong bài này |
| just-a-FA-for-name/DSHgo | Một project điện thoại khác, tích hợp Tailscale + plugin dsh phía PC |
| @xiazhi88/dshgo | Plugin DSH, mở web UI cục bộ ra mạng LAN |
| JopenChen/dsh-go | Bản hiện thực Agent thuần Go, in-process, cho backend — không liên quan di động |
Repo trong bài là ccch1mneyyy/dsh-go, giấy phép AGPL-3.0 (sdk/ và examples/ là MIT). README nói rõ: cộng đồng, không chính thức, không liên kết với DeepSeek.
| Thông số | Giá trị (đối chiếu 2026-11-17) |
|---|---|
| Phiên bản | v1.1.0, phát hành 2026-11-15 |
| Nền tảng | Android 8.0 (API 26) trở lên; iOS đang phát triển, chưa có bản cài công khai |
| Gói cài | dsh-go-1.1.0-arm64.apk, 221 MB; bản này không có 32-bit ARM, không có x86_64 |
| Dung lượng cục bộ | ~1 GB; bỏ qua nếu chỉ kết nối host từ xa |
| Phân phối | Sideload APK, không phải cấu hình Google Play |

Ngoài ra còn nhiều fork dùng lại tên và mô tả giống hệt. Chỉ tải từ trang Releases của repo gốc hoặc trang tải chính thức.
2. Vì sao điện thoại chạy được DeepSeek Harness
DeepSeek Harness (lệnh dsh) là framework agent mã nguồn mở của DeepSeek — MIT, TypeScript, đánh dấu "xem trước kỹ thuật" (có thể thay đổi phá vỡ tương thích). Tư tưởng cốt lõi: "Agent = Model + Harness" — không tối ưu mô hình, mà tổ chức phiên, công cụ, quyền và vòng lặp agent thành các plugin thay thế được, và độc lập với mô hình.
Điện thoại chạy chính cái engine harness đó, không chạy mô hình. Engine phê duyệt lệnh gọi công cụ, đọc/ghi workspace, nói chuyện với API — không cần tính toán cục bộ. Nhờ DSH tách được front-end khỏi back-end, chỉ phụ thuộc Node.js và độc lập mô hình, nó mới nhét vừa vào điện thoại. Cái giá: DSH đang ở bản xem trước nên client phải chạy theo. Ghi chú v1.1.0 nói thẳng: giọng nói, thanh nổi, chế độ Không làm phiền và nâng cấp proot chỉ được kiểm bằng test tự động và build, chưa chạy đầy đủ trên máy thật.
Khác biệt duy nhất giữa hai chế độ là engine chạy trên thiết bị nào. Hội thoại, workspace và plugin đều thuộc về host của chúng.
| Tiêu chí | Chế độ cục bộ | Chế độ từ xa |
|---|---|---|
| Vị trí engine | Ubuntu + Node.js tích hợp trong máy | DSH trên máy tính/máy chủ |
| Điều kiện | ~1 GB, không cần root, không cần Termux | Đã cài DSH ở xa, mở SSH hoặc cài plugin remote |
| Thao tác trên | Thư mục làm việc trên điện thoại | Repo và công cụ build ở xa |
| Điều khiển điện thoại | Có (engine cục bộ, chỉ chế độ thường) | Không |
| Phù hợp | Văn bản nhẹ, script nhỏ, tự động hóa điện thoại | Tiếp quản tác vụ dài, dò lỗi code trên máy |
Cách chọn: có máy tính/máy chủ bật thường trực thì dùng từ xa (project cũng khuyên dùng từ xa khi bộ nhớ điện thoại eo hẹp); chỉ cài môi trường cục bộ khi muốn làm việc nhẹ hoàn toàn trên điện thoại. Hai điều dễ hiểu nhầm: chạy cục bộ không phải chạy mô hình offline — cả hai chế độ đều gửi suy luận tới nhà cung cấp bạn cấu hình và tính phí ở đó; cấu hình đi theo host — kênh, workspace và plugin nằm trên host đang kết nối, nên phải kiểm lại sau khi đổi host.
Hai cách kết nối từ xa:
- SSH — host cần có DSH (
npm i -g @deepseek-ai/dsh) và mở SSH. Thêm ở Cài đặt › Host từ xa; chế độ "khởi động quản lý" dùng lệnhdsh web; lần đầu đối chiếu vân tay. - DSH Remote — không cần cấu hình mạng, mã hóa đầu-cuối, hợp cho máy khác mạng. Cài plugin remote trên host và đăng nhập; đăng nhập cùng tài khoản trên điện thoại. Đây là project mã nguồn mở riêng, ds-harness-remote (
github.com/liguobao/ds-harness-remote), tương thích giao thức với dsh-Go. Qua DSH Remote chỉ gửi được ảnh; web view trong app, DS Bot và xuất log không dùng được, plugin chỉ bật/tắt.
3. Cài đặt và kiểm tra hash
- Tải APK arm64 từ Releases hoặc trang tải chính thức, cho phép nguồn cài khi được hỏi.
- Kiểm tra hash. SHA-256 công bố cho
dsh-go-1.1.0-arm64.apklàec7d9ffbfb6cf3d5d8b0c19cd34a5933df00b9290cfe9d6dbdc05337308b3037, khớp với fileSHA256SUMStrong bản phát hành. Trên PC, so bằngGet-FileHashcủa PowerShell. Hash đổi theo mỗi phiên bản — dùng giá trị trên trang vào ngày bạn tải. - Lần đầu mở, chọn cài cục bộ hoặc host từ xa. "Tự khởi động khi mở" và "tự vào chế độ an toàn" bật sẵn.
- APK khác chữ ký không ghi đè được bản đang cài — phải gỡ trước, việc này xóa hội thoại, môi trường Linux và cài đặt.
Khả năng sống nền không đáng tin: chính sách tiết kiệm pin sẽ kết thúc tiến trình nền, nên vào "Chạy nền" tắt tối ưu pin — và dù vậy hệ thống vẫn có thể kết thúc nó.
4. Kết nối mô hình: chính thức hay cổng tổng hợp
Khi engine đã ở trên một host, việc đầu tiên là cấu hình kênh mô hình. Tách rõ bốn thứ: giao thức, Base URL, API Key, model ID. Tên provider chỉ là nhãn; bốn thứ kia quyết định request được gửi thế nào.
Trực tiếp chính thức DeepSeek. Tạo key tại nền tảng mở DeepSeek (platform.deepseek.com). Ở Cài đặt › Mô hình, thẻ DeepSeek chính thức nhận key trực tiếp — không cần Base URL. Danh sách mô hình bám theo danh sách DeepSeek công bố (làm mới nền khoảng mỗi mười phút); tài liệu nêu tên ví dụ deepseek-flash và deepseek-v4-pro, nhưng hãy theo danh sách tài khoản bạn thấy.
Cổng tổng hợp, ví dụ Crazyrouter. Hữu ích khi muốn một endpoint và một key dùng cho mô hình của nhiều nhà cung cấp.
- Mở trang đăng ký Crazyrouter, hoặc đăng nhập nếu đã có tài khoản;
- vào quản lý token tạo key, đặt tên theo từng thiết bị; key đầy đủ chỉ hiện một lần — sau khi sao chép đừng dán vào ảnh chụp hay chat;
- kiểm tra hạn dùng, hạn mức và giới hạn mô hình — tạo được key chưa chắc còn số dư;
- sao chép model ID từ model square. Ví dụ dùng
deepseek-v4.1-flashvàqwen3.8-flash, là tên riêng của nền tảng này, khác với tên mô hình chính thức của DeepSeek — đừng trộn lẫn.

Thêm kênh trong dsh-Go (Cài đặt › Mô hình › Thêm kênh): chọn giao thức OpenAI cho endpoint tương thích OpenAI — đây là định dạng giao tiếp, không phải giới hạn chỉ dùng mô hình OpenAI; điền Base URL và API Key; Base URL dừng ở /v1 — đừng nối thêm /chat/completions — ở đây là https://api.crazyrouter.com/v1; bấm Lấy mô hình rồi chọn, hoặc Thêm thủ công và gõ nguyên văn model ID; lưu với ít nhất một mô hình.


Chi tiết dễ vướng: kênh thuộc host hiện tại và không đi theo khi đổi host; Provider ID là vĩnh viễn (request, phiên đã lưu, mô hình mặc định và tham chiếu thông tin xác thực đều dùng nó) — muốn đổi tên thì tạo mới rồi xóa cũ; một provider một giao thức; từ v1.0.16 kênh tùy chỉnh hỗ trợ header tùy chỉnh (cũng dùng để dò mô hình); reset môi trường runtime sẽ xóa kênh tùy chỉnh, chỉ key DeepSeek đã lưu được khôi phục.
5. Xác minh 3 lớp và bảng lỗi
"Đã lưu" không phải "dùng được". Kiểm theo ba lớp, đừng để một nút thay cho tất cả:
- Đọc danh sách mô hình — Lấy mô hình, hoặc Kiểm tra kết nối. Hướng dẫn ghi rõ Kiểm tra kết nối là "dùng key đã lưu để đọc danh sách mô hình, không tốn token". Nó chỉ chứng minh địa chỉ và key khớp nhau.
- Một câu trả lời ngắn — chọn mô hình, gửi một dòng, xác nhận request cơ bản thông.
- Một tác vụ nhỏ có công cụ — bảo nó liệt kê các file sẽ đọc, trích việc cần làm, rồi mới quyết định ghi. Chỉ bước này mới kiểm được streaming, lệnh gọi công cụ và chuỗi phê duyệt.

Khi lỗi, hãy gọi endpoint trực tiếp từ terminal trước — để tách lỗi kênh với lỗi client. Đoạn dưới là dạng chung tương thích OpenAI; luồng này chưa được test trong dsh-Go, nên lần đầu hãy xác minh với hạn mức nhỏ, và để key trong biến môi trường, đừng viết lên dòng lệnh (PowerShell: $env:CRAZYROUTER_API_KEY):
curl -s https://api.crazyrouter.com/v1/models \
-H "Authorization: Bearer $CRAZYROUTER_API_KEY"
Tra lỗi nhanh (từ phần khắc phục của tài liệu "Cấu hình mô hình" chính thức và hướng dẫn dsh-Go):
| Hiện tượng | Kiểm tra trước |
|---|---|
| Lấy mô hình trả 401 | Key có đầy đủ, có thuộc Base URL hiện tại; dò mô hình gọi GET /models |
| Báo sai định dạng hoặc danh sách rỗng | Định dạng ngoài phạm vi dò; thêm model ID thủ công, kết quả như nhau |
UNKNOWN_MODEL |
Chọn mô hình đã cấu hình, hoặc bổ sung mô hình còn thiếu |
MISSING_CREDENTIAL |
Lưu key qua trang mô hình, hoặc cung cấp biến môi trường được tham chiếu |
| Key và địa chỉ đều đúng nhưng mọi request đều bị từ chối | Hình dạng request của gateway khác OpenAI: đặt compat.supportsDeveloperRole: false và compat.maxTokensField: max_tokens trong cordis.patch.yml của host |
App chat được nhưng headless báo MISSING_CREDENTIAL |
dsh --profile headless không dùng key app đã lưu; cấu hình riêng qua biến môi trường hoặc .env |

Về chi phí: agent chạy vòng lặp nhiều bước và đưa kết quả công cụ trở lại ngữ cảnh nhiều lần, nên một tác vụ thường tốn token hơn chat thường. Dùng key riêng cho từng thiết bị kèm hạn mức, thử nhỏ trước, rồi đối chiếu với bảng điều khiển nhà cung cấp.
6. 8 rủi ro bảo mật cần cân nhắc trước
Nguyên văn README: công cụ gây ảnh hưởng thật, cơ chế xác nhận và chặn không đảm bảo loại bỏ mọi rủi ro — giữ mặc định, chỉ cấp quyền cần thiết. Theo tình huống:
- Tải về — chỉ từ nguồn chính thức và kiểm hash; sideload không có kiểm duyệt cửa hàng.
- Key — mỗi thiết bị một key kèm hạn mức, không đưa vào chat, issue hay ảnh chụp; gói chẩn đoán có cố xóa key nhưng vẫn tự kiểm trước khi chia sẻ; nghi lộ thì thu hồi trước, rồi xem lượng dùng.
- Dữ liệu đi đâu — chạy cục bộ không phải offline; prompt và nội dung file đều gửi tới nhà cung cấp, và qua bên tổng hợp khi dùng cổng.
- Điều khiển điện thoại — chữ trên màn hình có thể gửi cho mô hình, ảnh chụp cho mô hình nhìn ảnh (số thẻ, CMND được che trước); mật khẩu, mã OTP, thanh toán mặc định trả lại cho bạn — đừng "gỡ giới hạn" trên thiết bị chứa dữ liệu thanh toán; tắt màn hình thì dừng, ba phút không thao tác thì kết thúc; Android Shell cần cấp quyền riêng và xác nhận từng lệnh.
- Tối thiểu quyền, chống prompt injection — AI có thể bị lệnh độc trong trang web, tin nhắn, file dẫn dắt; từ xa dùng tài khoản hạn chế, không root; phê duyệt bước rủi ro cao; đừng chạy tác vụ không thể hoàn tác mà không giám sát.
- Plugin — nhãn rủi ro của chợ "không đảm bảo an toàn"; script cài chạy trên host mục tiêu, nên xem kỹ danh sách gói rồi mới cho phép; lần đầu plugin đọc ô nhập, clipboard hay một câu trả lời sẽ hỏi bạn, cấp rồi không thu hồi riêng được.
- Dữ liệu báo cáo — thống kê ẩn danh bật mặc định (phiên bản, dòng máy, các con số đếm, tổng token từ 1.0.17; không gồm tài khoản, key, hội thoại, địa chỉ host, mô hình dùng), tắt ở Quyền riêng tư & chia sẻ; Google ML Kit của điều khiển điện thoại có thống kê SDK riêng; "tự phân tích sự cố" tắt mặc định.
- Kết nối và chia sẻ — đối chiếu vân tay lần đầu kết nối SSH / DSH Remote; thông tin xác thực chỉ ở bộ nhớ an toàn của điện thoại; đọc chương "triển khai công khai" chính thức trước khi mở dịch vụ web; link chia sẻ mã hóa đầu-cuối nhưng ai có link đầy đủ đều đọc được; reset và gỡ cài xóa dữ liệu cục bộ không hoàn tác được.


7. Tính năng, plugin và phù hợp với ai
v1.1.0 có chuyển mô hình và mức độ suy nghĩ, gửi ảnh, nhập giọng nói, phê duyệt công cụ, chen lời và xếp hàng tin nhắn; chế độ web phản chiếu một hội thoại; link phát lại mã hóa đầu-cuối; điều khiển điện thoại; mới ở v1.1.0 là gọi thoại; ngoài ra có pet, tavern, tác vụ định kỳ, terminal và workspace.
Plugin đến từ chợ tích hợp chia ba mục: Chính thức, Tương thích DSH Go, Tất cả. Các danh sách tuyển chọn của cộng đồng (như awesome-dsh-plugin, github.com/bruc3van/awesome-dsh-plugin) hay nhắc dsh-web-ui / DSH-better-sidebar (giao diện), dsh-at-file (@file), modlens (thị giác), dsh-websearch (tìm kiếm), dsh-layered-memory (bộ nhớ), dsh-api-dashboard (lượng dùng) và dsh-plugin-gate (quét script, quyền, key, callback mạng trước khi cài). Giao diện gốc của plugin cần cầu nối dsh-go trên host — engine cục bộ có sẵn, host từ xa thường không — nên xem nhãn "Tương thích DSH Go".

Phù hợp với: lập trình viên đã dùng DSH, muốn phê duyệt và tiếp quản tác vụ khi rời bàn làm việc; người có máy bật thường trực qua SSH hoặc DSH Remote; người mới sẵn sàng bắt đầu bằng tác vụ chỉ-đọc, thư mục nhỏ.
Nên khoan: ai dùng thiết bị chứa dữ liệu thanh toán/ngân hàng (nhất là đừng gỡ giới hạn điều khiển điện thoại); ai muốn chạy tác vụ không hoàn tác mà không giám sát; ai trông chờ mô hình chạy offline cục bộ; người chỉ có iOS.
Hạn chế cần nhớ: không chính thức và phụ thuộc bản xem trước DSH nên hành vi có thể đổi giữa các phiên bản; một số tính năng mới chỉ qua test tự động và build; DSH Remote bị giới hạn tính năng; sống nền không đảm bảo; mã nguồn AGPL-3.0, còn tên, logo và linh vật nằm ngoài giấy phép mã nguồn mở, bản fork phải ghi công repo gốc và tác giả. Bài này chưa test trong dsh-Go; giao diện và luồng theo tài liệu chính thức và hướng dẫn project, phần mô tả plugin bên thứ ba lấy từ danh sách cộng đồng, chưa kiểm từng cái.
Giá trị của dsh-Go không phải "mô hình lớn trong túi". Nó đưa điểm vào và khâu phê duyệt của DeepSeek Harness lên điện thoại — đổi kiến trúc tách lớp và mô hình plugin của DSH lấy sự linh hoạt di động, và chấp nhận sự thay đổi phiên bản cùng bề mặt quyền của một framework xem trước. Thứ tự an toàn để bắt đầu: kiểm APK → khởi đầu bằng chế độ từ xa hoặc tác vụ chỉ-đọc → mỗi thiết bị một key kèm hạn mức → vượt qua kiểm tra ba lớp → rồi mới thêm plugin và nhiều quyền hơn.
Nguồn tham khảo
Đối chiếu 2026-11-17. Phiên bản, hash, model ID và nội dung trang có thể thay đổi; hãy dựa vào trang chính thức vào đúng ngày đó.
- Repo dsh-Go, README, Releases, SECURITY.md:
github.com/ccch1mneyyy/dsh-go - Hướng dẫn dsh-Go (cùng repo,
docs/guide/): mô hình và kênh, engine và host từ xa, điều khiển điện thoại, plugin, khắc phục lỗi - Repo DeepSeek Harness
github.com/deepseek-ai/deepseek-harness; tài liệu "Cấu hình mô hình" chính thứcdeepseek-harness.github.io/deepseek-harness/guide/providers - DSH Remote:
github.com/liguobao/ds-harness-remote - Danh sách tuyển chọn awesome-dsh-plugin:
github.com/bruc3van/awesome-dsh-plugin - Trang Crazyrouter:
crazyrouter.com; mục đăng ký, token và model square đối chiếu tháng 11/20
All rights reserved