Skip to content

armgit / peach

Public Imported from GitHub
0

Peach: Local-first video metadata scraper and media manager.

5.8 KB
Raw Blame
/* 设置偏好与 Peach 配置的五份服务端数据,各一个 Query 键。
 *
 * - `['settings']`:跟数据库走、所有访问端同一份的那几项(`/api/settings`,`src/peach/web_settings.py`)。
 *   面板每次打开都重取一次,取回来交给壳对账(`host.syncRemote`):界面偏好的真相仍是壳里那一份
 *   `appSettings`,这个键只是数据库那边的快照。写入同样走这个端点,成功后回来的整份写回这个键。
 * - `['follow-schedule']`:这台机器上关注自动更新的档位与上次运行状态。
 * - `['feed-schedule']`:订阅源定时拉取的档位与上次运行状态,形状同上,只读。
 * - `['thumbnail-jobs']`:视频缩略图采集的档位与状态。档位跟着机器走,不存在浏览器里。
 * - `['media-processing']`:这台机器生成预览的开关与抽帧、转码的编解码方式。配置页「视频预览」与
 *   「视频播放」两张卡读写同一份。
 *
 * 面板常驻不卸载,每次打开重取设置;Peach 配置在挂载时重取各自的数据。 */
import { useMutation, type QueryClient } from '@tanstack/react-query';

import { apiGet, apiSend } from '../../api';
import { queryClient } from '../query';

export const SETTINGS_URL = '/api/settings';
export const FOLLOW_SCHEDULE_URL = '/api/follow/schedule';
export const FEED_SCHEDULE_URL = '/api/feeds/schedule';
export const THUMBNAIL_JOBS_URL = '/api/thumbnail-jobs';

export const SETTINGS_KEY = ['settings'] as const;
export const FOLLOW_SCHEDULE_KEY = ['follow-schedule'] as const;
export const FEED_SCHEDULE_KEY = ['feed-schedule'] as const;
export const THUMBNAIL_JOBS_KEY = ['thumbnail-jobs'] as const;
export const MEDIA_PROCESSING_URL = '/api/media-processing';
export const MEDIA_PROCESSING_KEY = ['media-processing'] as const;

/** `/api/media-processing` 的整份;写入只送改了的那一项,回来的仍是整份。 */
export interface MediaProcessingPolicy {
  metadata_only: boolean;
  preview_acceleration?: 'auto' | 'software';
  playback_acceleration?: 'auto' | 'software';
}
export const fetchMediaProcessing = (signal?: AbortSignal) =>
  apiGet<MediaProcessingPolicy>(MEDIA_PROCESSING_URL, signal);

/** `q_settings` 返回的整份;写入时只送改了的那几个键,回来的仍是整份。 */
export interface SyncedSettings {
  taskSpeedMode?: 'low' | 'standard' | 'high';
  performerNameLanguage?: 'zh-CN' | 'ja';
  sidebarOrder?: string[];
  followInitialDays?: number;
  postSetupTutorialDone?: boolean;
  feedHideGroupCompilations?: boolean;
  feedHideSoloCompilations?: boolean;
  feedHideExcerpts?: boolean;
  /** 数据库里还没存过时是 null:这台设备本地那个数替所有访问端先定下来。 */
  searchHistoryLimit?: number | null;
  /** 番号识别规则,一条一个正则;配置页「媒体库与入库」里编辑。 */
  codePatterns?: string[];
}

export interface FollowScheduleStatus {
  available: boolean;
  enabled: boolean;
  interval_minutes: number;
  running?: boolean;
  last_error?: string | null;
  last_finished_at?: string | null;
  last_added?: number | null;
  next_run_at?: string | null;
  /** 连续失败的轮数;从第二次起下一轮按倍数推后。 */
  consecutive_failures?: number;
}

export interface ThumbnailJobStatus {
  mode: string;
  status: 'idle' | 'running' | 'failed' | 'complete' | string;
  stopped?: string;
}

export const fetchSettings = (signal?: AbortSignal) => apiGet<SyncedSettings>(SETTINGS_URL, signal);
export const fetchFollowSchedule = (signal?: AbortSignal) =>
  apiGet<FollowScheduleStatus>(FOLLOW_SCHEDULE_URL, signal);
export const fetchFeedSchedule = (signal?: AbortSignal) =>
  apiGet<FollowScheduleStatus>(FEED_SCHEDULE_URL, signal);
export const fetchThumbnailJobs = (signal?: AbortSignal) =>
  apiGet<ThumbnailJobStatus>(THUMBNAIL_JOBS_URL, signal);

/** 打开偏好弹窗时重取共享设置;采集状态由 Peach 配置中的控件读取。 */
export function refreshPanelData(client: QueryClient = queryClient): Promise<SyncedSettings | null> {
  return client.fetchQuery({
    queryKey: SETTINGS_KEY, queryFn: ({ signal }) => fetchSettings(signal), staleTime: 0,
  }).catch(() => null);
}

/** 写跟数据库走的那几项。回来的是合并之后的整份,写回 `['settings']`。 */
export function useSaveSettings() {
  return useMutation({
    mutationFn: (patch: SyncedSettings) => apiSend<SyncedSettings>(SETTINGS_URL, patch),
    onSuccess: (saved) => queryClient.setQueryData(SETTINGS_KEY, saved),
  });
}

export function useSaveFollowSchedule() {
  return useMutation({
    mutationFn: (minutes: number) => apiSend<FollowScheduleStatus>(FOLLOW_SCHEDULE_URL,
      { enabled: minutes > 0, interval_minutes: minutes || 60 }),
    onSuccess: (status) => queryClient.setQueryData(FOLLOW_SCHEDULE_KEY, status),
  });
}

/** 两个调度各自的「立即重跑」:服务端把下一轮提前到此刻,回来的状态已标成运行中。 */
export const SCHEDULE_RUNS = {
  follow: { url: `${FOLLOW_SCHEDULE_URL}/run`, key: FOLLOW_SCHEDULE_KEY },
  feed: { url: `${FEED_SCHEDULE_URL}/run`, key: FEED_SCHEDULE_KEY },
} as const;

export function useRunSchedule(kind: keyof typeof SCHEDULE_RUNS) {
  const { url, key } = SCHEDULE_RUNS[kind];
  return useMutation({
    mutationFn: () => apiSend<FollowScheduleStatus>(url, {}),
    onSuccess: (status) => queryClient.setQueryData(key, status),
  });
}

/** 调度正在跑时三秒重取一次,跑完就停,失败原因随之出现或消失。 */
export const schedulePollInterval = (data: FollowScheduleStatus | undefined) => data?.running ? 3_000 : false;

export function useSaveThumbnailMode() {
  return useMutation({
    mutationFn: (mode: string) => apiSend<ThumbnailJobStatus>(THUMBNAIL_JOBS_URL, { mode }),
    onSuccess: (status) => queryClient.setQueryData(THUMBNAIL_JOBS_KEY, status),
  });
}