Repository navigation
Releases
Releases · tarai-dl/fablr
v2.2.0 — 状态机迁移 + P0 稳定 + 死代码清零
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.ts426 → 397 行,核心生成逻辑可独立测试。 - 字幕格式转换工具(
subtitleFormatters.ts):SRT/VTT/ASS 互转 4 个纯函数,与字幕业务解耦。 - Track 历史撤销/重做(
store/createHistory.ts):通用 undo/redo controller,editorStoretrack 操作接入。
修复
- 6 个隐藏 bug(#20):Tauri
listen()在 unmount 后 resolve 仍保存 unlisten / 动态 import 竞态 /undefinedspread 导致后端收到意外键 / retry 边界 (maxRetries=0死循环) / 定时器在组件 unmount 后仍触发。 - CI cold compile 阻塞(#30):
brotli默认依赖在Cargo.lock解析到破坏性版本,pin8.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.ts24 行合并入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.tshook (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内联合法用法。ScriptWriting5 个: any→ 具体类型。@typescript-eslint/no-explicit-any警告清零(8 个 reducer 测试文件)。
CI / 基础设施
setup-pnpmcomposite action(#21):main.yml 6 个 job 重复的 setup 步骤抽到.github/actions/setup-pnpm,维护成本降 80%。rust-testsjob(#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。
样式 / 可访问性
.tDialogueWCAG-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 / 样式 / 文档"分类入档。
vv2.1.0
fix(release): tauri.conf.json version 2.0.0 → 2.1.0 安装包文件名应显示 2.1.0 而非 2.0.0。