ds-harness-remote: điều khiển DeepSeek Harness từ xa bằng điện thoại — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về liguobao/ds-harness-remote — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: ds-harness-remote: điều khiển DeepSeek Harness từ xa bằng điện thoại, web — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
ds-harness-remote là plugin cho DeepSeek Harness (DSH) giúp bạn truy cập từ xa vào máy đang chạy Harness bằng web, Android hoặc một máy tính khác. Dữ liệu đi qua kênh mã hoá đầu-cuối và máy chủ không cần mở cổng công khai. Cài plugin khá đơn giản, nhưng cần có tài khoản trên dịch vụ đi kèm, và đăng ký tài khoản mới cần mã mời.
ds-harness-remote là một plugin cho DeepSeek Harness (gọi tắt là DSH), cho phép bạn dùng lại đúng phiên làm việc của DSH trên máy tính ở nhà hoặc ở công ty từ điện thoại, máy tính khác hay trình duyệt web. Máy gốc vẫn chạy mọi thứ: cùng workspace, cùng công cụ, cùng cấu hình dự án. Plugin chỉ mở thêm một “cửa sổ” nữa để bạn nhìn vào môi trường đó.
Nếu bạn hay phải rời bàn làm việc trong lúc AI đang chạy tác vụ dài, repo này dành cho bạn. Bạn có thể xem tiến độ, gửi thêm yêu cầu, đổi mô hình, thậm chí mở thư mục và terminal từ xa. Dân lập trình dùng nhiều công cụ như Codex, Cursor hay Claude Code cũng có thể gom về một chỗ qua các tích hợp ACP.
Điểm đáng giá nhất là kiểu kết nối: máy chủ (Host) chỉ mở kết nối đi ra, không cần IP công khai, không cần mở cổng trên router. Nội dung hội thoại được mã hoá đầu-cuối, dịch vụ trung gian chỉ chuyển dữ liệu đã mã hoá. Repo hiện có khoảng 2.769 sao và 207 fork, giấy phép MIT, và vẫn được cập nhật trong vài tháng gần đây.
liguobao/ds-harness-remote
Plugin cho DeepSeek Harness, cho bạn mở lại đúng phiên làm việc trên máy ở công ty từ điện thoại, máy khác hoặc trình duyệt, qua kênh mã hoá đầu-cuối.
I.ds-harness-remote làm được gì
Dùng lại Harness từ nhiều thiết bị. Bạn truy cập Harness đang chạy trên máy của mình qua web, máy tính khác hoặc điện thoại. Hỗ trợ chính là DSH, ngoài ra còn có Codex, Cursor và Antigravity. Lợi ích thực tế: không phải ngồi canh máy, ra ngoài vẫn theo dõi được công việc.
Giao diện gốc của Harness. Bản desktop dùng luôn giao diện sẵn có, không có giao diện hội thoại riêng. Bạn tạo workspace, cấu hình mô hình và đổi mô hình trong hội thoại như khi dùng tại máy.
Không cần IP công khai. Host chỉ gọi ra ngoài. Kết nối thử theo thứ tự LAN, P2P, TURN rồi Relay. Nếu WebRTC không dùng được, hệ thống tự chuyển sang Relay qua WebSocket (vẫn mã hoá). Bạn không phải chỉnh router.
Xem file, terminal, xem trước dịch vụ. Từ thanh bên của Harness, bạn duyệt file workspace (chỉ xem, không ghi), mở terminal từ xa và xem trước các dịch vụ phát triển cục bộ đã được cấp quyền.
Nhiều thiết bị cùng lúc. Nhiều client có thể nối vào cùng một Host, mỗi kết nối được tách riêng.
Công cụ “remote_*” cho phiên làm việc. Plugin có thể đưa vào các công cụ cho phép tìm Host và workspace, tạo và quản lý phiên Harness, đọc lịch sử, chờ chạy xong, yêu cầu dừng, chuyển file đã được cấp quyền. Tính năng này bật mặc định và chỉnh được trong cài đặt Remote.
Làm việc với agent khác qua ACP (thử nghiệm). Ngoài Harness, bạn truy cập workspace của Codex, Cursor, Antigravity, Pi, OpenCode, Claude và Hermes. Mỗi agent giữ workspace và phiên riêng của nó.
Nhiều loại client. Có plugin cho DSH Desktop, trang Web, app Android, và DSH Go (app của một tác giả khác). Bản iOS đang thử nghiệm trên TestFlight, chưa phát hành công khai.
II.Cần chuẩn bị gì
- Một máy chạy DeepSeek Harness Desktop làm Host. README nói Host có thể là Windows, macOS, Linux, hoặc cả DSH Go.
- Phiên bản Harness: mốc hiện tại là
dsh-v0.2.2-rc.1. Các bảndsh-v0.2.1-rc.5và0.2.0rc.2 / rc.1 vẫn tương thích. Harness0.1.1-rc.2không còn được hỗ trợ. - Một tài khoản trên dịch vụ đi kèm. Bạn đăng nhập bằng Zhihu, GitHub hoặc Google, hoặc bằng tài khoản và mật khẩu. Đăng ký tài khoản mới cần mã mời, README bảo gửi email cho tác giả để xin.
- Kết nối internet. Mặc định plugin dùng máy chủ do dự án cung cấp tại dsh.r2049.cn.
- Thiết bị để điều khiển: trình duyệt, máy tính có cài plugin, hoặc điện thoại Android. Với iOS, cần tham gia bản beta.
- Nếu muốn dùng agent ACP (Codex, Cursor, Claude…), bạn cần cài và cấu hình sẵn các công cụ đó trên Host. README ghi riêng cho Pi cần cài Pi và
pi-acp, cho Claude cầnclaude-agent-acpđã được cấp quyền cục bộ. - README không nêu yêu cầu GPU hay RAM cụ thể.
III.Cài đặt từng bước
- Cài pluginThêm ds-harness-remote@0.6.5 vào DeepSeek Harness Desktop và khởi động lại
- Đăng nhậpMở mục Remote ở thanh bên và đăng nhập tài khoản
- Cài trên thiết bị thứ haiCài cùng plugin, hoặc dùng Web / Android
- Chọn HostChọn máy đang online rồi mở workspace
A.Cài plugin trong DeepSeek Harness Desktop
Mở Extensions / Plugin management trong DeepSeek Harness Desktop, chọn cài từ npm, rồi nhập tên gói:
ds-harness-remote@0.6.5Sau đó khởi động lại Desktop. Đây là chỗ người mới hay quên: chưa restart thì plugin chưa hiện.
Nếu bạn quen dòng lệnh, README nói trình khởi chạy dsh chính thức cũng cài được đúng bản này. Mở terminal (PowerShell trên Windows, Terminal trên macOS/Linux) và chạy:
dsh plugin --profile desktop add -w ds-harness-remote@0.6.5Với DSH 0.2.2 trở lên, bản cài qua npm hỗ trợ kiểm tra phiên bản và cập nhật ngay trong Plugin management. Nếu cập nhật nóng lỗi, hệ thống cố khôi phục bản cũ. Bản cài từ GitHub hoặc liên kết cục bộ cần chuyển sang npm trước.
B.Đăng nhập trong mục Remote
Trong thanh bên của DeepSeek Harness, mở Remote. Chọn đăng nhập bằng Zhihu, GitHub hoặc Google, hoặc dùng tài khoản và mật khẩu. Nếu chưa có tài khoản, bạn cần mã mời từ tác giả.
C.Chuẩn bị thiết bị thứ hai
Có hai cách:
- Cài cùng plugin trên một DeepSeek Harness khác, rồi đăng nhập cùng tài khoản.
- Hoặc không cài plugin: dùng Remote Web tại dsh.r2049.cn, app Android, iOS (beta) hay DSH Go.
Với Android, tải file APK ở mục Releases của repo rồi đăng nhập cùng tài khoản để thấy các Host của bạn. Với Linux (ví dụ máy chủ đám mây), README nói bạn đăng nhập trang web chính thức, lấy mã uỷ quyền cài đặt và cài bằng một lệnh. README không in sẵn lệnh đó, nên bạn lấy lệnh trên trang web sau khi đăng nhập.
Trình cài đặt Linux tạo dịch vụ systemd cấp hệ thống nên Host, công cụ của agent và terminal từ xa chạy với quyền root. Chỉ cho phép các tài khoản bạn tin tưởng.
D.Chọn Host và mở workspace
Trên thiết bị thứ hai, chọn một Host đang online, rồi chọn workspace có sẵn hoặc duyệt thư mục từ xa để mở một workspace. Giao diện hiện ra là giao diện gốc của Harness, kèm thông tin Host đang dùng và trạng thái kết nối mã hoá ở phần đầu.
IV.Kiểm tra đã chạy được chưa
Có vài dấu hiệu để biết mọi thứ ổn:
- Sau khi restart, mục Remote xuất hiện ở thanh bên của DeepSeek Harness.
- Đăng nhập xong, danh sách Host online hiện ra, trong đó có máy của bạn.
- Mở workspace từ thiết bị khác thì thấy giao diện Harness gốc, phần đầu hiển thị Host đang dùng và trạng thái kết nối mã hoá.
- Gửi một tin nhắn thử từ điện thoại và thấy nó xuất hiện, được xử lý trên máy Host.
Về lý thuyết, bạn cũng có thể kiểm tra trong Plugin management xem plugin có nằm trong danh sách, và với DSH 0.2.2 trở lên thì có thể xem phiên bản đang cài.
V.Dùng vào việc thật
A.Dev đang chạy tác vụ dài, phải ra ngoài
Bạn giao cho Harness một việc lớn như refactor một module rồi phải đi họp. Mở app Android, đăng nhập cùng tài khoản, chọn Host là máy ở nhà. Bạn đọc lại hội thoại, thấy agent đang hỏi xác nhận một bước và duyệt ngay trên điện thoại. Quyền và phê duyệt vẫn nằm ở máy Host, nên bạn không phải mở thêm cổng nào.
Máy vẫn làm việc ở nhà, điện thoại chỉ là thêm một ô cửa sổ để nhìn vào.
Ông T
B.Nhân viên văn phòng dùng chung một máy mạnh
Công ty có một máy tính cấu hình tốt cài sẵn Harness. Bạn ngồi máy khác hoặc làm việc ở nhà, mở trình duyệt vào Remote Web, chọn Host là máy đó. Bạn mở workspace chứa tài liệu dự án, nhờ AI tóm tắt hoặc chỉnh sửa, rồi xem file ở chế độ chỉ đọc. Nếu bạn không muốn máy làm việc bị máy khác điều khiển ngược, README gợi ý bật Controlled only trong danh sách Host trên trang web.
C.Gom nhiều agent về một giao diện
Bạn dùng cả Cursor và Claude trên cùng máy. Bật các mục tương ứng trong cài đặt (Claude và Hermes cần bật trong settings), sau đó từ máy khác chọn workspace của từng agent. Bạn gửi lời nhắc, xem phản hồi dạng stream và duyệt phê duyệt. Lưu ý đây là tính năng thử nghiệm, và Claude hiện hỗ trợ văn bản cùng phê duyệt, chưa hỗ trợ ảnh.
D.Kiểm tra một dịch vụ đang phát triển từ xa
Bạn đang chạy thử một trang web ở máy Host. Qua thanh bên của Harness, dùng chức năng xem trước dịch vụ phát triển cục bộ đã được cấp quyền để xem thử từ máy khác. Cần mở terminal, bạn dùng terminal từ xa. Nhớ rằng terminal chạy với quyền của người dùng trên Host.
VI.Lỗi hay gặp và cách xử lý
Không thấy mục Remote sau khi cài. Thường do chưa khởi động lại Desktop. Thoát hẳn ứng dụng rồi mở lại. Nếu vẫn không thấy, kiểm tra Harness của bạn có thuộc các phiên bản được hỗ trợ không, vì README nói Host chỉ cung cấp ApiProxy hoặc thiếu khả năng khám phá sẽ bị từ chối.
Không đăng ký được tài khoản. Đăng ký cần mã mời. Bạn gửi email cho tác giả repo để xin, hoặc thử đăng nhập bằng Zhihu, GitHub hay Google.
Không thấy Host nào online. Kiểm tra máy Host đang bật, Harness đang chạy, plugin đã cài và cùng một tài khoản đã đăng nhập. Nếu bạn từng bật Controlled only trên một thiết bị, thiết bị đó sẽ không thấy các thiết bị khác, nhưng vẫn bị điều khiển được.
Cập nhật plugin không được. Tính năng cập nhật chỉ hỗ trợ bản cài qua npm. Nếu bạn cài từ GitHub hoặc liên kết cục bộ, hãy chuyển sang cài bằng npm trước.
Agent ACP không xuất hiện. Agent đó phải được cài và cấu hình trên Host trước. Với Claude và Hermes cần bật trong cài đặt. Với Pi cần cài Pi và pi-acp. Tham khảo hướng dẫn tích hợp agent trong thư mục docs của repo.
VII.Có nên dùng không
Điểm mạnh: không cần IP công khai hay mở cổng, mã hoá đầu-cuối, giữ nguyên giao diện Harness quen thuộc, nhiều thiết bị cùng kết nối, có sẵn app Android và web. Giấy phép MIT, repo vẫn được cập nhật.
Giới hạn: bạn phụ thuộc vào Harness (DSH), nên công cụ này không dành cho người chưa dùng DeepSeek Harness. Mặc định dùng máy chủ do dự án vận hành, và đăng ký cần mã mời. Tự dựng máy chủ riêng thì chỉ có bản tối giản (điều phối WebRTC/P2P/TURN và Relay mã hoá, TURN cần tự triển khai coturn), không có đầy đủ trải nghiệm Remote Web. iOS còn trong beta, dsh-TUI mới ở dạng dự kiến. Nhiều tính năng agent ACP vẫn đang thử nghiệm.
Khi nào chọn cách khác: nếu chỉ cần truy cập mạng nội bộ nói chung, README cũng nhắc tới Tailscale, CF Turn hay UU Remote là các giải pháp tốt. Nếu bạn cần điều khiển toàn bộ màn hình máy tính, remote desktop phù hợp hơn, vì repo này chỉ truyền những thông điệp cần cho giao diện hội thoại Harness và không mở điều khiển desktop hay RPC công cụ tổng quát.
Câu hỏi thường gặp
ds-harness-remote có miễn phí không?
Repo dùng giấy phép MIT. Mặc định plugin dùng máy chủ do dự án cung cấp, nhưng README chưa nói gì về phí dịch vụ này. Đăng ký tài khoản mới cần mã mời từ tác giả.
Cần IP công khai hoặc mở cổng router không?
Không. Máy Host chỉ mở kết nối đi ra và không lắng nghe trên cổng công khai. Kết nối được thử theo thứ tự LAN, P2P, TURN, Relay.
Dịch vụ có đọc được nội dung hội thoại của tôi không?
Theo README thì không. Lưu lượng được mã hoá đầu-cuối, dịch vụ chỉ chuyển dữ liệu đã mã hoá. Dịch vụ vẫn thấy một số siêu dữ liệu điều khiển như tài khoản, sở hữu thiết bị, trạng thái online và thời điểm kết nối.
Máy nào làm Host được, có chạy trên Windows không?
README nói bất kỳ máy chạy Harness đã đăng nhập và cài plugin Remote đều làm Host được, dù là Windows, macOS, Linux hay cả DSH Go. Với Linux đám mây còn có cách cài một lệnh qua trang web chính thức.
Có dùng được trên điện thoại không?
Có app Android (tải APK ở mục Releases) và DSH Go, một app của tác giả khác. Bản iOS đang thử nghiệm TestFlight, chưa phát hành công khai. Bạn cũng có thể dùng Remote Web trên trình duyệt.
Nhiều thiết bị kết nối cùng lúc được không?
Được. README nói hiện chưa giới hạn số kết nối đồng thời và mỗi kết nối được tách riêng.
Khác gì frp, tunnel hay remote desktop?
Theo README, port forwarding qua máy chủ có thể bị nghẽn băng thông, còn remote desktop phải truyền cả màn hình. Dự án này chỉ mã hoá và truyền các thông điệp cần cho giao diện hội thoại Harness, không mở điều khiển desktop hay RPC công cụ tổng quát. README cũng nhắc Tailscale, CF Turn, UU Remote là các giải pháp tốt khác.


