DeepSeek Harness đang được nhắc đến rất nhiều trong cộng đồng AI và developer tools. Nhiều người gọi nó là một đối thủ mã nguồn mở của Claude Code hoặc Codex, nhưng cách hiểu đó mới chỉ đúng một phần. DeepSeek Harness không phải là một model DeepSeek mới; nó là lớp runtime giúp model đọc workspace, gọi công cụ, sửa file, chạy lệnh, lập kế hoạch và duy trì session qua nhiều bước.
Trong bài này, chúng ta sẽ phân biệt rõ ba khái niệm dễ bị trộn lẫn: model, harness và agent mode. Sau đó, bài viết đi qua kiến trúc Cordis, bốn mode của dsh, cách chạy local, giới hạn benchmark và các rủi ro phải xử lý trước khi cho agent chạm vào VPS hoặc repository thật.
Tóm tắt nhanh
| Câu hỏi | Câu trả lời ngắn |
|---|---|
| DeepSeek Harness là gì? | Một open-source agent runtime đặt quanh model để cung cấp tool use, session, planning, sandbox và UI. |
| Có phải model mới không? | Không. Model như DeepSeek V4, V4-Flash hoặc provider tương thích chỉ là một phần trong runtime. |
| Chạy ở đâu? | Thiết kế local-first, có Web UI local, headless runner và các hướng tích hợp chương trình. |
| Có thay Claude Code/Codex ngay không? | Chưa nên kết luận như vậy. Harness mở và dễ mở rộng hơn ở lớp runtime, nhưng vẫn đang ở developer preview. |
| Có nên cài trực tiếp trên production server? | Không. Nên chạy trong VM hoặc container biệt lập, workspace staging và quyền tối thiểu. |
DeepSeek Harness là gì?
Một model ngôn ngữ tự thân chỉ tạo ra token. Để hoàn thành một công việc kỹ thuật kéo dài, agent cần biết workspace nào đang mở, file nào được phép đọc, lệnh nào có thể chạy, kết quả tool trả về là gì và khi nào cần dừng để xin phép. Harness là lớp runtime đảm nhiệm những phần đó.
DeepSeek mô tả Harness bằng ý tưởng Everything is a plugin. Model adapter, tool registry, session log, agent loop, filesystem, sandbox, storage và UI được tổ chức thành các capability có thể lắp ghép hoặc thay thế. Vì vậy, Harness gần với một agent operating layer hơn là một giao diện chat đơn giản. Kiến trúc chính thức của dự án được xây trên Cordis, một meta-framework quản lý service, event, dependency và lifecycle của plugin.
Hiểu theo cách thực dụng: model quyết định nên làm gì, còn harness quyết định model được nhìn thấy gì, được gọi công cụ nào, thao tác trong phạm vi nào và có thể lặp lại tiến trình ra sao.
Phân biệt model, harness và agent mode
Đây là phần quan trọng nhất nếu bạn muốn đọc các bài benchmark về DeepSeek Harness mà không bị nhầm. Model là bộ máy suy luận, chẳng hạn một model DeepSeek hoặc endpoint OpenAI-compatible. Harness là runtime bao quanh model: nó quản lý tool, session, context, permission, sandbox và vòng lặp agent. Agent mode là một composition cụ thể của các plugin và policy, chẳng hạn Standard, Code, Minimal hoặc Creator.
Hai người cùng dùng một model nhưng khác harness, khác mode, khác tool policy và khác workspace có thể nhận kết quả rất khác nhau. Vì thế, một điểm số agent không nên được đọc như điểm số tuyệt đối của model. Khi nguồn benchmark nói model được chạy bằng DeepSeek Harness Minimal mode, điểm số đó phản ánh cả model lẫn scaffolding, prompt và cấu hình runtime đi kèm.
Kiến trúc “Everything is a plugin” hoạt động thế nào?
Cordis cung cấp một context chung để plugin đóng góp service, typed event và reversible effect. Khi plugin được mount, nó đăng ký capability vào runtime; khi bị stop hoặc unload, các side effect tương ứng có thể được thu hồi theo lifecycle. Cách làm này cho phép thay provider filesystem, subprocess, sandbox hoặc subagent mà không phải sửa toàn bộ lõi ứng dụng.
Ở cấp triển khai, một profile được ghép từ nhiều bundle và patch layer. Bundle nền cung cấp model adapter, tool, persistence, sandbox hoặc approval policy. Bundle web thêm giao diện trình duyệt, còn headless profile cho phép chạy một job mà không cần khởi động Web UI. Người dùng có thể xem cấu hình sau khi các layer được compose bằng lệnh dump config, thay vì đoán runtime đang chứa những plugin nào.
| Thành phần | Vai trò | Điều cần kiểm soát |
|---|---|---|
| Model adapter | Kết nối model hoặc provider | Tool calling, reasoning format, rate limit và dữ liệu gửi ra ngoài |
| Tool registry | Công bố file, shell, search và tool khác | Quyền, tham số và khả năng tạo side effect |
| Session log | Ghi turn, step, message và tool result | Secret, dữ liệu riêng tư và thời gian lưu trữ |
| Sandbox | Giới hạn filesystem, process và subprocess | Blast radius khi agent hoặc plugin sai |
| Profile/patch | Ghép mode và override của người dùng | Thứ tự layer, version và khả năng tương thích |
Bốn mode của DeepSeek Harness
1. Standard mode
Standard là coding agent đầy đủ nhất, thường có file editing, shell, file hoặc web search, skills, planning, goals, workflows và subagents. Đây là mode phù hợp để thử một công việc phát triển nhiều bước trong workspace riêng, nhưng cũng là mode có blast radius lớn nhất nếu permission policy bị cấu hình quá rộng.
2. Code mode
Code mode dùng Code Mode SDK để model điều phối nhiều round tool call trong một chương trình TypeScript. Ý tưởng là gom một số thao tác có cấu trúc vào chương trình thay vì bắt model quay lại vòng lặp cho từng lệnh nhỏ. Mode này có tiềm năng giảm round-trip, nhưng nên dùng sau khi bạn hiểu rõ code mà agent sinh ra sẽ được chạy trong context nào.
3. Minimal mode
Minimal chỉ giữ lại lớp công cụ tối thiểu như shell và file editor. Nó hữu ích cho benchmark vì giảm scaffolding, giúp đánh giá khả năng suy luận và tool calling của model trong môi trường đơn giản hơn. Nó không đại diện cho trải nghiệm Standard đầy đủ và không nên dùng điểm Minimal để hứa hẹn hiệu năng production.
4. Creator mode
Creator dành cho người muốn inspect runtime, thử Cordis plugin trong memory và kết hợp chúng thành một mode hoặc preset mới. Đây là nơi Harness trở nên khác biệt so với một coding assistant đóng gói sẵn: người dùng có thể xây lớp runtime riêng, nhưng phải chấp nhận chi phí học API và rủi ro breaking change.
Cách cài và chạy DeepSeek Harness local
Cách nhanh nhất được tài liệu dự án giới thiệu là chạy Web UI local bằng npm:
npx @deepseek-ai/dsh webWeb UI mặc định chạy trên loopback, thường là http://127.0.0.1:3080. Nếu muốn khởi động từ source, có thể clone repository, cài dependency, build artifact rồi chạy launcher:
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web --no-openSau khi mở giao diện, bạn cần vào phần model settings để cấu hình provider/API key, rồi chọn workspace trước khi composer có thể làm việc. Đừng đặt key trực tiếp trong repository, shell history hoặc file được agent đọc. Với lần thử đầu tiên, hãy tạo một repository fixture nhỏ gồm vài file source, test và README; không dùng ngay thư mục chứa website, database dump hoặc credential production.
Một workflow thử nghiệm an toàn
Workflow đầu tiên nên nhỏ và có thể đảo ngược. Hãy yêu cầu agent đọc cấu trúc repository, giải thích một lỗi cố ý trong test, đề xuất diff rồi chờ bạn review. Chỉ sau khi nhìn thấy diff mới cho phép agent sửa branch riêng và chạy test. Mục tiêu của bước này không phải chứng minh agent có thể tự làm mọi thứ, mà là đo xem nó có dừng đúng lúc, đọc đúng file và không chạy lệnh ngoài phạm vi hay không.
- Chạy Harness trong VM hoặc container bằng user không có quyền root.
- Mount một workspace staging; không mount thư mục chứa secret hoặc production volume.
- Chọn model và mode, bắt đầu bằng một task đọc-only.
- Kiểm tra trajectory và tool calls trước khi cho phép file edit.
- Review diff, chạy test và chỉ merge bằng quy trình Git thông thường.
Benchmark có chứng minh Harness vượt đối thủ không?
Một số bài viết dẫn các điểm số agent cao của DeepSeek V4-Pro hoặc V4-Flash trên Terminal Bench, Toolathlon và DSBench. Những số liệu này có thể cho thấy hướng phát triển rất đáng chú ý, nhưng cần đọc cùng cấu hình: model version, reasoning tier, temperature, tool policy, mode và cách chấm. Nhiều con số là vendor-reported hoặc được nguồn độc lập trích lại từ công bố của DeepSeek, chưa phải reproduction hoàn toàn độc lập.
Đặc biệt, benchmark dùng Minimal mode không thể dùng để kết luận rằng Standard mode sẽ luôn tốt hơn hoặc rằng Harness đã thay thế Claude Code/Codex. Mỗi runtime có tool, permission, context injection và UX khác nhau. Nếu muốn chọn cho workflow của mình, bạn nên chạy một bộ eval nhỏ trên chính repository: đọc code, sửa bug nhỏ, chạy test, xử lý prompt injection trong fixture và thực hiện preflight không mutation.
DeepSeek Harness so với Claude Code, Codex và OpenCode
| Tiêu chí | DeepSeek Harness | Claude Code/Codex | OpenCode và các tool mở |
|---|---|---|---|
| Trọng tâm | Runtime/plugin để tự lắp agent | Trải nghiệm coding agent hoàn chỉnh | CLI/agent mở và provider linh hoạt |
| Khả năng mở rộng | Sâu ở model, loop, tool, session, sandbox và UI | Mở rộng qua skills, hooks, MCP hoặc hệ sinh thái riêng | Thường linh hoạt ở provider và tool |
| Độ trưởng thành | Developer preview, API thay đổi nhanh | Ổn định và polished hơn ở product surface | Tùy project và provider |
| Self-host | Local-first, phù hợp lab/runtime builder | Tùy sản phẩm và policy | Thường thuận tiện cho self-host |
Vì vậy, câu hỏi đúng không phải “DeepSeek Harness có thắng Claude Code không?”. Câu hỏi đúng là bạn muốn một coding assistant dùng ngay, hay muốn kiểm soát từng lớp của agent runtime. Nếu muốn UX và reliability, sản phẩm trưởng thành có lợi thế. Nếu muốn học orchestration, thay provider, viết plugin và quan sát trajectory, Harness có giá trị riêng.
Rủi ro bảo mật cần biết trước khi dùng
Harness có thể đọc file và chạy command trên máy, nên rủi ro của nó gần với việc cấp quyền cho một automation process chứ không chỉ là dùng chatbot. Prompt injection có thể nằm trong README, issue, website, log hoặc file được agent đọc. Một instruction độc trong dữ liệu không đáng tin có thể dụ agent chạy lệnh trái với mục tiêu ban đầu.
Plugin cũng là một bề mặt tấn công. Một plugin có thể thêm tool, event listener, filesystem capability, UI hoặc provider. MIT license của source không có nghĩa mọi plugin cộng đồng đều an toàn. Hãy pin version/commit, đọc source và dependency, thử trong sandbox, redact log và không cung cấp SSH key, API key, database password hoặc Ghost Admin key.
Không expose Web UI ra Internet chỉ bằng cách đổi bind address. Nếu cần truy cập từ xa, phải có private network hoặc lớp authentication, firewall và audit phù hợp. Trong giai đoạn thử nghiệm, bind loopback là lựa chọn an toàn hơn.
Có nên cài DeepSeek Harness trên VPS hoặc shared hosting không?
Không nên cài trực tiếp trên shared hosting cPanel production. Shared hosting thường có giới hạn process, quyền filesystem, Node runtime và network; trong khi Harness được thiết kế để chạy tool và command trên workspace. Nếu agent bị prompt injection hoặc plugin có lỗi, bạn không muốn blast radius chạm vào Ghost, file backup, key hoặc database.
Với workflow TechNT, vị trí phù hợp của Harness hiện tại là một VM hoặc container riêng để làm coding/research workstation. Bạn có thể clone repository staging, chạy QA draft, kiểm tra manifest, tạo report và đề xuất patch. Pipeline publish Ghost vẫn nên có dry-run và human confirmation; các thao tác upload, publish, migration, xóa file hoặc deploy không nên được agent tự quyết định.
| Giai đoạn | Quyền nên cấp | Mục tiêu |
|---|---|---|
| Lab ban đầu | Read-only workspace | Đo khả năng đọc code, lập kế hoạch và tạo report |
| Staging | Edit trên branch riêng, chạy test | Đánh giá chất lượng diff và failure mode |
| QA automation | Headless cho task không phá hủy | Kiểm tra link, manifest, ảnh và schema |
| Production | Không cấp quyền tự do; mutation cần approval | Bảo vệ Ghost, secrets và dữ liệu thật |
Câu hỏi thường gặp
DeepSeek Harness có phải DeepSeek V4 không?
Không. DeepSeek V4 hoặc các model tương tự là model; Harness là runtime điều phối model, tool, session, sandbox và UI.
DeepSeek Harness có chạy offline hoàn toàn không?
Runtime có thể chạy local, nhưng model/provider có thể vẫn cần gọi API. Muốn offline thực sự, bạn phải dùng model local tương thích, kiểm tra toàn bộ dependency và tắt các tool/network route không cần thiết.
Có cần GPU để chạy Harness không?
Không nhất thiết. Harness là lớp orchestration; GPU phụ thuộc model bạn dùng. Nếu gọi model qua API, máy chạy Harness chủ yếu cần tài nguyên cho runtime và tool.
DeepSeek Harness có thay thế Claude Code hoặc Codex không?
Chưa thể nói chung như vậy. Harness có lợi thế về khả năng mở rộng runtime và self-host, nhưng vẫn là developer preview và khác về UX, provider, sandbox, cloud workflow và độ ổn định.
Người mới có nên cài ngay không?
Nên thử trong repository fixture hoặc VM riêng nếu bạn muốn học agent runtime. Không nên bắt đầu bằng VPS production, thư mục website thật hoặc nơi chứa credential.
Tài liệu tham khảo
- DeepSeek Harness official overview
- DeepSeek Harness official quickstart
- DeepSeek Harness GitHub repository
- DeepSeek Harness architecture guide
- Cordis repository
- DeepSeek Harness Safe Use Policy
- VentureBeat: DeepSeek Harness and V4-Pro context
- DeepakNess: hands-on with DeepSeek Harness
Kết luận
DeepSeek Harness đáng chú ý vì nó mở lớp runtime mà nhiều coding agent thường đóng gói sẵn. “Everything is a plugin”, Cordis, session log và bốn mode Standard, Code, Minimal, Creator tạo ra một nền tảng đáng thử cho người xây agent và self-hoster. Nhưng độ hot không đồng nghĩa với production readiness: bản phát hành vẫn là release candidate, API có thể breaking và chính sách chính thức đã cảnh báo prompt injection cùng command execution.
Với người dùng TechNT, cách tiếp cận hợp lý là bắt đầu từ VM hoặc container biệt lập, dùng workspace staging, chạy eval nhỏ và chỉ mở rộng quyền sau khi trajectory có thể kiểm tra. Hãy dùng Harness như một trợ lý coding/research có kiểm soát; đừng biến nó thành process toàn quyền trên Ghost production ngay từ ngày đầu.
