先找哪一步开始模糊
不要只看编辑器里的预览，也不要只凭文件名写着1080p判断清晰。把同一时刻分别定位到原片、剪后画面母版和本地导出，用同一播放器、相同窗口大小与播放条件比较。先看细字、边缘和纹理，再正常速度看运动；截图只能看单帧，不能判断整段运动画质。
| 首次变差的位置 | 接下来查什么 |
|---|---|
| 原片已经不清楚 | 换可用的原始文件或补拍必要画面；提高导出尺寸无法补回原来没有记录的细节。 |
| 原片清楚，剪后母版变差 | 是否用了低清下载或预览副本，是否放大了局部，拼多来源时哪个画面被放大。 |
| 母版清楚，本地导出变差 | 实际输出宽高、缩放上限、编码设置以及是否重复压制已有成片。 |
| 本地导出清楚，上传播放才变差 | 平台处理是否结束、实际播放清晰度与观看条件；先别因此重做本地剪辑。 |
同一文件在不同播放器中差别明显时，把播放器和显示缩放也记录下来，不能直接把差异归到导出参数。
输出尺寸与画面里的细节分开查
画幅是宽高关系，分辨率是实际宽高像素，两者不是同一件事。横竖素材怎样并排进入一个画幅，见横竖屏拼接；本页检查的是已经选定的画面在制作途中哪里丢了细节。
大画布里放着一个小视频，再加留边，文件尺寸可以很大，主体占用的像素仍有限。裁出原片很小的区域放满画面，也会放大已有像素。检查实际可见区域，不能只记录容器宽高。
所引 video-cut 多来源路径把片段等比例放进统一画布并留边；画布选择考虑实际采用来源的方向、面积与时长。低清来源可能在较大画布里被放大。这个流程解决拼接规格，不保证每段达到同等细节，也不会自动做超分辨率修复。
源几何探测还考虑旋转和像素宽高比。对竖屏或带旋转信息的素材，按实际显示画面核对，不只抄存储宽高。
核对当前skill真正使用的设置
下面只说明所引固定版本的 video-assemble 合成路径，其他编辑器和包装路径须另查。它有三项输出设置：
- OUTPUT_MAX_HEIGHT：大于0时限制输出高度并保持宽高比；0表示本阶段不加这个缩放。实现只缩小，不把低清画面升成高清。
- OUTPUT_CRF：此路径的x264编码质量设置，默认18。调大通常减少体积并加重损失；调小不能恢复源画面已经丢掉的细节。不要把18称为所有素材都无损的保证。
- OUTPUT_PRESET：默认veryfast。它参与编码速度与压缩取舍，不能当成分辨率选项。
这些编码设置仅在本阶段重新编码视频时生效。烧录字幕、遮罩、视觉叠加、包装、缩放或强制重编码会进入编码路径；没有这些处理时，视频流走复制路径，改CRF不会凭空重新压制它。音频另按已有声音方案处理。
video-cut 产生剪后母版时已使用自己的编码设置；合成阶段再设置更低CRF不会恢复上一步的损失。可回到尚清楚的源文件重建受影响画面，避免反复把已压制成片当原片。若另走前景包装或剪映导出，也按那条路径的实际实现与输出复核，不把这里三个变量当通用开关。
原创排查方案：装订教程里的细线看不清
这是虚构的纸面案例，没有真实文件、探测或观看结论。创作者把一段手工装订教程剪成短视频，关键内容是针从纸孔穿出，细线收紧，随后打结。假设原片和已剪画面母版都是1920×1080，源文件能看清孔位与线条；旧导出使用OUTPUT_MAX_HEIGHT=480，作者觉得针线细节不够清楚。字幕、剪点与声音已定。
先证实假设：实际打开三份对应文件，定位穿孔和收线时刻；探测它们的真实宽高；同条件播放比较。若母版已经丢了细节，就停止只改最终导出，回到造成损失的那一步。若旧导出实际没有缩到480高，也不能拿这项设置当已证实原因。
若比较确认损失首次出现在该缩小导出，本例作者选择保留1080高的本地候选：从清楚的画面母版重新出文件，在这条合成路径把OUTPUT_MAX_HEIGHT改为0，编码采用OUTPUT_CRF=18、OUTPUT_PRESET=veryfast。保持原字幕、画面次序与声音决定，使用单独候选工作目录和输出，留下原版作比较。关闭这个缩放只是不再缩小，不承诺候选立刻清楚；仍需实际检查。
完整复查：同条件比较原片、母版、旧导出和新候选的穿孔、收线、打结全过程。针应确实穿出，线应真正收紧，结应完成；不能为了看起来更清晰改成静态示意图或删掉步骤。核字幕没有因缩放改变而压住针线，声音仍完整且同步，再测候选宽高。
若候选细节可读，记录文件与实际观察后供作者采用；若仍不好，分别排查源细节、裁切放大和编码，不直接宣称参数已修复。若平台要求另交较小文件，单独制作并比较这一版的可读性，不把这里取消缩放当成所有交付规格。
修画质时保住已经定下的内容
向AI交代哪些是已定内容：台词、字幕文本、剪点、动作顺序、配乐与完整混音。要求先定位首次损失，说明拟改的输入和输出设置，再出画面候选；不要因为你说“高清一点”便重写旁白、换声线或重剪故事。
已有完整混音时，按保留已定声音采用与新画面兼容的处理办法，不能从新默认流程悄悄生成另一版声音。交付时提供实际文件、探测值、查看过的关键段及尚未确认的问题。渲染成功只证明文件生成，不是观看已经满意。
常见问题
把720p导出成4K会恢复细节吗？
尺寸变大不等于原有细节回来。先检查可用原始文件与实际主体像素；本文所引路径不做超分辨率，不能把放大结果当真实恢复。
本地清楚，上传YouTube后模糊怎么办？
先区分上传处理与本地导出。YouTube说明视频初期会先有低清版本，较高清晰度在处理完成后可用；检查处理状态与实际播放选项，再比较。参见YouTube低清播放说明，不要给所有平台套固定等待分钟数。
用 skill 来做
使用 /video-recap（Codex中用 $video-recap）核对我提供的原片、剪后母版、导出文件及输出设置，先给首次画质损失的证据与修改方案。本轮保留已定台词、字幕文本、镜序与混音；只讨论时不运行剪辑、配音或合成。批准制作候选后再按真实支持路径执行。
查看具体方法： 实际输出尺寸与编码配置 · 重编码与视频流复制分支 · 只缩小的高度限制 · 显示几何与多来源画布选择 · 剪后母版缩放与编码