@aswless_854771076/ai_short_studio_cli 0.1.60 → 0.1.62

package/skills/using-vvicat-ai-short-studio-cli/references/troubleshooting.md

@@ -0,0 +1,30 @@
+# 故障排查与恢复边界
+
+仅在任务失败、产物异常、语言错配或连线审计失败时读取。
+
+## 配置、语言和版本
+
+- **settings 写错位置**：画幅、画风、`outputLanguage`、模型和默认分辨率必须写项目 settings。账户 config、项目描述和节点 prompt 不能替代。
+- **拆镜语言错配**：先打印语言契约。普通模式修正 `outputLanguage`；专业 Markdown 修正 `targetLanguage` 和源文件本地化块。全局错配重跑 breakdown，单镜偶发错误才精确 `edit-shot`；不能只改字幕。
+- **任务成功但仍是旧内容**：按 `selectedOutputVersionId`、`parentAssetId`、`producerNodeId` 和 stale 链核对，不能按提交顺序猜版本。
+- **自动下游重复**：breakdown、storyboard image 或 prompt 完成后先刷新画布，复用服务端物化节点。
+
+## H3 音频与成片
+
+- **没有人声或旁白**：检查模型 `generateAudioOptions` 包含 `true`，节点 config 显式为 `generateAudio: true`，提示词含逐字文本、说话者和语言。任一不符先修正并重跑该镜，禁止外部 TTS 补洞。
+- **语言正确但吞字/断句**：检查声音时间表是否放得下全部文本；拆镜或经确认删减，不加速硬塞。
+- **BGM 切换突兀**：核对共享音乐锚点和转场主导侧；只重跑不合格的一镜，不铺外部 BGM。
+- **遮挡转场仍生硬**：先检查两侧真实画面是否都达到遮挡条件；生成素材不成立时重跑对应镜头，长叠化不能修复根因。
+
+## 资产与连线
+
+- **道具存在但没有 reference**：不能只看结构化 `props`；同时扫描 description、video prompt 和 photography plan，并核对图片 reference 边与资源文字边。
+- **真假、年龄或同名资源串线**：结合场景、完整资源名、状态和叙事上下文消歧；不唯一时询问用户。
+- **旧 description 与新参考图冲突**：在受影响分镜提示词中明确覆盖旧描述，并重新连接新节点丢失的 reference；不要无限重跑冲突输入。
+- **错边修复**：只删除精确 edge ID；禁止清空全部边或重建节点掩盖问题。
+
+## 专项错误
+
+- `STORYBOARD_LANGUAGE_MISMATCH`：专业拆镜输出含目标语言之外的文字；修正本地化块或 `targetLanguage` 后重跑。
+- `COSYVOICE_TTS_CUSTOM_VOICE_REQUIRED`：仅独立 TTS 流程使用同型号声音设计/克隆 ID，不反复尝试预置音色。
+- `CAT_MEME_REQUIRED_PROP_MISSING`：返回 material search；`CAT_MEME_DISPLAY_CONTENT_REQUIRED` 修复计划；`CAT_MEME_FFMPEG_FAILED` 修复渲染器后重试，均不得静默切换通用视频生成。