DeepSeek Harness (dsh): Agent harness “Everything is a plugin” cho developer

Tóm tắt nhanh:

• DeepSeek Harness (dsh) là một agent harness mã nguồn mở, nơi “mọi thứ đều là plugin”, cho phép bạn lắp ghép agent, tool, UI và workflow như lego thay vì bị khóa vào một framework cứng nhắc.
• Bạn có thể chạy Web UI chỉ với một lệnh npx @deepseek-ai/dsh web hoặc clone source, build bằng pnpm, sau đó mở một môi trường agent AI linh hoạt, mở rộng được, phù hợp để xây dựng AI agent self-hosted và tích hợp vào hệ thống của riêng bạn.

DeepSeek Harness (dsh) là một open-source agent harness do DeepSeek AI phát triển, được thiết kế để trở thành lớp điều phối agent trung tâm cho nhiều mô hình và plugin khác nhau. Điểm cốt lõi của dsh là kiến trúc “everything is a plugin”: gần như mọi thành phần trong hệ thống đều là plugin có thể thay thế, từ agent, tool cho đến bộ phận UI và tích hợp backend.

dsh được xây dựng trên Cordis, một framework được mô tả trong bài nghiên cứu “A Programming Paradigm for Spatiotemporal Composability”, nhấn mạnh khả năng kết hợp các behavior theo không gian và thời gian. Điều này giúp bạn dễ dàng lắp ghép nhiều agent, workflow và nguồn dữ liệu khác nhau để tạo ra hành vi phức tạp mà vẫn giữ kiến trúc tương đối trong sáng, testable.

Trạng thái developer preview và cảnh báo breaking changes

Hiện tại DeepSeek Harness đang ở trạng thái developer preview và nhóm phát triển nhấn mạnh rất rõ rằng sẽ còn có nhiều thay đổi phá vỡ backward compatibility. Điều này nghĩa là cấu trúc plugin, API, thậm chí cách tổ chức repo và command line có thể thay đổi giữa các bản release, nên bạn không nên coi dsh ở thời điểm này như một nền tảng “LTS” để build sản phẩm thương mại đã đóng băng lâu dài.

Tuy vậy, developer preview cũng là cơ hội tốt để bạn đi trước đường cong, hiểu kiến trúc tương lai của agent harness “mọi thứ là plugin”, và góp ý để giúp dự án chín muồi hơn. Nếu bạn quen với việc theo dõi changelog, pin version, và wrap dsh phía sau một lớp adapter riêng, thì rủi ro breaking changes hoàn toàn có thể quản lý được trong môi trường production.

Kiến trúc “Everything is a plugin” và Cordis

Triết lý chính của DeepSeek Harness là “DeepSeek Harness: Everything is a Plugin”, được nhắc lại ngay trong phần giới thiệu của dự án. Thay vì hard-code logic của agent, tools, UI, connector vào core framework, dsh coi chúng như plugin Cordis, giúp bạn dễ dàng thêm, gỡ bỏ hoặc thay thế từng phần mà không phải fork core.

Cordis đóng vai trò nền tảng cho composability: bạn có thể định nghĩa các plugin xử lý từng giai đoạn trong thời gian (spatiotemporal), ví dụ routing request, quản lý context, truy cập tool, ghi log, v.v. Cách tiếp cận này đặc biệt phù hợp nếu bạn đang xây dựng một hệ agent phục vụ nhiều product team khác nhau, cần khả năng mở rộng mà vẫn giữ chung một “spine” kiến trúc.

Cài đặt nhanh bằng npm: Chỉ một lệnh

Cách nhanh nhất để thử DeepSeek Harness là chạy trực tiếp từ npm, chỉ yêu cầu bạn đã cài Node.js trên máy. Theo hướng dẫn trong README, bạn chỉ cần:

npx @deepseek-ai/dsh web

Lệnh này sẽ cài (nếu chưa có) và chạy dsh dưới dạng Web UI, phục vụ mặc định tại http://127.0.0.1:3080 trên máy của bạn. Đây là cách phù hợp nếu bạn muốn thử nghiệm nhanh UI, trải nghiệm flow agent, demo cho team hoặc khám phá cấu trúc plugin mà không phải setup môi trường phức tạp.

Chạy từ source với pnpm cho môi trường dev nghiêm túc

Khi muốn tùy biến sâu hơn (ví dụ chỉnh sửa core logic, thêm plugin nội bộ, đóng góp code), bạn nên chạy từ source theo hướng dẫn chính thức. Dự án dùng pnpm làm package manager và cấu trúc monorepo với nhiều package con, nên bạn sẽ quen thuộc nếu đã từng làm việc với các repo TypeScript lớn.

Quy trình cài đặt từ source như sau:

# Clone repository
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness

# Cài dependency
pnpm install

# Build toàn bộ workspace
pnpm run build

# Chạy Web UI
pnpm dsh web

Sau khi chạy pnpm dsh web, bạn cũng sẽ có Web UI tại http://127.0.0.1:3080 tương tự như khi chạy bằng npx, nhưng lần này toàn bộ code nằm trên máy và bạn có thể sửa, gắn debugger, hoặc thêm plugin ngay trong repo. Đây là con đường phù hợp nếu bạn dự định biến dsh thành một phần hạ tầng agent dài hạn trong công ty, cần kiểm soát version và hội nhập CI/CD.

Bức tranh repo: Apps, native, Python và website

DeepSeek Harness là một monorepo khá lớn với nhiều folder con: apps, native, python, packages, website, examples và hơn thế nữa. apps chứa các ứng dụng như Web UI, trong khi packages tập trung các package core, plugin và tiện ích được chia nhỏ phục vụ nhiều bối cảnh khác nhau.

Có thư mục native và python, gợi ý rằng dsh không chỉ gói gọn trong JavaScript/TypeScript mà còn có thành phần native runner và binding Python đi kèm. Website docs cũng nằm trong repo (thư mục website), cùng với tài liệu như BENCHMARK.md, AGENTS.md, CONTRIBUTING.md, tạo điều kiện để bạn hiểu sâu hơn về kiến trúc và cách viết agent, plugin.

License, ngôn ngữ và mức độ mở của dự án

Dự án sử dụng giấy phép MIT cho các package DSH, cho phép bạn dùng trong sản phẩm thương mại, fork, đóng gói lại hoặc tự host trong hạ tầng của riêng mình. Điều này rất hấp dẫn nếu bạn đang tìm một agent harness open-source để tự xây dựng nền tảng agent của công ty thay vì lệ thuộc hoàn toàn vào SaaS đóng.

Theo thống kê ngôn ngữ trên GitHub, repo sử dụng khoảng 97,1% TypeScript, 1,6% CSS, cùng một ít Python, JavaScript, Shell và C. Con số này cho thấy nền tảng chính của dsh là TypeScript, phù hợp với developer đã quen với ecosystem Node.js, React, Vite, PNPM và tooling hiện đại.

Cộng đồng, plugin dsh-plugin và con đường đóng góp

DeepSeek Harness khuyến khích cộng đồng tham gia thông qua GitHub Discussions, nơi bạn có thể gửi feedback, bug report và đề xuất tính năng. Ngoài ra, dự án còn có Discord community riêng cho dsh, giúp bạn trao đổi trực tiếp với team và các contributor khác về plugin, use case và best practice.

Nếu bạn viết plugin cho dsh, README gợi ý thêm topic dsh-plugin vào repo plugin của mình trên GitHub để dễ được cộng đồng tìm thấy. Việc đóng góp code được hướng dẫn trong CONTRIBUTING.md, với phiên bản i18n nhiều ngôn ngữ, cho thấy dự án rất chú trọng chiều sâu cộng đồng và khả năng địa phương hoá.

Nếu bạn là developer hoặc entrepreneur đang xây hệ thống AI agent tự động hoá nhiệm vụ nội bộ, DeepSeek Harness là một “control plane” giàu tiềm năng để thử nghiệm. Bạn có thể bắt đầu với lệnh npx @deepseek-ai/dsh web để trải nghiệm nhanh, sau đó chuyển sang chạy từ source để thêm plugin tùy chỉnh, kết nối mô hình yêu thích (DeepSeek, các LLM khác) và dần dần hoá dsh thành nền tảng agent thống nhất cho toàn tổ chức.

Khi đã quen với kiến trúc “everything is a plugin”, bạn có thể tách phần agent logic khỏi product cụ thể, cho phép nhiều ứng dụng khác nhau (dashboard, CLI, bot, extension) dùng chung một lớp agent core. Trong bối cảnh hệ sinh thái AI agent đang phát triển rất nhanh, việc nắm vững một harness linh hoạt, open-source và MIT như DeepSeek Harness là lợi thế đáng kể cho bất kỳ đội ngũ kỹ thuật nào.