feat: add compatibility tasks admin page

Author: OXeu

client/public/locales/en/translation.json

@@ -5,12 +5,39 @@
   },
   "admin": {
     "back_to_site": "Back to site",
+    "compat_tasks_description": "Run compatibility jobs in bulk to backfill missing AI summaries and image blurhash metadata for older posts.",
     "health_description": "Review required configuration, missing integrations, and risks that can affect runtime behavior.",
     "queue_status_description": "Inspect AI summary queue progress, recent task results, and failures.",
     "settings_description": "Manage site behavior, integrations, and publishing rules in one place.",
     "title": "Admin",
     "writing_description": "Write, edit, and publish content from the private management workspace."
   },
+  "compat_tasks": {
+    "title": "Compatibility Tasks",
+    "loading": "Loading compatibility task status...",
+    "generated_at": "Last updated: {{date}}",
+    "running": "Running",
+    "yes": "Yes",
+    "no": "No",
+    "ai_summary": {
+      "title": "Backfill AI Summaries",
+      "description": "Scan existing published posts and enqueue AI summary generation for entries that do not have one yet.",
+      "eligible": "{{count}} posts pending",
+      "enabled": "AI summary enabled: {{value}}",
+      "queue_configured": "Queue configured: {{value}}",
+      "run": "Start backfill",
+      "result": "Queued {{queued}} AI summary tasks and skipped {{skipped}} posts."
+    },
+    "blurhash": {
+      "title": "Backfill Image Blurhash",
+      "description": "Scan existing posts and write missing blurhash and image size metadata back into markdown image fragments.",
+      "eligible": "{{count}} posts pending",
+      "note": "This task runs in the current browser and processes images one post at a time.",
+      "run": "Start backfill",
+      "progress": "Processed {{processed}} / {{total}}, updated {{updated}} posts, failed {{failed}} posts.",
+      "result": "Blurhash backfill finished: scanned {{total}} posts, updated {{updated}}, failed {{failed}}."
+    }
+  },
   "ai_summary": {
     "message": {
       "completed": "AI summary is ready.",

client/public/locales/ja/translation.json

@@ -5,12 +5,39 @@
   },
   "admin": {
     "back_to_site": "サイトに戻る",
+    "compat_tasks_description": "過去記事向けの AI 要約と画像 blurhash メタデータを一括補完する互換タスクを実行します。",
     "health_description": "必須設定、未構成の連携、動作に影響するリスクを確認します。",
     "queue_status_description": "AI 要約キューの進行状況、最近のタスク結果、失敗内容を確認します。",
     "settings_description": "サイトの挙動、連携設定、公開ルールを一か所で管理します。",
     "title": "管理画面",
     "writing_description": "非公開の管理ワークスペースから記事を作成、編集、公開します。"
   },
+  "compat_tasks": {
+    "title": "互換タスク",
+    "loading": "互換タスクの状態を読み込んでいます...",
+    "generated_at": "最終更新: {{date}}",
+    "running": "実行中",
+    "yes": "はい",
+    "no": "いいえ",
+    "ai_summary": {
+      "title": "AI 要約を補完",
+      "description": "既存の公開記事を走査し、まだ要約がない記事を再度キューに入れます。",
+      "eligible": "対象 {{count}} 件",
+      "enabled": "AI 要約の有効化: {{value}}",
+      "queue_configured": "キュー設定済み: {{value}}",
+      "run": "補完を開始",
+      "result": "{{queued}} 件をキューに追加し、{{skipped}} 件をスキップしました。"
+    },
+    "blurhash": {
+      "title": "画像 Blurhash を補完",
+      "description": "既存記事内の画像を走査し、欠けている blurhash と画像サイズ情報を markdown fragment に追記します。",
+      "eligible": "対象 {{count}} 件",
+      "note": "このタスクは現在のブラウザ内で実行され、記事ごとに画像を処理します。",
+      "run": "補完を開始",
+      "progress": "{{processed}} / {{total}} 件処理済み、更新 {{updated}} 件、失敗 {{failed}} 件。",
+      "result": "Blurhash 補完が完了しました。全 {{total}} 件を走査し、{{updated}} 件を更新、{{failed}} 件が失敗しました。"
+    }
+  },
   "ai_summary": {
     "message": {
       "completed": "AI 要約の生成は完了しました。",

client/public/locales/zh-CN/translation.json

@@ -5,12 +5,39 @@
   },
   "admin": {
     "back_to_site": "返回站点",
+    "compat_tasks_description": "批量触发向前兼容任务，用于补齐历史帖子缺失的 AI 摘要和图片 blurhash 元数据。",
     "health_description": "检查关键配置、缺失的集成项，以及可能影响服务正常运行的风险。",
     "queue_status_description": "查看 AI 摘要队列进度、最近任务结果和失败信息。",
     "settings_description": "在统一的后台空间中管理站点行为、集成配置和发布规则。",
     "title": "后台管理",
     "writing_description": "在独立的管理工作区中编写、编辑和发布内容。"
   },
+  "compat_tasks": {
+    "title": "兼容任务",
+    "loading": "正在加载兼容任务状态...",
+    "generated_at": "最近更新时间：{{date}}",
+    "running": "执行中",
+    "yes": "是",
+    "no": "否",
+    "ai_summary": {
+      "title": "补齐 AI 摘要",
+      "description": "扫描历史已发布帖子，为尚未生成摘要的内容重新入队。",
+      "eligible": "待处理 {{count}} 篇",
+      "enabled": "AI 摘要已启用：{{value}}",
+      "queue_configured": "队列已配置：{{value}}",
+      "run": "开始补齐",
+      "result": "AI 摘要任务已入队 {{queued}} 篇，跳过 {{skipped}} 篇。"
+    },
+    "blurhash": {
+      "title": "补齐图片 Blurhash",
+      "description": "扫描历史帖子中的图片，为缺失占位图和尺寸元数据的图片补齐 markdown fragment。",
+      "eligible": "待处理 {{count}} 篇",
+      "note": "该任务在当前浏览器中执行，会逐篇加载图片并回写元数据。",
+      "run": "开始补齐",
+      "progress": "已处理 {{processed}} / {{total}}，更新 {{updated}} 篇，失败 {{failed}} 篇。",
+      "result": "Blurhash 补齐完成：共扫描 {{total}} 篇，成功更新 {{updated}} 篇，失败 {{failed}} 篇。"
+    }
+  },
   "ai_summary": {
     "message": {
       "completed": "AI 摘要已生成。",

client/public/locales/zh-TW/translation.json

@@ -5,12 +5,39 @@
   },
   "admin": {
     "back_to_site": "返回站點",
+    "compat_tasks_description": "批次觸發向前相容任務，用於補齊歷史文章缺失的 AI 摘要與圖片 blurhash 中繼資料。",
     "health_description": "檢查關鍵配置、缺失的整合項，以及可能影響服務正常運行的風險。",
     "queue_status_description": "查看 AI 摘要佇列進度、最近任務結果與失敗資訊。",
     "settings_description": "在統一的後台空間中管理站點行為、整合配置與發佈規則。",
     "title": "後台管理",
     "writing_description": "在獨立的管理工作區中編寫、編輯並發佈內容。"
   },
+  "compat_tasks": {
+    "title": "相容任務",
+    "loading": "正在載入相容任務狀態...",
+    "generated_at": "最近更新時間：{{date}}",
+    "running": "執行中",
+    "yes": "是",
+    "no": "否",
+    "ai_summary": {
+      "title": "補齊 AI 摘要",
+      "description": "掃描歷史已發佈文章，為尚未生成摘要的內容重新入列。",
+      "eligible": "待處理 {{count}} 篇",
+      "enabled": "AI 摘要已啟用：{{value}}",
+      "queue_configured": "佇列已設定：{{value}}",
+      "run": "開始補齊",
+      "result": "AI 摘要任務已入列 {{queued}} 篇，略過 {{skipped}} 篇。"
+    },
+    "blurhash": {
+      "title": "補齊圖片 Blurhash",
+      "description": "掃描歷史文章中的圖片，為缺失占位圖與尺寸中繼資料的圖片補齊 markdown fragment。",
+      "eligible": "待處理 {{count}} 篇",
+      "note": "此任務會在目前瀏覽器中執行，逐篇載入圖片並回寫中繼資料。",
+      "run": "開始補齊",
+      "progress": "已處理 {{processed}} / {{total}}，更新 {{updated}} 篇，失敗 {{failed}} 篇。",
+      "result": "Blurhash 補齊完成：共掃描 {{total}} 篇，成功更新 {{updated}} 篇，失敗 {{failed}} 篇。"
+    }
+  },
   "ai_summary": {
     "message": {
       "completed": "AI 摘要已生成。",

client/src/api/client.ts

@@ -91,6 +91,38 @@ export interface QueueTaskActionResponse {
   success: boolean;
 }
 
+export interface CompatTasksResponse {
+  generatedAt: string;
+  aiSummary: {
+    enabled: boolean;
+    queueConfigured: boolean;
+    eligible: number;
+  };
+  blurhash: {
+    eligible: number;
+  };
+}
+
+export interface CompatAISummaryActionResponse {
+  queued: number;
+  skipped: number;
+}
+
+export interface CompatBlurhashCandidate {
+  id: number;
+  title: string | null;
+  content: string;
+}
+
+export interface CompatBlurhashCandidatesResponse {
+  generatedAt: string;
+  items: CompatBlurhashCandidate[];
+}
+
+export interface CompatBlurhashApplyResponse {
+  updated: boolean;
+}
+
 // Re-export for external use
 export type {
   ApiResponse,
@@ -455,6 +487,22 @@ class ConfigAPI {
     return this.http.get<QueueStatusResponse>("/api/config/queue-status");
   }
 
+  async getCompatTasks(): Promise<ApiResponse<CompatTasksResponse>> {
+    return this.http.get<CompatTasksResponse>("/api/config/compat-tasks");
+  }
+
+  async runCompatAISummary(): Promise<ApiResponse<CompatAISummaryActionResponse>> {
+    return this.http.post<CompatAISummaryActionResponse>("/api/config/compat-tasks/ai-summary");
+  }
+
+  async getCompatBlurhashCandidates(): Promise<ApiResponse<CompatBlurhashCandidatesResponse>> {
+    return this.http.get<CompatBlurhashCandidatesResponse>("/api/config/compat-tasks/blurhash");
+  }
+
+  async applyCompatBlurhash(feedId: number, content: string): Promise<ApiResponse<CompatBlurhashApplyResponse>> {
+    return this.http.post<CompatBlurhashApplyResponse>(`/api/config/compat-tasks/blurhash/${feedId}`, { content });
+  }
+
   async retryQueueTask(feedId: number): Promise<ApiResponse<QueueTaskActionResponse>> {
     return this.http.post<QueueTaskActionResponse>(`/api/config/queue-status/${feedId}/retry`);
   }

client/src/app/routes.tsx

@@ -9,6 +9,7 @@ import { Padding } from "../components/padding";
 import { Tips, TipsPage } from "../components/tips";
 import useTableOfContents from "../hooks/useTableOfContents";
 import { CallbackPage } from "../page/callback";
+import { CompatTasksPage } from "../page/compat-tasks";
 import { ErrorPage } from "../page/error";
 import { FeedPage, TOCHeader } from "../page/feed";
 import { FeedsPage } from "../page/feeds";
@@ -73,6 +74,10 @@ export function AppRoutes() {
         <QueueStatusPage />
       </AdminRoute>
 
+      <AdminRoute path="/admin/compat-tasks" requirePermission title={t("compat_tasks.title")} description={t("admin.compat_tasks_description")}>
+        <CompatTasksPage />
+      </AdminRoute>
+
       <AdminRoute path="/admin/writing" requirePermission title={t("writing")} description={t("admin.writing_description")}>
         <WritingPage />
       </AdminRoute>

client/src/components/admin-layout.tsx

@@ -64,6 +64,7 @@ export function AdminLayout({
                 <AdminNavItem href="/admin/settings" icon="ri-settings-3-line" label={t("settings.title")} />
                 <AdminNavItem href="/admin/health" icon="ri-heart-pulse-line" label={t("health.title")} />
                 <AdminNavItem href="/admin/queue-status" icon="ri-todo-line" label={t("queue_status.title")} />
+                <AdminNavItem href="/admin/compat-tasks" icon="ri-history-line" label={t("compat_tasks.title")} />
               </div>
             </div>
           </div>