Cài đặt

Cấu hình tự động lưu, ngôn ngữ, Android, Team ký app, AI, Jira, Amplitude và App Store Connect, đặt Cài đặt dự án, và chạy Setup check.

Mở Settings bằng Cmd+, hoặc Astra Scout → Settings…. Cửa sổ có thanh bên với các mục: Chung, Android, iOS, AI, Jira, Amplitude và App Store. Thay đổi có hiệu lực ngay khi bạn chỉnh, trừ chỗ có nút Lưu.

Chung

• Tự động lưu: lưu thay đổi của file sau một khoảng trễ ngắn.
• Ngôn ngữ: Mặc định hệ thống, English hoặc Tiếng Việt. Có hiệu lực ở lần mở app tiếp theo.
• Cập nhật: mục này hiện Phiên bản bạn đang chạy. Astra Scout kiểm tra bản mới mỗi ngày một lần và hỏi trước khi cài. Tắt Tự động kiểm tra bản cập nhật nếu chỉ muốn kiểm tra khi bấm Kiểm tra bản cập nhật… (có cả trong menu Astra Scout). Xem Cập nhật.

Astra Scout theo giao diện của macOS (Sáng hoặc Tối) và không có cài đặt giao diện riêng.

Android

Android SDK: đường dẫn tới Android SDK của bạn. Để trống nếu SDK nằm ở vị trí mặc định. Khi đó Astra Scout tìm nó qua ANDROID_HOME, ANDROID_SDK_ROOT hoặc ~/Library/Android/sdk. Nhập một đường dẫn hoặc bấm Chọn thư mục… để ghi đè. Mục này hiển thị SDK nào đã được dò thấy và dò từ đâu.

iOS

Ở mục Team ký app, chọn Team dùng để ký WebDriverAgent khi chạy trên iPhone thật, quét lại Keychain, hoặc nhập Team ID thủ công. File app mà clearState sử dụng được chọn ở menu app trên toolbar → Bản build cho clearState…, không phải ở đây. Xem Device.

AI

Mục này có các trang sau (tên trong giao diện tiếng Anh là Intelligence):

• Agent: các CLI AI tìm thấy trên máy Mac này (Claude Code, Codex, Gemini CLI). Bấm Quét lại sau khi bạn cài hoặc đăng nhập một CLI. Mở một agent để đặt Model, Tham số thêm (ví dụ --effort low cho Claude Code) và Đường dẫn CLI (để trống thì tự tìm CLI), và để cài hoặc cập nhật plugin scout. Xem Plugin scout.
• Mặc định: Nhà cung cấp mặc định và Lệnh AI trong flow. Xem Trợ lý AI.
• Kết nối MCP: bật công tắc Bật kết nối từ CLI (MCP), sao chép URL và token, và xem Hoạt động từ CLI. Xem Plugin scout.
• Môi trường shell: thêm SCOUT_MCP_TOKEN và SCOUT_MCP_URL vào profile shell. Xem Plugin scout.

App không nhúng terminal. App hiện đúng lệnh cần chạy để cài hoặc cập nhật plugin, với nút Sao chép và Chạy, và không có gì chạy cho tới khi bạn bấm Chạy.

Ngữ cảnh app không nằm ở đây. Nó nằm trong Cài đặt dự án.

Jira

Mục Jira chỉ giữ phần đăng nhập: Tài khoản (Kết nối và Ngắt kết nối) và trang App OAuth (Client ID và Secret, admin thiết lập một lần). Dự án, loại issue, nhãn và các tuỳ chọn báo cáo khác nằm trong Cài đặt dự án. Xem Jira.

Amplitude

Công tắc Nhận event từ device trong mạng nằm ở đầu mục, dưới Mạng. Nó cho các device cùng Wi-Fi gửi event tới cổng 5051 của Mac. Công tắc bật sẵn để iPhone hoặc Android thật gửi được event mà không cần cài đặt gì; hãy tắt khi dùng mạng công cộng (Simulator và emulator không cần nó). Có hiệu lực sau khi server khởi động lại (Khởi động lại server ngay).

Mỗi project trong danh sách có Chuyển tiếp event tới Amplitude, Kiểm tra kết nối, Sửa… và nút thùng rác (Xoá project, sau khi xác nhận sẽ gỡ các key của nó khỏi máy Mac này).

Bấm Thêm project… ở cuối mục để mở sheet Project Amplitude (hoặc Sửa project Amplitude), nhập project Amplitude (API key và Secret key) để đọc lại kết quả của run, thêm app key bằng dòng App key mới rồi + (chọn một key rồi bấm − để xoá), và bật forward theo từng dự án. Xem Tracking.

App Store

Pane có tiêu đề App Store Connect.

Thêm API key App Store Connect (Issuer ID, Key ID và file .p8), chọn sandbox tester và đặt tốc độ gia hạn gói đăng ký của tester đó. Xem Sandbox tester.

Cài đặt dự án

Cài đặt dự án thuộc về workspace đang mở, không thuộc về app. Mở bằng File → Cài đặt dự án… (Option+Cmd+,). Cửa sổ được lưu trong workspace (.scout/project.json và .scout/context.md), nên ai mở dự án cũng dùng chung. Thay đổi có hiệu lực ngay, trừ Ngữ cảnh app có nút Lưu.

• Jira: Nơi nhận báo cáo: Site (khi có nhiều hơn một), Dự án, Loại issue, Nhãn mặc định, Components, Ngôn ngữ bug, và Đặt Priority theo severity (mức 5 là priority cao nhất của dự án, 1 là thấp nhất). Đăng nhập Atlassian vẫn nằm ở Settings → Jira. Nếu chưa kết nối Jira, mục này hiện Kết nối Jira trong Cài đặt….
• Crash: Tự gửi crash tạo issue Jira khi app crash, trừ khi đã có issue trùng. Số issue tối đa mỗi giờ từ 1 đến 20 (mặc định 3). Chỉ đổi được khi đang tắt tự gửi, và tự gửi tắt lại sau khi khởi động lại. Xem Jira.
• Ngữ cảnh app: tên màn hình, tên gói và thuật ngữ của app, tối đa 16 KiB. AI đọc nó ở mỗi lần gọi. Xem Trợ lý AI.

Kiểm tra thiết lập

Help → Kiểm tra thiết lập… mở một sheet kiểm tra máy của bạn và chỉ cách khắc phục từng mục. Các phép kiểm tra chỉ đọc và không thay đổi gì. Bấm Kiểm tra lại sau mỗi lần sửa, Tài liệu để mở tài liệu và Xong để đóng. Phần tóm tắt có dạng "5 pass · 1 warning · 0 fail".

Nhóm	Kiểm tra gì
Xcode	Xcode có mặt và xcode-select trỏ tới nó, phiên bản, license và lần mở đầu, Command Line Tools, và runtime iOS cho simctl. Các mục này là bắt buộc.
iOS signing	Chứng chỉ Apple Development trong Keychain, Team ID đang dùng, và warning với Personal Team (profile 7 ngày).
iPhone thật	Với mỗi iPhone đang cắm: tin cậy Mac, Developer Mode, đang khoá hay mở khoá, Developer Disk Image, nhắc về Auto-Lock, và Direct iPhone control (HID).
Mirror & video	xcuiax chạy được (không bắt buộc), và ffmpeg (không bắt buộc).
Android	SDK và adb, một AVD, và USB debugging đã được cho phép trên device.
AI	Đã cài CLI và đã đăng nhập.
Quyền macOS	Local Network (iPhone qua Wi-Fi).

Các mục có fail hoặc warning có thể có nút mở đúng mục trong Settings hoặc mở hướng dẫn.

App cũng chạy kiểm tra này ở nền ở lần mở đầu tiên và hiện Mac này chưa thiết lập đủ để chạy flow khi thiếu mục bắt buộc.