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. Giới hạn nào là giới hạn của bản beta thì đều được ghi rõ. 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.

Hark đang trong giai đoạn beta công khai miễn phí. Tải ảnh đĩa về, mở nó, kéo Hark vào thư mục Ứng dụng, đẩy ảnh đĩa ra, rồi mở Hark từ thư mục Ứng dụng. Ứng dụng được ký bằng Developer ID của chúng tôi và được Apple công chứng, nên macOS mở nó mà không hiện cảnh báo.

Đă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, sắp xếp và gửi Gmail của bạn. Đây chính là phần ứng dụng email: hiển thị thư, đánh dấu đã đọc, nhãn, lưu trữ, tạm ẩn, bản nháp và gửi thư. Hark cố ý không xin quyền cho phép xóa vĩnh viễn, nên nó chỉ có thể chuyển thư vào Thùng rác.
• Cài đặt Gmail cơ bản. Chữ ký, thư trả lời tự động khi vắng mặt, bộ lọc và địa chỉ “gửi thư dưới tên”, để bạn quản lý chúng trong phần Settings của Hark và thay đổi hiện lên cả trên web.
• Lịch của bạn. Xem, tạo và chỉnh sửa sự kiện, trả lời lời mời, hiện và ẩn lịch, tạo và chia sẻ lịch.
• Việc cần làm của bạn. Bảng Google Tasks bên cạnh lịch.
• Danh bạ của bạn, chỉ đọc. Tự hoàn thành người nhận hoặc khách mời khi bạn gõ, và hiển thị ảnh của người gửi. Hark không bao giờ ghi vào danh bạ của bạn.
• Các tệp Drive bạn chọn. Đính kèm tệp Google Drive mà bạn chọn trong trình chọn tệp của chính Google. Hark chỉ thấy được những tệp bạn chọn, không bao giờ thấy toàn bộ Drive của bạn.
• Địa chỉ email và tên của bạn. Để đặt tên cho tài khoản bên trong Hark.

Đã đượ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.

Tạm thời chỉ một tài khoản

Bản beta kết nối một tài khoản Google cho mỗi lượt cài đặt. Hộp thư đến hợp nhất cho nhiều tài khoản đã được xây dựng và đang tắt trong giai đoạn beta; mục “Add account” sẽ chưa xuất hiện cho đến khi tính năng này được bật.

Cập nhật

Ở lần khởi chạy thứ hai, Hark hỏi liệu nó có được tự kiểm tra bản build mới hay không. Nếu bạn đồng ý, Hark kiểm tra khoảng mỗi ngày một lần (mỗi giờ với bản build beta) và báo cho bạn khi có bản mới, kèm một thông báo ngay cả khi Hark đang chạy nền. Để kiểm tra ngay, hãy chọn “Check for Updates…” trong menu “Hark”.

Mọi bản cập nhật đều được ký, và ứng dụng xác minh chữ ký đó trước khi cài đặt bất cứ thứ gì. Việc cài đặt thay thế ứng dụng ngay tại chỗ; nó không hỏi mật khẩu quản trị viên của bạn. “About Hark” trong menu “Hark” cho biết phiên bản và bản build bạn đang chạy — thông tin hữu ích để đưa vào báo cáo lỗi.

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ị; 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.

• Tìm kiếm. Các toán tử của chính Gmail — from:, has:attachment, is:unread, older_than:1y — được gửi tới Google đúng như bạn gõ, và kết quả là của Gmail. Một lượt tìm kiếm bạn muốn giữ lại có thể được biến thành bộ lọc Gmail bằng “Create filter”, và bộ lọc đó sẽ chạy phía Google cho mọi thiết bị.
• Soạn thư. Bạn soạn thư trong một vùng văn bản macOS thực thụ: in đậm, in nghiêng và gạch chân từ thanh định dạng, liên kết, ảnh chèn trong thư, trình kiểm tra chính tả của hệ thống. Thả một tệp vào thư để đính kèm, hoặc đính kèm tệp Google Drive từ trình chọn tệp. “Undo Send” giữ thư lại vài giây sau khi bạn gửi (từ 5 đến 30 giây, trong Settings › General › Sending). “Schedule Send” lưu thư dưới dạng bản nháp và gửi vào thời điểm bạn chọn — khi đó Hark phải đang chạy, nếu không thư sẽ được gửi vào lần tới Hark mở, vì API của Gmail không có tính năng hẹn giờ gửi riêng.
• Thùng rác, không phải xóa. Hark chuyển thư vào Thùng rác và không bao giờ xóa vĩnh viễn — đó là chủ đích thiết kế; việc dọn sạch Thùng rác được thực hiện trên Gmail bản web.
• Hình ảnh trong thư. Theo mặc định, Hark hiển thị hình ảnh từ xa trong thư. Nếu muốn được hỏi trước, hãy đặt “External images” thành “Ask before displaying” trong Settings › General.
• Các cài đặt nằm trên web. Một vài cài đặt Gmail không ứng dụng nào truy cập được. Hark liệt kê chúng trong Settings kèm một liên kết mở Gmail bản web đúng tài khoản, thay vì giả vờ như chúng không tồn tại.

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

Trong bản beta, bộ phím tắt cố ý được giữ nhỏ. Toàn bộ lớp phím tắt của Gmail đang được bổ sung lại từng phím một, mỗi phím đều được giới hạn phạm vi để không thể kích hoạt khi bạn đang gõ thư.

• j và k, hoặc các phím mũi tên di chuyển trong danh sách.
• Esc rời khỏi thư và quay về danh sách.
• In đậm, in nghiêng và gạch chân chưa có phím tắt; chúng nằm trên thanh định dạng khi bạn soạn thư.
• “Zoom In”, “Zoom Out” và “Actual Size” nằm trong menu “View” và thay đổi cỡ chữ của nội dung thư.
• ⌘, mở Settings, như mọi ứng dụng Mac.
• ⇧⌘R mở “Report a Bug”.

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. Bộ nhớ đệm thư, sự kiện và việc cần làm là một cơ sở dữ liệu trong ~/Library/Application Support/Hark, mỗi tài khoản một thư mục, và chỉ người dùng của bạn mới đọc được các tệp trong đó. Tệp đính kèm đã tải về được lưu riêng trong ~/Library/Caches/Hark; hình ảnh từ xa, ảnh người gửi và logo được lưu đệm trong ~/Library/Caches/hark-url-cache, ~/Library/Caches/hark-image-cache và trong kho WebKit của ứng dụng — tất cả đều nằm trong thư mục Thư viện của chính bạn. 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 nằm trong tệp tùy chọn thông thường của ứng dụng.

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 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.

Để gỡ cài đặt, hãy đăng xuất trước — đó là bước thu hồi quyền đã cấp ở phía Google — 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/Application Support/Hark, ~/Library/Caches/Hark, ~/Library/Caches/hark-url-cache, ~/Library/Caches/hark-image-cache, ~/Library/Caches/com.souplin.hark (bộ nhớ đệm tải về của trình cập nhật), ~/Library/HTTPStorages/com.souplin.hark, ~/Library/WebKit/com.souplin.hark và ~/Library/Preferences/com.souplin.hark.plist.

Nếu bạn đã xóa ứng dụng mà chưa đăng xuất, 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.