Peach: Local-first video metadata scraper and media manager.
docs(media): 保持补全说明与共享任务契约一致
longmeidaoff7ee43a13c4
diff --git a/docs/STATUS.md b/docs/STATUS.mdindex 62fc5382c..67956e812 100644--- a/docs/STATUS.md+++ b/docs/STATUS.md@@ -32,7 +32,6 @@- amane 0.20.0,安装一致;[功能与接入](reference-snapshots/upstream-review.md)。- 发行名 `peach`、目录名 `peach-app`。macOS 按待办第 26 条处理后重启菜单栏;无口令的 `peach serve --host 0.0.0.0` 拒绝启动。- 扫描、采集 120 秒无进展预警;资料 90 秒、封面 240 秒超时可重试;见 `state/library-processing-<job_id>.issues.jsonl`。-- 缺预览影片可在列表、实体作品区与详情点「补全资料与预览」;下拉可分开生成本地预览或采集在线资料,全库入口在数据管理。任务优先生成本机九宫格,失败可重试,完成后刷新卡面。- 口味、复核、关注按账本、文件版本缓存;女优资料后继每轮存量至多 16 条。- 下载后处理:16 条旧失败任务保留,部分资产已移动;`task_run` 外键异常 242 条未清理。- [标签归一](reference-snapshots/tag-vocabulary-audit.md)diff --git a/frontend/src/react/library-processing/library-processing.ts b/frontend/src/react/library-processing/library-processing.tsindex 49245df99..9ae8a5273 100644--- a/frontend/src/react/library-processing/library-processing.ts+++ b/frontend/src/react/library-processing/library-processing.ts@@ -1,8 +1,7 @@/* 扫描与采集的数据契约、轮询节律与纯折算。*- * 这一趟后台任务有两个读者:数据管理页那张卡片(`#libraryProcessing`)和目录页顶上那条- * 横幅(`#libraryProcessingNotice`)。两边读同一个 `queryKey`,所以它们看到的是同一份快照,- * 轮询也由 Query 合成一份——各存一份状态的话,卡片说「已完成」、横幅还挂着进度。+ * 数据管理页卡片、目录横幅与缺预览提示读同一个 `queryKey`,使用同一份任务快照。+ * 轮询也由 Query 合成一份,进度、失败与完成状态由服务端统一提供。* 端点在 `frontend/src` 里只在这里声明一次(`tests/test_frontend_build.py` 盯着)。 */import { apiGet } from '../../api';import { elapsedText } from '../activity/tasks';@@ -62,7 +61,7 @@ export interface LibraryProcessingData {completed_at?: number;}-/** 一次写操作的请求体:全跑、只扫描、只采集,或者按任务号重试失败项。 */+/** 一次写操作的请求体:指定处理阶段与影片,或者按任务号重试失败项。 */export type LibraryProcessingCommand =| Record<string, never>| { stage: 'scan' | 'collect' | 'previews' | 'metadata'; asset_ids?: number[] }