> ## Documentation Index
> Fetch the complete documentation index at: https://guide.uku.to/llms.txt
> Use this file to discover all available pages before exploring further.

# UKU 故障排除指南

> UKU 店主常见问题排查：登录失败、收不到验证码、条码扫描异常、传单无法显示、图片上传失败、电视配对问题等。按步骤操作，快速恢复使用。

UKU 在使用过程中偶尔会遇到一些小问题。本指南按照最常见的症状整理了解决方案，你可以根据遇到的问题直接跳转到对应的部分，按照步骤操作即可。

<AccordionGroup>
  <Accordion title="无法登录">
    如果你无法登录 UKU，请按照以下步骤排查：

    <Steps>
      <Step title="检查手机号和密码">
        确认你输入的是注册时使用的手机号，密码区分大小写。如果忘记密码，请点击「忘记密码」通过验证码重置。
      </Step>

      <Step title="检查网络连接">
        确保你的设备已连接到稳定的 Wi-Fi 或移动网络。可以尝试打开其他网页确认网络正常。
      </Step>

      <Step title="确认账号状态">
        如果你使用的是免费版，请确认当前没有其他设备已登录你的账号。免费版仅支持一个设备同时在线。
      </Step>

      <Step title="重新安装应用">
        如果以上步骤都无效，尝试删除 UKU 应用后重新从 App Store 下载安装。
      </Step>
    </Steps>

    <Tip>
      如果问题仍然存在，请 [联系客服](/zh/support/contact) 并提供你的手机号和错误提示截图。
    </Tip>
  </Accordion>

  <Accordion title="OTP 没收到">
    注册或重置密码时需要短信验证码。如果长时间未收到：

    <Steps>
      <Step title="等待 60 秒后重试">
        短信可能会有延迟，请耐心等待一分钟后点击「重新发送」。
      </Step>

      <Step title="检查手机号是否正确">
        确认你输入的手机号没有缺位或错位，特别是国家区号部分。
      </Step>

      <Step title="检查短信拦截">
        查看手机的垃圾短信文件夹或短信拦截设置，验证码可能被误判为垃圾信息。
      </Step>

      <Step title="切换网络环境">
        从 Wi-Fi 切换到移动数据，或反之，然后重新请求验证码。
      </Step>
    </Steps>

    <Warning>
      如果多次尝试后仍收不到验证码，可能是运营商短信通道延迟。建议稍后再试，或联系客服协助处理。
    </Warning>
  </Accordion>

  <Accordion title="条码扫不出来">
    扫描条码时无法识别或没有结果：

    <Steps>
      <Step title="调整扫描距离">
        将手机摄像头与条码保持 10-20 厘米距离，确保条码在取景框内完整显示。
      </Step>

      <Step title="确保光线充足">
        在光线较暗的环境下，条码可能无法被识别。尝试开启闪光灯或移动到更亮的位置。
      </Step>

      <Step title="检查条码清晰度">
        如果条码本身模糊、破损或反光严重，系统可能无法读取。你可以尝试手动输入条码数字。
      </Step>

      <Step title="手动创建产品">
        如果社区数据库中没有该条码对应的产品，UKU 会提示你手动输入产品名称、价格和上传图片。
      </Step>
    </Steps>

    更多技巧请查看 [扫描条码](/zh/products/scan-barcode)。
  </Accordion>

  <Accordion title="数字传单打不开">
    顾客或你自己无法打开数字传单链接：

    <Steps>
      <Step title="检查链接是否正确">
        确认复制的链接完整，没有遗漏字符。链接格式类似于 `uku.app/f/你的传单名称`。
      </Step>

      <Step title="确认传单已发布">
        在 UKU 中检查该数字传单的状态，确保它没有被删除或设为草稿。
      </Step>

      <Step title="检查网络环境">
        让访问链接的设备确认网络连接正常，可以尝试用其他浏览器打开。
      </Step>
    </Steps>

    <Info>
      数字传单链接是公开的，不需要登录 UKU 即可查看。如果链接失效，可能是传单已被删除或 slug 被修改。
    </Info>
  </Accordion>

  <Accordion title="电视不显示传单">
    店铺电视已配对成功，但没有轮播单页传单：

    <Steps>
      <Step title="检查传单有效期">
        电视上只显示未过期的单页传单。进入传单编辑页面，确认「有效期至」日期没有过期。
      </Step>

      <Step title="确认传单状态为启用">
        检查你的单页传单是否处于启用状态，已禁用或归档的传单不会出现在电视播放列表中。
      </Step>

      <Step title="检查电视网络">
        确保电视设备已连接到互联网。如果电视断网，播放列表将无法更新。
      </Step>

      <Step title="重新配对电视">
        在电视端退出当前账号，然后在 UKU 应用中生成新的配对码，重新完成配对流程。
      </Step>
    </Steps>

    详情请查看 [价格与有效期](/zh/single-flyers/price-validity)。
  </Accordion>

  <Accordion title="图片上传失败">
    上传产品图片或自定义电视图片时遇到问题：

    <Steps>
      <Step title="检查图片格式">
        UKU 支持 JPG、PNG 和 WebP 格式。请确认你的图片是这三种格式之一。
      </Step>

      <Step title="检查图片大小">
        产品图片最大支持 12MB，自定义电视图片最大支持 10MB。如果图片过大，请先用手机相册或图片编辑工具压缩后再上传。
      </Step>

      <Step title="检查网络稳定性">
        大图片上传需要稳定的网络。建议在 Wi-Fi 环境下上传，避免使用信号较弱的移动网络。
      </Step>

      <Step title="尝试 base64 上传">
        如果直接上传文件失败，可以尝试使用 base64 编码方式上传（适用于网页版）。
      </Step>
    </Steps>

    <Note>
      图片上传后可能需要几秒钟处理时间，请耐心等待，不要重复点击上传按钮。
    </Note>
  </Accordion>

  <Accordion title="电视配对码失效">
    在电视上输入配对码时提示已过期或无效：

    <Steps>
      <Step title="确认配对码时效">
        UKU 的电视配对码有效期为 3 分钟。如果超过 3 分钟未输入，需要重新生成新的配对码。
      </Step>

      <Step title="重新生成配对码">
        在 UKU 应用的电视设置中，点击「生成新配对码」，然后在电视上立即输入。
      </Step>

      <Step title="检查输入是否正确">
        配对码为 6 位数字，请仔细核对每一位，避免输错。
      </Step>
    </Steps>

    <Tip>
      建议在生成配对码前，先打开电视端的 UKU 应用并停留在配对输入页面，然后再在手机上生成配对码，以缩短等待时间。
    </Tip>
  </Accordion>

  <Accordion title="会话意外断开">
    正在使用 UKU 时突然被迫退出登录：

    <Steps>
      <Step title="检查设备数量">
        免费版只支持一个设备登录。如果你在另一台设备上登录了同一个账号，之前设备的会话会被自动断开。升级到 Pro 版即可多设备同时使用。
      </Step>

      <Step title="检查网络波动">
        长时间网络不稳定可能导致会话失效。尝试切换 Wi-Fi 或移动数据后重新登录。
      </Step>

      <Step title="清除缓存重新登录">
        在网页版中，清除浏览器缓存后重新登录。在 iOS 应用中，可以尝试重启应用。
      </Step>
    </Steps>

    详情请查看 [多设备登录](/zh/account/sessions)。
  </Accordion>

  <Accordion title="App 卡顿或闪退">
    UKU iOS 应用运行缓慢或突然关闭：

    <Steps>
      <Step title="关闭后台应用">
        双击 Home 键或从底部上滑，关闭 UKU 和其他不用的后台应用，然后重新打开 UKU。
      </Step>

      <Step title="检查存储空间">
        如果手机存储空间不足，应用可能运行不稳定。请清理手机中不需要的照片、视频或应用。
      </Step>

      <Step title="更新到最新版本">
        前往 App Store 检查 UKU 是否有更新。新版本通常包含性能优化和 bug 修复。
      </Step>

      <Step title="重启手机">
        如果问题持续，尝试重启你的 iPhone，这可以清除系统缓存并恢复应用正常运行。
      </Step>
    </Steps>

    <Warning>
      如果闪退问题频繁发生，请记录发生闪退前的操作步骤，并 [联系客服](/zh/support/contact) 反馈，我们会尽快排查修复。
    </Warning>
  </Accordion>

  <Accordion title="价格显示错误">
    传单上的原价、折扣价或折扣百分比显示不正确：

    <Steps>
      <Step title="检查输入的价格">
        进入产品编辑页面，确认原价和折扣价输入正确，没有多输或少输数字。
      </Step>

      <Step title="检查传单自定义设置">
        在单页传单的自定义选项中，确认「显示原价」「显示折扣百分比」等开关已正确设置。
      </Step>

      <Step title="检查颜色设置">
        如果你自定义了价格颜色，确保颜色对比度足够，不会因为颜色太浅导致看起来像是显示错误。
      </Step>

      <Step title="刷新传单预览">
        修改价格后，点击预览按钮查看最新效果，确保更改已保存。
      </Step>
    </Steps>

    详情请查看 [自定义传单样式](/zh/single-flyers/customize)。
  </Accordion>

  <Accordion title="客户导入失败">
    批量导入客户名单时部分或全部失败：

    <Steps>
      <Step title="检查文件格式">
        UKU 通常支持 CSV 或 Excel 格式导入。请确认你的文件格式正确，且没有损坏。
      </Step>

      <Step title="检查必填字段">
        确保每一行都包含客户姓名和手机号，且手机号格式统一（建议不带国家区号或统一带区号）。
      </Step>

      <Step title="检查重复号码">
        同一个手机号在同一个店铺中只能出现一次。导入文件中如果有重复号码，系统会跳过重复项。
      </Step>

      <Step title="分批导入">
        如果一次性导入大量客户（如超过 500 条），建议分成多个小文件分批导入，以提高成功率。
      </Step>
    </Steps>

    <Tip>
      导入完成后，请在客户列表中核对导入结果。如果部分客户未导入成功，系统通常会提示失败原因。
    </Tip>
  </Accordion>

  <Accordion title="忘记商店登录手机号">
    如果你忘记了注册 UKU 时使用的手机号：

    <Steps>
      <Step title="查找短信记录">
        在你的手机短信中搜索 "UKU" 或 "验证码"，找到之前注册或登录时收到的短信，即可确认手机号。
      </Step>

      <Step title="询问店铺员工">
        如果店铺有多个员工使用 UKU，询问其他已登录的员工，他们可以在账号设置中查看绑定的手机号。
      </Step>

      <Step title="联系客服">
        如果以上方法都无法找回，请 [联系客服](/zh/support/contact) 并提供你的店铺名称和尽可能多的注册信息（如注册时间、店铺地址），我们会协助你核实身份并找回账号。
      </Step>
    </Steps>

    <Warning>
      为了账号安全，客服可能需要你提供额外的身份验证信息。请准备好营业执照或店铺相关证明材料。
    </Warning>
  </Accordion>
</AccordionGroup>

## 问题仍未解决？

如果以上方案都没有解决你的问题，请 [联系客服](/zh/support/contact) 获取进一步帮助。反馈时建议提供以下信息，以便我们更快定位问题：

* 你的手机号（注册账号）
* 问题发生的具体时间
* 错误提示的文字或截图
* 你使用的设备类型（iPhone 型号 / 浏览器名称）