feat: add cover image functionality for articles

- Implemented `resolveApiURL` function to handle various URL formats. - Updated `ArticleDetail` and `UpdateArticleRequest` interfaces to include `cover_asset_url`. - Enhanced `ArticleEditorView` to manage cover image uploads, including a new `CoverPickerModal` component. - Added cover image requirements logic in `cover-requirements.ts` to enforce platform-specific cover image rules. - Modified backend services to handle cover image uploads and validations, including checks for required cover images for specific platforms. - Improved error handling for cover image requirements during article publishing.
2026-04-07 09:19:03 +08:00
parent 1e844704e4
commit 9f721f6088
13 changed files with 1360 additions and 129 deletions
@@ -0,0 +1,84 @@
+import { normalizePublishPlatformIds } from "./publish-platforms";
+
+export type CoverSupportMode = "native" | "unsupported";
+
+export interface PlatformCoverRequirement {
+  platformId: string;
+  required: boolean;
+  supportMode: CoverSupportMode;
+  aspectRatio: number | null;
+  aspectLabel: string | null;
+  outputWidth: number | null;
+  outputHeight: number | null;
+  priority: number;
+}
+
+const defaultRequirement = {
+  required: false,
+  supportMode: "unsupported" as CoverSupportMode,
+  aspectRatio: null,
+  aspectLabel: null,
+  outputWidth: null,
+  outputHeight: null,
+  priority: 0,
+};
+
+const requirementCatalog: Record<string, Partial<PlatformCoverRequirement>> = {
+  baijiahao: {
+    required: true,
+    supportMode: "native",
+    aspectRatio: 16 / 9,
+    aspectLabel: "16:9",
+    outputWidth: 1200,
+    outputHeight: 675,
+    priority: 100,
+  },
+};
+
+export function getPlatformCoverRequirements(platformIds?: Array<string | null | undefined>): PlatformCoverRequirement[] {
+  return normalizePublishPlatformIds(platformIds).map((platformId) => {
+    const config = requirementCatalog[platformId] ?? {};
+
+    return {
+      platformId,
+      required: config.required ?? defaultRequirement.required,
+      supportMode: config.supportMode ?? defaultRequirement.supportMode,
+      aspectRatio: config.aspectRatio ?? defaultRequirement.aspectRatio,
+      aspectLabel: config.aspectLabel ?? defaultRequirement.aspectLabel,
+      outputWidth: config.outputWidth ?? defaultRequirement.outputWidth,
+      outputHeight: config.outputHeight ?? defaultRequirement.outputHeight,
+      priority: config.priority ?? defaultRequirement.priority,
+    };
+  });
+}
+
+export function coverUploadRequired(platformIds?: Array<string | null | undefined>): boolean {
+  return getPlatformCoverRequirements(platformIds).some((item) => item.required);
+}
+
+export function getPrimaryCoverRequirement(platformIds?: Array<string | null | undefined>): PlatformCoverRequirement {
+  const requirements = getPlatformCoverRequirements(platformIds);
+  if (!requirements.length) {
+    return {
+      platformId: "default",
+      ...defaultRequirement,
+    };
+  }
+
+  return [...requirements].sort((left, right) => right.priority - left.priority)[0];
+}
+
+export function deriveCoverFileName(value?: string | null): string {
+  const trimmed = String(value ?? "").trim();
+  if (!trimmed) {
+    return "";
+  }
+
+  try {
+    const pathname = new URL(trimmed, "https://cover.local").pathname;
+    const lastSegment = pathname.split("/").filter(Boolean).at(-1) ?? "";
+    return decodeURIComponent(lastSegment);
+  } catch {
+    return "";
+  }
+}