Hark
Trợ giúp

Trợ giúp: cài đặt và sử dụng Hark trên máy Mac

Mọi nội dung trên trang này mô tả ứng dụng đúng như phiên bản đang phát hành. Nếu có gì ở đây chưa đúng, hoặc câu hỏi của bạn không có ở đây, hãy viết thư cho support@souplin.com và một người thật sẽ trả lời bạn.

Yêu cầu và cài đặt

Hark chạy trên macOS 14 (Sonoma) trở lên, trên máy Mac dùng Apple silicon (M1 trở lên); không hỗ trợ máy Mac dùng chip Intel. Bạn cần một tài khoản Gmail hoặc Google Workspace.

Đăng nhập, và những gì Hark yêu cầu

Ở lần khởi chạy đầu tiên, hãy chọn “Sign in with Google”. macOS mở trang đăng nhập của chính Google trong một cửa sổ do hệ thống cung cấp — Hark không bao giờ thấy mật khẩu của bạn, và xác minh 2 bước hay khóa bảo mật hoạt động ở đó như ở bất cứ đâu. Khi bạn hoàn tất, cửa sổ đóng lại và hộp thư đến của bạn được tải.

Màn hình xin cấp quyền của Google liệt kê những gì Hark yêu cầu. Nói một cách dễ hiểu, kèm lý do cho từng quyền:

Đã được Google xét duyệt

Quyền truy cập của Hark vào tài khoản Google của bạn đã được Google xét duyệt và phê duyệt vào năm 2026, qua quy trình xác minh OAuth và một đợt thẩm định bảo mật CASA độc lập.

Tài khoản Workspace

Tài khoản Google Workspace đăng nhập theo cùng cách, miễn là tổ chức của bạn cho phép ứng dụng bên thứ ba. Nếu không, Google sẽ hiện thông báo riêng trên trang đăng nhập và Hark không thể tiếp tục; quản trị viên của bạn có thể cho phép Hark trong bảng điều khiển dành cho quản trị viên Workspace.

Nhiều tài khoản

Để thêm một tài khoản Google khác, nhấp vào ảnh tài khoản ở góc trên bên phải cửa sổ và chọn “Add account…”, hoặc dùng “Add account…” trong “Settings › Accounts and Import”. Cách đăng nhập giống như tài khoản đầu tiên, và Hark kết nối tối đa năm tài khoản. Khi có từ hai tài khoản trở lên, “All Inboxes” ở thanh bên hiển thị hộp thư đến của mọi tài khoản trong một danh sách, và tìm kiếm từ đó sẽ tìm trong tất cả các tài khoản.

Thông báo, Dock và thanh menu

Cho đến khi bạn quyết định, Hark hiển thị một thanh ở đầu cửa sổ đề nghị bật thông báo; bấm “Turn On” và macOS sẽ hỏi bạn có cho phép không. Yêu cầu tương tự cũng là nút “Allow…” trong Settings › General › Desktop notifications. Nếu bạn đã từ chối rồi đổi ý, hãy vào Cài đặt hệ thống › Thông báo › Hark.

Những gì Hark thông báo cho bạn nằm trong Settings › General › Desktop notifications: thư mới; lời mời, thay đổi và hủy bỏ trên lịch; thông báo có hiện tiêu đề và bản xem trước hay không; và có phát âm thanh hay không. Hark giữ im lặng khi nó đang là ứng dụng hoạt động — âm thanh cho thứ đã có sẵn trên màn hình chỉ là tiếng ồn.

Huy hiệu trên Dock hiển thị số thư chưa đọc trong hộp thư đến, đúng con số Gmail hiển thị — khi có nhiều tài khoản, đó là tổng của các tài khoản đang bật “Count in Dock badge” (Settings › Accounts and Import); tắt nó bằng “Show unread count in Dock” trong Settings › General › Appearance. Mục trên thanh menu cho bạn xem nhanh những gì vừa đến mà không cần đưa cửa sổ lên trước.

Thư

Nhãn của bạn nằm ở thanh bên và trên từng thư, và đó chính là nhãn Gmail của bạn — thay đổi trong Hark sẽ hiện trên web và trên điện thoại. Khung đọc có đủ các thao tác bạn cần: lưu trữ, gắn nhãn, gắn dấu sao, đánh dấu chưa đọc, tạm ẩn đến thời điểm bạn chọn (Hark chứ không phải Google đưa thư trở lại, nên Hark phải đang chạy thì thư mới quay về), tắt tiếng cuộc trò chuyện, chuyển vào Thùng rác. Thư từ danh sách gửi thư có liên kết “Unsubscribe” ở trên cùng.

Lịch và Tasks

Lịch chỉ cách hộp thư đến một cú nhấp trên thanh bên trái. Có các chế độ xem “Day”, “Week”, “Month”, “Year” và “Schedule”, cùng các khoảng 4 ngày, 2 tuần và 4 tuần; kéo để tạo, kéo để di chuyển hoặc đổi kích thước; thông báo “Undo” sau mỗi thay đổi; sự kiện định kỳ có thể sửa cho sự kiện này, sự kiện này và các sự kiện tiếp theo, hoặc tất cả. Lịch được hiện và ẩn từ thanh bên, nơi bạn cũng có thể tạo, chia sẻ và đăng ký lịch. Google Tasks mở trong một bảng bên cạnh lưới lịch, và việc cần làm được kéo vào ngày nào sẽ được lên lịch vào ngày đó.

Lời mời đến trong hộp thư sẽ hiển thị “Yes”, “No” và “Maybe” ngay trên thư, và câu trả lời được ghi thẳng vào lịch. Mô tả đầy đủ có tại Google Calendar dưới dạng ứng dụng Mac native.

Bàn phím

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

Hark không có máy chủ nào cho thư của bạn; mọi thứ nó lưu đều nằm trên máy Mac của bạn. Thông tin xác thực tài khoản Google nằm trong Chuỗi khóa của macOS. Mọi thứ khác nó lưu — bộ nhớ đệm thư, sự kiện và việc cần làm (mỗi tài khoản một thư mục), tệp đính kèm đã tải về, hình ảnh từ xa, ảnh người gửi và logo được lưu đệm, cài đặt của bạn, 25 lượt tìm kiếm gần nhất và id của những cuộc trò chuyện bạn đã tắt tiếng — đều nằm trong vùng chứa sandbox của Hark, ~/Library/Containers/com.souplin.hark, bên trong thư mục Thư viện của chính bạn.

Settings › Advanced chứa ba tùy chọn quan trọng ở đây. “Clear cache” xóa hình ảnh đã lưu đệm và tệp đính kèm đã tải về — thư, bản nháp, cuộc trò chuyện đang tạm ẩn và tài khoản của bạn vẫn nguyên vẹn, còn hình ảnh và tệp đính kèm sẽ được tải lại khi cần. “Send crash reports” mặc định tắt; khi bật, mỗi lần ứng dụng gặp sự cố sẽ gửi stack trace, loại ngoại lệ, tín hiệu và lý do kết thúc, luồng nào bị lỗi, thời điểm xảy ra và id mà macOS gán cho sự cố đó, phiên bản ứng dụng, bản build và commit, cùng phiên bản macOS và kiểu máy — không bao giờ gửi thư của bạn. “Look up avatars on gravatar.com” mặc định tắt; khi bật, nó gửi giá trị băm địa chỉ của từng liên hệ tới dịch vụ đó. Bức tranh đầy đủ, bao gồm nội dung của một báo cáo lỗi, có tại ứng dụng Gmail không bao giờ thấy thư của bạn.

Đăng xuất và gỡ cài đặt

Để đăng xuất, bấm vào ảnh tài khoản ở góc trên bên phải cửa sổ và chọn “Sign out” kèm địa chỉ của bạn, hoặc dùng “Sign out” trong Settings › Accounts and Import. Đăng xuất khỏi tài khoản duy nhất (hoặc cuối cùng) làm ba việc: yêu cầu Google thu hồi quyền truy cập của Hark vào tài khoản của bạn, xóa thông tin xác thực khỏi Chuỗi khóa, và xóa bộ nhớ đệm của tài khoản đó khỏi ổ đĩa. Khi có nhiều tài khoản, Settings › Accounts and Import có “Remove…” cho từng tài khoản, còn menu tài khoản có “Remove” kèm địa chỉ của bạn cho tài khoản đang hoạt động: nó xóa thông tin xác thực và bộ nhớ đệm của tài khoản đó, và chỉ thu hồi quyền truy cập của Hark ở phía Google nếu bạn đánh dấu “Also revoke Hark’s access to this Google account.”

Để gỡ cài đặt, trước tiên hãy xóa mọi tài khoản, và mỗi lần được hỏi đều đánh dấu “Also revoke Hark’s access to this Google account.” — đăng xuất khỏi tài khoản cuối cùng luôn thu hồi quyền — rồi thoát Hark và kéo nó từ thư mục Ứng dụng vào Thùng rác. Để xóa sạch mọi dấu vết, hãy xóa thêm ~/Library/Containers/com.souplin.hark.

Nếu bạn đã xóa ứng dụng, hoặc một tài khoản, mà không thu hồi quyền truy cập của Hark, quyền đã cấp vẫn còn trong tài khoản Google của bạn: mở myaccount.google.com/permissions, tìm Hark trong danh sách ứng dụng bên thứ ba và xóa quyền truy cập của nó. Các mục trong Chuỗi khóa nằm trong Truy cập Chuỗi khóa, có tên bắt đầu bằng com.hark.oauth.

Báo lỗi

Chọn “Report a Bug” trong menu “Help” (⇧⌘R), chọn phần của ứng dụng mà vấn đề liên quan, rồi mô tả chuyện đã xảy ra. Báo cáo gồm những gì bạn đã gõ, bạn đánh dấu đó là lỗi hay yêu cầu, khu vực bạn chọn, mọi hình ảnh bạn đính kèm, ô tên hoặc email — điền sẵn địa chỉ bạn đang đăng nhập; hãy xóa nó nếu bạn không muốn bị nhận diện — và các thông tin về ứng dụng và máy: phiên bản, bản build và commit, phiên bản macOS, kiểu máy, số lõi CPU, dung lượng bộ nhớ, dung lượng ổ đĩa còn trống, vùng ngôn ngữ, múi giờ, trạng thái nhiệt, chế độ nguồn điện thấp, số giờ kể từ lần khởi động, thời điểm bạn gửi, số tài khoản đang kết nối (chỉ là con số) và một id ngẫu nhiên cho mỗi lượt cài đặt. Báo cáo không bao giờ chứa nội dung thư, tiêu đề, địa chỉ của bất kỳ ai khác, token hay nhật ký. Ảnh chụp màn hình thường là cách nhanh nhất để cho chúng tôi thấy lỗi — và đó cũng là cách duy nhất để bất cứ thứ gì từ hộp thư của bạn đến được chỗ chúng tôi, nên hãy cắt bớt nếu điều đó quan trọng với bạn.

Hoặc viết thư cho support@souplin.com. Nếu được, hãy ghi kèm số bản build trong “About Hark”.

Ngôn ngữ

Hark có tiếng Anh và tiếng Trung giản thể. Settings › General › Language đặt cả ngôn ngữ hiển thị Gmail lẫn giao diện của chính Hark; Hark làm theo cài đặt này ở những phần đã được dịch, còn lại giữ tiếng Anh. Hãy khởi động lại Hark để thay đổi ngôn ngữ giao diện.