Hướng dẫn tác nhân Flaq AI

Hướng dẫn thực hành sử dụng DeepSeek Harness với API tương thích OpenAI của Flaq AI

Chạy giao diện web mã nguồn mở DeepSeek Harness với endpoint tương thích OpenAI của Flaq AI, sau đó kết nối một mô hình DeepSeek v4 được hỗ trợ để phân tích kho mã và thực hiện các quy trình lập trình. DeepSeek Harness tuân theo kiến trúc “mọi thứ đều là plugin”: bộ chuyển đổi mô hình, công cụ, vòng lặp agent, bộ nhớ phiên, quyền, sandbox, phép đo từ xa và giao diện web đều có thể được kết hợp hoặc thay thế thông qua plugin và cấu hình.

Hướng dẫn tác nhân

Claude Code/cc-apiOpenAI Codex/codex-api/v1Hermes Agent/api/v1DeepSeek Harness/api/v1ZCode/api/v1

Cài đặt

Chạy DeepSeek Harness

DeepSeek Harness yêu cầu Node.js 22.19+ hoặc bản phát hành 24+. Hãy khởi chạy từ thư mục dự án mà bạn muốn dùng làm vị trí hệ thống tệp mặc định; theo mặc định, lệnh npm chính thức sẽ khởi chạy giao diện web tại http://127.0.0.1:3080.

1

Chạy giao diện web DeepSeek Harness

Sử dụng gói npm chính thức để khởi chạy giao diện web. Giữ terminal này hoạt động trong khi bạn sử dụng DeepSeek Harness.

Lần chạy đầu tiên sẽ tải gói @deepseek-ai/dsh hiện tại và khởi tạo hồ sơ giao diện web.

Lệnh npm chính thức

npx @deepseek-ai/dsh web

Kho mã: Xem hướng dẫn cài đặt mới nhất, các bản phát hành, ghi chú về khả năng tương thích và mã nguồn trong kho mã DeepSeek Harness chính thức trên GitHub.

Cấu hình

Kết nối DeepSeek Harness với Flaq AI

Mở Settings → Models trong DeepSeek Harness, thêm Flaq AI làm nhà cung cấp tùy chỉnh và nhập khóa API Flaq của bạn. Provider ID không thể thay đổi sau khi lưu, vì vậy hãy dùng flaq trừ khi bạn chủ động cần một tên tuyến khác. Sau khi lưu nhà cung cấp, hãy chọn một không gian làm việc trước khi bắt đầu phiên.

Mô hình DeepSeek v4 Pro được đề xuất cho việc phân tích kho mã, các tác vụ lập trình và những quy trình làm việc cần khả năng suy luận mạnh hơn.

Trong Settings → Models, chọn Add provider → Add a custom provider. Nhập các giá trị bên dưới và thêm thủ công ID mô hình đã chọn thay vì dùng Fetch available models. Lưu nhà cung cấp, sau đó chọn mô hình đó cho một phiên mới. DeepSeek Harness coi các mô hình được nhập thủ công là chỉ hỗ trợ văn bản, trừ khi có khai báo thêm phương thức dữ liệu khác.

  • Sử dụng chính xác URL cơ sở của Flaq và giao thức openai-completions.
  • Thay nội dung giữ chỗ bằng khóa API Flaq của bạn và giữ nguyên ID mô hình đúng như hiển thị.

Nhà cung cấp Flaq AI tùy chỉnh

Provider ID: flaqDisplay name: Flaq AIBase URL: https://api.flaq.ai/api/v1API protocol: openai-completionsCredential / API key: Your_Flaq_Api_KeyModel ID: deepseek-v4-pro-text-to-text

Xác minh

Xác minh Flaq trong DeepSeek Harness

Mở giao diện web, chọn thư mục dự án nơi bạn đã khởi chạy DeepSeek Harness, chọn mô hình Flaq đã cấu hình và tạo một phiên mới. Trình soạn thảo sẽ không khả dụng cho đến khi một không gian làm việc được chọn.

  • DeepSeek Harness hiển thị URL đang hoạt động trong terminal.
  • Địa chỉ cục bộ mặc định được trình bày bên dưới.

Mở giao diện web

http://127.0.0.1:3080
  • Trước tiên, hãy gửi một tác vụ chỉ đọc.
  • Một câu trả lời bình thường phản ánh đúng không gian làm việc đã chọn sẽ xác nhận rằng DeepSeek Harness có thể kết nối tới endpoint Flaq và sử dụng mô hình đã cấu hình.

Kiểm tra quyền truy cập kho mã

Summarize this repository and identify its main packages. Do not modify any files.

Ví dụ về plugin

Cài đặt plugin DeepSeek Harness

Sử dụng DSH OpenPencil làm ví dụ cụ thể cho kiến trúc “mọi thứ đều là plugin” của DeepSeek Harness. Hoàn tất việc cấu hình và xác minh nhà cung cấp Flaq ở trên, dừng giao diện web đang chạy, sau đó thêm plugin vào hồ sơ web và khởi động lại cùng phiên bản DeepSeek Harness đó. DSH OpenPencil bổ sung các công cụ để tạo, xem trước, kiểm tra và chỉnh sửa tài liệu thiết kế .op ngay trong cuộc trò chuyện.

1

Cài đặt DSH OpenPencil

Thêm gói OpenPencil công khai vào hồ sơ web với phiên bản DeepSeek Harness hiện được plugin kiểm thử. Chạy lệnh này từ chính thư mục dự án mà bạn dùng cho DeepSeek Harness.

Cài đặt DSH OpenPencil

npx --yes -p @deepseek-ai/[email protected] dsh plugin --profile web add @zseven-w/dsh-openpencil@latest

Kho mã: Xem mã nguồn, yêu cầu thiết lập, các bản phát hành và ghi chú về khả năng tương thích trong kho mã DSH OpenPencil trên GitHub.

2

Khởi động lại giao diện web

Khởi chạy lại phiên bản DeepSeek Harness đã được kiểm thử để hồ sơ web tải DSH OpenPencil. Giữ terminal này hoạt động trong khi bạn mở lại giao diện web.

Khởi động lại giao diện web

npx --yes -p @deepseek-ai/[email protected] dsh web
3

Kiểm tra DSH OpenPencil với Flaq AI

Chọn mô hình Flaq và không gian làm việc đã cấu hình, bắt đầu một phiên mới rồi gửi yêu cầu bên dưới. Khi tệp nhị phân OpenPencil khả dụng, plugin sẽ tạo một tài liệu .op và hiển thị bản xem trước có thể chỉnh sửa trong cuộc trò chuyện.

Kiểm tra DSH OpenPencil với Flaq AI

Create a simple editable OpenPencil document with a title, a subtitle, and two feature cards. Save it as openpencil-demo.op, then render an editable preview.

Mã nguồn mở

Khám phá kho mã DeepSeek Harness chính thức

DeepSeek Harness là một bộ khung agent mã nguồn mở do DeepSeek AI phát triển. Hãy truy cập kho mã chính thức để xem mã nguồn, theo dõi các bản phát hành và thay đổi về khả năng tương thích, đọc tài liệu mới nhất và báo cáo sự cố trong giai đoạn xem trước dành cho nhà phát triển.

DeepSeek Harness trên GitHub

Mở kho mã DeepSeek Harness chính thức để xem mã nguồn, tài liệu thiết lập, ghi chú phát triển, thảo luận và thông tin cập nhật của dự án.

Hướng dẫn mã nguồn mở

Khám phá hướng dẫn DeepSeek Harness mã nguồn mở của Flaq AI

Tiến xa hơn bước thiết lập ban đầu với hướng dẫn độc lập về DeepSeek Harness do cộng đồng Flaq AI duy trì. Tìm hiểu cách cây plugin, hồ sơ, gói, lớp bản vá, vòng lặp agent có thể thay thế, bộ chuyển đổi mô hình, công cụ, dịch vụ phiên, chính sách quyền, sandbox và tiện ích mở rộng giao diện web hỗ trợ các quy trình agent tùy chỉnh.

Hướng dẫn DeepSeek Harness trên GitHub

Khám phá các ghi chú kiến trúc thực tiễn, sổ tay sử dụng, công thức phát triển plugin, tài liệu đa ngôn ngữ và kỹ năng agent có thể tái sử dụng để tìm hiểu, mở rộng và phát triển dựa trên DeepSeek Harness.

Khắc phục sự cố

Câu hỏi thường gặp về DeepSeek Harness

Việc sử dụng thiết lập trong hướng dẫn này có thể làm tăng đáng kể lượng token sử dụng.

Thảo luận về DeepSeek Harness trên X (Twitter)

Khám phá các cuộc thảo luận của nhà phát triển và những người tham gia đầu tiên về DeepSeek Harness (DSH), một bộ khung agent mã nguồn mở, bao gồm kiến trúc “Mọi thứ đều là plugin”, runtime có thể kết hợp, hệ sinh thái plugin và trải nghiệm thực hành.