Ứng dụng DeepSeek Harness cho máy tính: Trình cài đặt thực sự đặt những gì lên máy của bạn

Ứng dụng máy tính để bàn DeepSeek Harness là một vỏ Electron bọc quanh chính giao diện web mà bạn nhận được từ npx @deepseek-ai/dsh web, và nó được phát hành dưới dạng ba bộ cài đặt riêng cho từng nền tảng dành cho một harness hiện đang ở phiên bản 0.2.1-rc.2. Mô tả đó nghe có vẻ xem nhẹ và không phải ý tôi là vậy. Bọc một giao diện đang hoạt động trong một container máy tính để bàn là công việc của một cuối tuần; bọc nó trong một container sở hữu thư mục runtime riêng, giữ các tác vụ của bạn tiếp tục chạy khi bạn đóng cửa sổ, tự cập nhật trên một kênh không có bản phát hành ổn định và bảo toàn các phiên của bạn qua từng thao tác đó mới là phần mất hàng tháng, và đó là phần đáng để đọc. Nếu bạn muốn chạy DeepSeek-V4.1-Flash thông qua một harness sống trong cửa sổ thay vì terminal, thì đây chính là bản dựng đó, và những câu hỏi thú vị đều xoay quanh việc gì xảy ra xung quanh cửa sổ.

Hai điều cần nói trước khi đi vào chi tiết. Thứ nhất, bài viết này thay thế hướng dẫn trước đây của chúng tôi rằng không có ứng dụng máy tính để bàn — hướng dẫn đó đúng vào thời điểm được viết vào tháng 8 năm 2026, và giờ đã sai. Thứ hai, đây là bản xem trước công khai, vẫn được gắn nhãn như vậy trên trang của chính DeepSeek, và bản đóng gói còn có những điểm chưa mượt mà như nhãn đó ngụ ý. Trình cài đặt hoạt động. Phần phân phối xung quanh nó mỏng hơn bạn tưởng.

Bản build desktop thực chất là gì

Ứng dụng desktop là một lớp Electron mỏng, có nhiệm vụ khởi động một tiến trình Host và trỏ một cửa sổ tới đó. Cửa sổ không tự bố trí giao diện trò chuyện riêng: nó tải entry Web đã đóng gói nằm trong ứng dụng tại dsh-app://app/, và các hộp thoại cập nhật bạn sẽ thấy đến từ một origin đóng gói thứ hai tại dsh-app://shell/. Một tiến trình Node con được khởi chạy ở chế độ RunAsNode của Electron để khởi động trình chạy profile dùng chung, và shell chuyển tiếp HTTP tới Web Host đã xác thực, loại bỏ các header transfer-encoding, connection và keep-alive trên đường đi. Các phản hồi bundle plugin được đánh dấu no-store, một chi tiết nhỏ nhưng có hệ quả rõ ràng: thay đổi một plugin và lần tải lại tiếp theo sẽ hiển thị thay đổi.

Vì URL là dsh-app:// chứ không phải localhost, nên không có cổng cố định nào cần ghi nhớ và không có xung đột cổng nào cần xử lý. Desktop Host mặc định lắng nghe trên một cổng do HĐH gán. Nếu bạn cần một cổng cụ thể, bạn có thể đặt cổng đó thông qua một webserver.config.port ghi đè, nhưng mặc định cố ý không phải là hằng số, và Host lắng nghe trên 127.0.0.1. Điều này quan trọng nếu bạn đã làm theo các hướng dẫn cũ: số 19387 từng lưu hành trong các hướng dẫn cài đặt tháng 8 không phải là cổng desktop, và coi nó là cổng đó sẽ khiến bạn đi tìm một dịch vụ không hề tồn tại.

Việc ghim phiên bản nghiêm ngặt hơn vẻ ngoài ban đầu. Electron và @deepseek-ai/dsh luôn mang chính xác cùng một phiên bản — không phải một khoảng, không phải một major tương thích — nên nâng cấp harness là một bản phát hành desktop, và không có tổ hợp được hỗ trợ nào của một dsh mới và một cửa sổ cũ. Tiến trình Electron lấy một khóa đơn thực thể tồn tại suốt vòng đời tiến trình và sở hữu độc quyền $DSH_HOME/profiles/desktop. Tính độc quyền đó là có thật: CLI không thể khởi động profile đó, và một npm được cài đặt bằng dsh không thể thay đổi nó. Điều mà hai bản cài đặt thực sự chia sẻ là trạng thái quan trọng với bạn — phiên, cài đặt, thông tin xác thực, không gian làm việc và lưu trữ, tất cả nằm dưới $DSH_HOME. Điều chúng không chia sẻ là các gói thực thi, kích hoạt plugin, tệp khóa hoặc node_modules, đó là lý do vì sao cài đặt một plugin vào profile desktop không phải là thao tác giống như cài đặt nó vào profile CLI.

Ba trình cài đặt, một kênh cập nhật, không có bản phát hành ổn định

Có ba trình cài đặt và cả ba đều phản hồi. Tệp thực thi Windows 64-bit có kích thước 289.385.456 byte và được phục vụ với HTTP 200. Ảnh đĩa Apple silicon có kích thước 264.990.950 byte, cũng 200. Ảnh đĩa Intel Mac có kích thước 289.480.824 byte, cũng 200. Cả ba đều được sửa đổi lần cuối vào ngày 17 tháng 10 năm 2026. Chỉ có hai trong số đó được liên kết từ trang tải xuống. Bản dựng Intel vẫn hoạt động, có thể truy cập được và không có liên kết nào trỏ tới nó ở bất kỳ đâu trên deepseek.com/en/harness/ — nếu bạn đang dùng Intel Mac và bạn đã làm theo trang, bạn sẽ kết luận một cách hợp lý rằng không có bản dựng nào dành cho mình.

Bản dựng Intel cũng chậm hơn một phiên bản. Nguồn cập nhật của nó liệt kê 0.2.1-rc.1; nguồn của Windows và Apple-silicon đều liệt kê 0.2.1-rc.2. Một release candidate không phải là khoảng cách lớn về tính năng, nhưng đó là tín hiệu thực sự về việc những mục tiêu nào được xây dựng trước và những mục tiêu nào được xác minh sau, và đó chính xác là loại điều bạn muốn biết trước khi giao các phiên làm việc của mình cho một nền tảng.

Chính ở các kênh cập nhật, câu chuyện phân phối trở nên mờ nhạt. Các feed được tách theo từng target, nằm dưới /dsh-desk/feeds/<target>/ trên cùng máy chủ. Windows x64 phân giải nightly.yml; cả hai target macOS đều phân giải nightly-mac.yml. Hỏi bất kỳ kênh nào trong ba kênh đó để lấy latest.yml hoặc latest-mac.yml thì bạn nhận được 404 — không có kênh ổn định, không có kênh beta, và không có cách nào từ chối kênh duy nhất đang tồn tại. Ghi chú phát hành của chính DeepSeek xác nhận cách bố trí này chứ không hề mâu thuẫn với nó: mọi bản phát hành đều công bố một feed nightly, và chỉ các bản phát hành ổn định mới công bố một feed latest trỏ đến cùng các artefact. Trong ngữ cảnh này, "Nightly" là tên kênh chứ không phải nhịp độ build — các feed Windows và Apple-silicon đều phục vụ cùng bản dựng 0.2.1-rc.2, đề ngày 17 tháng 10, với gói Windows có dấu thời gian 09:22 UTC và gói Apple-silicon 09:57 UTC. Vậy là bạn có bộ máy tự động cập nhật, cơ chế polling có jitter, backoff tới mức trần một giờ, và không có cách nào yêu cầu bất cứ thứ gì khác ngoài thứ mà kênh preview hiện đang có.

GitHub đưa ra cùng một luận điểm từ một góc nhìn khác. Kho lưu trữ deepseek-ai/deepseek-harness — 256.559 sao và 30.921 lượt fork khi được đọc vào ngày 21 tháng 10 năm 2026 — có 31 bản phát hành vào cùng ngày hôm đó, mỗi bản đều được gắn cờ là bản phát hành trước, và mỗi bản đều không có tệp nhị phân nào đính kèm. Không có mục nào trên trang Releases có thể tải xuống. Nếu bạn muốn một bản dựng, bạn lấy nó từ download.deepseek.com hoặc từ npm, nơi @deepseek-ai/dsh hiện phân giải latest thành 0.2.1-rc.2. Kho lưu trữ là nguồn thông tin chuẩn cho changelog và là ngõ cụt đối với sản phẩm đầu ra, điều này đủ bất thường để đáng nói thẳng ra, bởi vì khi nhìn thấy 31 bản phát hành, bản năng là kỳ vọng sẽ có một trình cài đặt trên một trong số đó.

Những gì trình cài đặt ghi vào, và những gì nó từ chối đụng đến

Bộ cài Windows là một gói NSIS gốc, không phải lớp bao quanh MSI, và nó hoạt động đúng như vậy. Bạn có các bảng màu sáng, tối và tự động — có thể chọn khi cài đặt bằng /THEME=light, /THEME=dark hoặc /THEME=auto — một thư mục đích có thể chỉnh sửa, và phạm vi cài đặt giới hạn ở người dùng hiện tại. Thư mục gốc của ổ đĩa bị từ chối làm đích, và một thư mục đích không rỗng chỉ được chấp nhận nếu đó đã là một bản cài đặt đã đăng ký, tức là bộ cài từ chối ghi đè lên một thư mục không liên quan. Khi cập nhật, chế độ im lặng chờ tối đa mười giây để ứng dụng đang chạy thoát ra, rồi dừng với mã thoát 2 nếu ứng dụng vẫn đang chạy. Đó là một lỗi trung thực thay vì một bản cài đặt bị hỏng, và nó sẽ hiện ra trong bất kỳ triển khai bằng script nào không thoát ứng dụng trước.

Trình gỡ cài đặt này vạch ra ranh giới mà hầu hết trình gỡ cài đặt làm sai. Nó xóa thư mục userData của Electron, thư mục sản phẩm trong %APPDATA%, và bộ nhớ đệm của trình cập nhật trong %LOCALAPPDATA%. Nó không động tới thư mục home của harness — ~/.dsh, hoặc bất cứ nơi nào DSH_HOME trỏ tới — nơi lưu giữ phiên, cài đặt, thông tin xác thực và plugin của bạn. Truyền --updated hoặc /KEEP_APP_DATA cũng giữ lại dữ liệu Electron. Vì vậy, gỡ cài đặt rồi cài đặt lại là một cách được hỗ trợ để sửa cửa sổ bị hỏng mà không mất công việc của bạn, và đó là quyết định thiết kế có chủ đích chứ không phải ngẫu nhiên.

Các runtime đi kèm đáng để biết đến vì chúng lớn và nằm ngoài thư mục ứng dụng. Python cùng numpy, pandas, python-docx, python-pptx, openpyxl, Pillow, lxml và XlsxWriter, cùng với Node và pnpm, được cài đặt dưới $DSH_HOME/dsh-runtimes/dsh-primary-runtime — thông thường ~/.dsh/... trên cả hai nền tảng — lần đầu tiên một không gian làm việc khai báo rằng nó cần chúng. Đó là lý do tại sao dung lượng đĩa chiếm dụng sau một tuần sử dụng không phải là dung lượng đĩa sau khi cài đặt, và tại sao việc gỡ cài đặt mà giữ nguyên $DSH_HOME cũng giữ nguyên vài trăm megabyte runtime.

Cài đặt được đọc một lần khi khởi động từ desktop/settings.json bên trong thư mục userData của Electron, trên Windows có nghĩa là %APPDATA%\@deepseek-ai\dsh-desktop\desktop\settings.json và trên macOS có nghĩa là ~/Library/Application Support/@deepseek-ai/dsh-desktop/desktop/settings.json. DSH_HOME không di chuyển tệp này — một điểm đáng lưu ý, vì đây là phần cấu hình duy nhất không tuân theo biến mà mọi thứ khác đều tuân theo. Các cài đặt cập nhật trong tệp đó tính bằng mili giây: intervalMs mặc định là 600.000, và maxBackoffMs mặc định là 3.600.000 và phải ít nhất bằng intervalMs. Jitter mặc định là 0,2, được giới hạn trong khoảng từ 0 đến 1, và có sàn là một giây trong khi không bao giờ vượt quá giới hạn backoff. Thời hạn không hoạt động cho mỗi kết nối là 60.000 mili giây áp dụng cho lưu lượng HTTP cập nhật, mặc dù một lượt tải xuống đang hoạt động không có thời hạn tổng — một đường truyền chậm sẽ không bị ngắt giữa chừng khi đang tải xuống.

Đóng cửa sổ không đóng ứng dụng

Trên cả hai nền tảng, đóng cửa sổ sẽ ẩn nó đi. Trên macOS, đó là Command-W; trên Windows, đó là nút đóng, Alt-F4, hoặc Close từ thanh tác vụ. Windows yêu cầu xác nhận trước lần ẩn đầu tiên và ghi một cờ background-close-confirmed trong thư mục userData của Electron để chỉ hỏi một lần chứ không phải lần nào cũng hỏi. Windows cũng duy trì một biểu tượng khay hệ thống trong suốt quá trình chạy. macOS hoàn toàn không có biểu tượng trên thanh menu, khiến trạng thái ẩn thực sự vô hình ở đó — ứng dụng đang chạy, các tác vụ đang chạy, và không có gì trên màn hình cho biết điều đó cho đến khi bạn mở lại bằng dsh://open hoặc khay hệ thống, tùy theo nền tảng.

Phần còn lại sau khi ẩn mới là phần hữu ích. Các tác vụ đang chạy vẫn tiếp tục chạy, và lần tới khi cửa sổ được hiển thị, nó sẽ trình bày cùng một tài liệu với cùng phiên, cùng các bản nháp và cùng vị trí cuộn. Đây là hành vi khác với một tab trình duyệt mà bạn đóng rồi mở lại, và đó là lý do bản desktop đáng có, nếu công việc của bạn liên quan đến các tác vụ agent chạy dài: bạn có thể đóng cửa sổ và để tác vụ hoàn thành.

Thoát là một hành động riêng với logic riêng của nó. Trước khi thoát, shell sẽ kiểm tra Host để tìm các agent đang chạy, bao gồm subagent và agent đang chờ phê duyệt, tin nhắn trong hàng đợi, job đang chạy hoặc đang dừng, và các nhắc nhở đã lên lịch đang được kích hoạt. Nếu không có mục nào trong số đó, nó sẽ thoát trong im lặng. Nếu có bất kỳ mục nào, bạn sẽ thấy một hộp thoại xác nhận gốc (native) có tiêu đề Thoát DeepSeek Harness? cùng một trong ba lời giải thích tùy theo những gì nó phát hiện: tác vụ sẽ bị gián đoạn, tác vụ đã lên lịch sẽ không chạy, hoặc cả hai. Một Host chưa từng đạt trạng thái sẵn sàng thì không thể đã khởi động bất kỳ tác vụ nào, nên việc thoát ở trạng thái đó sẽ diễn ra mà không hỏi. Sự phân biệt giữa "đóng" và "thoát" chính là toàn bộ mục đích của thiết kế, và điều này đúng trên cả hai nền tảng dù chỉ một trong hai hiển thị cho bạn biểu tượng thường trực.

Lệnh dsh, và thứ tự mới là điều quan trọng

Trình cài đặt có thể đặt dsh vào PATH của bạn, đây là thứ cho phép bạn chạy CLI với cùng thư mục home harness mà ứng dụng desktop sử dụng. Mục điều khiển là Quản lý lệnh dsh…, và nó nằm ngay bên dưới Kiểm tra cập nhật… trong menu, với ba hành động: Cài đặt, Sửa chữa và Gỡ bỏ. Trên macOS, nó ghi một trình khởi chạy tại /usr/local/bin/dsh và sẽ nhắc yêu cầu quyền quản trị viên khi cần; trên Windows, nó đăng ký lệnh trong PATH của người dùng hiện tại.

Hai quy tắc về thứ tự thao tác rất dễ bị bỏ sót và gây khó chịu khi phát hiện ra sau đó. Quy tắc thứ nhất: chạy Remove trước khi gỡ cài đặt ứng dụng desktop, vì trình gỡ cài đặt không xóa dsh đăng ký. Nếu gỡ cài đặt trước, bạn sẽ còn lại một mục PATH trỏ đến một tệp nhị phân không còn tồn tại. Quy tắc thứ hai: nếu bạn di chuyển ứng dụng đến một vị trí khác, hãy dùng Repair trên macOS hoặc Install từ vị trí mới trên Windows, thay vì cho rằng đăng ký sẽ đi theo ứng dụng.

Quản lý plugin cho hồ sơ desktop có một điểm phức tạp riêng. Vì Electron độc quyền nắm giữ $DSH_HOME/profiles/desktop trong khi nó đang chạy, nên việc cài đặt vào hồ sơ đó không phải là việc bạn làm khi ứng dụng đang mở. Trình tự được hỗ trợ là khởi chạy ứng dụng desktop một lần, thoát khỏi nó, rồi chạy dsh plugin --profile desktop add <package> từ dòng lệnh. Gói này sẽ được đặt vào hồ sơ desktop và sẽ hoạt động vào lần tiếp theo bạn mở cửa sổ.

Những gì bao bì đã cho bạn biết vẫn chưa hoàn chỉnh.

Phần hạn chế đã biết trong README thẳng thắn một cách bất thường, và hai mục trong đó chính là những mục sẽ ảnh hưởng đến bạn đầu tiên.

• Đăng nhập tài khoản chưa được kết nối. Nút Đăng nhập bị vô hiệu hóa. Thay vào đó, lần chạy đầu tiên sẽ mở một cửa sổ chào mừng kích thước 600 x 700 với biểu mẫu API-key; Lưu và tiếp tục sẽ ghi khóa vào kho thông tin xác thực dành cho phát triển, còn Thiết lập sau sẽ mở không gian làm việc thực sự mà không lưu khóa nào. Nhấn Đăng nhập ở nơi nút này xuất hiện sẽ mở trang nền tảng đã cấu hình trong trình duyệt hệ thống của bạn, với Host đảm nhận việc trao đổi PKCE và một callback loopback tạm thời — phần hạ tầng đã có, còn liên kết tài khoản thì chưa. Trên thực tế, hãy chuẩn bị sẵn một khóa.

• Việc ký phát hành và công chứng được nêu là cần môi trường phát hành production. Đó là README đang cẩn trọng, và cũng là chỗ mà một phép đo có ích hơn một câu văn. Tệp thực thi Windows đã phát hành mang chữ ký Authenticode hợp lệ với chuỗi xác thực mở rộng: GlobalSign Root CA–R3, đi xuống qua GlobalSign Code Signing Root R45 và GlobalSign GCC R45 EV CodeSigning CA 2020, đến chứng chỉ lá được cấp cho Hangzhou DeepSeek Artificial Intelligence Co., Ltd. với khu vực tài phán được ghi là CN / Zhejiang / Hangzhou, và danh mục doanh nghiệp là tổ chức tư nhân. Dấu thời gian RFC-3161 trên chữ ký đó ghi 2026-10-17T09:22:04Z, khớp với ngày phát hành trong nguồn cập nhật Windows với sai lệch không quá một phút, và bản tóm tắt SHA-512 của tệp đã tải khớp từng byte với mã băm được công bố trong nguồn đó. Vì vậy, trên Windows, tệp nhị phân hiện đã được ký, đóng dấu thời gian và khớp mã băm, bất kể README nói gì về việc quy trình chưa được production hóa hoàn toàn. Phía macOS là một câu hỏi khác và chúng tôi không xác minh việc công chứng ở đó; đừng lấy kết quả Windows áp sang.

Báo cáo sự cố và một chi tiết đáng lưu tâm

Báo cáo sự cố được ghi dưới dạng crash-<UTC time>-<source>.log, vào ~/Library/Logs/DeepSeek Harness trên macOS hoặc thư mục logs trong đường dẫn userData của Electron trên Windows, và mười bản gần đây nhất được giữ lại. Số lượng bản lưu đó nhỏ đến mức đáng lo ngại: nếu sự cố xảy ra lặp đi lặp lại mà bạn không kiểm tra trong vài ngày, nhật ký lẽ ra đã giải thích lỗi đầu tiên sẽ không còn nữa. Hãy sao chép thư mục nếu bạn đang gỡ lỗi một sự cố chập chờn.

Đường khôi phục cho một cấu hình bị hỏng cũng đặc thù tương tự. Shell đổi tên cordis.patch.yml thành cordis.patch.yml.bak-<timestamp> mà không phân tích cú pháp tệp này, nên tệp được giữ nguyên thay vì được sửa chữa, và ứng dụng khởi động từ cấu hình mặc định. Nếu bạn đã tự chỉnh sửa tệp đó, thì .bak chính là nơi các chỉnh sửa của bạn đã được lưu vào, và tệp này vẫn có thể đọc được.

Điều này khiến lời khuyên “không có ứng dụng desktop” trước đó trở nên thế nào?

Chúng tôi đã công bố hướng dẫn vào tháng 8 năm 2026 rằng harness không có ứng dụng desktop và người dùng Windows nên chạy bản terminal — điều đó đúng vào thời điểm đó và giờ đã lỗi thời. Bản terminal vẫn hoạt động và vẫn là lựa chọn đúng cho máy chủ, container hoặc bất kỳ thứ gì chạy bằng script. Điều đã thay đổi là bản desktop không phải một lớp bọc đồ chơi: nó có profile riêng, giữ các tác vụ tiếp tục chạy khi đóng cửa sổ, tự cập nhật và chia sẻ trạng thái với CLI theo hướng có lợi cho bạn. Nếu bạn từng trì hoãn việc dùng bản desktop vì bài viết trước đó nói rằng nó không tồn tại, thì lý do đó không còn nữa.

Bản thân các bước cài đặt đã có trong hướng dẫn cài đặt của chúng tôi và được cố ý không nhắc lại ở đây. Điều mà hướng dẫn đó không thể cho bạn biết là bộ cài nào trong ba bộ cài không có liên kết trên trang tải xuống, nền tảng đích nào chậm một bản phát hành, rằng không có kênh cập nhật ổn định nào để chọn tham gia, và rằng tệp nhị phân Windows đã được ký dù README nói việc ký thuộc về một bản phát hành trong tương lai. Đó là những dữ kiện quyết định liệu bản dựng desktop có phải là thứ đúng để cài hay không, và là lý do trang này tồn tại riêng.

Nếu bạn không muốn cài đặt bất cứ thứ gì

Cài đặt một harness chỉ để truy cập một mô hình là quá nhiều bề mặt cho một lượng việc nhỏ, và ứng dụng desktop là bản xem trước chỉ có một kênh cập nhật duy nhất cùng một bản dựng Intel mà chẳng ai liên kết tới. Nếu thứ bạn thực sự muốn là DeepSeek-V4.1-Flash — mô hình mà harness mặc định dùng, cũng chính là mô hình mà ghi chú 0.2.1-rc.2 bổ sung hỗ trợ — thì một endpoint API làm được điều đó mà không cần trình cài đặt, không cần thư mục profile và không có biểu tượng khay hệ thống mà bạn phải nhớ là nó đang chạy.

Phép so sánh cần thực hiện không phải là ứng dụng desktop với API một cách trừu tượng. Mà là liệu công việc có cần một tác nhân có thể giữ không gian làm việc luôn mở ngay cả khi cửa sổ đã đóng, chạy script trên máy của bạn và giữ một phiên hoạt động trong nhiều giờ — trong trường hợp đó, những vấn đề đóng gói ở trên đáng để chịu đựng, và bản dựng desktop là cách duy nhất để có được hành vi đó — hay liệu công việc chỉ là một chuỗi yêu cầu đến một mô hình đã được phục vụ ở nơi khác. Đối với trường hợp thứ hai, thư mục mô hình là con đường ngắn hơn, và không có gì trong bài viết này thay đổi điều đó.