Android AI 檔案管理 Agent Plugin：安裝、路徑、批次預覽與刪除核准
Android AI 檔案管理 Agent Plugin 如何安全整理檔案？本文說明 FoneClaw File Manager Plugin 的獨立 APK、所有檔案存取權、相對路徑、批次改名預覽、永久刪除、HTTPS 下載與安裝驗證。
- FoneClaw File Manager Plugin 0.0.4 是需另外安裝的 Android 外掛套件，具備自己的 APK、套件識別碼、簽署者、權限與工具，不屬於 FoneClaw 內建工具。
- 外掛可列出及搜尋檔案、限量讀取文字、建立與寫入檔案、建立資料夾、改名、批次改名、刪除，以及從 HTTPS 網址下載到外部儲存空間的相對路徑。
- 批次改名必須先產生預覽和 previewToken，再用相同憑證套用；建立檔案不會直接覆寫同名項目，刪除在目前版本中則是永久動作。
- Android 的所有檔案存取權只提供作業系統層級的存取條件；實際讀取、寫入、改名、下載或刪除仍由工具規則、目標路徑、操作預覽與使用者核准共同管理。
AI 檔案管理 Agent 可以安排哪些工作
Android AI 檔案管理 Agent Plugin 的價值，不只是把檔案總管按鈕改成自然語言，而是把目標、路徑、衝突處理、核准與結果驗證整理成一項可檢查的任務。使用者可以提出「找出 Download/Receipts 裡本月的文字收據」或「先預覽把這批照片依日期改名」，Agent 再選擇相應工具並顯示下一步。
目前 File Manager Plugin 0.0.4 提供 13 項工具。能力包括查詢外掛狀態與設定、列出檔案、搜尋檔案、限制最大讀取量的文字讀取、建立檔案、寫入文字、建立資料夾、單一項目改名、批次改名預覽與套用、永久刪除，以及從 HTTPS 網址下載檔案。這些工具各自有明確用途，不會因為 Agent 理解了要求就自動合併成未經檢查的變更。
以整理下載資料夾為例，安全流程可以先列出 Download/Reports，再搜尋名稱含有 invoice 的檔案。若需要確認內容，可限量讀取文字檔，而不是一次把整個大型檔案交給模型。接著建立新的月份資料夾，預覽改名或移動計畫，最後才執行需要核准的寫入動作。
建立檔案時，工具採用不覆寫同名項目的方式。若目標已存在，結果應回報衝突，讓使用者改名、換路徑或選擇其他處理方式。寫入完成後，也不應只回覆「成功」；Agent 可以再次列出目標資料夾、查看檔案大小，必要時限量讀回文字，確認觀察到的結果和要求一致。
檔案工作很適合拆成查詢、預覽、套用與驗證四段。查詢先找到正確範圍，預覽顯示變更，套用產生實際結果，驗證則確認檔案確實出現在預期位置。這種結構能讓自然語言保有便利，也讓每次副作用保持可追蹤。
File Manager 為什麼是獨立外掛
File Manager 是另外安裝的 Android Plugin，不是 FoneClaw 內建工具。官方套件索引目前列出的版本為 0.0.4、版本代碼 4，套件識別碼是 ai.android.claw.plugin.device.filemanager，並列出目前適用的最低主程式需求。它擁有自己的 APK、套件資訊、預期簽署者、權限聲明與工具契約。
這個界線對使用者很重要。安裝外掛代表手機多了一個具備檔案能力的套件，Android 會針對該套件管理權限；FoneClaw 則在外掛安裝並通過驗證後，註冊它提供的工具。設定模型負責理解「整理下載資料夾」的意圖，外掛工具才負責實際列出、建立、寫入、改名或刪除檔案。
目前套件資料應以File Manager Plugin 官方套件索引為準。索引提供目前版本、最低主程式需求、套件識別碼、權限和工具資料；公開的FoneClaw 外掛目錄與安裝說明則適合了解外掛機制與安裝入口。
外掛與內建工具也有不同的生命週期。使用者可以決定是否安裝、授予權限或移除外掛；外掛更新時，也要重新核對版本、簽署者與權限變化。移除 File Manager Plugin 後，它註冊的檔案工具便不再提供，但先前已建立、下載或改名的檔案仍保留在儲存空間中。
FoneClaw 的 YouTube Downloader 也是獨立外掛，但它處理的是分享連結、格式選擇和下載任務，不能和 File Manager 的一般檔案工具混為一談。相關範例可閱讀免費 FoneClaw YouTube 下載外掛：本機 Plugin、Android 分享連結、格式核准與取消任務。
所有檔案存取權與相對路徑怎麼看
File Manager Plugin 會要求 MANAGE_EXTERNAL_STORAGE 與 INTERNET。前者是 Android 的「所有檔案存取權」，讓外掛能在支援範圍內處理共享外部儲存空間；後者用於 HTTPS 下載。這些權限由 Android 管理，使用者需要在系統提供的特殊存取設定中查看和授予。
所有檔案存取權是一項作業系統能力，不代表每個檔案任務都已得到使用者同意。外掛取得權限後，FoneClaw 仍會依工具規則處理操作：狀態與設定查詢屬於低影響自動操作，其他檔案工具需要核准，批次套用與刪除則屬於破壞性動作。使用者核准的是特定路徑上的特定工作，而不是把儲存空間交給 Agent 任意整理。
路徑以外部儲存空間根目錄為基準，使用相對路徑表達。例如 Download/Invoices/2026-08.txt 指向外部儲存空間下的 Download 資料夾，而不是任意系統路徑。介面應把根目錄和相對路徑一起說清楚，避免只顯示同名檔案而看不出實際位置。
讀取文字時還要控制資料量。外掛的文字讀取工具支援 maxBytes，可以限制一次讀入的最大位元組數。遇到大型記錄檔、匯出資料或可能包含敏感資訊的文件，先讀取較小範圍，再決定是否需要更多內容，能降低不必要的資料暴露和模型負擔。
Android 本身仍可能限制特定受保護位置、其他應用程式的私人目錄或無法直接解碼的檔案格式。Agent 應將「找不到」、「沒有權限」、「格式不支援」和「空白結果」分開回報。當任務需要更廣的存取時，使用者應先確認是否真的必要；相關稽核方式可參考AI Android 手機健康檢查指南：權限稽核、特殊存取與隱藏應用程式檢查。
批次改名前先產生預覽與 previewToken
批次改名最容易因模糊規則造成大範圍錯誤，因此 File Manager Plugin 把「預覽」和「套用」拆成兩個工具步驟。預覽工具先根據目標資料夾、選取條件與命名規則產生變更清單，並回傳 previewToken；套用工具必須帶入該憑證，才能執行對應的批次變更。
假設 Download/Trip 裡有二十張照片，使用者要求依拍攝順序改成 taipei-001 至 taipei-020。Agent 應先列出候選檔案，再產生預覽，顯示原名稱、新名稱、排序依據、略過項目和同名衝突。這時尚未修改任何檔案，使用者可以調整前綴、編號位數或選取範圍。
previewToken 的作用，是把實際套用綁定到一份特定預覽。使用者核准時，看到的是和憑證對應的變更清單，而不是只同意一句「批次整理照片」。若資料夾內容在預覽後改變、檔案已被其他應用程式改名，或使用者調整了規則，應重新產生預覽和新憑證。
套用批次改名屬於破壞性操作，需要明確核准。核准畫面應顯示作用資料夾、檔案數量、衝突處理方式與部分失敗時的回報方式。執行後再列出目標資料夾，逐項比對成功、略過和失敗結果，避免把部分完成誤報成全部完成。
單一檔案改名也應先確認完整路徑和新名稱，但不需要沿用批次憑證流程。介面可依影響選擇適當強度：單一改名顯示來源與目的地，批次變更則提供完整預覽、憑證和逐項結果。若想進一步理解手機 Agent 為何需要持續檢查，而不是只在安裝前掃描一次，可閱讀AI Agent 技能安全：為什麼手機 Agent 不能只靠安裝前掃描。
永久刪除、HTTPS 下載與寫入驗證
File Manager Plugin 目前版本的刪除是永久動作。它不會先把檔案移到外掛提供的資源回收筒，也沒有由外掛執行的復原功能。因此，刪除前必須顯示完整相對路徑、目標類型、檔案數量與可觀察資訊，並要求破壞性操作核准。
若使用者說「刪掉所有舊報告」，Agent 要先把「舊」轉成明確條件，例如日期早於 2026 年 1 月 1 日，並列出候選檔案。重要資料可先複製到使用者指定的備份位置，或由使用者確認已有其他備份。未經確認的搜尋條件不能直接接到永久刪除。
刪除後的驗證，是重新列出或搜尋原路徑，確認目標項目已不存在，並逐項回報成功與失敗。若部分檔案因權限、占用或路徑變更而未刪除，結果應保留原始清單和失敗原因，讓使用者決定是否重試。對可能已成功的項目，不應在結果不明時盲目重複刪除。
下載工具只接受 HTTPS 網址，目的地要使用外部儲存空間下的相對路徑。例如可以把檔案下載到 Download/Manuals/guide.pdf，但不能用不安全的 HTTP 網址或把任意絕對系統路徑當成目的地。外掛需要 INTERNET 權限，下載前仍應顯示來源網域、目標路徑與預期檔名。
同名衝突必須在寫入前處理。建立新檔案本身不覆寫既有項目；下載和寫入流程也應先檢查目的地，讓使用者選擇改名、換資料夾或取消。完成後可再次列出檔案、核對大小與名稱；文字檔還能限量讀回內容。這樣「下載完成」代表手機上確實觀察到目標檔案，而不只是網路要求已送出。
從官方中繼資料到第一次安全任務
安裝流程應從官方中繼資料開始。FoneClaw 的 plugin_search 只搜尋官方外掛資料，不會安裝套件。搜尋 File Manager 時，使用者應看到名稱、目前版本 0.0.4、套件識別碼、最低主程式版本、權限與工具範圍，再決定是否建立安裝提案。
plugin_request_install 會產生可見的安裝提案，本身不會下載或安裝 APK。Home 介面接著讓使用者檢查來源、版本、套件名稱、預期簽署者、完整性資料和權限。使用者確認後，主程式才依產品流程取得並安裝套件。
安裝完成不代表工具立即可用。FoneClaw 主程式會核對套件中繼資料與預期簽署者，再從已安裝的外掛 APK 註冊工具。若套件名稱、簽署者或版本條件不符合，外掛不應進入可執行狀態。公開架構與外掛程式碼可從FoneClaw Android 官方 GitHub 專案查看。
- 使用
plugin_search搜尋官方 File Manager 中繼資料。 - 核對版本 0.0.4、套件識別碼與目前適用的最低主程式需求。
- 查看
MANAGE_EXTERNAL_STORAGE和INTERNET的用途。 - 建立可見安裝提案，核對來源、簽署者與完整性資訊。
- 由使用者在 Home 確認安裝。
- 安裝後授予目前任務需要的 Android 特殊存取權。
- 確認 FoneClaw 已註冊 File Manager 工具。
- 先執行狀態查詢與低風險資料夾列出。
第一次任務建議使用自行建立的測試資料夾，例如 Download/FoneClaw-Test。先建立資料夾，再建立一個不含敏感資料的文字檔，寫入短句，限量讀回內容，最後執行單一改名。每一步都核對實際路徑與結果，暫時不要測試永久刪除。
完成基本驗證後，再用數個測試檔案進行批次改名預覽。檢查 previewToken、候選清單和衝突處理，但先拒絕套用一次，確認任務能安全停止。接著重新產生預覽並核准，觀察套用後的逐項結果。
檔案 Agent 的安裝與操作檢查清單
評估 Android AI 檔案管理 Agent Plugin 時，先從套件信任開始，再檢查權限、路徑、預覽、核准與結果。自然語言可以簡化操作，但不能取代對實際檔案變更的核對。
- 官方來源：外掛是否來自官方索引，版本、套件識別碼和最低主程式版本是否一致？
- 套件驗證：安裝提案是否顯示預期簽署者與完整性資料，主程式是否在註冊工具前完成驗證？
- 權限範圍：是否清楚說明所有檔案存取權和網路權限的用途？不使用時能否撤回？
- 路徑顯示：介面是否顯示外部儲存空間根目錄與完整相對路徑，而非只有檔名？
- 讀取限制：大型或敏感文字是否使用
maxBytes控制讀取量？ - 建立衝突：同名檔案是否停止並要求選擇，而非直接覆寫？
- 批次預覽：改名前是否列出原名稱、新名稱、略過項目與衝突，並產生
previewToken？ - 破壞性核准：批次套用和永久刪除是否顯示目標、數量、影響與不可復原性？
- 下載限制：是否只接受 HTTPS，並在開始前顯示來源網域和目的路徑？
- 結果驗證：寫入、改名、下載或刪除後，是否重新列出或讀取目標以確認結果？
- 失敗紀錄：部分成功時，是否逐項保留成功、略過與失敗原因？
- 復原準備：永久刪除前是否已有可驗證備份或替代副本？
- 移除外掛：不再使用時，是否能撤回特殊存取權並解除安裝套件？
操作紀錄應能回答誰提出任務、使用哪個工具、作用在哪個路徑、何時核准，以及最後觀察到什麼。對逐工具權限、核准和稽核的完整設計，可閱讀AI 代理身份與權限治理：逐工具核准、稽核紀錄與 FoneClaw Android 控制。
卸載前先確認是否還有執行中或等待核准的檔案任務。撤回所有檔案存取權、停止下載，再移除外掛。卸載只會移除套件和工具，不會自動刪除先前建立或下載的使用者檔案；這些檔案應由使用者依實際需求保留或整理。
一套可靠的檔案 Agent 工作方式，是先縮小路徑，再預覽變更，接著核准明確動作，最後以手機上的實際結果完成驗證。我們在 FoneClaw 把模型理解、外掛套件、Android 權限、工具核准和結果回報分開管理，讓便利性建立在可見且可追蹤的檔案操作上。