先判断是一个接点瞬态，还是别的问题
把“有杂音”改成可复查记录：在哪个输出文件、什么时间、持续到哪里、接点前一句是否完整、接点后第一字是否完整、原片同一位置是否已有异常。戴耳机定位可以帮助发现问题，仍要用正常播放条件回听整句。
| 听到的形状 | 优先检查 | 不要先做什么 |
|---|---|---|
| 只在剪点出现一次极短咔嗒，两段原音各自干净 | 两段是否非连续、波形边缘是否突变、现有边缘处理是否真正进入输出 | 不要重录整段或做全片降噪 |
| 末字少了辅音、呼吸或自然收尾 | 源片出点与句末/停顿证据 | 不要用淡出把缺字变得更不明显 |
| 切后底噪、混响或空调声持续改变 | 地点、声源与环境底声接续 | 不要把持续变化称为一个 click |
| 一整句都沙裂或削顶 | 原录音、增益、混音与导出 | 不要只在句首句尾加 fade |
| 声音干净但动作对不上 | 音画来源区间与放置 | 不要把同步错误当边缘杂音 |
在原片中也存在的咔嗒不能靠移动一次拼接就宣称修好。只在某个播放器预览时出现，也要用同一导出文件换播放条件复核，避免修改本来正确的媒体。
修边缘之前，先锁完整字音和真实连续接点
video-cut 的固定工作流先避开原片硬切，再把边界吸附到可靠句末或自然停顿；如果 ASR 证据仍显示入点或出点落在讲话区间，会把它作为阻断项。声音完整性优先于为了画面干净而切掉半句。
还要区分两类相邻片段：
- 同一源文件的真实连续范围：前段正好接到后段，没有跳过任何源时间。固定实现不在这类连接两侧加默认淡化，以免凭空形成音量凹口。若这里仍有 click，先查源音、编码与实际连接，不把“加更长 fade”当唯一答案。
- 非连续片段或不同来源：两个波形边缘可能突然接上。短淡化可以成为候选，但须保住字头字尾和有意义的静默，并试听输出。
若一句“蓝色文件夹”在“夹”字释放前被切断，应先扩回原片中完整发声和必要停顿。一个没有完整字音的片段即使边缘很平滑，也不是合格修复。
30 ms、5 ms 与 50 ms 各自只属于固定实现
这些数字说明源码怎样工作，不能硬变成全场公式：
| 固定工具路径 | 实际行为 | 不能推出什么 |
|---|---|---|
video-cut CLIP_JOIN_AUDIO_FADE_MS | 默认 30 ms；参数必须是非负有限数；每个边缘的实际淡化不超过该片段时长的一半 | 30 ms 一定听不见，或一定能修所有 click |
| video-cut 连续同源连接 | 检测为无损连续时，接点这一侧使用 0 ms 默认淡化 | 所有同文件片段都连续；是否连续仍取决于源区间 |
| video-assemble 旁白边缘 | 淡化受可测边缘静音限制；没有可测静音时只保留 5 ms 防咔嗒斜坡 | 可以裁掉字尾来塞进窗口；实现反而在无安全完整窗口时阻断 |
| short-drama-edit 单个已放置声音 | Placed 默认尾淡出 50 ms，并压到不超过声音时长一半；用于避免裁短尾部 click | 它会给原片接点做交叉淡入、执行 声音 说明或修复嵌在原音里的爆音 |
实际项目先用当前路径的默认行为出候选，再按听到的问题决定是否需要明确调整。改环境变量或外部编辑器参数时，记录旧值、新值、受影响接点和新输出；不只保存界面截图。
原创完整排查例：文件夹交接的两段素材
这是作者设计的纸面练习，没有真实文件、波形测量、渲染或试听结论。社区中心前台有两段虚构原片：源 A 中，职员许舟说“回执在蓝色文件夹里”，随后把文件夹推过柜台；源 B 中，志愿者苏宁接住文件夹，回答“我拿到了”，并把它放进周转箱。故事要求保住说明、接住和确认，不能把“拿到了”改成已经送达目的地。
假设初版计划如下：
| 片段 | 纸面源区间与职责 |
|---|---|
| A | 源 A 4.20–6.80 s：完整说明，文件夹滑到柜台中线，许舟松手 |
| B | 源 B 12.40–14.10 s：苏宁接稳，说完“我拿到了”，放入周转箱 |
| 输出接点 | A 后直接接 B；设想在输出 2.60 s 听见一次咔嗒，但本例未实际生成，不能写“检测到”或“修复成功” |
先建立三份候选判断，不跳步选参数：
- 如果回听虚构源 A 的
6.80 s附近本身已有咔嗒，问题属于源尾或所选区间。比较稍早/稍晚但仍保住松手的合法出点，或处理源音；不能说拼接 fade 已消除源缺陷。 - 如果两段源音各自干净，完整字音与动作都在区间内，而异常只在非连续输出接点，保留两个职责和区间，先用 video-cut 该版本默认边缘处理重出一个候选。正常速度听“文件夹里”到接住的全过程，再放大检查接点；30 ms 只是实现事实，结果仍待听。
- 如果 B 开始后整个前台底声持续变空，异常属于声场变化。转入环境声接续：记录两段空间、底噪和混响，比较合适的底轨或外部交叉处理。不能靠把边缘 fade 从 30 ms 拉长，就宣布持续声场已统一。
完整字音优先的分支： 假设实际听审发现源 A 的 6.80 s切在“里”的尾音上，而 6.96 s才有完整释放和短停顿。应先把 A 的出点候选扩到真实 6.96 s，再检查文件夹松手和 B 的接住是否造成重复动作。若动作区间冲突，重选能同时保住声音和交接的素材；不把尾音淡没。这里的 6.96 s仍是教学设定，不是可复制到别的视频的数值。
修后结论只能来自新输出：说完整、接物只发生一次、咔嗒不再可听、底声变化符合现场、苏宁只确认已接到文件夹。任何一项未听或未看，就标待检查。
复制这份剪点修复记录
每次只改有证据的范围：
当前输出： 文件路径、版本或哈希；接点时间。
前段来源： 文件、源入点/出点、最后完整字音或动作。
后段来源： 文件、源入点/出点、第一完整字音或动作。
异常形状： 单次 click / 缺字 / 持续底声变化 / 整段失真 / 同步偏移。
原片对照： 前段原音、后段原音各自是否存在同样异常。
连续性： 是否同一源文件且区间首尾无缝相接；未知就写未知。
本次改动： 移动哪个边界、恢复哪段字音、使用哪个固定工具默认或哪项明确外部处理。
保留不动： 画面职责、完整台词、字幕、旁白、配乐或其他已定轨道。
新输出验收： 正常速度整句、接点前后、动作一次性、底声、字幕和同步；未听写待检查。
对 video-cut，clip_plan.json 仍用真实源秒数和 reason 记录取舍；不要只改导出文件而保留陈旧计划。若旁白已经按旧输出时间写好，剪点变化后要按新 edited_source.mp4 时间线复核，不能假定后续位置自动正确。
失败修法：别用一个 fade 包办所有声音故障
| 失败做法 | 实际风险 | 更小的修法 |
|---|---|---|
| 所有剪点统一加长交叉淡化 | 连续同源接点出现音量凹口，辅音和短音效被削弱 | 先判连续性和异常位置，只处理有证据的边缘 |
| 缺一个字也只做淡出 | 缺失仍在，只是更难听清 | 回源恢复完整句末与必要停顿，再重选动作接点 |
| 底声跳变当一次 click | 边缘平滑后，空间仍在整段改变 | 转到环境声层，记录声源、距离、混响和实际外部处理 |
| 整段爆音只修两端 | 中间削顶或失真不变 | 比较源录音、混音与导出，修首次出错的层 |
| 调到报告没有异常就结束 | 工具成功不等于实际听感通过 | 听新文件的接点、整句与整段，并保留未测项 |
| 为了塞进窗口裁 TTS 尾字 | 语义和可懂度受损 | 缩文案、移动窗口或阻断；固定旁白实现本身不把不完整尾字当安全适配 |
常见问题
把淡化改得越长，咔嗒声越容易消失吗？
更长淡化会削弱字头字尾、短音效或连续接点的电平。先确认异常只在边缘、字音完整且两段属于非连续来源，再对实际候选回听。
video-cut 的 30 ms 是推荐的通用参数吗？
不是。它是固定源码版本的默认实现，实际还会受片段长度上限与连续同源豁免影响。文章不把它推广成所有编辑器、素材或声音的标准。
用 skill 来做
请用 $video-recap 检查我标出的音频剪点。先对比实际输出与两段原音，确认完整字音、同源连续性和异常持续范围；保留 clip plan 的来源区间与理由，给最小修复候选并重新输出。不要自动把所有接点加长淡化；回听新文件后再报告结果。
查看具体方法： video-cut 剪点、句界与声音优先级 · 30 ms 默认值与参数校验 · 连续接点豁免与边缘淡化实现 · 旁白边缘静音与 5 ms 防咔嗒回退 · 短剧音效尾淡出与混音边界