更新日志

本文件记录了项目的所有重要更改。

[3.0.8] - 2026-02-04

新功能

预检检查：在生成开始前添加配置验证。验证 API 密钥、Whisper 模型文件（GGML/GGUF 格式）和 CTC 对齐模型目录。显示清晰的错误消息，并提供设置和文档链接。
关闭确认：在有活动任务（生成、下载、压缩、转码）时关闭应用会显示警告对话框，防止意外数据丢失。
音频提取：支持取消音频提取操作。

修复

Windows：彻底修复 Unicode 路径编码问题。使用直接二进制调用替代 cmd.exe 包装器，确保中文/日文/韩文路径正常工作，无需代码页转换。
视频预览：修复 MKV 文件从实时转码切换到静态播放模式时出现的"ReadableStream is already closed"错误。

[3.0.7] - 2026-02-03

修复

CTC 对齐器：修复 CJK 语言的语言检测失败导致对齐错误的问题。eld 库现在使用静态导入以确保 Vite 正确打包，并添加了基于 CJK 字符的回退检测，支持日语、韩语和中文。
Gemini API：修复 JSON 解析失败时的不必要 API 调用。截断续写逻辑现在仅在明确的 MAX_TOKENS 完成原因时触发，避免对格式错误的响应进行无效重试。
macOS：修复自动更新时 SHA512 校验和不匹配的问题。latest-mac.yml 现在正确包含 ZIP 文件的哈希值而非 DMG 文件的哈希值。

[3.0.6] - 2026-02-03

修复

生成：字幕生成失败时显示汇总的错误消息，帮助用户了解具体问题，而非仅显示通用失败提示。
Windows：修复应用安装在包含空格的路径（如 C:\Program Files\...）时出现的"C:\Program 不是可识别的命令"错误。
macOS：通过在 DMG 构建旁添加 ZIP 目标，启用自动更新功能。

重构

界面：将 Toast 通知居中显示，提升可见性。

[3.0.5] - 2026-02-03

修复

流水线：修复处理超过 2 小时视频时的崩溃问题。长视频模式现在正确地按需提取音频片段，而不是访问空的音频缓冲区。
Electron：修复保存字幕文件时的 ENOENT 错误。如果用户在处理过程中删除了输出目录，现在会自动重新创建。
macOS：修复 macOS 上 CTC 强制对齐失败的问题。缺失的 libonnxruntime.dylib 动态库现已包含在应用包中。

[3.0.4] - 2026-02-02

重要提示：下载了 v3.0.3 的用户请立即更新。 此版本修复了一个导致部分视频无法下载和生成字幕的严重 bug。

修复

Electron：修复 shell 参数转义问题，防止 URL 解析错误。包含特殊字符的 URL（如 B 站的 vd_source 参数中的 &）在 Windows 上会被错误地解析为命令分隔符，导致视频下载和字幕生成失败。

[3.0.3] - 2026-02-02

修复

Electron：修复 Windows 上 Unicode 路径编码问题，影响 Whisper、yt-dlp 和 CTC 对齐器处理包含非 ASCII 字符（中文、日文等）的路径。
Electron：修复长时间运行操作（音频提取、压缩、下载进度）期间窗口被销毁时的 IPC 崩溃问题。
编辑器：在搜索替换面板中添加正则表达式语法错误反馈，支持防抖验证。

重构

错误处理：为 UserActionableError 添加错误代码，实现类型安全的错误处理。

[3.0.2] - 2026-02-01

修复

视频预览：修复取消视频预览时错误触发 CPU 回退转码的问题。
Whisper：改进模型文件验证，修复非 ASCII 路径的文件名编码问题。

[3.0.1] - 2026-02-01

新功能

长视频支持：新增超过 2 小时视频的按需音频分段提取功能，通过 FFmpeg 按需提取音频片段而非将整个音频加载到内存，避免内存溢出问题。

修复

Electron：修复更新服务中 IPC 处理器重复注册的问题，该问题可能导致应用重启时出错。
路径处理：改进文件名清理逻辑，处理更多特殊字符（shell 元字符、智能引号），避免文件创建失败。
路径处理：限制 yt-dlp 输出文件名为 80 个字符，避免 Windows 上的路径长度问题。
FFmpeg：修复 FFmpeg 滤镜语法中字幕路径的单引号转义问题。

重构

错误处理：引入 UserActionableError 类以更好地分类错误，防止用户可解决的错误（API 密钥、配额、账单）被报告到 Sentry。

[3.0.0] - 2026-01-31

亮点

本次大版本更新带来了重大架构改进、新功能和更好的稳定性。

新功能

项目更名为 MioSub：项目已从 Gemini-Subtitle-Pro 正式更名为 MioSub。
CTC 强制对齐器：集成基于 CTC 的强制对齐，实现精确的字幕时间同步。
纯音频文件支持：完整支持无视频的音频文件（MP3、WAV 等），包括优化的播放器界面。
编辑器搜索替换：字幕编辑器新增搜索与替换功能，支持批量修改字幕文本。
手动选择 Whisper 路径：用户现在可以手动指定 Whisper 可执行文件路径，支持自定义安装。
自动更新系统：内置更新检测和自动更新支持，实现无缝升级。
启动闪屏：新的启动闪屏防止应用启动时出现白屏闪烁。
增强日志系统：新的日志系统，支持 JSON 视图、日志查看器界面和改进的调试功能。
Linux ARM64 支持：新增 Linux ARM64 架构的构建支持。

改进

界面全面重构：重新设计编辑器、布局组件和设置面板，视觉更统一、交互更流畅。
内置中日文字体：集成 NotoSans JP/SC 字体，字幕渲染效果更佳。
React Compiler 集成：集成 React Compiler v1.0，实现自动性能优化。
状态管理迁移：从 React Context 迁移到 Zustand stores，提升性能和可维护性。
JSON 解析增强：使用 jsonrepair 库统一 JSON 解析，更好地处理 AI 返回的不规范数据。
取消操作优化：转码和下载任务支持取消，临时文件自动清理。
错误追踪：集成 Sentry 进行错误追踪和分析，提升稳定性。
资源清理：修复多处资源泄漏，改进整个应用的内存管理。
字幕编辑器性能：修复字幕编辑器中 10 多个性能问题，提供更流畅的编辑体验。
流水线健壮性：增强生成流水线中的取消处理和错误边界。
打包优化：改进代码分割，减小应用体积。

文档

新文档站点：文档迁移至 Fumadocs，完整支持国际化（中文/英文）。
重新设计的 README：新的落地页风格 README，改进布局和徽章。

其他变更

许可证变更：切换至 AGPL-3.0 许可证。
macOS x64 交叉编译：在 ARM64 运行器上添加 macOS x64 交叉编译支持。
CI 改进：通过二进制缓存和更新的 OS 运行器加快构建速度。

[2.13.0] - 2026-01-15

新功能

批量操作：将"修复时间戳"替换为"重新生成" - 对选定批次进行完整流水线重新运行（转录 → 优化 → 对齐 → 翻译），支持可选的用户提示。
重新生成弹窗：新增重新生成操作弹窗，支持转录和翻译提示输入。
说话人管理：新增自定义颜色编辑和说话人合并功能。
关于标签页：新增系统信息显示，包含 Whisper 详情、GPU 检测和独立日志路径。
日志系统：增强日志系统，支持 JSON 视图和 IPC 处理器。
编辑器：新增字幕验证规则，对时间问题显示可视化标记。
国际化：完成日语（ja-JP）翻译，为所有语言添加重新生成弹窗字符串。

修复

流水线：更新生成钩子和配置以支持新的步骤架构。
界面：改进术语表配置说明和颜色选择器验证。
核心：解决 lint 警告和二进制路径解析问题。
视频预览：修复 ASS 渲染器对折叠状态的依赖。
协调器：处理后停止继承注释字段。
编辑器：退出过滤模式时重置自动滚动，支持 CANCELLED 状态。

重构

Electron：便携式存储路径（配置/日志在 exe 目录中）和异步硬件检测以加快启动速度。
流水线：将共享上下文提取到 pipelineCore.ts，添加 ProofreadStep 以供未来集成。
流水线：使用新的基于步骤的设计简化块处理器架构。
批量：将 operations.ts 拆分为 proofread.ts 和 regenerate.ts 以实现更清晰的分离。
提示词：移除 fix_timestamps 模式，简化为仅 refinement/translation/proofread。
设置：将控制台日志迁移到 logger，将设置弹窗拆分为模块化组件。
工作区：优化自动保存并更新说话人配置的数据类型。

杂项

i18n 检查器：添加 --check-missing 和 --check-unused 标志，改进检测。
配置：增加字幕最大宽度（55→65）和最小分割宽度（10→20）。
配置：禁用思考级别以优化成本（可重新启用）。
OpenSpec：归档已完成的提案，为批量操作添加永久规范。
构建：更新构建系统以注入 git commit hash。

[2.12.1] - 2026-01-08

新功能

视频预览：改进宽高比处理和加载状态。

修复

配置：将优化和翻译的思考级别调整为中等。
工作区：加载新文件时防止快照历史被清除。
API：在翻译 schema 中包含 text_original 以供参考。
流水线：修复批量操作中的说话人分离标志逻辑。
字幕：改进非语音过滤并清理测试导出。

重构

流水线：简化翻译负载结构并改进元数据继承。

[2.12.0] - 2026-01-06

新功能

对齐：完成 CTC 强制对齐器集成
流水线：添加用于元数据保留的协调器
字幕：实现基于视觉宽度的分割
调试：添加细粒度的模拟 API 控制
流水线：增强元数据保留和处理健壮性
对齐：添加 CTC 对齐器服务和设置界面

修复

字幕：处理未定义的说话人颜色
快照：在时间戳显示中包含日期
国际化：为所有语言添加缺失的翻译键
Lint：添加缺失的 hook 依赖
界面：使用细粒度边界隔离组件错误
国际化：为字幕生成流水线添加缺失的本地化键
字幕：服务改进（生成器、解析器、时间）

重构

命名：将 glossary-state.ts 重命名为 glossaryState.ts
结构：组件重构后更新服务和钩子
类型：集中类型定义并更新导入
组件：重构后更新组件并修复导入
国际化：本地化硬编码的中文字符串并改进提取脚本

杂项

技能：添加 release-version 技能
配置：添加 Claude AI 开发配置
脚本：添加 i18n 键验证脚本
依赖：更新依赖和类型

[2.11.0] - 2026-01-01

新功能

视频预览：实现全面的视频预览系统，支持智能缓存和缓存管理界面。
渲染：使用 assjs 添加所见即所得的字幕渲染，准确呈现样式（字体、大小、颜色等）。
界面：在视频预览中添加原文切换，改进国际化支持。

修复

国际化：添加自动滚动切换和 API 密钥错误消息的缺失翻译。
缓存：修复缓存管理中的国际化和清理逻辑。

杂项

依赖：移除 react-player，改用原生视频处理，并更新依赖。
清理：移除 ytdlp 模块中未使用的代码并修复 lint 警告。

[2.10.2] - 2025-12-28

新功能

国际化：添加日语本地化（ja-JP），实现完整的多语言支持。

修复

国际化：缩短首页卡片描述，以便在较小屏幕上更好地布局。
国际化：优化翻译措辞，使所有支持的语言更加自然。
批量处理：修复时间戳转换，在发送到 Gemini API 之前使用相对时间以提高准确性。
构建：修复打包应用程序中缺少语言文件的关键问题（ENOENT 错误）。

[2.10.1] - 2025-12-25

新功能

设置：语言偏好现在存储在统一的应用设置中，跨会话持久化。
国际化同步：添加渲染进程和主进程之间的语言同步，实现一致的本地化。
Electron：为主进程对话框和原生界面元素添加国际化支持。

修复

国际化：修复语言初始化，使其在应用启动时进行而不是等待设置弹窗，确保从首次渲染就使用正确的语言。

重构

语言切换器：简化当前值逻辑，实现更清晰的实现。

文档

国际化：添加 v2.10.0 国际化系统的基础设施文档。

[2.10.0] - 2025-12-25

新功能

国际化（i18n）：在整个应用程序中实现完整的多语言支持。
- 使用 react-i18next 设置国际化基础设施（阶段 1）。
- 转换所有主要组件：HomePage、SettingsModal、SubtitleEditor、WorkspacePage、DownloadPage、CompressionPage、Editor 组件和 EndToEndWizard（阶段 2-12）。
- 添加语言切换器，让用户更改应用程序语言。
- 为设置、界面组件和所有弹窗创建全面的翻译文件。
- 使用自动化脚本提取中文字符串以进行翻译工作流程。