feat: 优化任务状态与进度体验

app/static/app.js

@@ -91,6 +91,27 @@ function pollTaskDetailStatus(taskId) {
   window.setTimeout(poll, intervalMs);
 }
 
+function pollTaskListStatus() {
+  const tableBody = document.querySelector("[data-task-list-auto-poll='true']");
+  if (!tableBody) return;
+
+  const intervalMs = 5000;
+  const poll = async () => {
+    try {
+      const resp = await fetch("/api/tasks", { cache: "no-store" });
+      if (!resp.ok) return;
+      const tasks = await resp.json();
+      const hasRunningTask = tasks.some((task) => task.status === "running");
+      window.location.reload();
+      if (!hasRunningTask) return;
+    } catch (_error) {
+      return;
+    }
+    window.setTimeout(poll, intervalMs);
+  };
+  window.setTimeout(poll, intervalMs);
+}
+
 async function downloadExport(url, defaultFilename, event) {
   if (event) event.preventDefault();
   const resp = await fetch(url);

app/templates/index.html

@@ -1,4 +1,5 @@
 {% extends "base.html" %}
+{% set has_running_tasks = tasks | selectattr("status", "equalto", "running") | list | length > 0 %}
 {% block title %}任务列表 - 热榜评论分析工具{% endblock %}
 {% block content %}
 <div class="d-flex justify-content-between align-items-center mb-3">
@@ -57,10 +58,13 @@
           <th>操作</th>
         </tr>
       </thead>
-      <tbody id="task-table-body">
+      <tbody id="task-table-body" {% if has_running_tasks %}data-task-list-auto-poll="true"{% endif %}>
         {% include "partials/task_rows.html" %}
       </tbody>
     </table>
   </div>
 </section>
+{% if has_running_tasks %}
+<script>document.addEventListener("DOMContentLoaded", () => pollTaskListStatus());</script>
+{% endif %}
 {% endblock %}

app/templates/partials/task_rows.html

@@ -1,16 +1,36 @@
 {% for task in tasks %}
   {% set status_label, status_class = status_badge_config(task.status) %}
+  {% set percent = progress_percent(task.processed_items_count, task.total_items_count) %}
+  {% set ai_percent = rate_percent(task.analysis_success_rate) %}
   <tr>
     <td><code>{{ task.id }}</code></td>
     <td>{{ task.platform | platform_label }}</td>
     <td>{{ task.created_at }}</td>
     <td><small class="text-muted">热点 {{ task.hotspot_limit }} / 内容 {{ task.item_limit_per_hotspot }} / 评论 {{ task.comment_limit_per_item }}</small></td>
-    <td>{{ task.successful_items_count }} / {{ task.total_items_count }}</td>
+    <td class="task-progress-cell">
+      <div class="d-flex justify-content-between align-items-center gap-2">
+        <span class="small">已处理 {{ task.processed_items_count }} / 共 {{ task.total_items_count }} 条内容</span>
+        <span class="small text-muted">{{ percent }}%</span>
+      </div>
+      <div class="progress task-progress mt-1" role="progressbar" aria-label="任务进度" aria-valuenow="{{ percent }}" aria-valuemin="0" aria-valuemax="100">
+        <div class="progress-bar" style="width: {{ percent }}%"></div>
+      </div>
+      <div class="small text-muted mt-1">成功 {{ task.successful_items_count }} / 失败 {{ task.failed_items_count }}</div>
+      <div class="small {% if task.analysis_status == 'insufficient' %}text-warning{% else %}text-muted{% endif %}">
+        AI 成功率 {{ ai_percent }}%
+        {% if task.analysis_status == "insufficient" %}
+          <span class="badge text-bg-warning ms-1">AI 样本不足</span>
+        {% endif %}
+      </div>
+    </td>
     <td>
       <span class="badge {{ status_class }}">{{ status_label }}</span>
       {% if task.error_stage or task.error_type %}
         <br><small class="text-muted">{{ task.error_stage }} / {{ task.error_type }}</small>
       {% endif %}
+      {% if task.error_message %}
+        <br><small class="text-danger">{{ task.error_message }}</small>
+      {% endif %}
     </td>
     <td><a class="btn btn-sm btn-outline-primary" href="/tasks/{{ task.id }}">查看</a></td>
   </tr>

app/templates/tasks/detail.html

@@ -13,13 +13,29 @@
 </div>
 <section class="card mb-4" {% if task.status == "running" %}data-task-id="{{ task.id }}" data-auto-poll="true"{% endif %}><div class="card-body">
   {% set label, cls = status_badge_config(task.status) %}
+  {% set percent = progress_percent(task.processed_items_count, task.total_items_count) %}
+  {% set ai_percent = rate_percent(task.analysis_success_rate) %}
   <p>平台：{{ task.platform | platform_label }} <span class="badge {{ cls }}">{{ label }}</span></p>
-  <p>成功 {{ task.successful_items_count }} / 共 {{ task.total_items_count }} 条内容</p>
+  <div class="mb-3">
+    <div class="d-flex justify-content-between align-items-center gap-2">
+      <span>已处理 {{ task.processed_items_count }} / 共 {{ task.total_items_count }} 条内容</span>
+      <span class="text-muted">{{ percent }}%</span>
+    </div>
+    <div class="progress task-progress mt-2" role="progressbar" aria-label="任务进度" aria-valuenow="{{ percent }}" aria-valuemin="0" aria-valuemax="100">
+      <div class="progress-bar" style="width: {{ percent }}%"></div>
+    </div>
+    <div class="small text-muted mt-2">成功 {{ task.successful_items_count }} / 失败 {{ task.failed_items_count }}</div>
+  </div>
+  <div class="mb-2">
+    <span class="{% if task.analysis_status == 'insufficient' %}text-warning{% else %}text-muted{% endif %}">AI 成功率 {{ ai_percent }}%</span>
+    {% if task.analysis_status == "insufficient" %}
+      <span class="badge text-bg-warning ms-1">AI 样本不足</span>
+    {% endif %}
+  </div>
   {% if task.error_message %}<div class="alert alert-danger">{{ task.error_stage }} / {{ task.error_type }}：{{ task.error_message }}</div>{% endif %}
 </div></section>
 {% if task.status == "running" and not hotspots %}
 <div class="text-center text-muted py-5"><div class="spinner-border text-warning mb-3"></div><p>正在抓取热点数据，请稍候...</p></div>
-<script>pollTaskDetailStatus("{{ task.id }}");</script>
 {% endif %}
 <div class="accordion" id="hotspot-list">
 {% for hotspot in hotspots %}
@@ -45,4 +61,7 @@
   </div>
 {% endfor %}
 </div>
+{% if task.status == "running" %}
+<script>document.addEventListener("DOMContentLoaded", () => pollTaskDetailStatus("{{ task.id }}"));</script>
+{% endif %}
 {% endblock %}

app/templating.py

@@ -28,6 +28,20 @@ def from_json_filter(value: str | None) -> list:
     return parsed if isinstance(parsed, list) else []
 
 
+def progress_percent(processed_count: int, total_count: int) -> int:
+    if total_count <= 0:
+        return 0
+    return min(100, max(0, round((processed_count / total_count) * 100)))
+
+
+def rate_percent(rate: float | None) -> int:
+    if rate is None:
+        return 0
+    return min(100, max(0, round(rate * 100)))
+
+
 templates.env.globals["status_badge_config"] = status_badge_config
+templates.env.globals["progress_percent"] = progress_percent
+templates.env.globals["rate_percent"] = rate_percent
 templates.env.filters["platform_label"] = platform_label
 templates.env.filters["from_json"] = from_json_filter