Electron 工具工作区¶

历史背景： 本页面编写于 Electron 和 Tauri 应用共存期间。文中提到的 Tauri 辅助程序、页面、测试和回归结果描述的是迁移期的情况；Tauri 外壳此后已被移除，共享代码现在位于 electron/src/shared/。现有 Tauri 安装：请参阅迁移指南。

克隆侧边栏或命令搜索中的工具会打开三个实用程序窗格：

• Directorial AI 使用现有方向服务将导演指示解析为指令、翻译提示、语速偏差、token 和分类法。
• Speech-rate fit 将翻译后的文本、正向时间段和目标语言提交给现有拟合服务。无效时长会阻止提交。
• Probe file 将绝对路径提交给现有的 ffprobe 元数据端点。

每个操作仅在明确提交时启动。切换工具会中止前端请求，并防止过期结果替换其他工具的内容。LLM 支持的操作遵循配置的后端路由。错误保持简洁，并带有可展开的诊断信息。不会添加新的处理引擎或网络依赖。

工具浏览器冒烟测试使用模拟响应验证请求字段和结果。设置 > 音频工具公开现有应用管理的媒体捆绑安装程序、状态/进度、系统副本选择、还原以及 yt-dlp 更新/还原操作。下载仅通过明确操作启动。自定义可执行文件选择仍需要 Electron 原生路径授权桥接。

现有的带校验和的安装程序已成功在开发应用数据目录中安装了 ffprobe。真实探针随后从 MP4 测试文件中读取了两条流和四秒的时长。未更改任何系统级二进制文件或应用程序版本。

自定义 FFmpeg/FFprobe 可执行文件可以从桌面应用的媒体工具中选择。原生选择器使用 -version 验证所选可执行文件，然后发出与 Tauri 在后端公告的数据目录中使用的相同的单次路径授权。取消操作会保持当前工具不变。仅浏览器会话不公开原生选择器。

实时 Windows 转换冒烟测试现在会执行完整的 工具 > 转换 路径，使用所选的 Faster-Whisper 和 OmniVoice 引擎：上传、ASR、已保存配置转换、返回的波形和 Vidstack 播放时钟推进。该测试文件使用现有的克隆配置，不会更改用户的引擎选择。

工具 > 转换 列出已保存的 Voice Design 配置以及带参考音频或锁定 take 的克隆。按保存的配置名称搜索，选择它，然后上传或录制源片段。设计声音使用其保存的样本和指令；没有样本的旧版设计回退到其保存的指令和种子。仍然需要支持克隆的就绪 TTS 引擎。转换会转录音源并以其选定声音合成文本。匹配时长调整整体长度；它不保留原始表演的音高、停顿或表达方式。结果与 Clone 和 Design take 具有相同的下载操作：在桌面应用中，它打开原生保存对话框以保存 WAV 文件，并将文件记录在导出历史中。结果也会保存到历史记录。

保持我的原声 (#3421) 改为直接转换录音本身：只有声音改变，源音频的时序、停顿、节奏和语调保持录制时的原样。不进行任何转录，因此源语言和匹配时长不适用。它需要安装 CosyVoice 3（模型目录 → 引擎）；不必是当前激活的引擎。目标声音需要参考录音：克隆，或带有已保存样本的设计。超过约 28 秒的片段会在停顿处拆分转换；超过 10 分钟的源文件被拒绝。没有录音的声音（没有已保存样本的设计）在开启时会被隐藏。默认（关闭）保持转写-重说行为。

媒体工具安装会重试临时文件系统锁最长四秒，包括可执行文件探查后的 Windows 锁。它会在兄弟备份目录中保留现有安装，直到发布成功，并在发布失败时尝试恢复。如果回滚也失败，先前的安装保留在 .media-backup-*/previous 中；错误信息包含该恢复路径。持久锁会显示其原始错误；不会删除系统二进制文件或用户媒体。相同的行为了适用于 yt-dlp 覆盖更新，并且还原已测试版本会报告清理失败。配音后台保留和长导出滤镜图同时支持传统 -filter_complex_script 和现代 FFmpeg -/filter_complex 文件参数。如果 FFmpeg 在处理前拒绝传统选项，VoiceStudio 会使用现代拼写重试一次；滤镜内容保留在文件中以避免 Windows 命令行长度限制。实际的解码/滤镜错误会直接报告，不进行重试。