Plugin AI agent quản lý tệp Android: cài đặt và thao tác an toàn

AI agent có thể tổ chức những tác vụ tệp nào?

Plugin AI agent quản lý tệp Android biến một yêu cầu tự nhiên thành thao tác có đường dẫn, tham số và kết quả quan sát được. Thay vì nói chung chung “dọn thư mục tải xuống”, người dùng có thể yêu cầu liệt kê tệp trong một thư mục, tìm tài liệu theo tên, đọc một tệp văn bản nhỏ hoặc tạo thư mục mới để gom tài liệu theo dự án.

Theo chỉ mục plugin chính thức của FoneClaw, File Manager Plugin 0.0.4 cung cấp 13 công cụ. Phạm vi gồm kiểm tra trạng thái và cài đặt; liệt kê, tìm kiếm và đọc văn bản với giới hạn maxBytes; tạo tệp không ghi đè, ghi văn bản, tạo thư mục, đổi tên một mục; xem trước và áp dụng đổi tên hàng loạt; xóa; cùng tải tệp HTTPS vào đường dẫn tương đối trên bộ nhớ ngoài.

Mỗi thao tác cần đầu vào cụ thể. Ví dụ, “tìm các tệp PDF có chữ hóa đơn trong Download/Receipts” xác định thư mục và điều kiện tìm. “Đọc 20 KB đầu của Documents/notes.txt” đặt giới hạn dữ liệu. “Tạo ProjectA/summary.txt” cho biết đường dẫn đích. Khi kết quả trả về, người dùng cần thấy tệp nào được tìm thấy, bao nhiêu mục đã xử lý và đường dẫn thực tế.

Tác nhân giúp lập kế hoạch, nhưng plugin mới thực hiện thay đổi trên bộ nhớ. Phân tách này cho phép người dùng xem đề xuất trước khi ghi, đổi tên hoặc xóa. Với tác vụ đầu tiên, nên chọn thao tác chỉ đọc trong một thư mục thử nghiệm, sau đó mới chuyển sang tạo tệp và đổi tên một mục có thể kiểm tra dễ dàng.

Vì sao File Manager là plugin cài riêng?

File Manager là một gói Android độc lập có mã gói ai.android.claw.plugin.device.filemanager, APK, chữ ký, quyền và công cụ riêng. Chỉ mục chính thức ghi nhận phiên bản hiện tại là 0.0.4, mã phiên bản 4, với nền FoneClaw tương thích hiện có. Thông tin có cấu trúc trong chỉ mục là căn cứ hiện tại cho phiên bản gói.

Việc cài riêng tạo ra ranh giới dễ kiểm tra. Người dùng có thể xem nguồn phân phối, tên gói, phiên bản, chữ ký dự kiến và các quyền được yêu cầu trước khi thêm khả năng quản lý tệp. Sau khi APK được cài và xác minh, FoneClaw đăng ký các công cụ do plugin công bố. Khi gỡ plugin, nhóm công cụ đó cũng rời khỏi môi trường tác vụ.

FoneClaw giữ plugin tách khỏi hơn 100 công cụ tích hợp có kiểm soát của ứng dụng chính. Nhờ vậy, quyền truy cập bộ nhớ rộng chỉ xuất hiện khi người dùng thực sự cần quản lý tệp. Cấu trúc tương tự cũng áp dụng cho những gói mở rộng khác; bài FoneClaw miễn phí: plugin tải YouTube cục bộ cho thấy một plugin tải nội dung được cài và quản lý độc lập với công cụ có sẵn như thế nào.

Hướng dẫn plugin trong kho mã FoneClaw cung cấp phần mô tả dễ đọc, nhưng dòng phiên bản cũ trong tài liệu này không thay thế phiên bản 0.0.4 của chỉ mục hiện hành. Khi kiểm tra một gói cài đặt, hãy ưu tiên metadata chính thức có tên gói, mã phiên bản, yêu cầu máy chủ và thông tin xác minh cụ thể.

Quyền truy cập mọi tệp và phạm vi đường dẫn

File Manager Plugin yêu cầu MANAGE_EXTERNAL_STORAGE, thường được Android hiển thị dưới dạng quyền truy cập mọi tệp, cùng quyền INTERNET cho tải xuống. Quyền đầu tiên cho phép plugin làm việc rộng hơn với bộ nhớ ngoài dùng chung. Quyền thứ hai chỉ cần khi tác vụ truy cập địa chỉ HTTPS để tải dữ liệu.

Cấp quyền hệ thống mới chỉ cho phép plugin tiếp cận phạm vi kỹ thuật tương ứng. Mỗi tác vụ vẫn cần đường dẫn và bước phê duyệt riêng. Yêu cầu “đọc tệp” chưa đủ rõ nếu không có thư mục, tên tệp và giới hạn dữ liệu. Yêu cầu “xóa các bản cũ” càng cần danh sách mục tiêu chính xác vì thao tác xóa của phiên bản này là vĩnh viễn.

Đường dẫn plugin được xác định tương đối so với gốc bộ nhớ ngoài. Ví dụ, Download/FoneClaw/report.txt rõ hơn “tệp báo cáo trong phần tải xuống”. Cách biểu diễn tương đối giúp tránh việc mô hình tự dựng một đường dẫn tuyệt đối không phù hợp với thiết bị. Dù có quyền rộng, một số vùng riêng của ứng dụng, nội dung được bảo vệ hoặc tài nguyên do nhà cung cấp khác quản lý vẫn có thể không đọc được theo cùng một cách.

Đọc văn bản có tham số maxBytes để giới hạn lượng nội dung đưa vào tác vụ. Đây là điểm kiểm soát quan trọng với nhật ký dài, tệp cấu hình hoặc tài liệu chứa dữ liệu nhạy cảm. Hãy chọn số byte vừa đủ cho mục tiêu thay vì đọc toàn bộ theo mặc định. Bài Bảo mật kỹ năng AI agent trên điện thoại trình bày sâu hơn cách tách quyền của ứng dụng, khả năng công cụ và phạm vi dữ liệu mà một tác vụ thực sự cần.

Xem trước trước khi đổi tên hàng loạt

Đổi tên hàng loạt là thao tác dễ gây nhầm vì một quy tắc có thể ảnh hưởng tới nhiều tệp. File Manager Plugin tách việc này thành hai bước. Bước xem trước tạo danh sách tên cũ, tên mới, xung đột tiềm ẩn và trả về một previewToken. Bước áp dụng phải sử dụng đúng mã đó thay vì tự dựng lại kế hoạch từ lời nhắc ban đầu.

Giả sử thư mục Download/Invoices chứa các tệp có tên không thống nhất. Người dùng yêu cầu thêm tiền tố năm và đánh số theo thứ tự. Bản xem trước cần cho biết từng ánh xạ, chẳng hạn invoice-a.pdf thành 2026-01.pdf. Nếu tên đích đã tồn tại hoặc hai tệp cùng dẫn tới một tên, xung đột phải được nêu trước khi áp dụng.

previewToken gắn thao tác phá hủy với đúng kế hoạch người dùng đã xem. Nếu thư mục thay đổi sau bước xem trước, cách an toàn là tạo bản xem trước mới và kiểm tra lại thay vì dựa vào danh sách cũ. Người dùng cũng có thể loại một mục, đổi quy tắc hoặc hủy toàn bộ mà chưa làm thay đổi tệp thật.

Khi áp dụng, giao diện cần hiển thị số tệp dự kiến, phạm vi thư mục và nút có động từ rõ như “Áp dụng đổi tên”. Sau đó plugin phải trả về kết quả quan sát được: mục nào thành công, mục nào thất bại và tên cuối cùng của từng tệp. Việc đối chiếu sau thao tác giúp phát hiện tình trạng một phần kế hoạch đã chạy nhưng phần còn lại bị chặn bởi xung đột hoặc trạng thái bộ nhớ.

Xóa vĩnh viễn, tải HTTPS và xử lý trùng tên

Trong phiên bản tối thiểu hiện tại, thao tác xóa của File Manager Plugin là xóa vĩnh viễn. Tệp không được chuyển vào thùng rác và plugin không cung cấp hoàn tác sau khi xóa. Vì vậy, màn hình phê duyệt phải nêu đầy đủ đường dẫn, số mục, tổng phạm vi dự kiến và hậu quả trước khi gọi công cụ.

Một yêu cầu như “xóa các tệp tạm cũ” cần được chuyển thành danh sách mục tiêu để người dùng kiểm tra. Nếu bộ lọc theo ngày hoặc tên tạo ra kết quả bất ngờ, hãy hủy và thu hẹp điều kiện. Với dữ liệu quan trọng, tạo bản sao ở vị trí khác hoặc xác nhận rằng nguồn gốc vẫn còn trước khi xóa. Sau thao tác, liệt kê lại thư mục để kiểm tra mục tiêu đã biến mất và các tệp lân cận vẫn nguyên vẹn.

Tải xuống chỉ chấp nhận địa chỉ HTTPS và lưu vào đường dẫn tương đối trên bộ nhớ ngoài. Ví dụ, người dùng có thể yêu cầu tải một tệp kiểm thử vào Download/FoneClaw/sample.pdf. Trước khi bắt đầu, đề xuất cần hiển thị miền nguồn, tên tệp, thư mục đích và quyền mạng. Sau khi tải, hãy xác minh tệp tồn tại, kích thước hợp lý và đường dẫn đúng với yêu cầu.

Xung đột tên cần được xử lý trước khi ghi. Công cụ tạo tệp không ghi đè tệp đã có; đây là tín hiệu để người dùng chọn tên mới hoặc quyết định bước tiếp theo. Với đổi tên và tải xuống, bản đề xuất cũng cần phát hiện mục tiêu đã tồn tại thay vì mặc định thay thế. Khi một thao tác ghi thất bại, kết quả phải giữ rõ nguyên nhân để người dùng sửa tên, quyền hoặc dung lượng rồi thử lại có chủ đích.

Từ tìm plugin đến tác vụ an toàn đầu tiên

Quy trình cài đặt bắt đầu bằng việc tìm metadata trong nguồn chính thức. Công cụ plugin_search chỉ tìm thông tin gói và không tự cài đặt. Kết quả nên hiển thị File Manager Plugin 0.0.4, mã gói, phiên bản FoneClaw tối thiểu, quyền truy cập mọi tệp, quyền Internet và danh sách khả năng chính.

Khi người dùng chọn cài, plugin_request_install tạo một đề xuất hiển thị rõ ràng; thao tác này chưa tải hoặc cài APK. Home đưa đề xuất tới người dùng để kiểm tra nguồn, tên gói, phiên bản và thông tin xác minh. FoneClaw kiểm tra metadata gói cùng chữ ký dự kiến trước khi đăng ký công cụ từ APK đã cài. Giá trị băm từ metadata chính thức cũng nên được đối chiếu với gói được đề xuất.

Sau khi cài đặt, Android yêu cầu người dùng cấp quyền truy cập mọi tệp theo giao diện hệ thống. Hãy quay lại FoneClaw, kiểm tra trạng thái plugin rồi xem các công cụ đã được phát hiện. Quyền mạng chỉ được sử dụng khi gọi chức năng tải HTTPS; các thao tác cục bộ như liệt kê thư mục không cần tạo một yêu cầu tải xuống.

Tác vụ đầu tiên nên diễn ra trong thư mục thử, chẳng hạn Download/FoneClaw-Test. Tạo thư mục, tạo một tệp văn bản mới, ghi một câu ngắn, đọc lại với maxBytes nhỏ rồi đổi tên một tệp. Không dùng xóa hoặc đổi tên hàng loạt trong lần thử đầu. Khi đã xác nhận đúng đường dẫn, phê duyệt và kết quả, bạn mới mở rộng sang dữ liệu thật.

Kho mã và tài liệu công khai của FoneClaw là điểm tham khảo cho kiến trúc máy chủ, plugin và cách công cụ được quản lý. Khi cần hiểu sâu hơn về danh tính gói, quyền, phê duyệt và lịch sử thao tác, bài Danh tính tác nhân AI: quyền, phê duyệt công cụ và nhật ký kiểm toán cung cấp khung kiểm tra liên quan.

Kiểm tra độ tin cậy, quyền và khả năng phục hồi

Đánh giá một tác nhân quản lý tệp cần bắt đầu từ nguồn gói rồi đi tới kết quả cuối. Không nên chỉ kiểm tra xem câu lệnh có chạy hay không. Một quy trình tốt phải cho biết plugin nào thực hiện, đường dẫn nào bị tác động, dữ liệu nào được đọc, thao tác nào cần phê duyệt và cách xử lý khi một bước thất bại.

• Nguồn: metadata có đến từ chỉ mục chính thức và khớp tên gói, phiên bản cùng yêu cầu máy chủ không?
• Xác minh: APK có khớp metadata, chữ ký dự kiến và giá trị băm được công bố không?
• Quyền: quyền truy cập mọi tệp và Internet có được giải thích theo tác vụ cụ thể không?
• Đường dẫn: yêu cầu có dùng đường dẫn tương đối rõ ràng và giới hạn trong thư mục cần thiết không?
• Đọc dữ liệu: maxBytes có được đặt đủ nhỏ với tệp văn bản nhạy cảm hoặc dung lượng lớn không?
• Xem trước: đổi tên hàng loạt có hiển thị từng tên cũ, tên mới, xung đột và previewToken không?
• Phê duyệt: thao tác ghi, đổi tên, tải xuống, áp dụng hàng loạt và xóa có dừng ở đúng bước không?
• Kết quả: plugin có trả về đường dẫn, mục thành công, mục thất bại và trạng thái sau thao tác không?
• Phục hồi: dữ liệu quan trọng có bản sao trước khi xóa vĩnh viễn và quy trình có tránh chạy lại mù quáng không?
• Gỡ bỏ: sau khi gỡ plugin, quyền liên quan và các công cụ đã đăng ký có được kiểm tra lại không?

Hãy chạy lại kiểm tra quyền sau một thời gian sử dụng, nhất là khi bạn chỉ cài plugin cho một nhiệm vụ ngắn hạn. Bài Kiểm tra sức khỏe và quyền Android bằng AI với FoneClaw giúp rà soát những quyền còn hoạt động và xác định phần mở rộng nào không còn cần thiết.

Plugin quản lý tệp tạo giá trị khi biến một mục tiêu rộng thành chuỗi thay đổi có thể kiểm tra. Nguồn cài đặt, phạm vi đường dẫn, bản xem trước, phê duyệt và kết quả quan sát được phải đi cùng nhau. Với thao tác xóa vĩnh viễn, chuẩn bị bản sao trước khi thực hiện vẫn là đường phục hồi đáng tin cậy nhất.