DeepSeek Harness trên Windows: Không cần ứng dụng desktop, không vấn đề gì — Cách chính thức để chạy

There is no official DeepSeek Harness desktop app for Windows, and you do not need one. DeepSeek Harness (dsh) — the open-source agent runtime DeepSeek released under an MIT license on 2026-08-13 — is a Node.js tool that runs a local web server you open in your browser, with a headless CLI for the terminal as the alternative. On Windows the whole setup is two commands: install Node.js 22.19 or newer (Node 24 LTS is the safer pick), then run npx @deepseek-ai/dsh web and open http://127.0.0.1:3080. Every "DeepSeek Harness Desktop" repository on GitHub is an unofficial community wrapper around that same two-command setup — useful to some people, but not required. It is also the harness DeepSeek uses to produce the agentic coding results it reports for DeepSeek V4 Pro and DeepSeek V4 Flash, which is why the two models keep showing up in any conversation about it.

Nếu bạn tìm kiếm "deepseek harness windows", có lẽ bạn đang nhìn chằm chằm vào một trang chứa các kho wrapper và phân vân không biết nên cài cái nào. Bài viết này giải đáp câu hỏi thực sự đằng sau tìm kiếm đó: DeepSeek Harness thực chất là gì, cách chính thức để chạy nó trên Windows hiện nay, các lựa chọn thay thế trên terminal, và những lưu ý trung thực khi chạy một công cụ ở giai đoạn xem trước. Đây là bài hướng dẫn, không phải bài giới thiệu ra mắt — phần ra mắt và chuỗi rò rỉ được đề cập trong các bài viết riêng.

DeepSeek Harness là gì (và không phải là gì)

DeepSeek Harness không phải là một mô hình, và nó không dùng để benchmark một mô hình nào. Nó là runtime tác tử: lớp kết nối mô hình với công cụ, tệp tin, shell, và internet — đọc mã của bạn, lập kế hoạch thay đổi, chạy lệnh, và lặp lại cho đến khi hoàn thành tác vụ. Kiến trúc được nêu rõ trong khẩu hiệu: "Mọi thứ là một Plugin." Các mô hình, công cụ, kỹ năng, phiên làm việc, sandbox, vòng lặp tác tử, và thậm chí giao diện web đều là các plugin được tổ hợp lúc khởi động, được xây dựng trên meta-framework Cordis — cùng một kernel đứng sau hệ sinh thái chatbot Koishi. Một bản triển khai mặc định cung cấp hơn 150 plugin.

Đây cũng rõ ràng là một bản xem trước. dsh đang ở phiên bản 0.1.0-rc.6, README gọi đây là bản xem trước dành cho nhà phát triển, và cảnh báo bằng chữ in hoa rằng "SẼ CÓ NHỮNG THAY ĐỔI PHÁ VỠ TÍNH TƯƠNG THÍCH." Điều đó không hề làm chậm tốc độ áp dụng: dự án đã đạt khoảng 50.000 sao GitHub chỉ trong 12 giờ đầu tiên khi ra mắt công khai vào ngày 2026-08-13, và đạt khoảng 126.000 sao tính đến ngày 2026-08-16 — bản phát hành mã nguồn mở nhanh nhất mà DeepSeek từng tung ra.

Câu trả lời ngắn gọn: cách chính thức trên Windows là hai lệnh

README chính thức của DeepSeek đưa ra đường dẫn chạy trên Windows trong một dòng: cài đặt Node.js, sau đó chạy npx @deepseek-ai/dsh web. Cụ thể, các bước là:

• Cài đặt Node.js 22.19+ hoặc Node 24. Bản phát hành dsh hiện tại yêu cầu Node 22.19 hoặc mới hơn; Node 24 LTS là lựa chọn an toàn hơn trên Windows, và lý do thì đơn giản — các phiên bản Node mới hơn bao gồm giải nén zstd gốc, mà dsh sử dụng để đọc các tệp nhật ký phiên đã nén. Kiểm tra cài đặt của bạn bằng node --version trong PowerShell hoặc cmd.

• Run the harness. Either run it on the spot with npx @deepseek-ai/dsh web, or install it once with npm install -g @deepseek-ai/dsh and then run dsh web from any folder afterwards. The first run prints the URL and starts the Web UI at http://127.0.0.1:3080.

• Mở địa chỉ đó trong trình duyệt của bạn. Web UI là một ứng dụng web cục bộ — đây là lý do không có ứng dụng desktop; trình duyệt chính là ứng dụng desktop.

• Thêm khóa mô hình một lần. Trong giao diện web, mở Cài đặt → Mô hình, dán khóa API DeepSeek và lưu lại. Có hiệu lực ngay lập tức, không cần khởi động lại máy chủ. dsh sử dụng thư mục nơi bạn đã khởi động nó làm vị trí hệ thống tệp mặc định, và ở giao diện, bước Chọn không gian làm việc cho phép bạn trỏ nó tới bất kỳ thư mục dự án nào.

Đó là toàn bộ quy trình chính thức. Nếu máy đã cài Node 22+ sẵn, thời gian từ "chưa có gì" đến "agent đang chạy" chưa đầy một phút.

Tại sao mọi repo "DeepSeek Harness Desktop" đều là một lớp bao bọc?

Kết quả trang 1 cho truy vấn này đều là các trình bao bọc desktop của cộng đồng — các shell Electron, Tauri và WebView2 gói một runtime Node và khởi chạy giao diện Web chính thức bên trong một cửa sổ có khung. Chúng không phải là sản phẩm của DeepSeek, và chúng không thêm khả năng harness; chúng chỉ thêm một trình khởi chạy. Điểm chung của chúng:

Chúng khởi chạy bằng cú nhấp đúp và hoàn toàn không cần dùng đến dòng lệnh, đó chính là điểm bán thực sự của chúng.

• Chúng không có chữ ký số, vì vậy Windows SmartScreen sẽ cảnh báo khi cài đặt — "More info → Run anyway" là một phần của quy trình.

• Họ bám theo dự án chính thức ở các tốc độ khác nhau: một số cố định ở 0.1.0-rc.5, một số ở 0.1.0-rc.6, một số theo nhánh master, vì vậy phiên bản wrapper và harness dần lệch nhau theo thời gian.

• Chúng lưu trữ cùng dữ liệu cục bộ mà dsh luôn sử dụng trong ~/.dsh, vì vậy việc chuyển đổi giữa wrapper và CLI chính thức sẽ không làm mất các phiên của bạn.

Khi nào một wrapper đáng giá? Khi yếu tố quyết định là "nhấp đúp vào biểu tượng, thấy khay hệ thống, không bao giờ chạm vào terminal", và bạn chấp nhận rằng bên thứ ba giờ đây là lớp cập nhật và bảo mật đứng trước một công cụ đang trong giai đoạn preview. Khi nào thì không? Con đường chính thức là hai lệnh và một tab trình duyệt — nếu bạn đã có Node, một wrapper mang lại cho bạn một trình khởi chạy mà bạn có thể không cần, và đổi lại, nó tự thêm một mảng bảo trì riêng.

Đường dẫn terminal: plugin CLI headless và TUI.

Nếu trình duyệt không phải là nơi bạn làm việc, dsh cũng có câu chuyện về terminal, được chia thành hai chế độ.

Headless là cấu hình không tương tác: dsh --profile headless "summarize this repository" chạy một tác vụ mà không có giao diện, in kết quả rồi thoát — chế độ thân thiện với CI. Trên Windows, đây cũng là chế độ mà các tập lệnh và tác vụ theo lịch trình nên sử dụng, vì nó không cần màn hình hay phiên đăng nhập.

TUI là một cổng giao diện dòng lệnh tương tác theo phong cách Claude Code, được phát hành dưới dạng các gói plugin cộng đồng thay vì nằm trong gói lõi. Các gói như dsh-tui được cài vào một profile bằng lệnh dsh plugin --profile tui add <package> và chạy bằng dsh --profile tui; có ít nhất một gói kèm theo trình khởi chạy .cmd cho Windows. Điều cần biết trước khi thử: một TUI yêu cầu một terminal thực sự cho cả đầu vào và đầu ra — nếu hệ thống của bạn dùng đường ống (pipe) hoặc chuyển hướng (redirect), dsh sẽ từ chối và bảo bạn dùng chế độ headless thay vào đó.

Bốn cài đặt sẵn: cái nào dành cho việc gì?

dsh cung cấp bốn preset agent tích hợp sẵn, và chúng không phải là một bậc thang độ khó — chúng là bốn bề mặt công cụ khác nhau. Bạn đặt giá trị mặc định trong ~/.dsh/settings.yaml tại agent-presets.default.

• Standard là chế độ mặc định: tác nhân toàn diện hàng ngày — chỉnh sửa tệp, shell, tìm kiếm tệp và web, kỹ năng, tác nhân phụ, lập kế hoạch. Đây là lựa chọn mà hầu hết người dùng Windows nên bắt đầu.

• PTC (còn được gọi là Code mode) giữ lại mọi thứ mà Standard có nhưng thay đổi cách các công cụ được hiển thị: thay vì một chuỗi dài các lệnh gọi công cụ riêng lẻ, mô hình viết một chương trình TypeScript để kết hợp các thao tác nhiều bước — vòng lặp, bộ lọc, nhánh điều kiện. Dành cho các quy trình làm việc phức tạp, lặp lại hoặc nhiều bước.

• Minimalcó chủ đích tước bỏ tác nhân chỉ còn hai công cụ — một shell thường trực và một trình soạn thảo tệp — nhằm phục vụ đánh giá và benchmarking, không dành cho công việc hàng ngày. Đây là preset mà các chỉ số agentic của chính DeepSeek chạy trên đó.

• Creation (Cordis) dành cho việc xây dựng các preset tùy chỉnh: bao gồm kiểm tra runtime, thử nghiệm plugin trong bộ nhớ và hướng dẫn tạo preset. Dành cho việc mày mò với chính harness.

MCP và phát lại quỹ đạo: tại sao điều này đáng để chạy

Hai tính năng chứng minh việc nên dùng dsh thay vì một trình chat đơn thuần. Thứ nhất, một máy khách Giao thức Ngữ cảnh Mô hình (MCP) được tích hợp sẵn — lệnh /mcp và tab Cài đặt MCP kết nối các máy chủ MCP bên ngoài vào bộ khung, nhờ đó các công cụ mà các tác nhân khác của bạn sử dụng cũng cắm vào được dsh. Thứ hai, mọi phiên chạy đều được ghi vào nhật ký phiên chỉ nối thêm, và chế độ xem Trajectory cho phép bạn kiểm tra một phiên chạy theo nguồn, tiếp tục nó, rẽ nhánh nó, tìm kiếm nó và phát lại nó. Đó chính là khác biệt giữa việc gỡ lỗi một tác nhân bằng cách nhìn vào câu trả lời cuối cùng và việc xem từng bước hiểu vì sao nó thực hiện mỗi lần gọi.

Khi con đường chính thức là câu trả lời sai

• Bạn cần một cú nhấp chuột, không cần terminal. Không có trình cài đặt chính thức. Nếu thao tác nhấp đúp là bắt buộc, bạn đang dựa vào các trình bao bọc cộng đồng — vốn không được ký số, vì vậy hãy cân nhắc sự tiện lợi so với bề mặt bảo trì của bên thứ ba.

• Máy tính Windows của bạn đã cũ hoặc bị khóa chặt. dsh cần Node 22.19+ (hoặc Node 24). Trên một máy tính được quản lý, điều đó có nghĩa là cần cài đặt runtime và có thể cần sự chấp thuận mà bạn không có.

• Đây là bản xem trước, và nó sẽ bị lỗi. 0.1.0-rc.6 đi kèm với cảnh báo rằng các thay đổi phá vỡ tương thích sắp tới; giữa các bản rc, plugin và profile có thể ngừng hoạt động. Hãy khóa phiên bản của bạn cho bất kỳ thứ gì chạy bằng script.

• Chi phí mô hình là do bạn chịu. dsh miễn phí; mỗi tác vụ đốt token trên bất kỳ key nào bạn đã cấu hình. Vòng lặp agent đọc lại tệp và thử lại, và một mô hình verbose trên một tác vụ khó có thể tiêu tốn một ngân sách đáng kinh ngạc trong một buổi chiều. Đây là lúc lựa chọn mô hình, chứ không phải lựa chọn harness, chi phối chi phí.

• Gói đăng ký trọn gói có thể vượt trội hơn định tuyến theo từng token. Nếu bạn nằm trong gói của một phòng lab dưới hạn mức của nó, gói đăng ký trọn gói thường rẻ hơn bất kỳ con đường định tuyến theo từng token nào. Định tuyến sẽ chiến thắng khi bạn kết hợp nhiều mô hình hoặc muốn dự phòng — không phải theo mặc định.

Định tuyến mô hình phía sau harness

Phương thức gốc là API riêng của DeepSeek: dán khóa vào Settings → Models và chạy thôi. Nhưng dsh cũng chấp nhận base URL tương thích OpenAI — đặt DEEPSEEK_BASE_URL trong biến môi trường hoặc cấu hình nhà cung cấp LLM trong settings.yaml — nghĩa là mô hình đằng sau bộ khung có thể hoán đổi mà không cần đụng tới bộ khung. Bạn có thể chạy DeepSeek V4 Pro cho các lần refactor khó và DeepSeek V4 Flash cho các chỉnh sửa cơ học rẻ, trên cùng một bản cài đặt dsh cục bộ.

Đó là tầng mà OrcaRouter chiếm giữ. Một base URL tương thích OpenAI, hơn 200 mô hình, không chênh lệch giá — giá niêm yết của nhà cung cấp được chuyển thẳng — và tự động chuyển đổi dự phòng khi nhà cung cấp giới hạn tốc độ hoặc suy giảm hiệu năng. Trỏ dsh vào nó và harness vẫn nằm trên máy của bạn trong khi danh mục mô hình trở thành một quyết định định tuyến thay vì một vụ mua sắm. Hai lưu ý thẳng thắn: chúng tôi không lưu trữ dsh — nó chạy cục bộ trên máy Windows của bạn, và chúng tôi chỉ là lớp truy cập mô hình nếu bạn muốn các mô hình vượt ngoài API của chính DeepSeek. Và đối với một mô hình nặng duy nhất trong giới hạn của gói, gói đăng ký cố định thường là lựa chọn rẻ hơn bất kể router nào.

Phiên bản ngắn

DeepSeek Harness trên Windows là thiết lập chỉ với hai lệnh, không phải cài đặt kiểu cửa hàng ứng dụng: Node 22.19+ (hoặc Node 24), sau đó chạy `npx @deepseek-ai/dsh web`, rồi mở trình duyệt tại http://127.0.0.1:3080. Các kho lưu trữ "desktop" trên GitHub là trình bao bọc không chính thức quanh cùng một máy chủ cục bộ đó. Với terminal, chế độ headless chạy các tác vụ một lần cho CI, còn các plugin TUI cung cấp giao diện kiểu Claude Code. Bốn chế độ cài sẵn — Standard, PTC, Minimal, Creation — giúp chọn bề mặt công cụ, và MCP cùng tính năng phát lại quỹ đạo khiến nó thực sự hữu ích. Nó miễn phí, mã nguồn mở và đang ở giai đoạn xem trước: hãy ghim phiên bản, theo dõi chi phí mô hình và định tuyến mô hình tách biệt khỏi harness.