> ## 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 扩展

> 在浏览器中解锁桌面端功能：从视频 URL 创建、搜索歌词，并本地导出

Youka 扩展将强大的桌面端功能带到你的浏览器中，让你可以从视频 URL 创建卡拉 OK、自动搜索歌词，并将视频本地导出。本地导出免费；云端导出仍会消耗额度。

## 你将获得什么

安装 Youka 扩展后，你将解锁三大功能：

* **从视频 URL 创建** — 直接从视频链接下载并创建卡拉 OK
* **在线搜索歌词** — 自动从互联网上查找并导入歌词
* **免费本地导出** — 在你的电脑上本地渲染视频，无需使用云端额度

## 安装

### 下载扩展

1. 访问[扩展下载页面](/extension)
2. 点击与你的操作系统对应的下载按钮（Windows、macOS 或 Linux）
3. 运行安装程序并按照安装指引完成设置
4. 扩展会在系统托盘中运行（你会看到一个小图标）

### 连接到浏览器

安装完成后，当你访问 Youka Online 时，扩展会自动连接：

1. 在浏览器中打开 [online.youka.io](https://online.youka.io)
2. 查看右上角的扩展状态指示（应显示 “Connected”）
3. 现在你就可以使用所有扩展功能了！

## 从视频 URL 创建卡拉 OK

现在你无需上传文件，也可以直接从视频链接创建卡拉 OK：

1. 在首页点击 **Create Karaoke**
2. 选择 **From URL** 标签页
3. 粘贴来自你常用流媒体平台的视频 URL
4. 点击 **Download**
5. 扩展会下载视频并提取音频
6. 接下来照常处理歌词即可

**注意**：使用此功能前，请确保扩展正在运行且已连接。

## 自动搜索歌词

在为卡拉 OK 添加歌词时，扩展可以帮你在线搜索：

1. 在歌词输入区域，你会看到一个 **Search** 按钮（仅在扩展已连接时可见）
2. 点击 **Search**，系统会根据你的歌曲标题自动查找歌词
3. 如果找到歌词，会自动导入到文本区域
4. 按需编辑或调整

这可以帮你省去手动去其他网站搜索并复制歌词的步骤。

## 免费本地导出

在不消耗云端额度的情况下，将你的卡拉 OK 视频本地导出。云端导出仍会消耗额度：

1. 在 Studio 编辑器中打开你的项目
2. 点击 **Export** 打开导出对话框
3. 你会看到两种导出选项：
   * **Cloud Export** — 消耗额度，在云端渲染
   * **Local Export** — 免费，在你的电脑上渲染（需要扩展）
4. 选择 **Local Export**
5. 选择你的导出设置（resolution、quality、FPS、transparency）
6. 点击 **Start Export**
7. 扩展会在本地渲染视频并保存到你的电脑

**本地导出的优势：**

* 完全免费 — 无需额度
* 导出次数不限
* 文件保留在你的电脑上
* 可完全控制输出位置

## 故障排查

### 扩展无法连接

如果扩展没有自动连接：

1. 确认扩展正在运行（检查系统托盘）
2. 重启扩展应用
3. 刷新浏览器页面
4. 确认你使用的是受支持的浏览器（Chrome、Edge、Firefox）

### 下载失败

如果视频下载失败：

1. 确认 URL 是有效的视频链接
2. 确认视频是公开可访问的（非私密/年龄限制）
3. 尝试换一个视频进行测试
4. 将扩展更新到最新版本

### 导出耗时过长

本地导出是在你的电脑上渲染，因此速度取决于：

* 你的 CPU/GPU 性能
* 视频时长与分辨率
* 导出质量设置

想要更快导出，可以尝试降低分辨率或质量设置。

## 系统要求

* **Operating System**: Windows 10+, macOS 10.15+, or Linux (Ubuntu 20.04+)
* **Memory**: 4GB RAM minimum, 8GB+ recommended
* **Storage**: 500MB for the extension, plus space for video files
* **Internet**: Required for downloading videos and searching lyrics

## 隐私与安全

Youka 扩展：

* 在你的电脑上本地运行
* 仅在你使用网页应用时才会连接到 Youka Online
* 不会收集或发送个人数据
* 下载在你的设备上处理
* 导出保存在你的电脑上（绝不上传）

## 更新

扩展在启动时会自动检查更新。如需手动更新：

1. 从[扩展下载页面](/extension)下载最新版本
2. 运行新的安装程序（将更新你现有的安装）
3. 重启扩展

## 获取帮助

如果你遇到问题：

* 查看上方的[故障排查部分](#troubleshooting)
* 发送邮件至 [support@youka.io](mailto:support@youka.io)