Astra Scout hoạt động thế nào

Xem app macOS, server cục bộ và driver device phối hợp với nhau thế nào trên máy Mac.

Astra Scout gồm vài thành phần phối hợp với nhau, tất cả chạy trên máy Mac của bạn.

Astra Scout macOS app (native, SwiftUI / AppKit)
        │  HTTP / SSE on localhost:5050
        ▼
astra-scout-server (Go)
        │
        ├── maestro-runner ──► WebDriverAgent ──► iOS Simulator / real iPhone
        │                  └─► DeviceLab driver ─► Android emulator / device
        ├── xcuiax (Swift) ► iOS Simulator UI tree (iOS 27+)
        ├── devicehid (Swift) ► direct touch on a real iPhone (optional)
        └── your AI CLI (Claude Code / Codex / Gemini CLI), read-only

App

App là app macOS native. Cửa sổ gồm navigator (file, tìm kiếm, run), trình soạn thảo code với bảng chạy test bên dưới, một inspector có màn hình device, và trợ lý AI, là chế độ thứ hai của thanh bên trái. Settings, Khám phá app và báo bug mở từ menu và trong cửa sổ riêng. App tự khởi động server đi kèm.

Server

astra-scout-server là server Go lắng nghe ở cổng 5050. Server cung cấp API cục bộ mà app và các AI CLI sử dụng, gồm cả endpoint cho tính năng AI, Jira và tracking. Server quản lý kết nối device, chạy flow, lưu lịch sử chạy và phục vụ endpoint MCP mà các AI CLI dùng (http://localhost:5050/mcp).

Nếu cổng 5050 đang bận, app khởi động server ở cổng khác và ghi URL thật vào ~/.astra-scout/mcp.json.

Runner

Flow chạy qua maestro-runner. Trên iOS, nó điều khiển device qua WebDriverAgent (WDA); trên Android, nó dùng driver DeviceLab. Lần đầu bạn kết nối device iOS, maestro-runner build WDA, mất khoảng 3 đến 10 phút. Các lần kết nối sau dùng lại bản build đó.

Mirror màn hình

Device	Màn hình đến app bằng cách nào
iOS Simulator	App tự render trong tiến trình qua SimulatorKit của Xcode; input đi qua devicehid
iPhone thật	Media stream của CoreDevice (HEVC), cáp hoặc Wi-Fi
Android	Stream H.264 dựa trên scrcpy, dự phòng bằng ảnh chụp màn hình

Dữ liệu của bạn nằm ở đâu

Nội dung	Vị trí
Log của server	~/Library/Logs/Astra Scout/server.log
Dữ liệu app (database, MCP token, Team ID)	~/Library/Application Support/Astra Scout/data
Các bản build WDA	~/Library/Application Support/Astra Scout/maestro-runner
Video của flow	<workspace>/artifacts/runs/
Bản sao plugin dùng cho AI CLI	~/.astra-scout/plugin

Không có gì được gửi lên dịch vụ cloud. Các kết nối mạng duy nhất ra ngoài máy bạn là những kết nối do chính bạn khởi động: AI CLI của bạn nói chuyện với nhà cung cấp của nó, và Jira khi bạn xác nhận báo cáo bug.

Kết luận do app tính

AI không bao giờ quyết định một run pass hay không. Astra Scout tính kết luận từ các dữ kiện có cấu trúc như kết quả từng step và error của driver. Xem Chạy flow.