Cài đặt và thiết lập ban đầu

Yêu cầu hệ thống

• macOS 13.0 trở lên
• Hỗ trợ cả kiến trúc Intel và Apple Silicon
• 3 MB dung lượng ổ đĩa
• Kết nối Internet (dùng cho truy vấn AI và cập nhật; một số tính năng hoạt động ngoại tuyến)

Phương thức cài đặt

Phương thức 1: Tải DMG từ trang web (Khuyến nghị)

1. Truy cập trang chủ DevGlish
2. Nhấn nút Download, tải xuống DevGlish.dmg phiên bản mới nhất
3. Nhấp đúp vào tệp .dmg để mở trình cài đặt
4. Kéo ứng dụng DevGlish vào thư mục Applications
5. Hoàn tất! Bạn có thể tìm thấy và khởi chạy DevGlish từ thư mục Applications

Phương thức 2: Phiên bản thử nghiệm TestFlight

Muốn trải nghiệm tính năng mới nhất? Tham gia chương trình thử nghiệm TestFlight:

1. Nhận liên kết mời qua Apple Mail (hoặc đăng ký tại trang chủ DevGlish)
2. Nhấn vào liên kết, nhấn Accept trong ứng dụng TestFlight
3. TestFlight sẽ tự động tải xuống phiên bản thử nghiệm DevGlish
4. Sau khi cài đặt xong, bạn có thể khởi chạy DevGlish từ ứng dụng TestFlight

Mẹo

Sử dụng phiên bản TestFlight để trải nghiệm sớm các tính năng mới. Chúng tôi rất mong nhận được phản hồi từ bạn!

Thiết lập quan trọng: Cấp quyền Accessibility

DevGlish sử dụng API Accessibility của macOS (AXUIElement) để đọc văn bản bạn đã chọn. Đây là điều kiện bắt buộc để ứng dụng hoạt động bình thường.

Tại sao cần quyền này?

DevGlish cần truy cập văn bản bạn chọn trong bất kỳ ứng dụng nào. Dù bạn đang chọn đoạn mã trong Xcode, tin nhắn trong Slack, hay nội dung trang web trong trình duyệt, DevGlish đều có thể lấy nội dung đã chọn thông qua quyền này, sau đó gọi AI để tra cứu.

Bước 1: Mở System Settings

1. Nhấn vào logo Apple ở góc trên bên trái thanh menu
2. Chọn System Settings (Cài đặt hệ thống)

Bước 2: Điều hướng đến Privacy & Security

1. Tìm Privacy & Security (Quyền riêng tư & Bảo mật) ở thanh bên trái
2. Nhấn vào để mở

Bước 3: Tìm và bật Accessibility

1. Cuộn xuống, tìm mục Accessibility
2. Nhấn vào Accessibility
3. Ở cửa sổ bên phải, tìm ứng dụng DevGlish
4. Nếu DevGlish chưa có trong danh sách, nhấn nút +, sau đó chọn DevGlish từ thư mục Applications
5. Đảm bảo công tắc bên cạnh DevGlish đã được bật (màu xanh)

Chú ý

Nếu DevGlish không có quyền Accessibility, phím tắt toàn cục ⌘⇧D sẽ không hoạt động.

Bước 4: Khởi chạy DevGlish

1. Đóng System Settings
2. Khởi chạy DevGlish từ thư mục Applications, hoặc sử dụng Spotlight (⌘Space, nhập “DevGlish”)
3. DevGlish sẽ xuất hiện ở góc trên bên phải thanh menu (biểu tượng bánh răng)

Đăng nhập

Sau khi khởi chạy DevGlish, bạn cần đăng nhập để đồng bộ tiến trình học tập và từ vựng đã lưu.

Tùy chọn 1: Sử dụng Apple Sign In (Khuyến nghị)

1. Nhấn vào biểu tượng DevGlish trên thanh menu
2. Chọn Sign in with Apple
3. Hoàn tất đăng nhập bằng Apple ID của bạn
4. Cấp quyền cho DevGlish truy cập tài khoản Apple của bạn (chỉ dùng để xác thực, DevGlish không lưu mật khẩu của bạn)

Tùy chọn 2: Sử dụng Magic Link (đăng nhập qua email)

1. Nhấn vào biểu tượng DevGlish trên thanh menu
2. Chọn Sign in with Email
3. Nhập địa chỉ email của bạn
4. Kiểm tra hộp thư, nhấn vào magic link nhận được
5. Liên kết sẽ tự động đăng nhập DevGlish

Khắc phục sự cố

Vấn đề: Nhấn ⌘⇧D không có phản hồi

Giải pháp:

1. Xác nhận DevGlish đã khởi chạy (góc trên bên phải thanh menu phải có biểu tượng)
2. Xác nhận DevGlish đã được bật trong System Settings > Privacy & Security > Accessibility
3. Thử khởi động lại DevGlish: nhấn biểu tượng trên thanh menu → Quit DevGlish, sau đó khởi chạy lại
4. Trong cài đặt Accessibility, tắt rồi bật lại công tắc quyền của DevGlish

Vấn đề: Không thể đăng nhập hoặc không nhận được email

Giải pháp:

1. Kiểm tra kết nối mạng
2. Nếu đăng nhập bằng email, kiểm tra thư mục thư rác (Magic Link đôi khi bị lọc)
3. Thử sử dụng Apple Sign In thay thế
4. Nếu vấn đề vẫn tiếp tục, vui lòng liên hệ [email protected]

Vấn đề: DevGlish không thể truy cập văn bản đã chọn

Giải pháp:

1. Xác nhận bạn đã cấp quyền trong Accessibility (xem Bước 3 ở trên)
2. Một số ứng dụng (như các ứng dụng bảo mật) có thể chặn truy cập Accessibility. Thử kiểm tra trong ứng dụng khác (như Notes, TextEdit)
3. Khởi động lại DevGlish (nhấn biểu tượng trên thanh menu → Quit, sau đó khởi chạy lại)

Ghi chú

Nếu vấn đề vẫn chưa được giải quyết, vui lòng liên hệ chúng tôi qua trang hỗ trợ.

Bước tiếp theo

Bạn đã cài đặt và thiết lập xong DevGlish! Hãy đến Bắt đầu nhanh trong 3 phút để học cách thực hiện tra cứu đầu tiên.