Automa CLI Toolkit (automa-vscode)

Giao diện Trung tâm (GUI) điều phối toàn bộ Hệ sinh thái Automa ngay trong VS Code.

Automa CLI Toolkit biến VS Code thành một trạm điều khiển trung tâm (Command Center) cho toàn bộ Hệ sinh thái Automa. Trải nghiệm biên tập tự động hóa chưa bao giờ dễ dàng đến thế: Tạm biệt những tệp .json khô khan, giờ đây bạn có thể thiết kế, quản lý, lên lịch và thực thi các chiến dịch (Campaign) đa trình duyệt thông qua các giao diện trực quan tuyệt đẹp.

🚀 Tính năng Nổi bật

🎨 Trình Chỉnh sửa Trực quan (Visual Editors)

Không còn phải dán mắt vào mã JSON thô cứng! Chỉ cần click vào bất kỳ file Automa nào để trải nghiệm bộ giao diện biên tập tùy chỉnh (được nhúng qua Webview):

Workflow Preview (*.automa.json): Tương tác cài đặt tham số đầu vào, chỉnh sửa dữ liệu toàn cục (global data), và cập nhật metadata trước khi chạy kịch bản.
Campaign Manager (*.campaigns.json): Trực quan hóa việc điều phối chạy song song nhiều tiến trình, ánh xạ hồ sơ trình duyệt (browser profiles), và đặt lịch cron.
Log Viewer (*.automa-log.json): Xem lại nhật ký thực thi (log) dưới dạng dòng thời gian (timeline) đẹp mắt. Hỗ trợ lọc theo trạng thái thành công/thất bại và đi sâu vào dữ liệu của từng Node.

⚡ Thực thi Siêu Tốc (Lightning Fast)

Chạy workflow ngay từ thanh tiêu đề hoặc menu chuột phải (Context Menu) trong Explorer.
Gọi trực tiếp xuống động cơ automa-cli chạy ngầm, sử dụng Chromium độc lập thông qua giao thức CDP Polling để chống phát hiện (anti-detection).
Tuyệt đối an toàn: Không còn lỗi crash liên quan đến webextension-polyfill! Tương thích 100% với các phiên bản Chrome mới nhất (129+).

Theo dõi toàn bộ "đế chế" tự động hóa của bạn ngay trên thanh Activity Bar:

Trình Quản lý Runners: Hiển thị đo lường từ xa (telemetry) của mọi tiến trình Daemon đang hoạt động. Cho phép một click để dừng (kill) hoặc xem log theo thời gian thực.
Profiles & Campaigns: Quản lý và tìm kiếm toàn bộ hồ sơ trình duyệt và chiến dịch tự động hóa trong Workspace của bạn.

🛡️ Smart Linter & Auto-Fix

Nhập workflow từ cộng đồng và phát hiện mã ID lỗi thời (như n1)?

Chỉ cần click chuột phải chọn Auto-Fix Workflow ID để hệ thống tự động làm sạch (sanitize) Nodes và Edges bằng mã 21-ký tự chuẩn NanoID.
Cơ chế Linting thời gian thực tích hợp thẳng vào thanh Problems của VS Code, giúp bắt các lỗi cấu trúc (Schema) trước cả khi bạn bấm nút chạy.

🛡️ Cách ly Môi trường Phát triển (Dev Sandbox)

Phần mềm thiết lập một cơ chế cách ly môi trường nghiêm ngặt nhằm bảo vệ dữ liệu thật của bạn (workflows, logs, browser profiles). Bất kể bạn đang lập trình phát triển Extension này hay thử nghiệm tính năng mới, hệ thống sẽ tự động bẻ lái đường dẫn lưu trữ:

[ Hành động của Dev ]                           [ Hành động của User ]
 ├─ F5 Debug in VS Code                          ├─ Cài đặt từ Marketplace
 ├─ Chạy pnpm run dev                            ├─ Chạy automa-cli binary
 └─ Dùng automa-vscode-dev.vsix                  └─ Dùng automa-vscode.vsix
          │                                               │
          ▼                                               ▼
+-----------------------+                       +-----------------------+
|  AUTOMA_ENV=dev       |                       |  AUTOMA_ENV=empty     |
+-----------------------+                       +-----------------------+
          │                                               │
          ▼                                               ▼
+-----------------------+                       +-----------------------+
|   CLI / Daemon        |                       |   CLI / Daemon        |
+-----------------------+                       +-----------------------+
          │                                               │
          ▼                                               ▼
 📁 ~/.automa-cli-dev/                           📁 ~/.automa-cli/
  (Isolated Sandbox)                              (Production Storage)
  ├─ 🗄️ run/log.sqlite                          ├─ 🗄️ run/log.sqlite
  ├─ ⚙️ config.json                             ├─ ⚙️ config.json
  └─ 🌐 browser/                                └─ 🌐 browser/

Mẹo: Bạn hoàn toàn có thể ghi đè (override) đường dẫn lưu trữ ở mọi môi trường bằng cách khai báo biến AUTOMA_HOME.

⚙️ Cấu Hình (Configuration)

Tinh chỉnh Động cơ Thực thi (Execution Engine) cho phù hợp với nhu cầu của bạn qua phần Settings của VS Code (Ctrl + , -> tìm kiếm automa):

Cấu hình	Mô tả	Mặc định
`automa.preview.defaultOnClick`	Biến Automa Visual Editor thành trình xem mặc định khi bấm vào file JSON.	`true`
`automa.run.useDefaultParameters`	Bỏ qua hộp thoại nhập tham số (trigger) và luôn dùng giá trị mặc định.	`false`
`automa.vault.run.defaultBrowser`	Trình duyệt mặc định khi chạy workflow (`chromium`, `chrome`, `edge`, `firefox`, `brave`, `active-tab`).	`"chromium"`
`automa.vault.run.headless`	Chạy trình duyệt ẩn (không hiện cửa sổ).	`false`
`automa.vault.run.closeBrowserOnFinish`	Tự động đóng trình duyệt khi workflow chạy xong.	`true`
`automa.vault.run.debug`	Bật ghi log siêu chi tiết (verbose) cho CLI.	`false`
`automa.vault.run.campaignGridSystem`	Tự động sắp xếp, chia nhỏ các cửa sổ trình duyệt thành dạng lưới khi chạy Campaign.	`true`
`automa.cliPath`	Đường dẫn tuyệt đối đến file thực thi `automa-cli`. Bỏ trống để hệ thống tự phát hiện hoặc gọi qua `npx`.	`""`
`automa.daemon.port`	Cổng (Port) mặc định cho tiến trình Background Daemon.	`8765`
`automa.extensionPaths`	Đường dẫn (ngăn cách bằng dấu phẩy) trỏ tới các file/thư mục Extension để nạp.	`""`
`automa.vault.run.globalVariables`	Đối tượng JSON chứa các biến toàn cục (global) tự động truyền vào mỗi lần chạy.	`{}`

(Mẹo: Bạn có thể tạo file .vscode/settings.json trong Workspace để gán biến automa.vault.run.globalVariables cho từng dự án riêng biệt!)

🛠 Yêu Cầu Hệ Thống (System Requirements)

Visual Studio Code >= 1.80.0
Node.js 18+ (Dành cho việc chạy CLI cục bộ)

🤝 Cộng Đồng & Hỗ Trợ

Nếu bạn yêu thích Extension này, hãy để lại một ngôi sao (Star) trên GitHub!

Tài liệu: Đọc toàn bộ Cẩm nang Kiến trúc (Obsidian Vault) tại thư mục documents/ trong repo.
Báo lỗi: Hãy tạo một Issue trên GitHub.

Automa CLI Toolkit

tuquet