Chuyển đến nội dung chính
Hướng dẫn này bao gồm các vấn đề thường gặp bạn có thể gặp khi dùng Craft và cách khắc phục. Để xem các vấn đề theo tính năng, hãy mở rộng các mục tương ứng bên dưới.
Một số chủ đề khắc phục sự cố được đề cập trong tài liệu tính năng của chúng tôi:

Vấn đề đồng bộ

Cách dễ nhất để khắc phục là đóng hoàn toàn và khởi động lại ứng dụng:Trên iOS:
  • Buộc thoát ứng dụng
  • Chờ khoảng 30 giây
  • Mở lại ứng dụng
Trên Mac:
  1. Mở Activity Monitor (tìm trong Spotlight hoặc trong Applications > Utilities)
  2. Tìm Craft trong danh sách
  3. Chọn Craft rồi nhấn nút dừng ở trên cùng
  4. Mở lại Craft
Sau khi khởi động lại, vào Cài đặt > Chẩn đoán để kiểm tra Tình trạng đồng bộ.
Kiểm tra bạn có đang dùng cùng một tài khoản không:Nếu bạn không thấy một số Tài liệu trên thiết bị, hãy xác nhận bạn đã đăng nhập bằng cùng một tài khoản và phương thức đăng nhập (Email hoặc Sign in with Apple).Để kiểm tra địa chỉ email của bạn:
  • Mac: Địa chỉ email hiển thị ở góc trên bên trái bên cạnh avatar trong danh sách Tài liệu
  • iPad: Chạm vào avatar ở góc trên bên trái trong danh sách Tài liệu để mở Danh sách Không gian và xem địa chỉ email
  • iPhone: Chạm vào avatar ở góc dưới bên phải trong danh sách Tài liệu để mở Danh sách Không gian và xem địa chỉ email
Nếu bạn thấy một địa chỉ email kết thúc bằng @privaterelay.appleid.com, điều đó nghĩa là bạn đã đăng nhập bằng Sign in with Apple, và đây là địa chỉ email được tạo tự động.
Mở Cài đặt > Chẩn đoán và nhấn nút Đồng bộ ngay. Sau khi nhấn, ứng dụng sẽ cố gắng khởi động lại quy trình đồng bộ.
Trong một số trường hợp, sử dụng VPN, bộ chặn quảng cáo (ví dụ: AdGuard) hoặc ứng dụng giám sát mạng (ví dụ: LittleSnitch) có thể ngăn việc đồng bộ giữa các thiết bị. Hãy thử:
  1. Tạm thời vô hiệu hóa các ứng dụng này
  2. Khởi động lại Craft
  3. Kiểm tra xem kết nối đồng bộ đã phục hồi chưa
Các tiện ích mở rộng trình duyệt như “Hush” và “Plume Guard” cũng có thể chặn truy cập tới máy chủ của Craft.
Cấu hình mạng công ty, tường lửa và chương trình bảo mật có thể chặn lưu lượng tới Craft. Nếu bạn dùng Craft tại nơi làm việc, hãy hỏi bộ phận IT về cấu hình mạng.Họ có thể cần cho phép truy cập các URL sau:
  • api.craft.do
  • docs.craft.do
  • res.craft.do
Xem thêm: Không thể truy cập Craft trên Web/Windows cho các vấn đề mạng liên quan.

Vấn đề đăng nhập

Khi bạn chọn Continue with Apple trên Mac, hệ thống sẽ yêu cầu mật khẩu. Đây là biện pháp bảo mật của Apple.Quan trọng: Bạn cần nhập mật khẩu tài khoản trên máy Mac của bạn, không phải mật khẩu Apple ID.Nếu bạn nhập mật khẩu Apple ID, hộp thoại sẽ chỉ hiện lại mà không báo lỗi.
Một số tiện ích trình duyệt, bộ chặn quảng cáo hoặc mạng riêng tư có thể ngăn bạn truy cập trang web hoặc ứng dụng Craft. Lỗi phổ biến gồm “Server Not Found” hoặc trang không tải.Ứng dụng thường gây ra lỗi này:Giải pháp:
  1. Tạm thời vô hiệu hóa các tiện ích này
  2. Đánh dấu domain của Craft là an toàn trong cấu hình của chúng
  3. Thử dùng một mạng khác
Nếu vấn đề vẫn xảy ra trên nhiều mạng và cả dữ liệu di động, vui lòng liên hệ hỗ trợ.

Vấn đề hiệu năng

Nếu bạn gặp vấn đề hiệu năng, thử các bước sau:Sửa nhanh:
  1. Khởi động lại ứng dụng qua Activity Monitor (xem phần vấn đề đồng bộ phía trên)
  2. Đóng các tab và cửa sổ không cần thiết
  3. Kiểm tra xem bạn có đang dùng ứng dụng quản lý cửa sổ (ví dụ như Magnet) và đảm bảo chúng đã được cập nhật
Thông tin nên cung cấp cho bộ phận hỗ trợ:Nếu vấn đề vẫn còn, hãy thu thập thông tin sau trước khi liên hệ hỗ trợ:
  • Bạn có đang dùng Không gian dựa trên External Storage không?
  • Bạn có đang dùng bất kỳ ứng dụng quản lý cửa sổ nào không?
  • Có công cụ bên thứ ba nào để chỉnh sửa văn bản không?
  • Ảnh chụp màn hình các ứng dụng được cài đặt trong System Settings > Privacy & Security > Accessibility
  • Khởi động lại ứng dụng có giúp không?
  • Có phải nhiều tab và cửa sổ gây ra vấn đề không?
Tạo Spindump (cho vấn đề kéo dài):
  1. Mở Activity Monitor
  2. Nhấp vào three-dot menu (⋯)
  3. Chọn Spindump
  4. Lưu file và gửi cho bộ phận hỗ trợ
Nếu bạn gặp vấn đề hiệu năng trên Windows, kiểm tra:
  1. Bạn đang chạy phiên bản Windows nào?
  2. Bạn có đang kết nối vào mạng công ty/VPN không?
  3. Khởi động lại ứng dụng có giúp phục hồi hiệu năng không?
  4. Khởi động lại máy tính có giúp không?
Nếu vấn đề vẫn tồn tại, hãy ghi lại video toàn màn hình mô tả lỗi/hành vi bất thường và chia sẻ với bộ phận hỗ trợ.
Để dùng Grammarly Desktop với app Craft trên Mac:
1
Tải Grammarly desktop từ grammarly.com/desktop
2
Sau khi cài, khởi chạy ứng dụng Grammarly
3
Làm theo hướng dẫn để bật Grammarly trong System Settings > Privacy & Security > Accessibility
4
Khởi động lại Craft
Widget của Grammarly bây giờ sẽ có sẵn khi bạn chọn một Khối để được kiểm tra.

Vấn đề riêng cho macOS

Nếu bạn không thấy phiên bản Craft mới nhất trong App Store (chỉ thấy nút “Open”):
1
Force quit App Store
2
Khởi động lại App Store
3
Tìm kiếm “Craft Docs”
4
Nhấp vào tiêu đề để vào trang chi tiết ứng dụng
5
Kiểm tra xem có nút cập nhật ở đó không
Thông báo này xuất hiện khi còn file sót lại từ lần cài trước. Thường xảy ra nếu bạn đã cài Craft từ nhiều nguồn (ví dụ App Store và Setapp).Cách giải quyết:
1
Xóa Craft khỏi thư mục Applications
2
Trong Finder, vào Go > Go to Folder và dán từng đường dẫn sau, xóa nội dung bên trong:
~/Library/Group Containers/group.com.lukilabs.lukiapp.share/
~/Library/Containers/com.lukilabs.lukiapp
3
Nếu vẫn không được, kiểm tra cả thư mục Group ContainersContainers để tìm file chứa “craft”, “lukilabs” hoặc “lukiapp” và xóa chúng
4
Cài lại Craft từ nguồn bạn chọn

Vấn đề riêng cho iOS/iPadOS

Hiện tại, bạn có thể chia sẻ văn bản và liên kết qua Share Sheet với Craft. Nếu bạn cố chia sẻ ảnh hoặc file, có thể sẽ nhận liên kết không sử dụng được.Giải pháp tạm thời:Tùy chọn 1: Sao chép và dán
  1. Chọn Copy trong Share Sheet
  2. Mở Craft
  3. Dán vào Tài liệu phù hợp
Tùy chọn 2: Tải về và thêm file
  1. Tải file về thiết bị của bạn
  2. Trong Craft, tap nút + ở góc dưới bên trái
  3. Chọn tùy chọn Files
  4. Chọn file từ thiết bị của bạn

Vấn đề riêng cho Windows/Web

Khi truy cập Craft trên thiết bị hoặc mạng công ty, giải pháp proxy của công ty có thể đang chặn truy cập.Yêu cầu bộ phận IT cho phép các URL sau:
  • api.craft.do
  • docs.craft.do
  • res.craft.do
Thông báo này nghĩa là ứng dụng tạm thời mất kết nối internet hoặc tới máy chủ của chúng tôi. Ứng dụng sẽ tự cố gắng kết nối lại.Cần làm gì:
  • Kiểm tra kết nối Internet: Đảm bảo kết nối ổn định
  • Tạm dừng chỉnh sửa: Để tránh mất dữ liệu, tạm dừng chỉnh sửa cho tới khi ứng dụng online trở lại
  • Tải lại trang: Nếu kết nối ổn định và bạn không có thay đổi chưa lưu, thử tải lại trang
Thông báo sẽ biến mất ngay khi kết nối được phục hồi.
Khi dùng phiên bản Web của Craft, bạn có thể thấy thumbnail cho một số liên kết dán (ví dụ LinkedIn) không hiển thị đúng, hiện “Failed to fetch data.”Giải thích: Nhà cung cấp bên thứ ba chúng tôi dùng để lấy dữ liệu link có thể đã bị chặn. Đây là vấn đề bên ngoài tầm kiểm soát trực tiếp của chúng tôi.Tin tốt:
  • Liên kết vẫn hoạt động khi nhấp
  • Vấn đề chỉ ảnh hưởng phiên bản Web
  • Chỉ ảnh hưởng tới liên kết hồ sơ LinkedIn cá nhân
  • Liên kết LinkedIn công ty hiển thị bình thường
  • Tất cả thumbnail LinkedIn hoạt động bình thường trên Mac, iOS và iPad apps
Craft cho Windows tự động cập nhật khi bạn thoát và mở lại ứng dụng. Bạn sẽ thấy thông báo trong khu vực thông báo của Windows (góc dưới phải) khi có phiên bản mới.Bạn cũng có thể cập nhật thủ công bằng cách:
  1. Gỡ cài đặt Craft cho Windows
  2. Tải phiên bản mới nhất từ craft.do/download hoặc từ Windows App Store

Vấn đề dữ liệu & lưu trữ

Thư mục Recently Deleted có thể biến mất vì hai lý do:
  1. Các tài liệu đã xóa hơn 30 ngày trước
  2. Nội dung trong thư mục đã bị xóa thủ công
Nếu bạn xóa nhầm, kiểm tra các tùy chọn khôi phục trong tài liệu Storage and Recovery.
Vấn đề: Khi cố thêm lại một External location, bạn nhận lỗi “External location already added” nhưng không thấy nó hiển thị như một Không gian.Giải pháp:
1
Sign out khỏi ứng dụng Craft
2
Sign back in
3
Thử thêm External location lại
Nếu vẫn gặp thông báo như cũ:
  1. Xóa ứng dụng Craft khỏi thiết bị
  2. Cài lại ứng dụng
  3. Thử thêm External location
Độ tin cậy và hiệu năng của iCloud Drive nằm ngoài tầm kiểm soát của chúng tôi. Nếu đồng bộ không hoạt động, các mẹo sau có thể giúp:
Chúng tôi KHÔNG khuyến nghị sử dụng Không gian External across multiple devices vì có thể dẫn đến xung đột dữ liệu và mất dữ liệu. Nếu bạn không chắc cách dùng Không gian, vui lòng liên hệ hỗ trợ.
Các bước khắc phục:
  1. Kích hoạt đồng bộ thủ công: Mở Finder trên Mac hoặc ứng dụng Files trên iOS và điều hướng tới thư mục iCloud Drive của bạn
  2. Chỉnh sửa một Tài liệu: Thay đổi nội dung của một Tài liệu để kích hoạt quy trình đồng bộ
  3. Kiểm tra truy cập Internet: Đảm bảo bạn đang dùng Wi‑Fi hoặc kết nối di động nhanh. Đảm bảo thiết bị được sạc
  4. Bật/Tắt Airplane Mode: Ngắt và kết nối lại mạng có thể kích hoạt đồng bộ iCloud Drive
  5. Kiểm tra cài đặt đồng bộ di động:
    • Bật “System Services” trong Settings > Cellular Data
    • Bật “Use Cellular Data” trong Settings > iCloud > iCloud Drive
  6. Kiểm tra mức pin: Khi pin thấp, thiết bị sẽ đồng bộ chậm hơn để tiết kiệm năng lượng
  7. Kiểm tra giới hạn dung lượng iCloud: Craft không thể đồng bộ nếu bạn đã đầy dung lượng
  8. Khởi động lại thiết bị: Đảm bảo dịch vụ iCloud đang chạy nền
  9. Xác nhận iCloud đã được bật:
    • iOS: Đăng nhập iCloud bằng Apple ID và bật iCloud Drive
    • Mac: Đăng nhập iCloud và đảm bảo iCloud Drive được bật trong Apple ID settings
  10. Tắt ‘Optimize Mac Storage’: Tùy chọn này có trong Apple ID settings. Nếu bật, Mac sẽ tải nội dung lên đám mây và có thể dẫn đến file bị ẩn
  11. Kiên nhẫn: Đồng bộ iCloud Drive có thể mất thời gian, đặc biệt khi lần đầu sử dụng. Có thể mất tới cả ngày để bắt đầu
  12. Sign out và Sign in lại: Nếu iCloud Drive bị treo hoặc rất chậm, đăng xuất và đăng nhập lại iCloud có thể giúp
  13. Đặt giờ tự động: Đảm bảo tất cả thiết bị bật cài đặt giờ tự động
  14. Cập nhật hệ điều hành: Apple liên tục cải tiến iCloud qua các bản OS mới
  15. Kiểm tra trạng thái dịch vụ của Apple: Truy cập Apple’s System Status page để kiểm tra iCloud có hoạt động không

Báo lỗi

Nếu bạn gặp lỗi trong Craft, chúng tôi rất cảm kích nếu bạn giúp ghi lại. Báo cáo rõ ràng giúp đội ngũ điều tra và sửa lỗi nhanh hơn.

Trước khi báo lỗi

  • Đảm bảo bạn đang dùng phiên bản mới nhất của Craft
  • Khởi động lại ứng dụng hoặc làm mới phiên bản web
  • Nếu vấn đề vẫn xảy ra, tiếp tục gửi báo cáo

Những gì cần đưa vào báo cáo lỗi

  1. Xác nhận phiên bản: Cho biết bạn có đang dùng phiên bản mới nhất không
  2. Môi trường của bạn:
    • Mẫu thiết bị (ví dụ: MacBook Pro, iPhone 14, laptop Windows)
    • Hệ điều hành và phiên bản (ví dụ: macOS Sonoma 14.2, iOS 17.3, Windows 11)
    • Nền tảng (desktop app, mobile app, hoặc web version)
  3. Mô tả các bước dẫn tới lỗi:
    • Ghi rõ các hành động chính xác đã làm dẫn tới lỗi
    • Ví dụ: “Mở một Tài liệu > Thêm trang mới > Chèn ảnh > Xuất hiện lỗi”
  4. Đính kèm video quay màn hình:
    • Giữ video ngắn và tập trung vào lỗi
    • Thực hiện các hành động cách nhau để dễ theo dõi
    • Quay toàn màn hình (không cắt)
    • Dùng độ phân giải cao nhất có thể
    • Ảnh chụp màn hình cũng hữu ích cho lỗi giao diện hoặc thông báo lỗi

Cách quay màn hình

iPhone: Mac: Windows:

Sau khi bạn gửi báo cáo

  • Vấn đề một lần: Chúng tôi sẽ ghi nhận và theo dõi các trường hợp liên quan
  • Lỗi có thể tái tạo: Chúng tôi sẽ nâng cấp và điều tra nội bộ để sửa
Cảm ơn bạn đã dành thời gian báo lỗi. Những phản hồi của bạn giúp chúng tôi làm Craft tốt hơn cho mọi người.

Vẫn cần trợ giúp?

Nếu bạn không tìm được giải pháp ở đây, chúng tôi luôn sẵn sàng hỗ trợ: