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

# 离线使用 Youka

> 将已完成的卡拉 OK 导出保存在设备上，并在没有互联网连接时播放。

Youka Desktop 和 Youka Extension 与 Youka Online 共享同一个 **Library** 页面。一个卡拉 OK 可以被标记为 **Available online**、**Available offline**，或 **Available online and offline**。

离线访问适用于已完成的卡拉 OK 视频导出。项目、源媒体、stems 和编辑器设置仍仅限在线使用。

## 离线前准备

1. 在有互联网连接时打开 Youka Desktop 或 Youka extension。
2. 登录并打开一次 **Library**。这会为当前版本的 Youka 准备离线页面。
3. 选择视频的存储方式：
   * 选择 **Make Library Available Offline** 立即下载所有符合条件的导出。
   * 开启 **Automatic Offline Saving**，将来自动保存新的符合条件的导出。
   * 保持自动保存关闭，以便为单个视频选择 **Make available offline**。
4. 在断开连接前，等待每个视频都显示 **Available offline**。

Youka 会记住上一次已通过验证的本地 profile，但不会在离线库中存储你的 Clerk 登录 token。如果你的在线会话已过期，请在重新联网后再次登录。

## 选择新导出的存储位置

在 Library 页面选择 **Save new Karaokes to** 以选择一个 Youka 文件夹。新的本地导出会按 Project 和 Export ID 存放在该文件夹内。现有导出不会被移动。

默认情况下，托管文件和本地 `db.json` 索引会存放在 `Videos/Youka` 下。该索引让 Library 加载更快；每个 Export 也都有自己的 manifest，因此 Youka 可以在不扫描视频元数据的情况下重建索引。

如果你之前选择了其他驱动器或文件夹，请使用 **Add existing Youka folder**。Youka 只会索引有效的托管 Export 文件夹，不会导入无关视频。

## 离线播放

在 Youka Desktop 或 Youka extension 中打开 **Library**。标记为 **Available offline** 的条目会自动使用本地视频。在线与离线使用同一个播放器、队列和播放控制。

请保持 Youka Desktop 或 Youka extension 处于打开状态。如果某个操作无法连接到它，请检查应用是否正在运行，然后重试。

## 将离线 Export 设为在线可用

对于仅本地的 Export，选择 **Make available online**。Youka 会在中断后继续上传已完成的部分，并在在线 Library 中创建一个视频，不会扣除导出 credits。

原始云端 Project 必须仍然存在。如果它已被删除，本地卡拉 OK 仍可播放，且 Youka 会说明无法上传的原因。

## 删除离线副本

Youka 从不自动移除离线文件，也不提供批量删除。

要删除某一个副本，打开该 Library 条目的菜单，选择 **Delete offline copy**，并确认具体的 Export。此操作只会从所选设备永久移除该 Export。除非你另外删除，否则在线副本仍然可用。

已中断的下载与渲染会被保留。你可以重试它们、打开其文件夹，或明确删除那个未完成的 Export。