Skip to Content

File

Bốn công cụ list_files, read_files, write_files và delete_files để agent đọc và ghi cây app/; mỗi lần ghi là một thao tác trọn gói, có bản sao tự động và kết quả check đi kèm.

Ghi file không deploy. Bản xem trước trong dashboard cập nhật sau mỗi lần ghi; app chạy thật chỉ đổi khi deploy.

list_files

Liệt kê đường dẫn file kèm loại (page, layout, handler…) và cỡ tính bằng byte.

  • Tham số: project; prefix để chỉ lấy file trong một thư mục, ví dụ app/orders/.
  • Trả về: mỗi file một dòng: đường dẫn, loại, cỡ.
  • Khi nào gọi: trước khi sửa một project có sẵn, để biết file nằm ở đâu.

read_files

Đọc nội dung một hoặc nhiều file.

  • Tham số: project; paths: 1–50 đường dẫn.
  • Trả về: nội dung từng file, tối đa 90 KB mỗi lần gọi. File vượt quá được ghi là bỏ qua để đọc ở lần sau. Riêng một file lớn hơn 90 KB thì trả về phần đầu, có ghi rõ đã cắt và file dài bao nhiêu.
  • Khi nào gọi: trước khi sửa file, để lấy đúng đoạn văn bản hiện có.

File manh.run sinh ra (app/api.ts, app/hooks.ts, các file người dùng sinh từ app/auth.ts) vẫn đọc được và được đánh dấu chỉ đọc. Muốn đổi thì sửa file nguồn: handler cho app/api.ts, app/auth.ts cho file người dùng.

write_files

Tạo file, ghi đè cả file, vá một đoạn trong file có sẵn và xoá file trong một lần ghi. Ghi xong, manh.run chạy ngay ba lớp đầu của check trên cây file mới.

  • Tham số:
    • files: nội dung đầy đủ, dạng [{ "path": "app/x/get.ts", "content": "…" }] hoặc { "app/x/get.ts": "…" }.
    • edits: các bản vá { path, find, replace, all? }. find phải khớp đúng văn bản hiện có, kể cả khoảng trắng, và chỉ một lần; all: true thay mọi chỗ khớp.
    • delete: đường dẫn cần xoá.
    • npm: chọn phiên bản gói npm cho backend, ví dụ { "jose": "^5" }. Bỏ trống thì gói mới được ghim bản mới nhất ở lần import đầu.
  • Trả về: số file đã ghi, vá, xoá; id bản sao tự động nếu có; file bị đổi đuôi; gói npm vừa ghim; kết quả check; mục Progress.
  • Khi nào gọi: mỗi giai đoạn một hai lần: bảng và repository, rồi handler, rồi layout và các trang. Sửa vài dòng thì dùng edits thay vì gửi lại cả file.

Lần ghi là trọn gói: một đường dẫn sai hoặc một bản vá không khớp thì không file nào được ghi. Chỉ nhận đường dẫn trong app/. File .ts chỉ bị đổi thành .tsx khi rõ là file giao diện: có JSX, hoặc một file .tsx import nó, và không file backend nào import nó. Mỗi lần đổi đuôi đều ghi trong kết quả trả về. Helper .ts ghi riêng một mình vẫn giữ .ts.

Trước khi đổi hay xoá một file có sẵn, manh.run lưu bản sao tự động của cả cây file, nên lần ghi nào cũng hoàn tác được. manh.run giữ 10 bản sao tự động mới nhất.

delete_files

Xoá file khỏi app/, rồi chạy check trên cây còn lại. Chỉ có ở địa chỉ /directory; bộ đầy đủ xoá file bằng delete của write_files.

  • Tham số: project; paths: đường dẫn cần xoá, ví dụ app/orders/delete.ts.
  • Trả về: như write_files.
  • Khi nào gọi: khi bỏ một tính năng hoặc dời file sang chỗ khác.

Bước tiếp theo

Cập nhật