# ReaCut 一周功能推进计划

执行周期：2026-10-20 至 2026-10-26，每天北京时间 10:00，在当前聊天继续推进。

本周目标：推进下一版 ReaCut 的剪辑完整度，交付可以实际完成作品的新能力。前六天围绕功能开发，第七天贯通完整工作流并交付安装包候选。修复、CI、文档与测试作为每项功能的交付要求，不单独占据整周。

这是功能目标和优先顺序，不是预先宣称全部功能都能按日完成。当天工作复杂时继续完成核心流程，记录剩余项并调整后续安排；不能把功能目标悄悄降级成改提示、补文档或修一个无关小问题。

## 功能里程碑

### 10 月 20 日：时间线编辑能力升级

- [x] 增加明确的“插入”与“覆盖”入轨模式，支持源素材 I/O 选段。
- [x] 支持视频与分离音频的关联选择、移动和裁剪，并提供解除关联操作。
- [x] 插入时正确推动受影响片段，覆盖时保留两侧剩余片段；处理锁轨和时间冲突。
- 验收：从三段素材完成粗剪，画声保持同步；一次撤销恢复完整操作；保存重开与实际导出结果一致。
- 已有分割、多选、音频分离与磁吸删除是复用基础，不能作为本次新增成果重复计数。

### 10 月 21 日：倒放与定格画面

- [x] 为选中视频片段增加倒放操作，基于本地 FFmpeg 生成可复用衍生媒体，提供进度和取消。
- [x] 支持从当前播放位置生成定格片段并调整持续时长。
- [x] 明确倒放时原声的处理方式，管理缓存及项目保存后的媒体引用。
- 验收：用带帧编号的合成视频核对倒放顺序、入出点和定格帧；预览、导出、撤销、重开均可用，不覆盖源媒体。

### 10 月 22 日：可视化关键帧曲线编辑器

- [x] 增加可视化关键帧时间轴/曲线面板，支持选择、拖动、删除和精确输入时间与数值。
- [x] 在现有 linear / smoothstep 基础上扩展缓入与缓出，采用共享插值模型；本次未实现任意贝塞尔手柄。
- [x] 支持关键帧复制/粘贴，处理裁剪、分割后的曲线连续性。
- 验收：使用同一工程制作推近、平移与透明度动画；逐帧比较预览/导出，保存重开不改变曲线。

### 10 月 23 日：字幕与文字动画工作流

- [x] 增加字幕按播放头拆分、相邻字幕合并，并明确文本拼接和时间范围规则。
- [x] 支持批量应用可编辑字幕样式，以及统一的文字入场、停留、出场动画设置。
- [x] 复用现有 SRT/WebVTT 导入和字幕列表，完善“导入字幕→修整→统一样式→导出”流程。
- 验收：用含中英文、长句和重叠时间的合成字幕完成全流程；撤销和项目重开正确，成片动画与预览一致。字幕文件导出明确其不携带动画的格式限制。
- 本周不引入云端语音识别；已有 16 款文字模板不作为新增字幕能力重复计数。

### 10 月 24 日：声音处理与自动压低背景音乐

- [ ] 增加本地响度分析与归一化入口，允许选择目标响度并展示分析/处理进度。
- [ ] 对用户明确选中的人声轨与音乐轨，实现人声区间内自动压低音乐，支持压低量及进入/恢复时长调整。
- [ ] 将结果保留为可编辑、可撤销的参数或音量包络，复用已有音量关键帧能力。
- 验收：用自造的人声替代信号和音乐测试预览/导出响度及压低区间，检查峰值、静音、重叠片段和取消操作，不破坏原媒体。

### 10 月 25 日：可复用模板与替换素材

- [ ] 将当前工程保存为本地模板，支持模板名称、封面预览、素材占位和文字占位。
- [ ] 从模板新建独立工程，一次替换多个素材与文案，明确时长不足和画面比例变化时的处理策略。
- [ ] 复用现有可搬移项目素材包，支持模板导入/导出，附至少三套自主制作的可用示例。
- 验收：宣传片、口播字幕、图文展示各生成一个独立工程并成功导出；不修改模板原件，不引用未授权第三方素材。

### 10 月 26 日：完整工作流联调与版本候选

- [ ] 使用原创/合成素材制作一支 30–60 秒作品，贯通本周实际完成的粗剪、倒放/定格、动画、字幕、声音和模板功能。
- [ ] 核对桌面版与 Codex 插件对新增功能的操作路径；有必要时补齐受限工具接口及 skill 说明。
- [ ] 解决阻碍交付的回归，更新功能矩阵、中英文 README、使用文档与更新日志。
- [ ] 构建 macOS DMG 和插件 ZIP 候选，生成校验文件、演示视频及周报。
- 验收：交付可下载/打开的本地产物和实际成片；逐项列明完成、部分完成、未完成及平台边界。v0.6.0 已由独立发布任务于 10/22 发布，包含此前功能及本地语音；本周剩余功能的候选版本需在验收后另定，不复用或覆盖已发布附件，不据版本号宣称整周完成。

## 每日交付标准

1. 先检查代码与最新 Git 状态，再选择实现路径；已有能力应扩展使用流程或补齐明确缺口，不能重复造轮子。
2. 每项新增功能至少贯通：界面入口、状态模型、保存/重开、撤销/重做、预览、导出；确实不适用的环节说明理由。只做按钮、静态效果或未接入导出的原型不算完成。
3. 使用合成素材执行与改动相关的语义和真实媒体测试。修复阻碍当前功能的 CI 问题，但不能通过删断言、隐藏失败或无理由跳过测试获得通过。
4. 当天汇报须包含用户现在能做什么、操作路径、测试证据、截图或短演示、提交链接和剩余缺口。
5. 验证通过后，提交归属明确的本次改动及进度记录，并正常推送至现有 GitHub 仓库；不强推，不覆盖用户、其他任务或远端的新修改。冲突无法安全处理时保留现场并报告。
6. 0.5.1 按需启动修复已于 10 月 19 日提交并推送（`d186385`），一周计划基线为 `1539c5a`；不能用这项既有修复替代第一天的新功能目标。
7. 遵守 AGENTS.md 和现有离线产品范围。研究仅限已授权范围；无需为了实现这些独立功能启动第三方应用、破解访问控制或复制其代码/素材。公开资料、原创实现和合成测试足以支持时直接开发。
8. 每天围绕一个功能主题持续推进。未完成的核心流程优先续完，可顺延后续主题并说明理由，不为每日打卡留下多个不可用半成品。
9. 每日只在实际进展、完成或阻碍时通知；没有变化时保持安静。计划于 10 月 26 日结束，不自动延长；最后汇总真实交付结果。
10. 周末安装包先作为候选产物交付，不自动覆盖已发布 Release，不改动用户现有项目。

## 每日记录

| 日期 | 可用的新能力 | 验证 / 演示 | 提交 / 产物 | 剩余缺口与调整 |
| --- | --- | --- | --- | --- |
| 2026-10-20 | 已完成：源 I/O 插入/覆盖/叠加及目标轨；分离后画声关联选择、移动、裁剪、分割、解除关联；锁轨原子保护 | 310 项测试、构建、真实桌面保存重启和五秒画面/音调导出验证；[截图与操作](TIMELINE_EDITING.md)、[解码证据](validation/timeline-editing-2026-10-20.json) | 本日功能提交见 [文件历史](https://github.com/Xiangyu-CAS/rea-capcut/commits/main/docs/TIMELINE_EDITING.md)；本机 `.test-output/timeline-edits-electron/rough-cut.mp4` | 源码已交付，未替换 DMG/已安装插件；暂无任意片段重新关联，新增模式从源预览操作；Windows CI 仍有既有失败，详见 VALIDATION.md。10/21 按计划继续倒放与定格。 |
| 2026-10-21 | 已完成：选段倒放（原声倒放/移除）、关联画声替换、可调时长静帧全轨插入；进度/取消、持久化衍生素材及复用 | 335 项测试、构建；真实桌面五组流程、保存重启、十个预览点及 108 帧导出逐帧匹配；[操作与截图](REVERSE_FREEZE.md)、[证据](validation/reverse-freeze-2026-10-21.json) | 本日提交见 [文件历史](https://github.com/Xiangyu-CAS/rea-capcut/commits/main/docs/REVERSE_FREEZE.md)；本机 `.test-output/derivatives-electron/reverse-freeze.mp4` | 源码交付，未替换 DMG/插件；倒放限 60 分钟、项目帧对齐时长、SDR 8-bit 和 4096×2160 像素量，完整文件不自动清理；Windows 既有 CI 问题仍保留。10/22 继续关键帧曲线。 |
| 2026-10-22 | 已完成：可视化关键帧拖动/精确输入/选择删除/跨片段复制粘贴；新增缓入、缓出，共享插值并保持裁剪/分割/转场相位 | 360 项测试、构建；真实桌面五组流程、保存重启及 60 帧预览/导出逐帧比对；[操作与截图](KEYFRAME_CURVES.md)、[证据](validation/keyframe-curves-2026-10-22.json) | 本日提交见 [文件历史](https://github.com/Xiangyu-CAS/rea-capcut/commits/main/docs/KEYFRAME_CURVES.md)；本机 `.test-output/keyframe-curves-electron/curves.mp4` | 今日源码尚未进入 v0.6.0 DMG；不含任意贝塞尔手柄/变速曲线；旧应用不能打开含新缓动的工程。同步了远端本地语音与发布改动，未重复计为今天成果；10/23 继续字幕编辑与动画。 |
| 2026-10-23 | 已完成：播放头/文本光标拆分、连续字幕合并；直接批量样式；入场/停留/出场动画（渐显隐/上滑/缩放与可调呼吸），生成可编辑关键帧 | 391 项测试、构建；真实桌面四组、保存重启、8 秒/240 帧导出与 12 点预览对照；[操作与截图](SUBTITLE_WORKFLOW.md)、[证据](validation/subtitle-workflow-2026-10-23.json) | 本日提交见 [文件历史](https://github.com/Xiangyu-CAS/rea-capcut/commits/main/docs/SUBTITLE_WORKFLOW.md)；本机 `.test-output/subtitle-workflow-electron/captions.mp4` | 源码交付，未替换 v0.6.0 DMG/插件；SRT 仅含文本与时间，动画表单不反推手动曲线；Windows 既有 CI 问题仍保留。10/24 按计划继续响度与自动压低音乐。 |
| 2026-10-24 | 待执行 | — | — | — |
| 2026-10-25 | 待执行 | — | — | — |
| 2026-10-26 | 待执行 | — | — | — |