diff --git a/CHANGELOG.md b/CHANGELOG.md
index 0ce3ba0..95b4c18 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -32,6 +32,15 @@
 - **`qc_check.py` 时长差文案**：原先「成片差 0.48s」会被读成缺陷，
   实际是段间 gap 与片尾留白的设计值；已改为分别列出「音轨 / layout 期望 / 成片」三个口径。
 
+### 文档勘误
+
+- **`lessons.md` 第 33 条与本次改动自相矛盾，已同步修正**：该条原写「`render_video.mjs`
+  没有单场景开关」（本次新增的 `--only` 正是此开关），且给出的主序列合成命令带 `-shortest`
+  并注明「与渲染器逐字一致」——**照抄会把上面刚修掉的片尾截断 bug 原样装回去**。
+  现改为：末场优先用 `--only`，临时项目法保留给「被改场景不在末位」的情形；合成命令同步换
+  `-af apad -t <renderSec>` 并加一段「别用 `-shortest`」的说明。
+- `--only` 的示例场景名由本项目专有的 `coda` 换成通用占位 `<场景id>`。
+
 ---
 
 ## [1.2.2] — 2026-09-21 — 首个公开版本