DeepSeek Harness là gì: agent mã nguồn mở, mọi thứ là plugin

Thử hình dung buổi họp giữa giám đốc và trưởng phòng IT. Giám đốc muốn cho nhân viên dùng AI agent như Claude Code. IT gật đầu, rồi đưa ba điều kiện: mọi yêu cầu phải đi qua cổng AI nội bộ, mọi thao tác phải ghi nhật ký để kiểm toán, và một số lệnh phải chặn hẳn.

Với công cụ đóng trọn gói, ba điều kiện đó thường là ba lần "chờ hãng thêm tính năng". DeepSeek Harness đi đường khác: mọi phần đều tháo ra lắp vào được, nên điều kiện nào cũng là chuyện cấu hình.

Đọc nhanh trong 30 giây

• DeepSeek Harness (gọi tắt dsh) là bộ khung chạy AI agent mã nguồn mở của DeepSeek, công khai ngày 13/08/2026, giấy phép MIT.
• Ý tưởng xuyên suốt "mọi thứ là plugin": kết nối model, kho công cụ, nhật ký phiên, cả vòng lặp agent đều thay được.
• Chạy nhanh bằng npx @deepseek-ai/dsh web, mở giao diện web tại http://127.0.0.1:3080.
• Hợp với đội kỹ thuật muốn tự dựng agent nội bộ trên nhiều model. Đây là bản xem trước, DeepSeek nói rõ sẽ có thay đổi phá vỡ tương thích.

DeepSeek Harness là gì, "bộ khung agent" nghĩa là sao?

DeepSeek Harness là phần mềm bao quanh model AI để model đọc file, sửa file, chạy lệnh, lập kế hoạch và giao việc cho agent con. Model giỏi đến đâu cũng chỉ biết trả lời bằng chữ; bộ khung mới là thứ cho nó tay chân. Claude Code hay Codex CLI cũng là một bộ khung như vậy, nhưng do một hãng làm trọn gói.

Harness tách mọi phần ra thành mảnh ghép. Hình dung như một tủ điện có thanh ray: aptomat, công tơ, bộ chống sét đều gắn lên ray, hỏng cái nào thay cái đó, không phải đi lại dây cả tủ.

Mọi phần chính của DeepSeek Harness đều là plugin gắn vào lõi Cordis.

Nền móng là Cordis, một framework mà theo tài liệu kiến trúc, các plugin đóng góp dịch vụ, sự kiện và tác động vào một ngữ cảnh chung. Khi plugin bị gỡ, mọi thứ nó đăng ký cũng tự gỡ theo. Tài liệu viết rằng không có phần lõi đặc quyền nào phải vá: muốn mở rộng thì gắn thêm plugin bên cạnh các plugin khác.

Plugin, bundle, profile khác nhau thế nào?

DeepSeek Harness lắp ráp theo ba tầng: plugin là từng mảnh, bundle là một gói mảnh, profile là bộ hoàn chỉnh có tên.

Profile là chồng nhiều lớp, lớp trên chỉnh lại lớp dưới.

Hai profile có sẵn là web (giao diện trên trình duyệt) và headless (chạy một việc rồi thoát, không cần máy chủ). Bundle dsh-base là lớp đầu tiên của mọi profile, chứa kết nối model, công cụ, lưu trữ, sandbox, chính sách xin phép, cài đặt, quản lý khóa.

Nhật ký phiên: phần tôi thấy chắc tay nhất

Trong DeepSeek Harness, mọi thứ model nhìn thấy đều phải tái dựng được từ nhật ký phiên, và nhật ký chỉ ghi thêm, không sửa. Tài liệu ghi rõ: cái gì đến được model thì phải nằm trong nhật ký.

Giống sổ cái của kế toán: ghi sai thì thêm bút toán điều chỉnh, không ai được tẩy trang cũ. Nhờ vậy, việc mở lại phiên, tách nhánh phiên, xem lại agent đã làm gì đều dựa trên một nguồn duy nhất. Với bộ phận kiểm soát nội bộ, đây là điều đáng giá hơn mọi tính năng hào nhoáng.

Cài DeepSeek Harness trong vài phút

DeepSeek Harness có hai cách chạy theo README lúc ra mắt.

Một lệnh npx là có giao diện web, sau đó nhập khóa và chọn thư mục.

1. Chạy từ npm, chỉ cần cài Node.js:

npx @deepseek-ai/dsh web

Lệnh này mở giao diện web, mặc định tại http://127.0.0.1:3080.

2. Hoặc chạy từ mã nguồn:

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

3. Vào Settings, Models, nhập khóa API DeepSeek và lưu. Theo hướng dẫn, khóa chỉ ghi vào, trang web không đọc lại được, và được lưu trong file $DSH_HOME/.credentials.yaml.
4. Bấm Choose workspace, chọn thư mục dự án, rồi mở phiên mới và giao việc.

Ngoài DeepSeek, trang cấu hình cho thêm nhà cung cấp có sẵn như Anthropic, OpenAI, hoặc nhà cung cấp tùy chỉnh qua địa chỉ tương thích OpenAI, ví dụ cổng AI nội bộ của công ty. Bedrock, Vertex, Azure và Codex dùng cách xác thực riêng của từng nền tảng.

Mẹo

Trước khi viết plugin đầu tiên, chạy dsh --profile web --dump-config để xem bộ plugin thật sự đang được nạp trên máy. Giống mở nắp tủ điện xem sơ đồ đấu dây trước khi lắp thêm thiết bị.

Thử DeepSeek Harness với hai việc thật

Việc 1: tìm hiểu một repo bằng giao diện web. Sau khi chọn workspace, anh chị gõ câu mẫu trong hướng dẫn:

Summarize this repository and identify its main packages.

Agent đọc file, chạy lệnh và trả lời. Theo hướng dẫn, giao diện sẽ hỏi trước những thao tác cần duyệt theo chính sách quyền đang bật.

Việc 2: chạy việc định kỳ không cần giao diện. Profile headless chạy một phiên mới, in câu trả lời cuối rồi thoát, hợp để gắn vào lịch chạy tự động:

dsh --profile headless "run the tests"

Ai cần gọi từ chương trình riêng thì có Python SDK, cài bằng pip install deepseek-harness-sdk. Hướng dẫn lúc ra mắt ghi SDK cần Python 3.10 trở lên, chạy trên Linux x64, Linux arm64 hoặc macOS 14 trở lên trên chip arm64.

Lưu ý

• Bản xem trước. README viết in hoa rằng sẽ có thay đổi phá vỡ tương thích. Plugin viết hôm nay có thể phải sửa khi lên bản mới.
• Hệ điều hành của SDK. Hướng dẫn Python SDK không liệt kê Windows. Phần chạy bằng npm không nêu giới hạn hệ điều hành.
• Quyền của agent. Agent đọc, sửa file trong workspace và chạy lệnh. Hướng dẫn SDK khuyên dùng một workspace tách biệt mà agent được phép sửa.
• Dữ liệu đi đâu. Nội dung gửi tới nhà cung cấp model anh chị cấu hình. Dùng API DeepSeek thì dữ liệu đi qua máy chủ của DeepSeek; dùng cổng tùy chỉnh thì kiểm soát được nơi đi.

Phần mềm miễn phí theo giấy phép MIT, danh sách giấy phép thư viện bên thứ ba nằm trong THIRD_PARTY_NOTICES.md. Chi phí nằm ở lượt gọi model theo nhà cung cấp.

Nhận xét của chuyên gia

DeepSeek Harness đáng chú ý vì nó cho doanh nghiệp quyền tự chủ mà các bộ khung đóng không cho. Ba điều kiện của phòng IT ở đầu bài, với Harness, mỗi điều là một plugin hoặc một dòng cấu hình, không phải chờ hãng.

Hợp với ai: đội kỹ thuật muốn dựng agent nội bộ trên nhiều model; đơn vị cần nhật ký đầy đủ cho kiểm soát; người đã quen viết plugin bằng TypeScript.

Chưa hợp với ai: người cần công cụ ổn định để dùng hằng ngày ngay bây giờ, vì đây mới là bản xem trước; nhân viên văn phòng chưa quen dòng lệnh.

Cách bắt đầu của tôi: chạy profile web trên một repo thử, dùng khóa API có hạn mức thấp, đọc --dump-config để hiểu cây plugin, rồi mới viết plugin đầu tiên. Độ linh hoạt cao cũng có nghĩa là nhiều chỗ để cấu hình sai, nên đi từng bước nhỏ.

Một câu để nhớ: DeepSeek Harness không bán cho anh chị một chiếc xe, nó bán bộ khung gầm để anh chị tự lắp.

Anh chị muốn so với cách Anthropic mở nền tảng agent thì đọc lại bài Claude Agent SDK, và xem toàn cảnh trong dòng thời gian AI.

Câu hỏi thường gặp

DeepSeek Harness có chỉ dùng được model DeepSeek không?

Không. Ngoài DeepSeek, trang cấu hình hỗ trợ Anthropic, OpenAI, Bedrock, Vertex, Azure, Codex và nhà cung cấp tùy chỉnh tương thích OpenAI.

DeepSeek Harness có miễn phí không?

Phần mềm là mã nguồn mở theo giấy phép MIT. Anh chị trả tiền cho lượt gọi model theo nhà cung cấp mình chọn.

DeepSeek Harness khác gì Claude Code?

Claude Code là sản phẩm hoàn chỉnh của Anthropic. DeepSeek Harness là bộ khung mở, mọi phần kể cả vòng lặp agent đều thay được bằng plugin, nhưng đang ở bản xem trước nên chưa ổn định.

Cài DeepSeek Harness cần gì?

Cách nhanh nhất chỉ cần Node.js và lệnh npx @deepseek-ai/dsh web. Chạy từ mã nguồn cần thêm Git và pnpm.

Nguồn: deepseek-ai/deepseek-harness trên GitHub, 13/08/2026.