fix: isolate storyboard videos by row

docs/source-analysis.html

@@ -997,11 +997,11 @@ ProductRefStateItem {
             <tr><td>角色图入库到 job</td><td><code>POST /jobs/{id}/assets/character-library</code></td><td><code>copyCharacterLibraryAssets</code></td><td>把所选角色的 7 张参考图复制为当前 job asset，返回 <code>subject_images</code>，产品融合生成视频时作为人物身份参考图提交。</td></tr>
             <tr><td>产品融合引导图</td><td><code>POST /jobs/{id}/product-fusion/guide</code></td><td><code>createProductFusionGuide</code></td><td>旧流程兼容接口：读取产品图和白底人物图，按 <code>product_region</code> 合成位置引导图。当前内置角色 + 产品 + 描述流程不再主动调用它。</td></tr>
             <tr><td>产品融合描述词</td><td><code>POST /jobs/{id}/product-fusion/descriptions</code></td><td><code>generateProductFusionDescriptions</code></td><td>兼容接口：可生成产品融合动作描述库。当前前端默认直接用本地 36 条镜头语言模板预填 6 行镜头，并通过“换一组”按钮按 6 条一组轮换。</td></tr>
-            <tr><td>分镜保存</td><td><code>PUT /frames/{idx}/storyboard</code></td><td><code>updateStoryboard</code></td><td>保存三字段中英镜像、选中视频 ID、4 图槽、时长、改造说明，以及高级抽屉里的镜头类型、人物描述、人物/产品开关、首帧规划、尾帧规划和产品出现方式。</td></tr>
+            <tr><td>分镜保存</td><td><code>PUT /frames/{idx}/storyboard</code></td><td><code>updateStoryboard</code></td><td>保存三字段中英镜像、选中视频 ID、4 图槽、时长、改造说明，以及高级抽屉里的镜头类型、人物描述、人物/产品开关、首帧规划、尾帧规划和产品出现方式。当前音频分镜行会额外写 <code>storyboard_row_idx</code>，避免多条分镜共用同一参考帧时互相覆盖。</td></tr>
             <tr><td>三字段自动展开</td><td><code>POST /jobs/{job_id}/frames/{idx}/storyboard/quick-plan</code></td><td><code>quickPlanStoryboard</code></td><td>输入 <code>skg_copy_*</code>、<code>scene_one_line_*</code>、<code>action_one_line_*</code> 和 <code>subject_brief</code>，用 <code>REWRITE_MODEL</code> 展开为完整 <code>StoryboardScene</code>，只作为视频 prompt 来源，不直接持久化。</td></tr>
             <tr><td>AI 改文案</td><td><code>POST /jobs/{job_id}/frames/{idx}/storyboard/refine</code></td><td><code>refineStoryboard</code></td><td>输入当前三字段和中文反馈，返回新的三字段中英镜像。前端必须先弹改前/改后预览，用户点应用后才写入行状态。</td></tr>
-            <tr><td>单条视频候选生成</td><td><code>POST /jobs/{job_id}/frames/{idx}/storyboard/video</code></td><td><code>generateStoryboardVideo</code></td><td>新增 <code>count</code> 和 <code>seed</code>，默认一次创建 4 个 <code>GeneratedVideo</code> 任务并立即返回 job；每个候选独立排队、生成、失败或成功。前端提交 prompt 前用 quick-plan 展开，高级首尾帧存在时继续带上，不存在时后端用参考帧/主体图/产品图透明兜底。</td></tr>
-            <tr><td>整片一键生成候选</td><td><code>POST /jobs/{job_id}/storyboard/batch-generate-all</code></td><td><code>batchGenerateAll</code></td><td>输入 <code>count_per_row=4</code>、<code>concurrency=4</code>，后台遍历分镜并为每行提交 4 个视频候选；job message 用轮询展示进度。单行失败只写 job error，不阻断其他行。</td></tr>
+            <tr><td>单条视频候选生成</td><td><code>POST /jobs/{job_id}/frames/{idx}/storyboard/video</code></td><td><code>generateStoryboardVideo</code></td><td>新增 <code>count</code>、<code>seed</code> 和 <code>storyboard_row_idx</code>，默认一次创建 4 个 <code>GeneratedVideo</code> 任务并立即返回 job；每个候选独立排队、生成、失败或成功。前端提交 prompt 前用 quick-plan 展开，高级首尾帧存在时继续带上，不存在时后端用参考帧/主体图/产品图透明兜底。视频候选显示必须优先按 <code>storyboard_row_idx</code> 归属到音频分镜行，而不是只按 <code>frame_idx</code>。</td></tr>
+            <tr><td>整片一键生成候选</td><td><code>POST /jobs/{job_id}/storyboard/batch-generate-all</code></td><td>当前主路径改为逐行调用 <code>generateStoryboardVideo</code></td><td>用户选择“每行 N 条”后，前端按音频分镜逐行提交，确保每个候选都带 <code>storyboard_row_idx</code>。后端批量接口保留为兼容能力，默认 <code>concurrency=1</code>，但当前 UI 不再用它做主路径。</td></tr>
             <tr><td>生图</td><td><code>POST /frames/{idx}/generate</code></td><td><code>generateImage</code></td><td>基于关键帧或已选生成图做 image-to-image，目前可用。</td></tr>
           </tbody>
         </table>
@@ -1108,6 +1108,19 @@ ProductRefStateItem {
         <h2>变更记录</h2>
         <p>这个记录不是 git log 的替代品。它记录“产品理解发生了什么变化、影响了哪些源码、你以后描述需求时该怎么说”。后续每次改功能都要补一条。</p>
         <div class="changelog">
+          <article class="change">
+            <header>
+              <h3>2026-05-19 · 视频候选按音频分镜行隔离</h3>
+              <span class="tag blue">API</span>
+              <span class="tag green">Video</span>
+              <span class="tag cyan">Storyboard</span>
+            </header>
+            <div class="body">
+              <p><strong>问题：</strong>多条音频分镜会映射到同一张参考帧，旧视频候选只按 <code>frame_idx</code> 过滤，导致第一行生成的视频也出现在后面共用参考帧的分镜行里。</p>
+              <p><strong>改动：</strong><code>StoryboardScene</code>、<code>GeneratedVideo</code> 和 <code>/storyboard/video</code> 请求增加 <code>storyboard_row_idx</code>；前端显示候选和读取已保存分镜时优先按该行号隔离，旧无行号候选只归到同参考帧的第一条兼容行。</p>
+              <p><strong>影响：</strong>点击某一行生成视频后，只会在该音频分镜行右侧出现候选；整片生成也改为逐行提交，避免候选跨行串位。</p>
+            </div>
+          </article>
           <article class="change">
             <header>
               <h3>2026-05-19 · 分镜行改成左文字右视频轨</h3>