Đồng bộ hóa#
PocketHook đồng bộ hóa cuộc trò chuyện và cài đặt ứng dụng của bạn trên các thiết bị bằng tài khoản iCloud riêng tư của bạn — không cần tài khoản PocketHook, không có máy chủ bên thứ ba nào tham gia.
| Yêu cầu | Đã đăng nhập iCloud, đã bật iCloud Drive |
| Đồng bộ những gì | Cuộc trò chuyện, cấu hình máy chủ và hầu hết các cài đặt |
| Không đồng bộ những gì | Một vài cài đặt được cố tình đặt riêng theo từng thiết bị — xem phần Tự động mở URL bên dưới |
Đăng nhập cùng một tài khoản iCloud trên iPhone, iPad và Mac của bạn, mọi thứ sẽ tự động xuất hiện — không cần thiết lập gì thêm. Dữ liệu của bạn ở lại trong cơ sở dữ liệu iCloud riêng tư của chính bạn; máy chủ của PocketHook không bao giờ nhìn thấy nó.
Cấu hình Máy chủ#
Các cài đặt kết nối cốt lõi cho máy chủ PocketHook của bạn.
URL Máy chủ#
| Kiểu | Trường văn bản (URL) |
| Mặc định | Trống |
| Lưu trong | iOS Keychain |
Endpoint HTTPS nơi PocketHook gửi các tin nhắn chat của bạn. Chỉ chấp nhận URL HTTPS — HTTP bị từ chối vì lý do bảo mật. Đây là endpoint chính mà máy chủ của bạn lắng nghe.
Token Xác thực#
| Kiểu | Trường văn bản bảo mật |
| Mặc định | Trống |
| Độ dài | 10–1.000 ký tự |
| Lưu trong | iOS Keychain |
Bearer token được gửi trong header Authorization với mọi yêu cầu. Máy chủ của bạn có thể dùng token này để xác minh rằng yêu cầu đến từ thiết bị của bạn. Được lưu an toàn trong iOS Keychain — không bao giờ ở dạng văn bản thuần.
Tương thích OpenClaw#
| Kiểu | Công tắc |
| Mặc định | OFF |
Bật nếu máy chủ của bạn sử dụng nền tảng OpenClaw hoặc bất kỳ API Chat Completions nào tương thích OpenAI. Khi được bật, PocketHook gửi tin nhắn theo định dạng chat của OpenAI và phân tích các đánh dấu phím tắt nội tuyến ([SHORTCUT:name], [DATA:{...}], [URL:...]) từ phản hồi. Header x-openclaw-agent-id được đính kèm với các yêu cầu.
Kiểm tra Kết nối#
Nút gửi một yêu cầu thử nghiệm đến máy chủ đã cấu hình của bạn. Hiển thị:
- Thời gian phản hồi tính bằng mili giây
- Kết quả health check (nếu được bật)
- Chi tiết lỗi nếu kết nối thất bại
Dùng nút này sau khi thay đổi URL Máy chủ hoặc Token Xác thực để xác minh mọi thứ hoạt động.
Mạng#
Tinh chỉnh hành vi thời gian chờ cho các loại thao tác khác nhau.
Thời gian chờ Yêu cầu#
| Kiểu | Stepper (±5 giây) |
| Mặc định | 5 giây |
| Phạm vi | 1–600 giây |
Khoảng thời gian PocketHook đợi máy chủ bắt đầu phản hồi một yêu cầu. Nếu máy chủ của bạn xử lý nặng (như gọi mô hình AI), hãy tăng giá trị này. Với các máy chủ webhook đơn giản, mặc định 5 giây thường là đủ.
Thời gian chờ Tài nguyên#
| Kiểu | Stepper (±10 giây) |
| Mặc định | 60 giây |
| Phạm vi | 30–600 giây |
Thời gian tối đa để toàn bộ phản hồi hoàn tất, bao gồm cả truyền dữ liệu. Giá trị này nên cao hơn Thời gian chờ Yêu cầu. Hãy tăng nếu máy chủ của bạn trả về payload lớn hoặc có tốc độ tải lên chậm.
Health Check#
| Kiểu | Công tắc |
| Mặc định | OFF |
Bật giám sát tình trạng máy chủ. Khi hoạt động, PocketHook gửi yêu cầu GET đến URL Health Check trong các lần kiểm tra kết nối và hiển thị máy chủ của bạn có báo cáo khỏe mạnh hay không.
URL Health Check#
| Kiểu | Trường văn bản (URL) |
| Mặc định | Trống |
| Hiển thị khi | Health Check đang ON |
Một endpoint HTTPS riêng trả về văn bản thuần true hoặc false. URL này được truy vấn trong các lần kiểm tra kết nối để xác minh máy chủ của bạn đang hoạt động. Hữu ích khi endpoint API chính của bạn nằm sau lớp xác thực nhưng bạn muốn một kiểm tra trạng thái đơn giản.
Tự động hóa#
Kiểm soát cách PocketHook thực thi các Phím tắt iOS được kích hoạt bởi phản hồi từ máy chủ.
Phím tắt iOS#
| Kiểu | Công tắc |
| Mặc định | ON |
Công tắc tổng cho việc thực thi Phím tắt. Khi OFF, PocketHook vẫn hiển thị tin nhắn từ máy chủ nhưng bỏ qua mọi trường shortcut trong phản hồi. Hữu ích để gỡ lỗi hoặc tạm thời tắt các tự động hóa.
Độ trễ Giữa các Phím tắt#
| Kiểu | Thanh trượt |
| Mặc định | 2.0 giây |
| Phạm vi | 0.5–10.0 giây |
Thời gian chờ giữa các lần thực thi phím tắt liên tiếp khi máy chủ trả về nhiều tự động hóa trong một phản hồi. Hãy tăng giá trị này nếu các phím tắt của bạn phụ thuộc lẫn nhau (ví dụ: phím tắt thứ nhất tạo một tệp mà phím tắt thứ hai đọc).
Thời gian chờ Phím tắt#
| Kiểu | Bộ chọn phân đoạn |
| Mặc định | 5 phút (300s) |
| Tùy chọn | 30 giây, 1 phút, 2 phút, 5 phút |
Thời gian tối đa để đợi từng phím tắt riêng lẻ hoàn thành trước khi PocketHook coi là hết thời gian chờ. Các phím tắt chạy lâu (như xử lý phương tiện hoặc thực hiện nhiều lệnh gọi API) có thể cần đủ 5 phút.
Giao diện Cá nhân#
Nhúng giao diện web tùy chỉnh trực tiếp vào PocketHook.
Giao diện Cá nhân#
| Kiểu | Công tắc |
| Mặc định | OFF |
Hiển thị một tab riêng với web view được nhúng. Khi được bật, một tab mới xuất hiện trong thanh điều hướng chính, nơi trang web tùy chỉnh của bạn được hiển thị. Trang được tải trước để hiển thị tức thì và hỗ trợ kéo để làm mới.
URL Giao diện Cá nhân#
| Kiểu | Trường văn bản (URL) |
| Mặc định | Trống |
| Hiển thị khi | Giao diện Cá nhân đang ON |
URL hiển thị trong tab Giao diện Cá nhân. Chấp nhận cả HTTP và HTTPS (khuyến nghị HTTPS). Đây có thể là một dashboard, trang quản trị hoặc bất kỳ trang web nào bạn muốn truy cập nhanh bên cạnh cuộc trò chuyện.
Liên kết#
Cấu hình cách PocketHook xử lý các URL từ phản hồi của máy chủ.
Tab Liên kết#
| Kiểu | Công tắc |
| Mặc định | ON |
Hiển thị hoặc ẩn tab Liên kết trong thanh điều hướng chính. Khi được bật, tất cả URL nhận được từ phản hồi của máy chủ sẽ được lưu và hiển thị trong một tab riêng với bản xem trước liên kết phong phú, tính năng tìm kiếm và xóa.
Tự động mở URL#
| Kiểu | Công tắc |
| Mặc định | ON |
| Đã đồng bộ? | Không — được đặt riêng trên từng thiết bị |
Khi được bật, PocketHook tự động mở các URL từ phản hồi của máy chủ trong trình duyệt mặc định của bạn. Khi tắt, URL vẫn được lưu vào tab Liên kết (nếu được bật) nhưng sẽ không tự động mở.
Cài đặt này được đặt riêng theo từng thiết bị một cách có chủ đích: bạn có thể muốn liên kết tự động mở trên iPhone nhưng không muốn trên Mac. Chạm vào viên liên kết bên dưới một tin nhắn luôn mở nó, bất kể cài đặt này.
Ngôn ngữ#
Tùy chỉnh ngôn ngữ của ứng dụng và ngôn ngữ đọc chính tả.
Ngôn ngữ Ứng dụng#
| Kiểu | Bộ chọn |
| Mặc định | Mặc định hệ thống |
| Tùy chọn | Mặc định hệ thống, English, Español |
Ghi đè ngôn ngữ hiển thị của ứng dụng độc lập với ngôn ngữ thiết bị của bạn. Khi đặt là “Mặc định hệ thống”, PocketHook tuân theo cài đặt ngôn ngữ iOS của bạn.
Ngôn ngữ Đọc chính tả#
| Kiểu | Bộ chọn |
| Mặc định | Ngôn ngữ hệ thống |
| Tùy chọn | 21 ngôn ngữ |
Ngôn ngữ dùng cho đọc chính tả bằng giọng nói (chuyển giọng nói thành văn bản) trong ô nhập chat. Các ngôn ngữ khả dụng:
| Ngôn ngữ | Mã |
|---|---|
| Tiếng Anh (Mỹ) | en-US |
| Tiếng Anh (Anh) | en-GB |
| Tiếng Tây Ban Nha (Tây Ban Nha) | es-ES |
| Tiếng Tây Ban Nha (Mexico) | es-MX |
| Tiếng Pháp | fr-FR |
| Tiếng Đức | de-DE |
| Tiếng Ý | it-IT |
| Tiếng Bồ Đào Nha (Brazil) | pt-BR |
| Tiếng Bồ Đào Nha (Bồ Đào Nha) | pt-PT |
| Tiếng Catalan | ca-ES |
| Tiếng Trung (Giản thể) | zh-CN |
| Tiếng Nhật | ja-JP |
| Tiếng Hàn | ko-KR |
| Tiếng Ả Rập | ar-SA |
| Tiếng Nga | ru-RU |
| Tiếng Hà Lan | nl-NL |
| Tiếng Thụy Điển | sv-SE |
| Tiếng Ba Lan | pl-PL |
| Tiếng Thổ Nhĩ Kỳ | tr-TR |
| Tiếng Thái | th-TH |
| Tiếng Việt | vi-VN |
Tác vụ Nền#
Kiểm tra định kỳ các tác vụ đang chờ ngay cả khi ứng dụng chạy nền.
Tác vụ Nền#
| Kiểu | Công tắc |
| Mặc định | OFF |
Bật polling trong nền. Khi hoạt động, PocketHook định kỳ gửi yêu cầu GET đến URL Polling. Nếu phản hồi là true, ứng dụng sẽ gửi Tin nhắn Truy xuất đến máy chủ chính khi được mở. Cần quyền thông báo để cảnh báo bạn về các tác vụ đang chờ.
Khoảng thời gian Kiểm tra#
| Kiểu | Bộ chọn phân đoạn |
| Mặc định | 15 phút |
| Tùy chọn | 5 phút, 15 phút, 30 phút, 1 giờ, 2 giờ |
Tần suất PocketHook kiểm tra URL Polling trong nền. Khoảng thời gian ngắn hơn đồng nghĩa phát hiện tác vụ đang chờ nhanh hơn nhưng tốn pin hơn. iOS có thể điều chỉnh tần suất thực tế dựa trên thói quen sử dụng thiết bị.
URL Polling#
| Kiểu | Trường văn bản (URL) |
| Mặc định | Trống |
| Hiển thị khi | Tác vụ Nền đang ON |
Endpoint HTTPS mà PocketHook truy vấn theo khoảng thời gian đã cấu hình. Phải trả về văn bản thuần true (có tác vụ đang chờ) hoặc false (không có tác vụ). Đây là một kiểm tra nhẹ — máy chủ của bạn nên phản hồi nhanh mà không xử lý nặng.
Agent Server: Dùng https://your-host/jobs (điều chỉnh host và cổng cho phù hợp với thiết lập của bạn).
Tin nhắn Truy xuất#
| Kiểu | Trường văn bản |
| Mặc định | fetchPendingTasks |
| Độ dài tối đa | 10.000 ký tự |
Tin nhắn được gửi đến máy chủ chính của bạn khi một lần kiểm tra nền phát hiện tác vụ đang chờ và ứng dụng được mở. Phản hồi của máy chủ xuất hiện trong chat như bất kỳ tin nhắn nào khác. Tùy chỉnh tin nhắn này để kích hoạt hành vi cụ thể phía máy chủ.
Quản lý Dữ liệu#
Theo dõi và quản lý các tin nhắn đã lưu của bạn.
Tin nhắn Đã lưu#
| Kiểu | Hiển thị chỉ đọc |
| Định dạng | “X trên 500 tin nhắn” |
Hiển thị số tin nhắn hiện đang được lưu. Chỉ báo được mã hóa theo màu:
- Xanh lá — Dưới 70% dung lượng
- Cam — 70–90% dung lượng
- Đỏ — Trên 90% dung lượng
Khi đạt giới hạn 500 tin nhắn, các tin nhắn cũ nhất sẽ tự động bị xóa để nhường chỗ cho tin nhắn mới.
Xuất Cuộc trò chuyện#
Nút xuất tất cả tin nhắn đã lưu dưới dạng tệp JSON thông qua share sheet của iOS. Bạn có thể lưu tệp, gửi qua AirDrop hoặc chia sẻ với bất kỳ ứng dụng nào. Hữu ích để sao lưu cuộc trò chuyện hoặc phân tích lịch sử tin nhắn.
Xóa Tất cả Tin nhắn#
Nút phá hủy dữ liệu, xóa vĩnh viễn tất cả tin nhắn đã lưu. Yêu cầu xác nhận trước khi thực hiện. Hành động này không thể hoàn tác.
Giới thiệu#
Thông tin chỉ đọc về bản cài đặt PocketHook của bạn.
| Trường | Mô tả |
|---|---|
| Phiên bản Ứng dụng | Phiên bản PocketHook hiện tại (ví dụ: 1.0.0) |
| Build | Số build của bản phát hành này |
| Phiên bản iOS | Phiên bản iOS/iPadOS đang chạy trên thiết bị của bạn |