DeepSeek Harness: Framework Agent Mã Nguồn Mở
/deepseek-harness
DeepSeek Harness biến mọi tính năng thành một plugin có thể tháo lắp, dùng Cordis để giữ các thành phần rời rạc nhưng vẫn ăn khớp với nhau thay vì rối vào nhau. Đây là hướng thiết kế thực sự hữu ích nếu bạn đang xây hệ thống agent cần mở rộng — điểm cần lưu ý là nhãn developer preview không phải chỉ để cho có: các thay đổi phá vỡ tương thích đã được báo trước, nên mọi thứ bạn xây trên đó lúc này nên coi là tạm thời cho tới khi có bản ổn định.
Tìm hiểu DeepSeek Harness
DeepSeek Harness là một agent harness mã nguồn mở, nơi mọi thứ đều vận hành như một plugin, chạy trên nền Cordis. Nhà phát triển có bộ công cụ viết bằng TypeScript để xây và ghép các khả năng của agent, kèm Web UI chạy tại máy để test trực tiếp. Kiến trúc Cordis xử lý phần mô hình khả năng kết hợp bên dưới, được mô tả trong bài báo riêng của họ về mô hình lập trình.
Kiến trúc lõi và khả năng
- ✓Kiến trúc plugin-first: mọi khả năng trong DeepSeek Harness đều là một plugin có thể thay thế
- ✓Chạy trên nền Cordis: hiện thực mô hình khả năng kết hợp theo không-thời gian như mô tả trong bài báo riêng về mô hình lập trình
- ✓Toàn bộ viết bằng TypeScript: cả harness lẫn plugin SDK đều dùng TypeScript
- ✓Web UI chạy tại máy: mở giao diện trình duyệt tại http://127.0.0.1:3080 để tương tác và debug
- ✓Dễ tìm plugin: repository gắn topic dsh-plugin trên GitHub sẽ được nhận diện như một plugin mở rộng
- ✓Giấy phép MIT: mã nguồn mở đầy đủ, license của các dependency bên thứ ba công khai trong THIRD_PARTY_NOTICES.md
- ✓Kênh cộng đồng: có Discord server và GitHub Discussions để hỗ trợ và chia sẻ plugin
- ✓Đang ở giai đoạn developer preview: cập nhật liên tục, có báo trước các thay đổi phá vỡ tương thích
Bắt đầu với DeepSeek Harness
Chỉ cần Node.js. Chạy trực tiếp harness mà không cần clone bằng lệnh `npx @deepseek-ai/dsh web`. Nếu muốn phát triển plugin hoặc build từ mã nguồn, clone repository rồi chạy `pnpm install` và `pnpm run build`.
Chạy Web UI
Chạy `npx @deepseek-ai/dsh web` để mở Web UI, mặc định phục vụ tại `http://127.0.0.1:3080`. Với repository đã clone, build bằng `pnpm run build` rồi chạy `pnpm dsh web`. Giao diện này cho phép tương tác với plugin đã nạp và test hành vi agent ngay tại máy.
Điểm mạnh
- ✓Kiến trúc plugin cho phép thay hoặc mở rộng hành vi lõi mà không cần fork codebase
- ✓Cordis lo phần khả năng kết hợp, nên bạn được thừa hưởng sẵn một mô hình tương tác giữa các thành phần đã định nghĩa rõ ràng
- ✓Viết bằng TypeScript nên plugin API có type-safe và được IDE hỗ trợ ngay từ đầu
- ✓Giấy phép MIT không giới hạn mục đích thương mại cho cả dự án nội bộ lẫn mã nguồn mở
- ✓DeepSeek AI đang phát triển tích cực, cho thấy vẫn tiếp tục đầu tư vào năng lực của framework
Tình trạng phát triển hiện tại
- △Đang ở giai đoạn developer preview nên chắc chắn sẽ có thay đổi phá vỡ tương thích giữa các bản
- △Chưa có cam kết ổn định cho production — README nói rõ không nên phụ thuộc vào API hiện tại
- △Hệ sinh thái plugin còn non trẻ, nên plugin sẵn có cho các tác vụ phổ biến hiện còn hạn chế
- △Tài liệu tập trung vào kiến trúc và hướng dẫn phát triển hơn là luồng sử dụng cho người dùng cuối
- △Mô hình khả năng kết hợp của Cordis đưa ra khái niệm riêng, cần đọc bài báo về mô hình lập trình mới dùng hiệu quả được
Các framework agent khác
Câu hỏi thường gặp về DeepSeek Harness
DeepSeek Harness dùng giấy phép MIT. License của các dependency bên thứ ba được liệt kê riêng trong file THIRD_PARTY_NOTICES.md trong repository.
Chưa. Dự án đang ở giai đoạn developer preview và README cảnh báo rõ sẽ có thay đổi phá vỡ tương thích. Không nên triển khai trong production.
Các repository plugin gắn topic dsh-plugin trên GitHub sẽ trở thành một phần của hệ sinh thái plugin có thể tìm thấy được cho DeepSeek Harness.
Cordis là nền tảng cho kiến trúc plugin. DeepSeek Harness dùng cách tiếp cận khả năng kết hợp theo không-thời gian của Cordis, được mô tả trong một bài báo riêng về mô hình lập trình.
Cần có Node.js. Không có yêu cầu runtime nào khác được nhắc tới. Chạy qua npx thì mọi thứ tự động; nếu build từ mã nguồn thì cần thêm pnpm.
DeepSeek Harness có Discord server và trang GitHub Discussions để gửi phản hồi, báo lỗi, và trao đổi với các nhà phát triển khác.
Bài toán mà nó giải quyết
Xây một hệ thống agent có thể mở rộng đòi hỏi phải tự thiết kế giao diện plugin, quản lý vòng đời, và khả năng kết hợp linh hoạt ngay từ đầu. Phần lớn framework khác khoá cứng bạn vào một tập tính năng cố định, khiến việc thay hoặc mở rộng hành vi lõi tốn công refactor đáng kể. DeepSeek Harness cung cấp một harness lấy plugin làm gốc, nơi bài toán khả năng kết hợp đã được giải sẵn thông qua Cordis.
Trường hợp sử dụng tốt nhất
- •Viết hành vi agent tuỳ chỉnh bằng cách tạo plugin móc vào vòng đời của harness
- •Dựng thử luồng làm việc multi-agent khi cần ghép nhiều khả năng khác nhau một cách linh hoạt
- •Nghiên cứu hoặc tìm hiểu mô hình khả năng kết hợp theo không-thời gian bằng Cordis trên một codebase thực tế
- •Mở rộng framework bằng các plugin có thể tìm thấy qua hệ sinh thái topic dsh-plugin trên GitHub
- •Thử nghiệm ý tưởng agent của DeepSeek AI trong môi trường phát triển local trước khi cam kết một kiến trúc lớn hơn
Ai nên dùng — và ai nên bỏ qua
Người viết plugin và các team đang thử nghiệm kiến trúc agent theo module là đối tượng tận dụng được DeepSeek Harness nhiều nhất lúc này — mô hình khả năng kết hợp là thật và SDK TypeScript đã dùng được ngay hôm nay. Ai cần API ổn định cho production, một kho plugin trưởng thành, hoặc không muốn rủi ro từ các thay đổi phá vỡ tương thích thì nên chờ thêm — trạng thái developer preview ở đây không phải chỉ là hình thức. TypeScript là bắt buộc cho phần phát triển lõi, nên team chưa dùng stack này sẽ tốn thêm công sức thiết lập trước khi viết plugin đầu tiên.
Repo liên quan
Muốn nghe thêm một ý kiến về deepseek-harness?
Hỏi một AI đọc được trang này — một cú bấm là có ngay nhận định về deepseek-harness.