> ## Documentation Index
> Fetch the complete documentation index at: https://craft-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Khắc phục sự cố

> Giải pháp cho các vấn đề thường gặp về đồng bộ, hiệu suất, đăng nhập, kết nối, lưu trữ và các vấn đề theo nền tảng trong Craft.

Hướng dẫn này đề cập đến các vấn đề thường gặp khi sử dụng Craft và cách khắc phục. Mở rộng các mục bên dưới để tìm chủ đề phù hợp với vấn đề của bạn.

<Info title="Cần trợ giúp về tính năng cụ thể?">
  Một số chủ đề khắc phục sự cố nằm trong tài liệu tính năng tương ứng:

  * [Vấn đề về Lịch](/vi/plan-and-do/calendar#troubleshooting)
  * [Vấn đề về tên miền tùy chỉnh](/vi/share-and-publish/publish/domains#troubleshooting)
  * [Vấn đề về chia sẻ](/vi/share-and-publish/share#troubleshooting)
  * [Vấn đề về đăng ký](/vi/account-and-subscription/billing#troubleshooting)
  * [Di chuyển bảng trắng](/vi/write-and-edit/whiteboards#updating-legacy-whiteboards)
</Info>

## Vấn đề đồng bộ

Hầu hết các sự cố đồng bộ có thể được chẩn đoán và khắc phục từ bảng **Chẩn đoán**. Mở **Cài đặt → Chẩn đoán** để xem trạng thái đồng bộ hiện tại, kích hoạt đồng bộ thủ công hoặc báo cáo lỗi đồng bộ trực tiếp đến đội ngũ của chúng tôi.

<Frame>
  <img src="https://mintcdn.com/craft-support/2Bd_9qGHtOA1AMgv/images/introduction/troubleshooting/en/content/diagnostics-settings.png?fit=max&auto=format&n=2Bd_9qGHtOA1AMgv&q=85&s=83b336be8c0f04d2d4dc169c3dbad717" alt="Bảng Cài đặt Chẩn đoán trong Craft hiển thị trạng thái đồng bộ, liên kết khắc phục sự cố, lịch sử đồng bộ và tùy chọn Đặt lại đồng bộ" width="1567" height="1103" data-path="images/introduction/troubleshooting/en/content/diagnostics-settings.png" />
</Frame>

<AccordionGroup>
  <Accordion title="Đồng bộ hiển thị là Ngoại tuyến trong phần chẩn đoán">
    Cách khắc phục nhanh nhất là đóng hoàn toàn và khởi động lại Craft.

    <Tabs>
      <Tab title="macOS">
        1. Mở **Activity Monitor** (tìm kiếm bằng Spotlight hoặc vào Applications → Utilities)
        2. Tìm **Craft** trong danh sách
        3. Chọn và nhấp nút **Stop** (⊗) ở trên cùng
        4. Mở lại Craft
      </Tab>

      <Tab title="iOS / iPadOS">
        1. Buộc thoát Craft (vuốt lên và ném thẻ Craft đi)
        2. Chờ khoảng 30 giây
        3. Mở lại Craft
      </Tab>

      <Tab title="Windows">
        1. Nhấp chuột phải vào biểu tượng Craft trong thanh tác vụ và chọn **Close window**
        2. Nếu ứng dụng vẫn đang chạy, mở **Task Manager**, tìm **Craft** và nhấp **End task**
        3. Mở lại Craft
      </Tab>
    </Tabs>

    Sau khi khởi động lại, mở **Cài đặt → Chẩn đoán** và kiểm tra trạng thái đồng bộ ở đầu bảng.
  </Accordion>

  <Accordion title="Tài liệu không đồng bộ trên các thiết bị">
    Trước tiên, hãy xác nhận bạn đang đăng nhập bằng **cùng một tài khoản và phương thức đăng nhập** trên mọi thiết bị. Email và **Đăng nhập bằng Apple** tạo ra các tài khoản khác nhau ngay cả khi địa chỉ email trông giống nhau.

    Để kiểm tra địa chỉ email của bạn:

    <Tabs>
      <Tab title="macOS">
        Email của bạn hiển thị ở góc trên bên trái của danh sách Tài liệu, bên cạnh ảnh đại diện.
      </Tab>

      <Tab title="iPad">
        Nhấn vào ảnh đại diện ở góc trên bên trái của danh sách Tài liệu để mở danh sách Spaces.
      </Tab>

      <Tab title="iPhone">
        Nhấn vào ảnh đại diện ở góc dưới bên phải của danh sách Tài liệu để mở danh sách Spaces.
      </Tab>
    </Tabs>

    <Info title="Về địa chỉ @privaterelay.appleid.com">
      Nếu email của bạn kết thúc bằng `@privaterelay.appleid.com`, bạn đã đăng ký bằng **Đăng nhập bằng Apple**. Đây là địa chỉ chuyển tiếp do Apple tạo ra, không phải email thực của bạn. Hãy đảm bảo bạn sử dụng cùng một Apple ID trên mọi thiết bị.
    </Info>
  </Accordion>

  <Accordion title="Kích hoạt đồng bộ thủ công">
    Mở **Cài đặt → Chẩn đoán** và nhấn **Sync Now**. Ứng dụng sẽ cố gắng khởi động lại quá trình đồng bộ.

    Nếu **Sync Now** không giải quyết được vấn đề:

    <Tabs>
      <Tab title="macOS / iOS">
        1. Đăng xuất khỏi Craft (**Cài đặt → Tài khoản → Đăng xuất**)
        2. Buộc thoát ứng dụng
        3. Chờ 30 giây, mở lại Craft và đăng nhập lại
      </Tab>

      <Tab title="Windows / Web">
        1. Khởi động lại ứng dụng (Windows) hoặc xóa bộ nhớ đệm trình duyệt (Web)
        2. Kiểm tra kết nối internet, tốt nhất là thử mạng khác
        3. Đăng xuất và đăng nhập lại
      </Tab>
    </Tabs>

    Nếu tài liệu xuất hiện trên một thiết bị nhưng không xuất hiện trên thiết bị khác, hãy kiểm tra lại tài khoản và phương thức đăng nhập trên cả hai (xem **Tài liệu không đồng bộ trên các thiết bị** ở trên).
  </Accordion>

  <Accordion title="VPN hoặc trình chặn quảng cáo chặn đồng bộ">
    VPN, trình chặn quảng cáo (ví dụ: **AdGuard**) và công cụ giám sát mạng (ví dụ: **Little Snitch**) có thể ngăn Craft đồng bộ.

    1. Tạm thời tắt công cụ đó
    2. Khởi động lại Craft
    3. Kiểm tra xem đồng bộ đã được khôi phục 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 quyền truy cập vào máy chủ của Craft.
  </Accordion>

  <Accordion title="Mạng công ty chặn Craft">
    Tường lửa và chương trình bảo mật của công ty có thể chặn lưu lượng truy cập vào Craft. Nếu bạn đang dùng mạng công ty, hãy yêu cầu bộ phận IT cho phép các tên miền sau:

    * `api.craft.do`
    * `docs.craft.do`
    * `res.craft.do`

    Xem thêm: [Không thể truy cập Craft trên ứng dụng Web hoặc Windows](#cant-access-craft-on-web-app-or-windows).
  </Accordion>
</AccordionGroup>

## Vấn đề đăng nhập

<AccordionGroup>
  <Accordion title="Không thể đăng nhập bằng Apple ID trên macOS">
    Khi bạn chọn **Tiếp tục với Apple** trên Mac, bạn sẽ được yêu cầu nhập mật khẩu. Đây là biện pháp bảo mật của Apple.

    <Warning>
      Nhập mật khẩu **tài khoản người dùng macOS** 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ẽ xuất hiện lại mà không có thông báo lỗi.
    </Warning>
  </Accordion>

  <Accordion title="Không thể truy cập trang web hoặc ứng dụng Craft">
    Một số tiện ích mở rộng trình duyệt, trình chặn quảng cáo hoặc mạng riêng tư có thể ngăn bạn truy cập Craft. Các triệu chứng thường gặp bao gồm **Server Not Found** hoặc trang web không tải được.

    Các ứng dụng được biết là gây ra vấn đề này:

    * [Hush](https://oblador.github.io/hush/)
    * **Plume Guard** (tính năng Secure DNS trong ứng dụng Plume HomePass)

    **Thử các bước sau:**

    1. Tạm thời tắt tiện ích mở rộng hoặc công cụ đó
    2. Đánh dấu tên miền của Craft là an toàn trong cấu hình của công cụ
    3. Thử 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ệ bộ phận hỗ trợ.
  </Accordion>
</AccordionGroup>

## Vấn đề hiệu suất

<AccordionGroup>
  <Accordion title="Craft chạy chậm trên macOS">
    **Khắc phục nhanh:**

    1. Khởi động lại ứng dụng qua **Activity Monitor** (xem [Đồng bộ hiển thị là Ngoại tuyến](#sync-shows-as-offline-in-diagnostics) ở trên để biết các bước)
    2. Đóng các tab và cửa sổ không sử dụng
    3. Kiểm tra xem các ứng dụng quản lý cửa sổ (ví dụ: **Magnet**, **Rectangle**) đã được cập nhật chưa

    **Thông tin cần cung cấp khi liên hệ hỗ trợ:**

    * Bạn có đang dùng không gian **External Storage** không?
    * Có ứng dụng quản lý cửa sổ nào đang sử dụng không?
    * Có công cụ chỉnh sửa văn bản của bên thứ ba nào không?
    * Ảnh chụp màn hình **System Settings → Privacy & Security → Accessibility**
    * Khởi động lại ứng dụng có giúp ích không?
    * Nhiều tab và cửa sổ có gây ra vấn đề không?

    Đối với tình trạng chậm kéo dài, hãy gửi cho chúng tôi một **Spindump**. Xem [Ghi lại dữ liệu chẩn đoán](#capture-diagnostic-data) trong phần *Báo cáo lỗi* để biết các bước thực hiện.
  </Accordion>

  <Accordion title="Craft chạy chậm trên Windows">
    Hãy kiểm tra các điểm sau:

    1. Bạn đang chạy **phiên bản Windows** nào?
    2. Bạn có đang kết nối với mạng công ty hoặc VPN không?
    3. Khởi động lại ứng dụng có khôi phục hiệu suất bình thường không?
    4. Khởi động lại máy tính có khôi phục hiệu suất bình thường không?

    Nếu vấn đề vẫn tiếp diễn, hãy quay video toàn màn hình về sự cố và chia sẻ với bộ phận hỗ trợ. Xem [Ghi lại dữ liệu chẩn đoán](#capture-diagnostic-data) trong phần *Báo cáo lỗi* để biết thêm nhật ký bạn có thể đính kèm.
  </Accordion>

  <Accordion title="Sử dụng Grammarly Desktop với Craft trên macOS">
    Để sử dụng ứng dụng Grammarly desktop với Craft trên macOS:

    <Steps>
      <Step title="Tải Grammarly">
        Tải ứng dụng desktop từ [grammarly.com/desktop](https://www.grammarly.com/desktop).
      </Step>

      <Step title="Khởi chạy Grammarly">
        Mở ứng dụng sau khi cài đặt.
      </Step>

      <Step title="Cấp quyền trợ năng">
        Làm theo hướng dẫn trong ứng dụng để bật Grammarly trong **System Settings → Privacy & Security → Accessibility**.
      </Step>

      <Step title="Khởi động lại Craft">
        Thoát và mở lại ứng dụng Craft.
      </Step>
    </Steps>

    Widget Grammarly sẽ xuất hiện mỗi khi bạn chọn một khối.
  </Accordion>
</AccordionGroup>

## Vấn đề riêng trên macOS

<AccordionGroup>
  <Accordion title="Bản cập nhật mới nhất không hiển thị trong App Store">
    Nếu bạn chỉ thấy nút **Open** trong App Store thay vì bản cập nhật:

    <Steps>
      <Step title="Buộc thoát App Store" />

      <Step title="Mở lại App Store" />

      <Step title="Tìm kiếm Craft Docs" />

      <Step title="Mở trang chi tiết ứng dụng">
        Nhấp vào tên ứng dụng để vào chế độ xem chi tiết đầy đủ.
      </Step>

      <Step title="Kiểm tra nút cập nhật" />
    </Steps>
  </Accordion>

  <Accordion title="Cửa sổ pop-up: Another Craft is already installed">
    Thông báo này xuất hiện khi các tệp còn sót lại từ lần cài đặt trước vẫn còn trên máy Mac của bạn. Thường xảy ra khi Craft được cài đặt từ nhiều nguồn (ví dụ: cả App Store và Setapp).

    <Steps>
      <Step title="Xóa Craft khỏi thư mục Applications" />

      <Step title="Xóa các thư mục container">
        Trong Finder, vào **Go → Go to Folder** và dán lần lượt các đường dẫn sau, sau đó xóa nội dung bên trong:

        ```
        ~/Library/Group Containers/group.com.lukilabs.lukiapp.share/
        ~/Library/Containers/com.lukilabs.lukiapp
        ```
      </Step>

      <Step title="Tìm kiếm các tệp còn sót lại">
        Nếu thông báo vẫn xuất hiện, hãy tìm trong cả hai thư mục **Group Containers** và **Containers** các mục có chứa `craft`, `lukilabs` hoặc `lukiapp` và xóa chúng.
      </Step>

      <Step title="Cài đặt lại Craft">
        Cài đặt Craft mới từ nguồn bạn muốn.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## Vấn đề riêng trên iOS / iPadOS

<AccordionGroup>
  <Accordion title="Chia sẻ tệp tạo ra liên kết không sử dụng được">
    Bạn có thể chia sẻ **văn bản và liên kết** vào Craft qua Share Sheet. Chia sẻ **ảnh hoặc tệp** trực tiếp có thể tạo ra liên kết không sử dụng được.

    **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 đích

    **Tùy chọn 2: Tải xuống và thêm**

    1. Lưu tệp vào thiết bị của bạn
    2. Trong Craft, nhấn nút **+** ở góc dưới bên trái
    3. Chọn **Files**
    4. Chọn tệp
  </Accordion>
</AccordionGroup>

## Vấn đề trên Windows và ứng dụng Web

<AccordionGroup>
  <Accordion title="Không thể truy cập Craft trên ứng dụng Web hoặc Windows">
    Trên thiết bị hoặc mạng của công ty, proxy của công ty có thể đang chặn quyền truy cập.

    Hãy yêu cầu bộ phận IT cho phép các tên miền sau:

    * `api.craft.do`
    * `docs.craft.do`
    * `res.craft.do`
  </Accordion>

  <Accordion title="Thông báo You Are Offline">
    Thông báo này có nghĩa là ứng dụng đã mất kết nối với internet hoặc máy chủ của chúng tôi. Ứng dụng sẽ tự động 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 đang hoạt động và ổn định.
    * **Tạm dừng chỉnh sửa.** Tránh thực hiện thay đổi cho đến khi kết nối được khôi phục để tránh mất dữ liệu.
    * **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, hãy làm mới trang.

    Thông báo sẽ biến mất ngay khi kết nối được khôi phục.
  </Accordion>

  <Accordion title="Hình thu nhỏ không lấy được dữ liệu">
    Trên ứng dụng Web, một số liên kết được dán (ví dụ: LinkedIn) có thể hiển thị **Failed to fetch data** thay vì hình thu nhỏ.

    Dịch vụ bên thứ ba mà chúng tôi sử dụng để lấy bản xem trước liên kết bị chặn bởi một số nhà cung cấp. Đây là vấn đề bên ngoài mà chúng tôi không thể kiểm soát trực tiếp.

    **Những gì vẫn hoạt động:**

    * Nhấp vào liên kết vẫn mở bình thường
    * Chỉ ảnh hưởng đến **ứng dụng Web**
    * Chỉ ảnh hưởng đến **liên kết hồ sơ LinkedIn cá nhân**
    * **Liên kết LinkedIn công ty** hiển thị đúng
    * Tất cả hình thu nhỏ LinkedIn hiển thị đúng trên **macOS, iOS và iPad**
  </Accordion>

  <Accordion title="Cách cập nhật Craft cho Windows">
    Craft cho Windows tự động cập nhật khi bạn thoát và mở lại ứng dụng. Một thông báo sẽ xuất hiện trong bảng thông báo Windows (góc dưới bên phải) khi có phiên bản mới.

    Để cập nhật thủ công:

    1. Gỡ cài đặt Craft cho Windows
    2. Tải phiên bản mới nhất từ [craft.do/download](https://www.craft.do/download) hoặc [Microsoft Store](https://apps.microsoft.com/store/detail/craft/9P9K8RN4TV3H)
  </Accordion>
</AccordionGroup>

## Vấn đề đăng ký

<AccordionGroup>
  <Accordion title="Vẫn thấy giới hạn khối sau khi nâng cấp">
    Nếu bạn vừa nâng cấp nhưng Craft vẫn hiển thị giới hạn gói miễn phí (1.500 khối), ứng dụng có thể chưa làm mới trạng thái đăng ký của bạn.

    1. Đăng xuất khỏi Craft (**Cài đặt → Tài khoản → Đăng xuất**)
    2. Đóng hoàn toàn ứng dụng
    3. Mở lại Craft và đăng nhập lại

    Gói đã nâng cấp của bạn sẽ được áp dụng. Nếu không, hãy đảm bảo bạn đang đăng nhập bằng **cùng tài khoản** bạn đã dùng để mua đăng ký.
  </Accordion>
</AccordionGroup>

## Vấn đề dữ liệu và lưu trữ

<AccordionGroup>
  <Accordion title="Thư mục Đã xóa gần đây biến mất">
    Thư mục **Đã xóa gần đây** có thể biến mất vì hai lý do:

    1. Các tài liệu đã xóa cũ hơn **30 ngày**
    2. Nội dung của thư mục đã xóa đã được làm trống thủ công

    Nếu bạn vô tình xóa thứ gì đó, hãy xem tài liệu [Lưu trữ và Khôi phục](/vi/account-and-subscription/storage-and-recovery) để biết các tùy chọn có sẵn.
  </Accordion>

  <Accordion title="Lỗi: External location already added">
    Nếu bạn liên tục nhận được thông báo **External location already added** khi thêm lại vị trí ngoài, nhưng nó không xuất hiện dưới dạng không gian:

    <Steps>
      <Step title="Đăng xuất khỏi Craft" />

      <Step title="Đăng nhập lại" />

      <Step title="Thử thêm vị trí ngoài lại" />
    </Steps>

    Nếu thông báo vẫn tiếp tục:

    1. Xóa ứng dụng Craft khỏi thiết bị
    2. Cài đặt lại ứng dụng
    3. Thử thêm vị trí ngoài lại
  </Accordion>

  <Accordion title="Vấn đề đồng bộ iCloud với External Storage">
    Độ tin cậy và hiệu suất đồng bộ 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 bước sau thường giúp ích.

    <Warning title="Quan trọng">
      Chúng tôi không khuyến nghị sử dụng không gian External trên nhiều thiết bị. Điều này 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 sử dụng các không gian của mình, vui lòng liên hệ bộ phận hỗ trợ.
    </Warning>

    **Các bước khắc phục:**

    1. **Kích hoạt đồng bộ thủ công.** Mở Finder (macOS) hoặc ứng dụng Files (iOS) và điều hướng đến 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 sẽ kích hoạt quá trình đồng bộ.
    3. **Kiểm tra kết nối internet.** Sử dụng Wi-Fi hoặc kết nối di động nhanh. Đảm bảo thiết bị được sạc đầy đủ.
    4. **Bật/tắt Chế độ Máy bay.** Kết nối lại có thể khởi động lại đồng bộ iCloud Drive.
    5. **Kiểm tra cài đặt đồng bộ di động:**
       * Bật **System Services** trong **Cài đặt → Dữ liệu di động**
       * Bật **Use Cellular Data** trong **Cài đặt → iCloud → iCloud Drive**
    6. **Kiểm tra mức pin.** Pin yếu làm chậm đồng bộ để tiết kiệm điện.
    7. **Kiểm tra giới hạn lưu trữ iCloud.** Đồng bộ dừng lại nếu bạn đã đạt đến hạn mức lưu trữ.
    8. **Khởi động lại các thiết bị.** Đảm bảo các dịch vụ iCloud đang chạy.
    9. **Xác minh iCloud đã được bật:**
       * **iOS:** Đăng nhập iCloud và bật iCloud Drive
       * **macOS:** Đăng nhập iCloud và bật iCloud Drive trong cài đặt Apple ID
    10. **Tắt tùy chọn Optimize Mac Storage.** Khi bật tùy chọn này, Mac sẽ chuyển các tệp lên đám mây, có thể gây ra tình trạng thiếu tệp.
    11. **Hãy kiên nhẫn.** Lần đầu đồng bộ có thể mất đến một ngày.
    12. **Đăng xuất và đăng nhập lại.** Nếu iCloud Drive bị treo, hãy đăng xuất khỏi iCloud và đăng nhập lại.
    13. **Đặt thời gian tự động.** Đảm bảo tất cả các thiết bị đều bật thời gian tự động.
    14. **Cập nhật hệ điều hành.** Apple cải thiện iCloud với mỗi phiên bản hệ điều hành.
    15. **Kiểm tra trang [Trạng thái hệ thống](https://www.apple.com/support/icloud/systemstatus/) của Apple.**
  </Accordion>
</AccordionGroup>

## Báo cáo lỗi

Nếu bạn gặp lỗi trong Craft, chúng tôi rất mong được bạn giúp tìm hiểu nguyên nhân. Báo cáo rõ ràng giúp chúng tôi điều tra và giải quyết vấn đề nhanh hơn.

### Trước khi báo cáo

* Đảm bảo bạn đang sử 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 tiếp diễn, hãy tiếp tục bên dưới

### Những gì cần cung cấp

<Steps>
  <Step title="Xác nhận phiên bản của bạn">
    Đề cập đến số phiên bản chính xác bạn đang sử dụng.
  </Step>

  <Step title="Chia sẻ môi trường của bạn">
    * **Model thiết bị** (ví dụ: MacBook Pro M2, iPhone 15, laptop Windows)
    * **Hệ điều hành và phiên bản** (ví dụ: macOS Sequoia 15.4, iOS 18.5, Windows 11 23H2)
    * **Nền tảng** (ứng dụng desktop, ứng dụng di động hoặc Web)
  </Step>

  <Step title="Mô tả các bước tái hiện lỗi">
    Liệt kê các thao tác chính xác dẫn đến vấn đề. Ví dụ: *Mở tài liệu → thêm trang mới → chèn ảnh → lỗi xảy ra.*
  </Step>

  <Step title="Đính kèm video quay màn hình">
    Giữ cho video ngắn gọn và tập trung vào vấn đề, quay toàn bộ màn hình (không cắt xén) và sử dụng độ phân giải cao nhất có thể. Ảnh chụp màn hình cũng phù hợp cho lỗi hiển thị và thông báo lỗi. Xem [cách quay màn hình](#how-to-record-your-screen) bên dưới.
  </Step>

  <Step title="Đính kèm tệp chẩn đoán (nếu có)">
    Đối với sự cố crash, đơ hoặc đồng bộ kéo dài, hãy đính kèm Spindump, sysdiagnose hoặc nhật ký console trình duyệt. Xem [Ghi lại dữ liệu chẩn đoán](#capture-diagnostic-data) bên dưới.
  </Step>
</Steps>

### Cách quay màn hình

<Tabs>
  <Tab title="iPhone / iPad">
    * Bật **Screen Recording** trong **Cài đặt → Control Center**
    * Mở Control Center và nhấn **Record**
    * Dừng ghi bằng cách nhấn thanh trạng thái màu đỏ
    * [Hướng dẫn chính thức của Apple](https://support.apple.com/en-us/HT207935)
  </Tab>

  <Tab title="macOS">
    * Nhấn **⌘ + Shift + 5**
    * Chọn **Record Entire Screen** hoặc **Record Selected Portion**
    * [Hướng dẫn chính thức của Apple](https://support.apple.com/en-us/HT208721)
  </Tab>

  <Tab title="Windows">
    * Nhấn **Windows key + G** để mở Xbox Game Bar
    * Sử dụng widget **Capture** để ghi
    * [Hướng dẫn chính thức của Microsoft](https://www.microsoft.com/en-us/windows/learning-center/how-to-record-screen-windows-11)
  </Tab>
</Tabs>

### Ghi lại dữ liệu chẩn đoán

Đối với các sự cố crash, đơ hoặc đồng bộ kéo dài, đội ngũ của chúng tôi có thể yêu cầu tệp chẩn đoán. Định dạng cụ thể tùy thuộc vào nền tảng của bạn, nhưng mục tiêu luôn giống nhau: ghi lại những gì hệ thống đang làm khi sự cố xảy ra.

<Tabs>
  <Tab title="macOS">
    **Spindump** ghi lại ảnh chụp nhanh của tất cả các tiến trình đang chạy. Đây là tệp hữu ích nhất bạn có thể gửi cho chúng tôi khi gặp tình trạng đơ, beachball hoặc chậm trên macOS.

    <Steps>
      <Step title="Tái hiện sự cố">
        Kích hoạt hành vi chậm hoặc không phản hồi trong Craft và giữ nguyên trạng thái đó.
      </Step>

      <Step title="Mở Activity Monitor">
        Tìm trong **Applications → Utilities** hoặc tìm kiếm bằng Spotlight (**⌘ + Space**).
      </Step>

      <Step title="Tạo Spindump">
        Nhấp vào menu ba chấm **(⋯)** trong thanh công cụ, sau đó chọn **Spindump**.
      </Step>

      <Step title="Lưu tệp">
        Chờ vài giây để báo cáo được tạo, sau đó **Lưu** tệp vào Desktop của bạn.
      </Step>

      <Step title="Gửi cho bộ phận hỗ trợ">
        Đính kèm tệp `.txt` vào phiếu hỗ trợ cùng với mô tả ngắn gọn về những gì bạn đã làm ngay trước khi sự cố xảy ra.
      </Step>
    </Steps>
  </Tab>

  <Tab title="iOS / iPadOS">
    **Sysdiagnose** là ảnh chụp chẩn đoán tích hợp của Apple. Đây là tương đương iOS của Spindump.

    <Steps>
      <Step title="Kích hoạt sysdiagnose">
        * **iPhone (Face ID):** Nhấn và thả nhanh **Tăng âm lượng**, sau đó **Giảm âm lượng**, rồi nhấn giữ **nút Side** + **cả hai nút âm lượng** khoảng 1 giây.
        * **iPhone có nút Home:** Nhấn giữ **nút Home** + **cả hai nút âm lượng** khoảng 1 giây.
        * **iPad:** Nhấn giữ **nút Top** + **cả hai nút âm lượng** khoảng 1 giây.

        Bạn sẽ cảm thấy một rung ngắn. Không có thông báo xuất hiện, đây là bình thường.
      </Step>

      <Step title="Chờ tệp được tạo">
        Chờ khoảng **10 phút**. Hệ thống cần thời gian để biên soạn báo cáo trong nền.
      </Step>

      <Step title="Tìm báo cáo">
        Mở **Cài đặt → Quyền riêng tư & Bảo mật → Analytics & Improvements → Analytics Data**. Cuộn để tìm mục bắt đầu bằng `sysdiagnose_` và ngày hôm nay.
      </Step>

      <Step title="Chia sẻ với bộ phận hỗ trợ">
        Nhấn vào mục đó, nhấn **biểu tượng chia sẻ** ở góc trên bên phải và gửi cho bộ phận hỗ trợ qua Mail hoặc Files.
      </Step>
    </Steps>

    <Info>
      Tệp có dung lượng lớn (thường trên 100 MB). Chia sẻ qua Mail hoặc AirDrop đến Mac, sau đó đính kèm vào email hỗ trợ thường là cách tốt nhất.
    </Info>
  </Tab>

  <Tab title="Windows">
    Cách nhanh nhất để hỗ trợ chúng tôi trên Windows là **video quay màn hình** về sự cố, cùng với **thông tin hệ thống** của bạn.

    <Steps>
      <Step title="Ghi lại sự cố">
        Nhấn **Windows key + G** để mở Xbox Game Bar, sau đó sử dụng widget **Capture** để ghi. Giữ cho video ngắn gọn và tập trung vào vấn đề.
      </Step>

      <Step title="Lấy thông tin hệ thống">
        Mở **Cài đặt → System → About** và chụp màn hình các phần **Device specifications** và **Windows specifications**.
      </Step>

      <Step title="(Tùy chọn) Xuất nhật ký Event Viewer">
        Đối với các sự cố crash lặp đi lặp lại, mở **Event Viewer** (tìm kiếm trong Start menu), mở rộng **Windows Logs → Application**, tìm các mục **Error** gần đây liên quan đến Craft, nhấp chuột phải → **Save All Events As…** và lưu dưới dạng tệp `.evtx`.
      </Step>

      <Step title="Gửi cho bộ phận hỗ trợ">
        Đính kèm video, ảnh chụp màn hình và bất kỳ nhật ký nào vào phiếu hỗ trợ của bạn.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Web">
    Đối với các vấn đề trên ứng dụng Web, **console trình duyệt** thường cho thấy nguyên nhân.

    <Steps>
      <Step title="Mở DevTools">
        * **Chrome, Edge, Brave:** Nhấn **F12** (Windows) hoặc **⌘ + Option + I** (Mac)
        * **Safari:** Bật menu Develop trước (**Safari → Settings → Advanced → Show Develop menu**), sau đó nhấn **⌘ + Option + C**
        * **Firefox:** Nhấn **F12** (Windows) hoặc **⌘ + Option + I** (Mac)
      </Step>

      <Step title="Chuyển sang tab Console">
        Nhấp vào **Console** ở đầu bảng DevTools.
      </Step>

      <Step title="Tái hiện sự cố">
        Với Console đang mở, lặp lại các bước gây ra vấn đề để ghi lại các lỗi.
      </Step>

      <Step title="Gửi ảnh chụp màn hình">
        Chụp màn hình Console hiển thị các thông báo lỗi màu đỏ và ghi rõ trình duyệt cùng phiên bản (ví dụ: Chrome 124, Safari 17).
      </Step>
    </Steps>
  </Tab>
</Tabs>

### Điều gì xảy ra sau khi bạn báo cáo

* **Vấn đề xảy ra một lần:** Chúng tôi ghi lại và theo dõi các trường hợp liên quan
* **Lỗi có thể tái hiện:** Chúng tôi chuyển lên nội bộ để điều tra và giải quyết

Cảm ơn bạn đã dành thời gian báo cáo lỗi. Phản hồi của bạn giúp chúng tôi cải thiện Craft cho tất cả mọi người.

***

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

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

<Columns cols={2}>
  <Card title="Liên hệ Hỗ trợ" href="https://support.craft.do/hc/en-us/requests/new">
    Nhận trợ giúp trực tiếp từ đội ngũ hỗ trợ của chúng tôi
  </Card>

  <Card title="Nhận trợ giúp" href="/vi/introduction/help">
    Tìm hiểu về tất cả các cách nhận hỗ trợ và chia sẻ phản hồi
  </Card>
</Columns>