Skip to content

v2.2.0 — 状态机迁移 + P0 稳定 + 死代码清零

Latest

Choose a tag to compare

@Agions Agions released this 22 Jun 06:27
· 287 commits to main since this release

v2.2.0 — 状态机迁移 + P0 稳定 + 死代码清零 (2026-06-22)

81 个 commit 汇总 (2026-06-08 → 2026-06-19)。最大亮点:18 个组件 useState → useReducer 迁移完成,-3970 行死代码清理,P0-P5 稳定性 / 可访问性 track 完整收官。

🎯 Headline 数字

指标 数值
commits since v2.1.0 98
useState → useReducer 迁移 141 个 useState → 状态机 reducer
新增 reducer 单元测试 +469 测试 / 19 个 reducer
死代码清理 -3970 行 / 0 调用者
Rust 集成测试 3 个新文件 (resilience / crash_recovery / audio_mix)
性能提升 2 个 CPU-bound 操作异步化 + axios 移除 (-16KB)
tsc / eslint / vite / vitest / cargo 全部 0 errors / 0 warnings

📋 完整 CHANGELOG (from docs/CHANGELOG.md)

新增

  • 自动转场建议引擎(transition-suggestion.ts,P1-A):30+ 规则矩阵,根据相邻片段的速度差 / 类型切换 / 节拍点 / 静音段自动推荐转场类型。
  • AI 剪辑速度 & 转场暴露 UI(P1-B):<SegmentTimelineCard> 显示 suggestedSpeed 和 suggestedTransition,用户一键应用。
  • panic hook + 进程级资源限制器(utils/resilience/,P0):捕获 Rust 端 panic,通过事件总线把报告发到前端,触发 graceful shutdown。
  • panic-hook 报告前端可视化(P0-4):前端 crash-recovery 模块订阅 panic 事件,展示崩溃摘要 + 最近日志 + 资源占用,用户可一键导出诊断包。
  • AppError + 27 处业务抛错标准化(core/errors/AppError.ts):消除裸 throw new Error('msg'),业务异常带错误码 + 上下文 + 重试建议。
  • ASR 策略模式(core/services/asr/providers/):原 445 行 asrService.ts 拆为 3 个独立 Provider + 1 个编排器,新 Provider 只需注册即可。
  • clip-pipeline 纯函数库(clipGenerators.ts):clipWorkflow.ts 426 → 397 行,核心生成逻辑可独立测试。
  • 字幕格式转换工具(subtitleFormatters.ts):SRT/VTT/ASS 互转 4 个纯函数,与字幕业务解耦。
  • Track 历史撤销/重做(store/createHistory.ts):通用 undo/redo controller,editorStore track 操作接入。

修复

  • 6 个隐藏 bug(#20):Tauri listen() 在 unmount 后 resolve 仍保存 unlisten / 动态 import 竞态 / undefined spread 导致后端收到意外键 / retry 边界 (maxRetries=0 死循环) / 定时器在组件 unmount 后仍触发。
  • CI cold compile 阻塞(#30):brotli 默认依赖在 Cargo.lock 解析到破坏性版本,pin 8.0.4 修复。
  • Timeline hooks 子目录相对路径错位(#11 轮重构遗留):Hook 移入 Timeline/hooks/ 后 import 路径未同步更新。
  • VideoExport 子组件 less import 路径错位:4 个子组件 Vite build 失败。
  • cargo test --lib 被 6 个 pre-existing 错误毒化:ExitStatus::from_raw 在 rustc 1.86+ 变 unsafe / (end - start).max(0.0) 数值类型歧义 / pcm_samples_from_wav 两个测试断言错(i16::MAX / 32768 ≈ 0.99997,3 字节 PCM = 1 帧非 2 帧)。
  • resilience 测试污染全局静态:ResourceLimiter 用 OnceLock<u64> 共享 MAX_CAPACITY,测试间互相污染 → 引入 with_capacity() 构造函数隔离。
  • Reducer 测试 TS 错误(CI blocker):#48 +229 测试引入 4 文件 tsc 报错,补完类型签名。

性能

  • detect_zcr_bursts 异步化 + 进度事件(#26):用 tauri::async_runtime::spawn_blocking 把 CPU 密集检测移出主线程,前端实时看到 0–100% 进度。
  • transcode_with_crop 异步化 + 进度事件(#27):多分钟 ffmpeg 转码不再阻塞 Tauri 主线程,通过事件 emit 每秒进度。
  • 移除 axios + uuid:替换为原生 fetch + crypto.randomUUID(),包体积 -16KB。
  • Zustand selector 优化:AIVideoEditor 的 editorStore 改为独立 selector,避免对象引用变化触发整树重渲染。

重构

  • 核心服务层拆分:visionService.ts (662 行) → 4 个独立服务(场景 / 物体 / 情感 / 报告);subtitleService.ts (558 行) → 2 个服务(Whisper / 字幕);scriptService.ts (548 行) → 4 个模块。
  • 巨型组件拆分:VideoComposing.tsx (716 行) → 1 Hook + 6 个子组件;VideoExport.tsx (450 行) → 3 个子组件 + 阶段推断工具;MultiTrackTimeline 拆分 + 3 个自定义 Hook。
  • Hook 拆分:useEditorState → 3 个独立 Hook(usePlaybackControl / useClipOperations / useTrackOperations);useVideo (366 行) → 4 个纯函数工具 + 删除 hook 自身。
  • useState → useReducer 状态机迁移(v3.4 §A2 范式,15 个组件):VideoEditor (16) / ProjectEdit (17) / VideoProcessingController (14) / VideoExport (14) / OriginalEditor (12) / ScriptDetail (11) / ClipRippling (11) / SubtitleExtractor (10) / ProjectDetail (6) / Highlights (6) / AIVisualizer (6) / VideoSelector (5) / VideoPlayer (5) / VideoUpload (5) / WorkflowEditor (4) / CommentaryPanel (5) / CommentaryScriptEditor (3) — 累计 163 个 useState → 17 个 reducer。
  • AI 模型配置拆分:aiModels.config.ts (1069 行) → 3 个子模块(provider / capability / pricing)。
  • 消除循环依赖:invoke / rawInvoke / TauriCommand / TauriBridgeError 提取到 core/tauri/invoke.ts,打破 tauri bridge ↔ clip-pipeline 互引。
  • DRY 整合:timecode.ts 24 行合并入 formatting.ts;projectMetrics 从 334 行 shared/utils/index.ts 抽出。
  • 死代码清理(5 轮,~3500 行净删除):
    • 8 个完全重复的 barrel 文件 (index.tsx = 组件.tsx)
    • 4 个 dead progress modules (#23, -849 行)
    • 4 个 dead ui/scripts 文件 (#24, -275 行)
    • 6 个 dead ui components (#25, -1846 行)
    • 8 个 dead code files (#48, -683 行)
    • 5 个 dead code (#39, -445 行)
    • useVideo.ts hook (249 行) + hooks/videoUtils.ts (157 行)
    • 4 个未引用 export(ALLOWED_EXTENSIONS / ApiError / AppConfig / AudioFile)
  • console.* 统一为 logger(6 个文件):useTrackOperations / useEditorState 等。

类型安全

  • @ts-expect-error 注释规范化(71 → 21):每个注释必须说明"为什么必须有",预留参数全部标 "reserved for future ..."。
  • any 收紧(8 文件 / 31 → 0):as any 全清,只剩 vite.config.ts 内联合法用法。
  • ScriptWriting 5 个 : any → 具体类型。
  • @typescript-eslint/no-explicit-any 警告清零(8 个 reducer 测试文件)。

CI / 基础设施

  • setup-pnpm composite action(#21):main.yml 6 个 job 重复的 setup 步骤抽到 .github/actions/setup-pnpm,维护成本降 80%。
  • rust-tests job(#23 验证 P0-1):跑 cargo test --test resilience + cargo test --test crash_recovery,lib 测试被 6 pre-existing 错误毒化问题时绕开。
  • libglib2.0-dev 安装(P1-C):CI runner 默认不带 glib-2.0/gtk-3/webkit2gtk 的 .pc 文件,rust-tests 编译链断。
  • CI 质量门收紧:ESLint warnings 阈值 250,coverage 阈值 30%,src/ TypeScript errors 必须为 0。

样式 / 可访问性

  • .tDialogue WCAG-safe 蓝色(P5):原 @info-color #3b82f6 对比度 3.61 不达标,改为 WCAG AA 蓝色。
  • SegmentTimelineCard 缺 CSS class 补齐(P3):14 个 CSS module 类引用但定义缺失。
  • a11y 对比度 + 移动端响应式(P4):智能面板 dark theme 对比度 / ≤768px 断点布局。

文档

  • REFACTORING_REPORT.md:完整记录 11 轮拆分 / 拆分前后行数 / 动机 / 验证步骤。
  • CHANGELOG 补完(本次):2.1.0 后 82 个 commit 按"新增 / 修复 / 性能 / 重构 / 类型安全 / CI / 样式 / 文档"分类入档。