关于 auto-editor-effects
auto-editor-effects 是 auto-editor 的技能指南，介绍如何为视频和音频片段应用动作与动画，涵盖条件编辑、叠加层、渐变、关键帧和时间范围操作。
主要功能
- 01按片段标签应用条件动作
- 02视频与音频效果
- 03媒体叠加与生成式图层
- 04动画渐变与定时关键帧
- 05覆盖指定时间范围的动作
适用场景
- 01加速或调整静音片段
- 02添加并动画化 Logo 叠加层
- 03制作淡入淡出和缩放效果
- 04对选定时间范围应用效果
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/auto-editor-effects确认已加载。
详细介绍
动作与动画
不要只是剪切，为每个片段设置一个带 --when-active
（-w:1，有声）和 --when-inactive（-w:0，静音）的动作。默认值：-w:1 nil
（保留），-w:0 cut。用逗号串联动作；动作按顺序应用。
auto-editor video.mp4 -w:0 speed:8 # fast-forward through silence (pitch preserved)
auto-editor video.mp4 -w:0 speed:3,volume:0.5 # speed up AND halve volume of silent parts
-w:0/-w:1 是静音（标签 0）和活动（标签 1）类别。你可以用 --edit:N/-e:N 定义更多类别，并用 --when:N/-w:N
对其执行动作（N = 2–255）——请参阅 auto-editor 技能的“Labels”部分。以下每个动作都可用作任何 -w:N 的值。
动作
| 动作 | 作用 | 格式／范围 |
|---|---|---|
nil | 保持不变 | — |
cut | 移除片段 | — |
speed | 拉伸时间，保留音高 | speed:8、speed:0.5 |
varispeed | 通过移调改变速度（磁带／黑胶唱片效果） | varispeed:2（0.2–100） |
pitch | 仅改变音高，保持时长 | pitch:12（升高一个八度）、pitch:-7（−24–24 个半音） |
volume | 调整音量（1=正常，0.5=−6dB） | volume:0.2 |
deesser | 减弱齿音 | deesser:intensity[:max[:freq]]（每项均为 0–1） |
tone | 根据 MIDI 音符生成波形（add:生成器） | add:tone:69、add:tone:36:saw |
invert | 反转像素 | — |
zoom | 缩放倍数（1=不缩放） | zoom:2、zoom:0.5（>0–100） |
rotate | 固定顺时针旋转，并扩展画面以避免裁切 | rotate:90（搭配 --resolution 使用） |
spin | 连续旋转 deg/rate（每秒度数） | spin:0/120、spin:90/-45 |
drawbox | 绘制实心矩形 | drawbox:x:y:w:h:color |
pos | 放置叠加片段 x:y[:scale] | 主要用于 add／v3 内部 |
add | 叠加一层：文件中的每个流 | add:path[:x:y:scale] |
auto-editor video.mp4 -w:1 deesser:0.8:0.7:0.4
auto-editor video.mp4 -w:1 rotate:90 --resolution 1080,1920 # landscape → portrait
auto-editor video.mp4 -w:1 drawbox:0:0:1920:200:#000000 # redact a strip
叠加层 — add
add 是虚拟的：它会添加一个叠加层，而非逐帧效果。
静态图像会持续显示整个片段；PNG 的 alpha 通道会保留。省略位置参数时，会缩放至适合画面并居中。add 之后串联的动作会应用于新叠加层，而非基础画面。add 会添加文件中的每个流：带声音的视频会生成一个视频层和其音频层（混入，而非作为第二个流），纯音频文件会添加声音但没有画面，图像会添加画面但没有声音。也可以不传文件，而传入一个生成器动作：confetti/drawbox 会绘制视频层，tone 会合成音频层（因此叠加多个 add:tone 会形成和弦）。
auto-editor video.mp4 -w:1 add:./logo.png # centered, fit to canvas
auto-editor video.mp4 -w:1 add:./pip.mp4:900:60:0.25 # PiP in the corner, audio included
auto-editor video.mp4 -w:1 add:./pip.mp4:900:60:0.25,volume:0.3 # ...tucked under the base
auto-editor video.mp4 -w:1 add:./music.mp3,volume:0.4 # background music, no picture added
auto-editor video.mp4 -w:1 add:./logo.png,spin:0/-30 # the logo spins, not the base video
auto-editor song.mp3 -bg white -w:1 add:./cover.png # audio + image → video
auto-editor video.mp4 -w:1 add:tone:69 # 440 Hz tone over the audio
auto-editor video.mp4 -w:0 nil,add:tone:81 # beep the silence, don't cut it
auto-editor video.mp4 -w:1 add:tone:60,volume:1..0:ease=out # a plucked, decaying note
auto-editor video.mp4 -w:1 add:tone:36:saw # buzzy bass (sine|saw|square|triangle)
叠加层仅会在其片段被保留的地方出现，因此对于静音片段，请使用
-w:0 nil,add:...（保留 + 叠加）。使用 --set-action 时，范围会自动保留。
动画 — 渐变 from..to
zoom、opacity、blur、brightness、volume 以及 pos 和 pixelate 的每个字段都支持渐变。数值会在片段范围内插值，并在最后一帧达到 to。超过两个点时即为关键帧，并会均匀分布。
auto-editor video.mp4 -w:1 zoom:1..1.5 # Ken Burns
auto-editor video.mp4 -w:1 opacity:0..1 # fade in
auto-editor video.mp4 -w:1 volume:0..1 # audio fade in
auto-editor video.mp4 -w:1 zoom:1..1.5..1 # zoom in then out (keyframes)
auto-editor video.mp4 -w:1 pixelate:1..64 # dissolve into coarser blocks
auto-editor video.mp4 -w:1 add:./logo.png,pos:0..1200:40:1..0.5 # slide + shrink overlay
缓动 — :ease=curve[:duration]，其中 curve ∈ linear|in|out|inout。单独的
ease: 标记会为其后的每个动画动作设置曲线。rotate/spin 不受缓动影响。
auto-editor video.mp4 -w:1 zoom:1..1.5:ease=inout
auto-editor video.mp4 -w:1 opacity:0..1:ease=in:2sec # ease over 2s, then hold
auto-editor video.mp4 -w:1 ease:out,zoom:1..1.3,brightness:0..0.3
定时关键帧 — value@time 会在相对于片段起始时间的位置设置关键帧：可使用裸帧数、sec 或片段的 %。第一个关键帧之前和最后一个关键帧之后会保持对应数值；定时关键帧之间的未定时关键帧会在相邻关键帧之间均匀分布。缓动曲线会对关键帧之间的每个变化段进行缓动（定时关键帧不支持缓动时长）。
auto-editor video.mp4 -w:1 zoom:[email protected]@1.5sec..1@100% # in by 1.5s, out by the end
auto-editor video.mp4 -w:1 volume:[email protected]@2sec..1@4sec # silent 2s, then fade in
auto-editor video.mp4 -w:1 opacity:1@80%..0:ease=in # fade out over the last 20%
指定时间范围 — --set-action
--set-action ACTION,START,END 会覆盖某个范围的默认设置（使用范围语法；
sec、start/end 和负值均可使用）。该范围会被强制保留。
auto-editor video.mp4 --set-action nil,0,5sec
auto-editor video.mp4 --set-action speed:1.5,varispeed:1.5,30sec,end
auto-editor video.mp4 --set-action add:./logo.png:600:300:1.0,1sec,2sec
示例
auto-editor :mic -w:1 deesser:0.8:0.7:0.4 # record, then clean up speech
auto-editor podcast.mp3 -w:0 cut -w:1 speed:1.15 # cut silence, tighten speech
auto-editor video.mp4 -w:0 volume:0.3 # duck (not cut) the silence
auto-editor video.mp4 -w:1 varispeed:1.25 # nightcore (speed + pitch up)
auto-editor video.mp4 -w:0 pitch:12 # chipmunk the silence, same length
auto-editor video.mp4 -w:0 speed:6,volume:0.4 # fast, quiet silent sections
使用 :mic 时，按 Ctrl-C 结束录制；动作会在之后应用。
完整参考：https://auto-editor.com/ref/actions.md。关于纯剪切／节奏／ 编辑方法，请参阅 auto-editor 技能。