fix: explain video generation failures

docs/source-analysis.html

@@ -1241,6 +1241,18 @@ ProductRefStateItem {
         <h2>变更记录</h2>
         <p>这个记录不是 git log 的替代品。它记录“产品理解发生了什么变化、影响了哪些源码、你以后描述需求时该怎么说”。后续每次改功能都要补一条。</p>
         <div class="changelog">
+          <article class="change">
+            <header>
+              <h3>2026-05-26 · 视频生成失败改为员工可读提示</h3>
+              <span class="tag amber">API</span>
+              <span class="tag rose">UX</span>
+            </header>
+            <div class="body">
+              <p><strong>问题：</strong>Seedance / Doubao 视频上游返回 <code>InputImageSensitiveContentDetected.PrivacyInformation</code>、HTTP 400、429、timeout 等机器错误时，画布错误框原样展示会让员工误以为账号、模型或网关坏了，需要人工解释。</p>
+              <p><strong>改动：</strong><code>api/main.py</code> 新增视频错误归一化逻辑，提交失败、轮询失败和后台任务异常都会先转换成可读中文，再写入 <code>GeneratedVideo.error</code>。例如含疑似真实人脸的参考图会提示“参考图里有清晰人物或疑似真实人脸，视频模型出于肖像/隐私风控拒绝生成”，并给出换无脸首帧、裁掉或模糊人物脸的下一步。</p>
+              <p><strong>影响：</strong>前端现有视频失败卡、画布轮询错误框和详情里的 <code>video.error</code> 会自动显示中文解释；原始上游错误只写入 API 日志，方便管理员排查，不再要求用户把英文错误码发给开发者翻译。</p>
+            </div>
+          </article>
           <article class="change">
             <header>
               <h3>2026-05-26 · 生产登录改为仅飞书</h3>