Electron 项目¶

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

从侧边栏、命令搜索或 Dubbing 标题栏打开“项目”。当前的配音工作会保存在其产生的位置：Dubbing 的项目窗格选项卡会以某个名称或作为新副本将其保存，位置就在已保存配音列表的上方。项目使用现有的后端 /projects 数据库和 Tauri 状态格式。

打开项目时，会在替换当前草稿前询问确认。进行中的配音工作和未解决的任务恢复会阻止切换。删除需要确认，且仅移除已保存的项目记录，并将其与当前草稿分离。删除不会移除源媒体或已生成的音频。

片段编辑、所选语言、源任务和可用音轨都会恢复。保存时，未公开的遗留选项和逐片段元数据会被保留。渲染器重新加载会保留当前活动项目的身份。这不会重建缺失的源媒体，也不意味着中断的后端任务仍在运行。

资料库结合了后端配音项目、本地 IndexedDB Stories 和 Audiobooks、已保存的语音配置、转录历史、生成的录音片段、导出历史和已完成的长篇渲染结果。所有项目列出你打开并持续编辑的工作（Dubbing、Stories 和 Audiobooks）；语音配置、转录稿、历史录音片段和导出内容则保留在 资料库 下各自的列表中，因此生成的录音片段绝不会混入项目列表。一个稳定的二级侧边栏按来源过滤并显示实时计数；一个搜索框和列表/网格切换器在操作时不会移动工作区的原点。在紧凑宽度下，全局侧边栏会变成图标栏，与其他带二级侧边栏的工作区保持一致。同一份工作也能在它产生的地方访问：Stories 和 Audiobook 显示各自的项目，Dubbing 显示其已保存的配音项目，Clone、Home 和 Design 显示已保存的语音，每个都在各自工作区自己的侧边面板中。

分区选项卡支持箭头键导航（包括从右到左的布局）、Home 和 End。切换选项卡会保留未完成的项目名称编辑。打开已保存的配音时会要求确认，在另一次选择之前会等待其加载完成，并在替换草稿之前重新检查进行中的工作。返回控制选项卡、折叠面板或离开工作区会取消待处理的加载，这样其响应就不会替换较新的编辑。在项目加载期间编辑当前配音也会保留这些编辑，并在替换之前再次要求确认。

打开一本书或故事时，会在确认后恢复其已保存的草稿；删除会将草稿分离，而不会移除已生成的媒体。内联重命名只更改已保存的名称：配音使用轻量级 PATCH 端点，而本地书籍会在序列化写入队列中重命名最新的持久记录。语音配置行用于在克隆中选择语音，转录稿和录音片段行复用其脚本，录音片段和已完成渲染行通过 Vidstack 预览，导出行则显示目标位置。

验证：electron/tests/projects-smoke.mjs 使用模拟的项目 API 对 UI 进行测试；项目格式单元测试检查遗留往返和格式错误的片段。另一个独立的可丢弃测试夹具针对运行中的后端通过了创建/读取/更新/删除测试。

浏览器回归测试验证项目和资料库计数、语音配置/转录稿过滤器，以及本地书籍保存、统一列表重命名、重新加载、确认打开时原始脚本保持不变和删除；配音重命名保留未公开选项并更新当前保存名称。一个可丢弃的真实后端重命名/读取/删除往返测试确认了状态保留。

删除管理¶

列表和网格视图中的每一行都有删除操作。选中单个复选框或选择可见项，然后点击删除选中项，在确认前查看名称。更改搜索或类别会清除选择，因此隐藏项永远不会被包含。取消按钮首先获得焦点；进行中的配音/长篇工作会阻止删除。失败的批次只会在对话框中保留失败项以供重试；成功的删除会立即刷新，不会重复执行。

• 已保存的 Dubbing、Stories 和 Audiobook 项目：移除已保存的记录，分离当前草稿，并保留源媒体/生成的媒体。
• 转录稿：移除已存储的文本，并更新其他打开的转录视图。
• 语音配置和生成的录音片段：使用其现有的删除行为，包括移除关联的已存储音频。导出的副本不受影响。
• 导出历史和已完成的长篇渲染结果：仅移除资料库记录；文件仍保留在磁盘上。活动或无关任务无法通过渲染库端点移除。

确认对话框会描述这些后果。删除无法撤销。后端元数据路由为 DELETE /export/history/{id} 和 DELETE /longform/jobs/{job_id}；两者都是幂等的。 测试：projects-page.test.tsx、transcript-deletion.test.ts 和 tests/test_projects_delete_management.py 使用一次性数据，而不是用户的资料库。