automation_file 繁體中文文件

繁中手冊依典型讀者旅程拆分為章節：安裝 → 執行 JSON 動作 → 操作本地檔案 → 串接遠端儲存 → 對外開伺服器 → 規模化自動化。可使用左側目錄，或直接跳到下方任一章節。

第 1 章 — 入門 

安裝 automation_file、執行第一份 JSON 動作清單，並理解註冊器與執行器之間的分工。

入門

快速開始

第 2 章 — CLI 

使用 python -m automation_file argparse 派發器驅動框架——子命令、舊版旗標與 JSON 檔案執行。

CLI

CLI

第 3 章 — 架構 

分層架構、設計模式（Facade、Registry、Command、Strategy、Template Method、Singleton、Builder），以及執行器與註冊器的互動方式。

架構

架構

由 local/ 策略模組提供的檔案、目錄、ZIP、tar 與壓縮檔操作； safe_join 路徑穿越防護；感知 OS 索引的 fast_find；串流式 file_checksum 與 find_duplicates；sync_dir rsync 風格鏡像；目錄差異比對與文字 patch；JSON / YAML / CSV / JSONL / Parquet 編輯； MIME 偵測；樣板渲染；垃圾桶送回 / 還原；檔案版本控制；條件式執行；變數替換；具逾時的 shell 子行程；以及 AES-256-GCM 檔案加密。

本地操作

本地檔案操作

第 5 章 — HTTP 傳輸 

經 SSRF 驗證的對外 HTTP 下載，並透過 http_download 設下大小、逾時、重試與 expected_sha256 上限。可透過 Range: 續傳到 <target>.part，並提供即時進度快照。

HTTP 傳輸

HTTP 傳輸
- 可續傳 HTTP 下載
- 傳輸進度與取消

第 6 章 — 雲端與 SFTP 後端 

Google Drive、S3、Azure Blob、Dropbox、OneDrive、Box、SFTP、FTP / FTPS、 WebDAV、SMB 與 fsspec——皆由 build_default_registry 自動註冊。 copy_between 可依 URI 前綴在不同後端間搬資料。

雲端與 SFTP 後端

雲端與 SFTP 後端

第 7 章 — 動作伺服器 

預設僅綁定 loopback 的 TCP 與 HTTP 伺服器，接受 JSON 動作清單，並可選擇啟用共享密鑰驗證、ActionACL 白名單、GET /healthz / GET /readyz 健康檢查、GET /openapi.json、GET /progress WebSocket，以及帶型別的 HTTPActionClient SDK。

動作伺服器

動作伺服器
- TCP 動作伺服器
- HTTP 動作伺服器

第 8 章 — MCP 伺服器 

MCPServer 透過 stdio 上的換行分隔 JSON-RPC 2.0，把註冊器橋接到任何 Model Context Protocol 主機（Claude Desktop、Claude Code、MCP CLI）。

MCP 伺服器

MCP 伺服器（Claude Desktop / Claude Code）

第 9 章 — 圖形介面 

PySide6 桌面控制介面——分頁佈局、日誌面板，以及 ActionWorker 執行緒池模型。

圖形介面

GUI（PySide6）

第 10 章 — 可靠性 

帶上限的指數退避 retry_on_transient、Quota 大小與時間預算、 CircuitBreaker、RateLimiter、FileLock / SQLiteLock、持久化的 ActionQueue、SQLite AuditLog、用於週期清單比對的 IntegrityMonitor，以及帶型別的 FileAutomationException 階層。