Skip to Content

Khối tính năng

Ba công cụ blocks, block_plan và block_add để agent tìm tính năng đã kiểm thử sẵn, xem trước khối sẽ thêm gì, rồi chép nó vào app/ làm code của chính app.

Khối được chép vào app, không phải thư viện. Sau khi thêm, file thuộc về app: agent sửa cho đúng spec, và manh.run không tự nâng cấp hay gỡ khối.

Các khối có sẵn:

  • auth: đăng nhập và vai trò.
  • resource: bảng, API, trang danh sách và trang chi tiết từ một danh sách trường. Thêm flow để có luồng trạng thái và bảng kéo thả, log để có lịch sử và ghi chú.
  • attachments (file đính kèm), search (tìm không dấu), export-excel, numbering (đánh số chứng từ), notify (thông báo).
  • mail (mẫu email chủ app tự sửa), email-report (báo cáo gửi email định kỳ), ai-extract.
  • ai-assistant (bản 3.0): trợ lý AI trong app. Gồm file agent app/assistant/assistant.agent.ts với vài công cụ mẫu để thay bằng công cụ của app, trang chat /assistant (danh sách cuộc trò chuyện, các bước gọi công cụ hiện ngay, thẻ Duyệt / Từ chối trước khi đổi dữ liệu, nút Dừng) và các route mỏng gọi manh/agent. App đã chép bản 2.x vẫn giữ nguyên file của mình và vẫn chạy; muốn lên 3.0 thì xoá file cũ rồi thêm lại khối.
  • tasklist: trang Việc cần làm cho người dùng của app: nhận, trả lại và hoàn tất các bước có người làm trong quy trình (.bpmn), mỗi bước có form riêng hoặc nút Duyệt / Từ chối.
  • site: website cho cửa hàng, phòng khám, có thông tin, giờ mở cửa, form liên hệ, bảng giá.
  • web: website theo một hướng thiết kế, kèm bộ section.

blocks

Tìm khối theo nhu cầu.

  • Tham số: q: mô tả nhu cầu, ví dụ “lịch sử thay đổi” hoặc “tải file lên”; tags: lọc theo nhãn.
  • Trả về: mỗi khối có id, tóm tắt, khối phụ thuộc (requires), tham số (params) và đoạn code mẫu.
  • Khi nào gọi: trước khi viết một tính năng hay gặp như đăng nhập, CRUD, đính kèm file, lịch sử.

block_plan

Xem trước khi thêm một khối, không ghi gì.

  • Tham số: project; id: id khối từ blocks; params: tham số của khối.
  • Trả về: file sẽ thêm, khối phụ thuộc đã có, file trùng đường dẫn (conflicts), lỗi tham số và các việc nối còn lại (wire).
  • Khi nào gọi: trước block_add, nhất là khi app đã có nhiều file.

block_add

Thêm khối và các khối nó cần.

  • Tham số: như block_plan.
  • Trả về: khối đã thêm, danh sách file, cách dùng, việc nối còn lại, kết quả check.
  • Khi nào gọi: sau khi block_plan không báo trùng file.

Trước khi chép, manh.run lưu bản sao tự động của cây file. File của app trùng đường dẫn mà khác nội dung thì không bị ghi đè: lần thêm dừng lại và báo trùng. Khối không deploy. Check cảnh báo block.unwired tới khi agent làm xong mọi việc nối, ví dụ thêm chuông thông báo vào layout.

Bước tiếp theo

Cập nhật