Files
UHD_Media_Tool/packages/contracts/src/organize-sources.ts
T
rootandClaude Opus 5.5 ceb66f8c77 feat: v0.3.8–v0.3.14 工作区汇总(依赖升级、整理来源、手动入库、原地入库等)
生产 v0.3.8~v0.3.13 均由 8013196 加工作区修改构建部署,此前未提交;本提交补齐源码,
并含未部署的 v0.3.14 原地入库。中间各版本源码状态未保存,无法逐版拆分,详见
docs/plan/17-full-upgrade.md 与 docs/plan/18-organize-release.md。

- v0.3.8 全面升级:Deno workspace 依赖、Router 8 / Vite 8、camofox 1.18.0 / Node 24、
  PostgreSQL 18.6、备份客户端 18.6、演示 qB 5.2.4
- v0.3.9 媒体整理:分类规则、整理来源与目录快照(0059)、文件管理整理入口
- v0.3.10 手动下载与入库:独立手动下载、详情页资源下载、TMDB / Local 元数据兜底
  (metadata.resolve_organize)、正常多版本 / 一次性洗版(0060)
- v0.3.11 搜索详情与桌面黑边修复
- v0.3.12 列表分页、搜索历史、首页概况
- v0.3.13 统一整理弹窗与队列
- v0.3.14 原地入库(0061,未部署)

同批审计修复:
- 刮削入队:确认原记录存在后才删重放产生的新记录;写回 run 关联失败时保持 queued,
  由处理器补关联(对齐 MP 先登记、只在入队失败时记失败)
- 识别升级链只在结果更确定时采用,不再用 no_match 顶替原有歧义候选
- bluray_dir 资产以原盘目录本身为刮削根(MP 同做法)
- metadata.resolve_organize 登记到入库排障 Skill 与能力地图
- db/src/types.ts 按迁移重新生成;contracts 整理动作枚举顺序与数据库对齐
- 测试:原地入库用例改为直接查记录表;domain 测试模板补 version
- 前端:通知铃铛弹层与用户菜单统一样式;站点卡片共用卡头、底栏贴底、分页间距

依赖升级证据只提交摘要文件,registry-snapshot.json 移至 .local/(SHA-256 记于文档)。

Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-10-02 15:47:17 +08:00

61 lines
2.4 KiB
TypeScript

import { z } from "zod";
import { Id, JsonObject, Timestamp } from "./common.ts";
// Independent reference shape avoids settings → instances → settings import cycles.
const SourceRef = z.object({
root: z.string().regex(/^(lib:[0-9a-f-]{36}|dl:[0-9a-f-]{36}:\d{1,3})$/i),
path: z
.string()
.max(4096)
.refine((p) => !p.startsWith("/") && !p.includes("\0") && !p.split("/").some((s) => s === ".." || s === ".")),
});
export const OrganizeSourceSnapshotRow = z.object({
sourceId: Id,
snapshot: JsonObject,
baselineAt: Timestamp.nullable(),
lastScanAt: Timestamp.nullable(),
lastError: z.string().nullable(),
});
export type OrganizeSourceSnapshotRow = z.infer<typeof OrganizeSourceSnapshotRow>;
export const OrganizeSourceInput = z.object({
name: z.string().trim().min(1).max(100),
enabled: z.boolean(),
source: SourceRef,
target: SourceRef.refine((v) => v.root.startsWith("lib:"), { message: "目标必须为媒体库" }),
mediaType: z.enum(["all", "movie", "tv"]),
category: z
.string()
.trim()
.min(1)
.max(100)
.refine(
(s) => !/[\\/<>:"|?*]/.test(s) && !Array.from(s).some((ch) => ch.charCodeAt(0) < 32) && s !== "." && s !== "..",
)
.nullable(),
action: z.enum(["copy", "move"]),
trigger: z.enum(["manual", "qb_tag", "snapshot"]),
downloaderInstanceId: Id.nullable(),
tag: z.string().trim().min(1).max(100).nullable(),
intervalSec: z.number().int().min(60).max(86400),
});
export type OrganizeSourceInput = z.infer<typeof OrganizeSourceInput>;
export const OrganizeSourceConfig = OrganizeSourceInput.extend({ id: Id });
export type OrganizeSourceConfig = z.infer<typeof OrganizeSourceConfig>;
export const OrganizeSourceView = OrganizeSourceConfig.extend({
baselineAt: Timestamp.nullable(),
lastScanAt: Timestamp.nullable(),
lastError: z.string().nullable(),
fileCount: z.number().int().nonnegative(),
});
export type OrganizeSourceView = z.infer<typeof OrganizeSourceView>;
export const OrganizeSourceList = z.object({ items: z.array(OrganizeSourceView) });
export const OrganizeStockInput = z.object({ path: SourceRef.shape.path.optional() });
export const OrganizeStockResult = z.object({
items: z.array(SourceRef),
skipped: z.number().int().nonnegative(),
unavailable: z.number().int().nonnegative(),
truncated: z.boolean(),
});
export type OrganizeStockResult = z.infer<typeof OrganizeStockResult>;