FAQ（常见问题）¶
VoiceScriptPlayer 目前仍在开发中。
以下内容是根据正式发布前常见的疑问整理的预期问答。
🧩 项目 / 文件管理¶
Q. 项目文件保存在哪里？
A. 默认保存在 我的文档 / VoiceScriptPlayer / Projects 文件夹中。
您也可以在创建新项目时指定自定义路径。
Q. 如何将现有项目转移到另一台电脑？
A. 只需复制整个项目文件夹即可完成转移。
Q. “模板项目”是什么？
A. 这是 VoiceScriptPlayer 提供的基础示例项目。
其中包含简单的脚本示例和设置，可在此基础上修改创建新项目。
🎧 音频 / 字幕¶
Q. 使用 Whisper 生成字幕时无法正常工作。
A. 请确认 Whisper 模型是否已下载，并在设置中指定正确路径。
在没有 GPU 的环境下，处理速度会较慢。
一般处理速度如下：
| 环境 | 模型 | 处理 10 分钟视频所需时间（大约） |
|---|---|---|
| CPU（普通桌面 i5 / i7 级别） | base |
约 7〜10 分钟 |
| CPU（低配置笔记本） | base |
约 12〜15 分钟 |
| GPU（RTX 3060 及以上） | base |
约 1〜2 分钟 |
| GPU（RTX 4090 等高性能显卡） | large |
约 30 秒〜1 分钟 |
⚡ 模型越大，识别精度越高，但处理速度会变慢。
Whisper 可在离线状态下运行，因此首次转换后无需联网。
Q. 字幕文件可以导出为哪种格式？
A. 可导出为 .srt 格式。
翻译后的字幕也可以单独保存为文件。
Q. 字幕未在画面中显示。
A. 可能是字幕显示功能被关闭，或 UI 元素挡住了字幕。
请启用“将字幕置于界面下方”的设置。
🤖 AI / 翻译¶
Q. DeepL 或 LibreTranslate 的 API 密钥在哪里设置？
A. 在“设置 → AI”选项卡中输入各引擎的 API 密钥。
API 密钥需在各服务网站（如 DeepL、LibreTranslate）上自行申请。
Q. AI 功能能在离线环境下使用吗？
A. Whisper、COEIROINK、Hailuo 部分引擎可在本地环境运行。
但 DeepL、Meta AI 等功能需要网络连接。
Q. Whisper 模型从哪里下载？
A. 可在 VoiceScriptPlayer 内自动下载 Whisper 模型。
在“设置 → AI / Whisper”选项卡中选择所需模型大小
（tiny, base, small, medium, large），即可自动下载并应用。
如果想手动下载，可访问 Whisper.cpp 模型页面 获取相同模型文件。
🎮 事件 / 交互¶
Q. 什么是 Interactive Event？
A. 这是根据用户输入（键盘、按钮、脚本触发等）
同时控制音频、视频、设备等动作的事件系统。
Q. 如何连接 Stroke 或 Trigger 事件？
A. 在项目的时间轴或事件面板中选择相应事件，
然后设置条件（输入键、时间点等）进行关联。
⚙️ 设置 / 错误¶
Q. 设置没有保存。
A. VoiceScriptPlayer 会在关闭时自动保存配置文件 (Option.json)。
如果程序未正常退出，设置将无法保存。
Q. 日志文件在哪里？
A. 日志保存在 我的文档 / VoiceScriptPlayer / Log 文件夹中，
并按日期生成。出现错误或异常时请参考该日志。
Q. 程序启动时提示“找不到文件”。
A. 项目引用的资源（音频、图片等）可能已被删除。
请重新指定路径或恢复相关资源。
🚀 发布 / 分享¶
Q. 可以将项目分享给他人吗？
A. 可以。导出项目后，其他人可通过 VoiceScriptPlayer Stub 运行。
Q. “Stub Player” 是什么？
A. 仅用于播放、无编辑功能的发布版播放器。
Q. 发布后别人可以修改项目吗？
A. 默认情况下发布版无法编辑，
但因文件未加密，若手动修改文件仍可能被编辑。
Q. 可以与 Patreon 或 GitHub Release 联动吗？
A. 在正式版本中将支持与 Patreon 和 GitHub 的集成。
（例如：为支持者提供专属模板、自动更新等）
💡 其他¶
Q. 运行所需系统环境？
A. 需要 Windows 10 或更高版本 / .NET 8 运行时 / 推荐内存 8GB 以上。
Q. VoiceScriptPlayer 是免费的吗？
A. 基本功能免费提供，部分 AI 集成功能可能需要 API 密钥或成为支持者后使用。
Q. 是否有手机版？
A. 目前仅支持 Windows 版本，手机版正在规划中。