auto-save 2026-05-13 23:29 (~5)

docs/source-analysis.html

@@ -706,6 +706,7 @@ api/main.py
             <tr><th>功能</th><th>接口</th><th>前端调用</th><th>说明</th></tr>
           </thead>
           <tbody>
+            <tr><td>历史列表</td><td><code>GET /jobs</code></td><td><code>listJobs</code></td><td>所有 job 精简列表（id/url/status/thumbnail/mtime…），按 state.json mtime 倒序。前端 URL 无 <code>?job=</code> 时拉它回填全部历史；带 <code>limit</code> 可截断。</td></tr>
             <tr><td>创建任务</td><td><code>POST /jobs</code></td><td><code>createJob</code></td><td>提交 TK 链接，后台开始下载，停在 downloaded 等用户点解析。</td></tr>
             <tr><td>上传视频</td><td><code>POST /jobs/upload</code></td><td><code>uploadJob</code></td><td>保存 source.mp4，然后同样进入下载完成状态。</td></tr>
             <tr><td>解析视频</td><td><code>POST /jobs/{id}/analyze</code></td><td><code>analyzeJob</code></td><td>拆轨 + 抽关键帧。当前不自动跑 ASR，避免 audio 阻塞视觉管线。</td></tr>
@@ -830,6 +831,18 @@ api/main.py
         <h2>变更记录</h2>
         <p>这个记录不是 git log 的替代品。它记录“产品理解发生了什么变化、影响了哪些源码、你以后描述需求时该怎么说”。后续每次改功能都要补一条。</p>
         <div class="changelog">
+          <article class="change">
+            <header>
+              <h3>2026-05-13 · 打开应用自动恢复历史 job</h3>
+              <span class="tag blue">API</span>
+              <span class="tag violet">Page</span>
+            </header>
+            <div class="body">
+              <p><strong>问题：</strong>前端只从 URL <code>?job=</code> 读 job 列表，没有任何本地或后端列表回填，打开 <code>/</code> 不带参数就是空白，之前跑过的 job 看不见。</p>
+              <p><strong>改动：</strong>后端新增 <code>GET /jobs</code> 列表接口（返回 <code>JobSummary</code>：id/url/status/progress/duration/width/height/video_url/frame_count/video_count/thumbnail/error/mtime，按 state.json mtime 倒序，可带 <code>limit</code>）。前端 <code>page.tsx</code> 启动逻辑：URL 有 <code>?job=</code> 时尊重 URL；没有时自动调 <code>listJobs()</code> 拿全部历史，反转后让最新 job 落在末尾（active）。持久化基于 <code>api/jobs/&lt;id&gt;/state.json</code> 磁盘文件，不依赖浏览器存储，换浏览器/清缓存都不会傻。</p>
+              <p><strong>影响：</strong><code>api/main.py</code>（<code>JobSummary</code> 类型 + <code>list_jobs</code> endpoint）、<code>web/lib/api.ts</code>（<code>JobSummary</code> + <code>listJobs</code>）、<code>web/app/page.tsx</code>（启动 useEffect）。</p>
+            </div>
+          </article>
           <article class="change">
             <header>
               <h3>2026-05-13 · 允许骨骼人使用按摩仪后状态变好</h3>