ZXSUB · 开发进度报告
本页随版本发布同步生成，截图为应用真实运行画面（无头 Chrome 于 localhost:4173 实截）。
版本 v0.3.0 2026-10-18 · 仓库 gitee.com/1530564211/zxsub · 构建 gzip ≈ 63KB · 运行时依赖仅 react
一、本版（v0.3.0）做了什么
| 类别 | 内容 |
|---|
| 图形化媒体预览 | 字幕编辑器新增视频播放窗：上传音/视频即可在编辑器内播放，波形红播放头与视频进度实时同步；点击波形定位时间。对标 Aegisub 的「视频 + 波形 + 文本」三联打轴。 |
| 波形降级策略 | 视频容器取不到 PCM 时（部分编码）波形降级为基线，播放与打轴不受影响。 |
| 落地页目录 | 新建独立 landing/ 目录：营销落地页 + 本进度页 + 截图。封包打包时自动排除（应用只构建 src/，Tauri/Electron 只装 dist/）。 |
| 截图流水线 | tools/shoot.mjs 用系统 Chrome 无头遍历八个模块自动截图，进度页里的图全部为真实运行画面。 |
关于「各种格式编码」的诚实说明：浏览器原生可播放 mp4/webm/ogg；MKV、HEVC、AVI 等需要原生解码器，将在桌面端（Tauri/Electron）集成 libVLC 实现——这是 M3 阶段内容，网页端先把流程跑通。
二、版本时间线
| 版本 | 日期 | 里程碑 |
|---|
| v0.1.0 | 2026-10-18 | 首个可运行版本：七模块工作台 + Changelog（md+页面）+ Tauri/Electron 脚手架 + 架构设计文档 |
| v0.2.0 | 2026-10-18 | M1 字幕编辑深化：真波形 + 播放同步 + 键盘打轴（,/. 定起止）+ ASS 样式面板 |
| v0.3.0 | 2026-10-18 | 图形化媒体预览（视频窗）+ 落地页目录 + 版本化进度页 + 截图流水线 |
三、各模块实际截图
01 · 项目 / 流水线 —— 十一环角色状态机（片源→翻译→…→发布），示例项目「深夜动画 S1」三集追踪
02 · 字幕编辑 —— 本版新增视频播放窗 + 波形打轴面板；快捷键提示（,/. 定起止、空格播放、Ctrl+←/→ 微调）
03 · 翻译协作 —— 句段状态机（未译/翻译中/已校）+ 术语库
04 · 编码导出 —— ffmpeg 预设可视化（CRF/Codec/preset/软字幕 vs 烧录），实时生成命令
05 · 片源 / 光盘 —— MakeMKV / eac3to / DGIndexNV 任务与命令生成
06 · 封装发布 —— mkvmerge 作业构建（视频/音轨/字幕/字体附件/章节）
07 · 质检 QC —— 九类检查清单与打回记录
08 · 更新日志 —— 应用内页面，与 CHANGELOG.md 由 src/changelog.ts 单一数据源同步
四、轻量化体检
| 指标 | 数值 | 说明 |
|---|
| 运行时依赖 | 2 | 仅 react + react-dom，无 UI 框架/图标库/状态库 |
| 构建产物（gzip） | ≈63KB | JS 62.9KB + CSS 1.7KB；视频播放用原生 <video>，零额外体积 |
| 桌面安装包 | 3–5MB | Tauri（lto+strip+opt-level=s）；Electron 备选 ~100MB |
| 打包排除 | landing/ | 落地页、进度页、截图、tools/ 均不进应用构建与安装包 |
五、下一步
- M2 · 协作后端：多人分配、评论、术语库云端同步（逻辑层不动，仅换状态源）
- M3 · 桌面端真调用：ffmpeg/MakeMKV 进度回流、压制队列、libVLC 全格式播放
- M4 · KFX/Typeset 辅助：卡拉OK 模板、Sign 定位预览