Tracks
Cơ bản về Trợ lý Trí tuệ Nhân tạo
6 giờ
DeepSeek Harness là gì?
DeepSeek Harness, viết tắt là dsh, là một agent harness mã nguồn mở từ DeepSeek AI theo giấy phép MIT. Nó nằm giữa một mô hình ngôn ngữ và thế giới bên ngoài, cung cấp công cụ, phiên, sandbox và vòng lặp giúp nhiệm vụ tiếp tục diễn tiến.
Cách nhìn của DeepSeek là "Agent = Model + Harness." Mô hình đảm nhận suy luận và sinh nội dung. Harness là mọi thứ cho phép suy luận đó tác động lên hệ thống tệp thực và tiếp tục mà bạn không phải giải thích lại nhiệm vụ ở mỗi bước.
Nó chạy trên Cordis, một khung plugin có trước DeepSeek Harness. Cordis cho phép cấu hình thay thế các phần này một cách độc lập. Tôi sẽ quay lại chi phí của lựa chọn đó ở phần sau.
Với khung này, dưới đây là hai hiểu lầm thường gặp.
DeepSeek Harness không phải một mô hình AI
Như đã đề cập, mô hình và runtime là hai lớp riêng. Sự tách biệt đó cho phép bạn thay nhà cung cấp mà không đổi công cụ hay thiết lập phiên. Cùng một runtime có thể dùng DeepSeek, Anthropic, OpenAI hoặc một endpoint tương thích OpenAI.
DeepSeek Harness nhiều hơn một trợ lý viết code
Chế độ Standard tạo cảm giác như một trợ lý code, nhưng đó chỉ là một cấu hình. Như sẽ trình bày sau, các chế độ Minimal và Creator thay đổi những gì agent có thể dùng. Xây dựng cấu hình mới vẫn cần công sức kỹ thuật; nhà phát triển có quyền truy cập các bộ phận.
Cordis tổ chức plugin của DeepSeek Harness như thế nào
Như đã nói, Cordis là khung plugin bên dưới DeepSeek Harness. Nó cho phép mỗi phần yêu cầu một dịch vụ mà không bị ràng buộc vào mã của một nhà cung cấp duy nhất.
Cordis xuất phát từ hệ sinh thái chatbot Koishi và được xây dựng bởi một nhà phát triển có tên Shigma; DeepSeek phân phối và mở rộng nó. Tác giả mô tả thiết kế trong bài báo A Programming Paradigm for Spatiotemporal Composability.
Những điều cơ bản đó dẫn đến khẩu hiệu chính của dự án và hai thuật ngữ Cordis. Tên nghe học thuật, nhưng hành vi khá đơn giản.
"Mọi thứ đều là plugin"
Tài liệu kiến trúc của DeepSeek nói bạn mở rộng dsh bằng cách gắn một plugin bên cạnh các plugin khác. Bộ chuyển đổi mô hình, công cụ, phiên, sandbox, lưu trữ, lập lịch, vòng lặp agent và giao diện người dùng đều là plugin.
Nếu hiểu theo nghĩa đen, khẩu hiệu đó đi quá xa. Cordis vẫn nằm dưới các plugin. Nó tải và gỡ chúng, kiểm tra những gì chúng cần và chạy các sự kiện chúng dùng để liên lạc với nhau. Cordis là bắt buộc, không phải một mảnh tùy chọn nữa.
Tính lắp ghép theo không gian quản lý phụ thuộc plugin
Một plugin khai báo các dịch vụ nó cần mà không yêu cầu chuỗi khởi động viết tay. Nó kích hoạt khi các dịch vụ đó tồn tại và hủy kích hoạt nếu một dịch vụ bắt buộc biến mất. Phụ thuộc quyết định khi nào nó có thể chạy.
DeepSeek gọi đây là tính lắp ghép theo không gian. Phụ thuộc cho Cordis biết một thành phần nằm ở đâu, để nhà phát triển không phải sắp xếp thứ tự khởi động bằng tay.
Tính lắp ghép theo thời gian gỡ cuộn hiệu ứng plugin
Cordis cũng theo dõi các đăng ký như bộ lắng nghe sự kiện, phần nhắc (prompt) và schema công cụ. Gỡ một plugin sẽ gỡ các hiệu ứng đó thay vì để lại bộ lắng nghe mồ côi. Điều này không hoàn tác hành động bên ngoài như lệnh shell; tính đảo ngược chỉ áp dụng cho các hiệu ứng Cordis theo dõi.
Kiến trúc DeepSeek Harness: Các lớp runtime khớp với nhau ra sao
Một phiên bản đang chạy là một cây plugin được dựng từ các thiết lập tải theo thứ tự xác định. Những thiết lập đó quyết định phần nào đang hoạt động.
Cordis kết nối mọi plugin runtime có thể thay thế. Ảnh: Tác giả.
Dịch vụ Cordis giúp plugin tìm thấy nhau
Cordis cung cấp một danh bạ dịch vụ dùng chung. Plugin dùng các khóa ổn định như ctx.tools, ctx.llm, và ctx.sessions thay vì import mã của một nhà cung cấp. Một công cụ gọi ctx.llm không cần biết bộ chuyển đổi mô hình nào ở phía sau.
Agent preset và hồ sơ runtime kiểm soát các lớp khác nhau
Nếu mọi thứ đều có thể thay thế, thì vẫn cần cái gì đó quyết định gắn gì cho một phiên chạy cụ thể, và DeepSeek Harness trả lời ở hai lớp dễ nhầm lẫn.
Phiên bản ngắn gọn: một hồ sơ (profile) kiểm soát cách chương trình khởi động, còn một preset kiểm soát agent có thể làm gì. Nếu bạn chỉ dùng web app, có thể bỏ qua hai tiểu mục tiếp theo.
Hồ sơ runtime
Một hồ sơ runtime (web, headless, sdk, sdk-minimal, và acp được cung cấp dạng mẫu) quyết định cách ứng dụng khởi động và những gói plugin Cordis nào được xếp chồng lúc boot. Đa số người đọc sẽ chỉ đụng lớp này khi chạy dsh web hoặc lệnh tương tự.
Agent preset
Một agent preset (Standard, PTC, Minimal hoặc Creator) quyết định một phiên đang hoạt động có thể dùng gì. Một tệp patch có thể thay đổi preset mà không cần chạm vào mã nguồn của Harness.
Vòng lặp agent điều phối lượt, bước và gọi công cụ
DeepSeek phân biệt một bước (step) với một lượt (turn). Một bước là một yêu cầu mô hình cộng với các lần gọi công cụ của nó. Một lượt gồm không hoặc nhiều bước: nó mở trước khi nhận đầu vào đầu tiên và đóng khi không còn điều gì tồn đọng. Hầu hết lượt chạy vài bước trước khi agent có thể trả lời, nhưng một đầu vào bị từ chối sẽ đóng một lượt mà không tốn bước nào.
Một lượt có thể chứa nhiều bước. Ảnh: Tác giả.
Phiên dùng nhật ký sự kiện chỉ-ghi
Đây là phần tôi cho là quan trọng nhất. Một phiên là nhật ký chỉ-ghi của các sự kiện có kiểu, không phải mảng tin nhắn chat. Harness dựng lịch sử của mô hình từ nhật ký đó, và tài liệu phiên yêu cầu bất kỳ thứ gì gửi đến mô hình đều phải có thể khôi phục từ đó.
Tiếp tục, phân nhánh, tìm kiếm, phát lại và giao diện Trajectory đều xây trên dòng sự kiện đó.
Dựng lại lịch sử không phải là chạy lại tất định. Đầu ra mô hình và trạng thái bên ngoài có thể khác, nhưng nhật ký vẫn cung cấp bản ghi có thể kiểm tra được về những gì đã xảy ra.
Lịch sử phiên là một nhật ký chỉ-ghi. Ảnh: Tác giả.
DeepSeek Harness kiểm soát công cụ và sandbox như thế nào
Một mô hình có thể yêu cầu một công cụ theo tên, nhưng không được tự chạy trực tiếp. Hai lớp kiểm soát tách biệt đứng giữa yêu cầu và thay đổi trên hệ thống tệp.
Pipeline thực thi công cụ
Lời gọi đi qua kiểm tra chính sách, thực thi và xử lý kết quả. Mô hình chọn công cụ; runtime quyết định có chạy và chạy như thế nào.
Runtime quyết định cách công cụ chạy. Ảnh: Tác giả.
Sandbox so với phê duyệt
- Phê duyệt hỏi liệu người dùng có nên xác nhận một hành động hay không.
- Sandbox giới hạn nơi và cách hành động được thực thi.
DeepSeek tách riêng chúng, dù preset quyền hạn gói cả hai loại kiểm soát, giống như một runtime container tách quyền tiến trình khỏi ranh giới thực thi.
Đáng lưu ý trước, vì tôi sẽ quay lại ở phần hạn chế: bảo mô hình trong system prompt "chỉ đọc tệp" là một gợi ý nó có thể làm theo, không phải ranh giới cưỡng chế như hạn chế sandbox ở cấp hệ điều hành.
Chế độ DeepSeek Harness: Standard, PTC, Minimal và Creator
DeepSeek Harness cung cấp bốn chế độ khác nhau. Không chế độ nào trong bốn cái này cao hơn cái khác. Chúng là bốn câu trả lời cho câu hỏi "nên phơi bày bao nhiêu phần của runtime cho phiên này," và lựa chọn đúng phụ thuộc vào nhiệm vụ. Như phần kiến trúc đã chỉ ra, mỗi chế độ thay đổi tập công cụ sẵn có cho agent.
Bốn chế độ dùng chung một nền tảng runtime. Ảnh: Tác giả.
Chế độ Standard
Mức cơ bản đa dụng:
- Chỉnh sửa tệp
- Truy cập shell
- Tìm kiếm tệp và web
- Kỹ năng
- Lập kế hoạch
- Mục tiêu
- Subagent
- Workflow
Với công việc kho mã thông thường, đây là nơi tôi sẽ bắt đầu.
Chế độ PTC
Chế độ PTC giữ gần như toàn bộ bộ công cụ của Standard nhưng thay đổi cách mô hình truy cập. (Từ phiên bản 0.1.2, PTC trên Web không còn mặc định phơi bày công cụ workflow đa dụng.)
Thay vì yêu cầu từng công cụ qua nhiều bước mô hình, mô hình viết một chương trình dựa trên SDK được tạo. Chương trình đó có thể gọi nhiều công cụ thông qua run_code. Mỗi lời gọi vẫn đi qua cùng kiểm tra chính sách, nên PTC thay đổi cách mô hình trình bày kế hoạch, không phải thay đổi quyền hạn được phép.
Trang sản phẩm vẫn dùng nhãn "Code mode," nhưng bản phát hành chính thức mới hơn đã đổi tên thành PTC mode trong khi vẫn giữ khả năng đọc các bản ghi hội thoại cũ. Tôi sẽ dùng PTC mode nhất quán; mục FAQ sẽ bàn về ý nghĩa của chữ viết tắt này.
Chế độ Minimal
Chế độ Minimal lược giản môi trường xuống còn hai công cụ: shell lưu trạng thái và trình chỉnh sửa tệp dạng thay thế chuỗi. DeepSeek dùng nó cho benchmark mô hình vì kết quả kiểm thử phụ thuộc một phần vào harness của mô hình, không chỉ vào trọng số.
Chế độ Creator
Chế độ Creator cho phép nhà phát triển kiểm tra runtime và thử plugin Cordis trong bộ nhớ. Nó dành cho xây dựng preset, và tôi sẽ không gọi nó là tự cải thiện ở nghĩa sâu hơn.
Điều gì làm DeepSeek Harness khác với các framework agent khác?
DeepSeek Harness khác nhiều framework agent ở chỗ cho phép thay thế các phần thấp của runtime. Tôi suýt gộp phần này vào kiến trúc, nhưng rất dễ bỏ lỡ khác biệt. Cordis xử lý các thay đổi đó qua một hệ thống plugin duy nhất.
Bạn có thể thay đổi cách agent vận hành, không chỉ các công cụ nó có thể gọi. Nhật ký sự kiện cũng tạo ra một phiên chạy mà nhà phát triển có thể kiểm tra, thay vì chỉ đọc như bản chép chat. Hai chế độ Minimal và Creator sau đó cho phép họ kiểm thử runtime từ hai hướng ngược nhau.
DeepSeek Harness so với Claude Code, Codex và OpenCode
Một bảng đánh dấu tính năng sẽ bỏ lỡ trọng tâm. Mỗi đối thủ đều hỗ trợ mở rộng; câu hỏi hữu ích là nhà phát triển có thể thay đổi phần nào. Khác biệt nghe nhỏ, nhưng không hề nhỏ. Bài so sánh chuyên sâu giữa Harness và Claude Code của chúng tôi dùng cùng một mô hình cho cả hai và đề cập thiết lập, nhật ký và chi phí.
DeepSeek Harness so với Claude Code
Claude Code hỗ trợ hướng dẫn dự án, kỹ năng, hook, MCP, subagent và Agent SDK, và giữ vòng lặp tích hợp cố định. DeepSeek Harness cho phép nhà phát triển thay thế vòng lặp, bộ chuyển đổi mô hình và lớp lưu trữ thông qua cấu hình.
DeepSeek Harness so với Codex
Codex cần so sánh cẩn trọng hơn vì CLI và App Server của nó cũng mã nguồn mở. Nó cung cấp một agent harness mà nhà phát triển mở rộng qua các điểm vào được tài liệu hóa. DeepSeek Harness được xây quanh việc thay đổi chính runtime. Hai bên cung cấp mức độ kiểm soát khác nhau.
DeepSeek Harness so với OpenCode
OpenCode đã là mã nguồn mở, làm việc với nhiều nhà cung cấp mô hình và dùng kiến trúc client-server. Bạn có thể cấu hình công cụ, quyền hạn, phien và nhà cung cấp. Plugin của nó mở rộng một lõi máy chủ cố định, trong khi DeepSeek còn cho phép thay thế vòng lặp và kho phiên.
Khi nào nên dùng DeepSeek Harness
Việc thay thế các phần runtime tự thân không hữu ích. Quyền kiểm soát bổ sung chỉ có ý nghĩa khi nó giải quyết vấn đề bạn đang có.
- Khi chính runtime là một phần của dự án. Nếu bạn đang sửa đổi bộ chuyển đổi mô hình, vòng lặp agent, lưu trữ hoặc hành vi phiên, không chỉ xây trên một agent có sẵn, đây là sự phù hợp trực tiếp hơn.
- Khi bạn so sánh mô hình trong môi trường kiểm soát. Dùng cùng runtime giữ nhiều yếu tố kiểm thử cố định hơn khi hoán đổi mô hình, dù các mô hình vẫn có thể khác nhau về cách dùng công cụ và phong cách suy luận.
- Khi việc gỡ lỗi một phiên chạy phức tạp là quan trọng. Nhật ký sự kiện phiên và giao diện Trajectory giúp dễ tái dựng mô hình đã thấy gì và công cụ nào đã chạy.
- Khi bạn kiểm thử nội bộ agent. Chế độ Creator và Cordis dành cho nhà phát triển nghiên cứu cách ghép nối agent, hơn là người chỉ cần code ứng dụng được viết sẵn.
Nó có thể là không cần thiết cho các lần gọi mô hình đơn giản hoặc cho đội ngũ muốn một agent viết code sẵn có mà không cần đụng vào phần nội bộ. Việc thay thế nhiều phần chỉ đáng công khi quyền kiểm soát đó giải quyết một vấn đề thực.
Hạn chế của DeepSeek Harness: Trạng thái xem trước và rủi ro bảo mật
Mọi điều về kiến trúc ở trên không có nhiều ý nghĩa nếu không nêu rõ những điểm còn thiếu hôm nay.
Vẫn là bản xem trước cho nhà phát triển
Kho của DeepSeek nêu rõ sẽ có thay đổi phá vỡ. Điều này đã xảy ra: đổi tên Code thành PTC đi kèm thay đổi API phiên và loại bỏ tùy chọn lưu trữ SQLite tùy chọn. Hãy cố định phiên bản. Bỏ qua bước đó và hy vọng thiết lập ổn định không phải là kế hoạch.
Nhiều kiểm soát hơn cũng đồng nghĩa nhiều phức tạp hơn
Việc cho phép thay thế nhiều phần của runtime cũng khiến nhà phát triển phải học nhiều hơn: phụ thuộc plugin, thiết lập, khác biệt nhà cung cấp và tương thích phiên bản. Đây là đánh đổi quen thuộc giữa tiện lợi và kiểm soát.
DeepSeek Harness có lưu trữ cục bộ không?
Theo tuyên bố xử lý dữ liệu của họ, DeepSeek Harness lưu nội dung phiên, bản ghi công cụ và thiết lập cục bộ theo mặc định. Bạn có thể tắt báo cáo ẩn danh về thiết lập và danh sách dự án.
Nhưng một nhà cung cấp mô hình bên ngoài, công cụ web, máy chủ MCP hoặc plugin vẫn có thể gửi dữ liệu ra ngoài máy của bạn theo chính sách riêng. "Ưu tiên cục bộ" không bao trùm mọi dịch vụ bạn kết nối.
Chạy agent đi kèm rủi ro bảo mật
Một runtime có thể chỉnh sửa tệp, chạy lệnh và tải plugin bên thứ ba có thể gây hư hại thực sự. Thông báo an toàn của DeepSeek cho biết dự án chưa được kiểm định bảo mật. Sandbox, phê duyệt và kiểm soát quyền hạn giảm rủi ro nhưng không đảm bảo cô lập.
Chạy phần mềm trên máy của bạn không loại bỏ rủi ro đó. Hãy dùng quyền hạn hạn chế và môi trường có thể bỏ đi cho công việc không tin cậy, và cẩn trọng với nội dung có thể chứa chỉ dẫn ẩn.
Vì sao hành vi agent phụ thuộc vào nhiều thứ hơn là mô hình
Hành vi của agent phụ thuộc vào runtime cũng như mô hình. Điều này quay lại "Agent = Model + Harness," và sự phân tách đó áp dụng cho agent LLM vượt DeepSeek.
Những gì một mô hình có thể sinh ra phụ thuộc vào trọng số của nó. Những gì một agent làm còn phụ thuộc vào ngữ cảnh nào đến được mô hình, hành động nào nó được phép thực hiện và mức độ ràng buộc thực thi chặt chẽ đến đâu. Những điều đó không nằm trong trọng số.
DeepSeek Harness cho thấy lớp bao quanh đó bằng cách tách nó thành các phần được đặt tên mà nhà phát triển có thể thay thế. Chế độ Minimal cho thấy vì sao điều này quan trọng vượt ra ngoài DeepSeek: điểm benchmark phần nào phản ánh harness dùng cho bài kiểm, không chỉ mô hình. Harness không làm mô hình thông minh hơn. Nó thay đổi bối cảnh mô hình làm việc.
Kết luận
Câu ở phần mở đầu là điều đáng nhớ: mô hình suy luận, nhưng runtime quyết định suy luận đó có thể chạm tới và làm được gì. DeepSeek Harness khiến runtime đó có thể chỉnh sửa, từ bộ chuyển đổi mô hình và công cụ đến kho phiên và vòng lặp agent.
Quyền kiểm soát đó đi kèm chi phí. Thay thế nhiều phần của runtime đồng nghĩa bạn phải sở hữu nhiều hơn phần thiết lập, thay đổi phiên bản và ranh giới bảo mật của nó. Một bản xem trước cho nhà phát triển có quyền shell không phải thứ cài rồi quên.
Quan điểm của tôi đơn giản: dùng DeepSeek Harness khi chính runtime là một phần của công việc. Nếu bạn chỉ cần chỉnh sửa kho mã, một agent viết code sẵn có đòi hỏi ít công sức hơn.
Bài hướng dẫn DeepSeek Harness của chúng tôi đề cập thiết lập. Hướng dẫn các lựa chọn thay thế Claude Code so sánh thêm nhiều agent viết code, trong khi Giới thiệu về AI Agents trình bày những điều cơ bản mà bài viết này giả định.
