Hướng dẫn: Thiết lập trên macOS
Hướng dẫn này đưa bạn qua toàn bộ quy trình làm quen dành riêng cho macOS của Rephlo, từ cài đặt cho đến lệnh kéo-chọn (drag-select) đầu tiên của bạn. Nếu bạn đã hoàn thành phần Cài đặt & Thiết lập chung, hướng dẫn này sẽ đi sâu hơn vào các chi tiết dành riêng cho macOS.
Mục đích
macOS có các yêu cầu bảo mật và quyền riêng tư đặc thù ảnh hưởng đến cách Rephlo hoạt động. Không giống Windows, nơi phím tắt toàn cục hoạt động ngay khi cài đặt, macOS yêu cầu người dùng cấp quyền rõ ràng cho Accessibility (Trợ năng) và Screen Recording (Ghi màn hình). Hướng dẫn này đảm bảo bạn cấu hình mọi thứ đúng cách để toàn bộ tính năng của Rephlo sẵn sàng sử dụng ngay từ ngày đầu.
Điều kiện tiên quyết
| Yêu cầu | Chi tiết |
|---|---|
| Phiên bản macOS | 10.15 Catalina trở lên |
| Kiến trúc | Apple Silicon (M1/M2/M3/M4) hoặc Intel (x64) |
| Dung lượng đĩa | ~250 MB cho gói ứng dụng |
| Ollama (tùy chọn) | Nếu bạn định dùng mô hình cục bộ, hãy cài Ollama riêng |
Bước 1: Tải và cài đặt
1.1 Tải Rephlo
Truy cập https://rephlo.app/download và tải gói macOS mới nhất:
Rephlo-macos-arm64.dmgcho Mac Apple Silicon (M1/M2/M3/M4)Rephlo-macos-x64.dmgcho Mac Intel
1.2 Cài vào Applications
- Mở tệp
.dmgvừa tải về. - Kéo
Rephlo.appvào thư mục/Applications. - Ngắt kết nối (eject) đĩa image.
1.3 Lần khởi chạy đầu tiên — Gatekeeper
Lần đầu tiên bạn mở Rephlo, Gatekeeper của macOS có thể chặn ứng dụng với thông báo: "Rephlo.app cannot be opened because the developer cannot be verified." (Không thể mở Rephlo.app vì không thể xác minh nhà phát triển.)
Để tiếp tục:
- Đừng nhấp đúp vào ứng dụng. Thay vào đó, hãy nhấp chuột phải (hoặc Control-click) vào
Rephlo.apptrong/Applications. - Chọn "Open" từ menu ngữ cảnh.
- Trong hộp thoại xác nhận, nhấp "Open" một lần nữa.
macOS sẽ ghi nhớ lựa chọn này. Những lần khởi chạy sau đó chỉ cần nhấp đúp bình thường.
Vì sao lại như vậy? Gatekeeper của macOS cảnh báo về các ứng dụng được tải từ bên ngoài Mac App Store. Cách nhấp chuột phải > Open sẽ bỏ qua kiểm tra này cho ứng dụng hiện tại.
Bước 2: Cấp các quyền cần thiết
Vì sao cần cấp quyền
Rephlo lắng nghe phím tắt toàn cục và đọc văn bản bạn đang chọn khi bạn kích hoạt một lệnh, việc này trên macOS đòi hỏi quyền Accessibility. Quyền Screen Recording được yêu cầu riêng cho việc chụp ảnh màn hình.
Nếu thiếu các quyền này, tính năng tích hợp toàn hệ thống của Rephlo sẽ không hoạt động.
2.1 Hộp thoại PermissionPreCheckDialog
Ngay sau lần khởi chạy đầu tiên, Rephlo hiển thị PermissionPreCheckDialog:
2.2 Cấp quyền Accessibility
- Trong PermissionPreCheckDialog, nhấp "Open System Settings" bên cạnh Accessibility.
- macOS sẽ mở System Settings > Privacy & Security > Accessibility.
- Tìm Rephlo trong danh sách ứng dụng.
- Bật công tắc chuyển sang ON.
- Nếu được yêu cầu, xác thực bằng mật khẩu macOS hoặc Touch ID.
- Quay lại hộp thoại Rephlo.
2.3 Cấp quyền Screen Recording
- Trong PermissionPreCheckDialog, nhấp "Open System Settings" bên cạnh Screen Recording.
- macOS sẽ mở System Settings > Privacy & Security > Screen Recording.
- Tìm Rephlo trong danh sách ứng dụng.
- Bật công tắc chuyển sang ON.
- Xác thực nếu được yêu cầu.
- Quay lại hộp thoại Rephlo.
2.4 Xác minh và khởi động lại
- Quay lại hộp thoại Rephlo, nhấp "Check Again".
- Cả hai quyền giờ đây sẽ hiển thị là Đã cấp.
- Thoát hoàn toàn Rephlo (nhấp chuột phải vào biểu tượng trên thanh menu > Exit, hoặc
Cmd+Q). - Khởi chạy lại Rephlo từ
/Applications. Một số thay đổi quyền trên macOS cần khởi động lại hoàn toàn mới có hiệu lực.
Mẹo: Nếu ô chọn vẫn hiển thị "Not Granted" sau khi đã bật các quyền, hãy thử thoát Rephlo, chờ vài giây rồi khởi chạy lại. Đôi khi macOS lưu tạm (cache) trạng thái quyền cũ.
Bước 3: Thiết lập nhà cung cấp đầu tiên của bạn
Sau khi đã cấp quyền, hãy cấu hình một nhà cung cấp AI để Rephlo có thể xử lý các lệnh của bạn.
- Nhấp vào biểu tượng Rephlo trên thanh menu, rồi chọn "Settings" (hoặc mở Dashboard và điều hướng đến Settings).
- Vào Settings > LLM Providers.
- Chọn một nhà cung cấp từ danh sách:
| Nhà cung cấp | Bạn cần gì |
|---|---|
| OpenAI | Khóa API từ platform.openai.com |
| Anthropic | Khóa API từ console.anthropic.com |
| Khóa API từ aistudio.google.dev | |
| Groq | Khóa API từ console.groq.com |
| xAI (Grok) | Khóa API từ console.x.ai |
| OpenRouter | Khóa API từ openrouter.ai |
| Azure OpenAI | URL endpoint + khóa API từ cổng thông tin Azure của bạn |
| Ollama | Cài đặt cục bộ, không cần khóa (endpoint: http://localhost:11434) |
| OpenAI-Compatible | URL endpoint + khóa API cho bất kỳ dịch vụ tương thích nào |
- Nhập API Key của bạn (và URL endpoint nếu có).
- Nhấp Test Connection để xác minh.
- Nhấp Save.
Gợi ý bắt đầu nhanh: Nếu bạn mới làm quen với API AI, OpenAI hoặc Anthropic là dễ thiết lập nhất. Nếu bạn muốn hoàn toàn riêng tư, không phụ thuộc đám mây, hãy cài Ollama và dùng mô hình cục bộ.
Bước 4: Tìm hiểu phím tắt trên macOS
Rephlo dùng các phím tắt mặc định riêng theo từng nền tảng. Dưới đây là các phím tắt mặc định trên macOS so với Windows/Linux:
| Hành động | macOS | Windows / Linux |
|---|---|---|
| Lớp phủ menu ngữ cảnh (Context Menu Overlay) | Shift+Cmd+C | Ctrl+Shift+Alt+C |
| Chụp ảnh màn hình (Screenshot Capture) | Shift+Cmd+S | Ctrl+Shift+Alt+S |
| Phím bổ trợ kéo-chọn (Drag-Select Modifier) | Cmd | Ctrl |
| Phóng to (Zoom In) | Cmd+Plus | Ctrl+Plus |
| Thu nhỏ (Zoom Out) | Cmd+Minus | Ctrl+Minus |
| Đặt lại tỷ lệ (Reset Zoom) | Cmd+0 | Ctrl+0 |
Tùy chỉnh phím tắt
Tất cả phím tắt đều có thể tùy chỉnh hoàn toàn:
- Mở Settings > Hotkeys.
- Nhấp vào ô phím tắt bạn muốn thay đổi.
- Nhấn tổ hợp phím mong muốn.
- Nhấp Save.
Mẹo: Nếu một phím tắt xung đột với ứng dụng khác (ví dụ: Spotlight, Alfred, hoặc Raycast), hãy chọn một tổ hợp khác. Rephlo sẽ cảnh báo nếu phím tắt bạn chọn đã được hệ thống sử dụng.
Bước 5: Thử nghiệm với kéo-chọn (Drag-Select)
Quy trình kéo-chọn là cách nhanh nhất để dùng Rephlo trên macOS. Hãy cùng thử:
5.1 Mở bất kỳ ứng dụng văn bản nào
Mở TextEdit, Notes, Safari, hoặc bất kỳ ứng dụng nào có văn bản có thể chọn được.
5.2 Thực hiện kéo-chọn
- Giữ phím
Cmd(phím bổ trợ kéo-chọn mặc định trên macOS). - Trong khi giữ
Cmd, nhấp và kéo chuột qua một đoạn văn bản để chọn nó. - Khi bạn thả chuột, lớp phủ Rephlo sẽ xuất hiện ngay gần con trỏ của bạn.
5.3 Thực thi một lệnh
- Trong lớp phủ, nhấp "Summarize" (hoặc bất kỳ lệnh nào).
- Rephlo gửi văn bản đã chọn đến nhà cung cấp AI bạn đã cấu hình.
- Kết quả xuất hiện trong lớp phủ.
- Nhấp Copy để đặt kết quả vào bộ nhớ tạm, hoặc Insert để thay thế văn bản gốc.
Lưu ý: Phím bổ trợ kéo-chọn có thể tùy chỉnh. Vào Settings > Hotkeys > Text Selection Trigger để đổi từ
Cmdsang phím khác nếu bạn muốn.
Xử lý sự cố đặc thù trên macOS
Phím tắt không hoạt động
Triệu chứng: Nhấn Shift+Cmd+C không có tác dụng gì. Lớp phủ không xuất hiện.
Nguyên nhân: Quyền Accessibility chưa được cấp, hoặc ứng dụng chưa được khởi động lại sau khi cấp quyền.
Cách khắc phục:
- Mở System Settings > Privacy & Security > Accessibility.
- Xác nhận Rephlo đã được bật ở trạng thái ON.
- Nếu đã bật sẵn, hãy tắt (OFF) rồi bật lại (ON).
- Thoát và khởi chạy lại Rephlo.
Chụp ảnh màn hình không hoạt động
Triệu chứng: Lệnh chụp ảnh màn hình thất bại hoặc tạo ra ảnh trống.
Nguyên nhân: Quyền Screen Recording chưa được cấp.
Cách khắc phục:
- Mở System Settings > Privacy & Security > Screen Recording.
- Xác nhận Rephlo đã được bật ở trạng thái ON.
- Thoát và khởi chạy lại Rephlo.
Lớp phủ không xuất hiện
Triệu chứng: Bạn nhấn phím tắt hoặc kéo-chọn, nhưng không có cửa sổ lớp phủ nào xuất hiện.
Nguyên nhân có thể và cách khắc phục:
| Nguyên nhân có thể | Cách khắc phục |
|---|---|
| Chưa cấp quyền Accessibility | Cấp quyền Accessibility rồi khởi động lại |
Ứng dụng không chạy dưới dạng gói .app | Khởi chạy từ /Applications/Rephlo.app, không dùng dotnet run |
| Phím tắt xung đột với ứng dụng khác | Kiểm tra Settings > Hotkeys để tìm xung đột; đổi tổ hợp phím |
| Ứng dụng đang tạm dừng | Nhấp chuột phải vào biểu tượng trên thanh menu; nếu thấy "Resume Rephlo", hãy nhấp vào đó |
Gatekeeper chặn ứng dụng ở mọi lần khởi chạy
Triệu chứng: macOS liên tục hiển thị cảnh báo "developer cannot be verified" (không thể xác minh nhà phát triển).
Cách khắc phục: Đảm bảo bạn đã nhấp chuột phải và chọn "Open" ở lần khởi chạy đầu tiên. Nếu vấn đề vẫn tiếp diễn:
- Mở System Settings > Privacy & Security.
- Cuộn xuống phần Security.
- Bạn sẽ thấy thông báo về việc Rephlo bị chặn. Nhấp "Open Anyway".
Rephlo không xuất hiện trong danh sách quyền
Triệu chứng: Bạn mở System Settings > Accessibility nhưng không thấy Rephlo trong danh sách.
Cách khắc phục: Khởi chạy Rephlo ít nhất một lần. macOS chỉ thêm ứng dụng vào danh sách quyền sau khi ứng dụng đó lần đầu cố gắng sử dụng tính năng được bảo vệ. Sau khi khởi chạy, kiểm tra lại danh sách quyền.
Bước tiếp theo
Bạn đã hoàn tất thiết lập trên macOS. Dưới đây là các bước tiếp theo được đề xuất:
- Hướng dẫn sử dụng lần đầu — Chạy lệnh AI đầu tiên của bạn từng bước một.
- Commands — Tìm hiểu cách tạo và tùy biến các lệnh của riêng bạn.
- Spaces — Thêm tài liệu của bạn làm ngữ cảnh AI để có phản hồi có căn cứ.
- Template Gallery — Duyệt các lệnh dựng sẵn cho các tác vụ phổ biến.
- Các trường hợp sử dụng nâng cao — Quy trình dành cho người dùng chuyên sâu và các công thức tự động hóa.