auto-save 2026-05-13 20:51 (~7)

docs/source-analysis.html

@@ -830,6 +830,30 @@ api/main.py
         <h2>变更记录</h2>
         <p>这个记录不是 git log 的替代品。它记录“产品理解发生了什么变化、影响了哪些源码、你以后描述需求时该怎么说”。后续每次改功能都要补一条。</p>
         <div class="changelog">
+          <article class="change">
+            <header>
+              <h3>2026-05-13 · 视频 API 未开通时前置禁用按钮</h3>
+              <span class="tag violet">StoryboardWorkbench</span>
+              <span class="tag blue">Health</span>
+            </header>
+            <div class="body">
+              <p><strong>问题：</strong>当前 SKG ezlink 未开 <code>/videos</code>，用户点生成后才看到失败 toast，容易误以为是某个分镜或模型选择错误。</p>
+              <p><strong>改动：</strong>前端启动时读取 <code>/health</code> 的 <code>models.video_configured</code>；若为 false，分镜编排的生视频区域直接显示“视频 API 未开通”，并禁用提交按钮。</p>
+              <p><strong>影响：</strong><code>web/lib/api.ts</code>、<code>web/app/page.tsx</code>、<code>web/components/storyboard-workbench.tsx</code>。</p>
+            </div>
+          </article>
+          <article class="change">
+            <header>
+              <h3>2026-05-13 · 生视频错误提示改为可读原因</h3>
+              <span class="tag rose">VideoGenNode</span>
+              <span class="tag blue">API</span>
+            </header>
+            <div class="body">
+              <p><strong>问题：</strong>提交生视频失败时，前端把 <code>generateStoryboardVideo 503 {"detail": ...}</code> 原样展示，用户无法快速判断是配置、端点还是 UI 问题。</p>
+              <p><strong>改动：</strong><code>generateStoryboardVideo</code> 解析后端 JSON 的 <code>detail</code> 后再抛错；后端 503 文案改为“SKG ezlink 已连通但当前 key 未开 /videos”；Video Gen 失败卡把 <code>/videos 404</code> 长错误压缩成一句可读原因。</p>
+              <p><strong>影响：</strong><code>web/lib/api.ts</code>、<code>web/components/nodes/index.tsx</code>、<code>api/main.py</code>。</p>
+            </div>
+          </article>
           <article class="change">
             <header>
               <h3>2026-05-13 · Video Gen 卡片增加复制和删除</h3>