docs(tutorial): V2 使用教程分镜按后台真实菜单重写，补单支视频录制要点

2026-11-05 13:05:00 +08:00
parent a6eb3ffc98
commit 8b4ba9bb7c
2 changed files with 84 additions and 8 deletions
@@ -29,6 +29,21 @@ V0 是导览，可选；其余 7 支是必录。
 - [秀杰 DTU 教程视频](/projects/xiu-dtu/guide/tutorial)
 - [XiuAdmin 教程视频](/projects/xiu-admin/guide/tutorial)

+## 单支视频的录制要点（以 V2 使用教程为例）
+
+一支使用类视频要讲清三件事，缺一不可：
+
+1. **每段开头一句话说清业务问题**——观众得知道「为什么要做这个动作」，不然菜单再全也是流水账
+2. **完整走完一条真实链路**——从入口到结果，中间不跳步、不剪成片段拼接
+3. **交代异常分支**——比如批量动作为什么是异步、失败怎么看，这是使用者真正会卡住的地方
+
+按后台真实菜单顺序组织，不按功能模块归类：观众是照着操作走的，菜单顺序就是他的心智路径。
+
+以 V2 为例，最小可交付的 8 段是：工作台 → 卡信息 → 入库与库存 → 业务受理 → 批次与执行日志 → 套餐与流量 → 达量断网 → 智能诊断。
+其中「业务受理」「批次与执行日志」「智能诊断」是平台区别于普通 CRUD 的核心，不可省。
+
+明确不录的内容也要说清，避免一支视频无限膨胀：OpenAPI 调用归接口那支、通道详细配置归实施方材料、系统管理页归组织与账号类材料。
+
 ## 通用录制规范

 | 项 | 口径 |