Merge branch 'libv1'

Co-Authored-By: Claude Fable 5.1 <[email protected]>

# Conflicts:
#	docs/plan/00-first-version-plan.md

apps/web/app/api/library-versions.ts

@@ -0,0 +1,18 @@
+import { useQuery } from "@tanstack/react-query";
+import { LibraryVersions } from "@umt/contracts";
+import { getParsed } from "~/api/library.ts";
+
+// LIBV-1:作品的入库版本(每集的本地文件版本、季汇总、与收录版本的比对)
+
+export const libraryVersionKeys = {
+  versions: (id: string, slotId?: string) => ["library", "versions", id, slotId ?? null] as const,
+};
+
+export function useLibraryVersions(id: string | undefined, slotId?: string) {
+  return useQuery({
+    queryKey: libraryVersionKeys.versions(id ?? "", slotId),
+    enabled: !!id,
+    queryFn: ({ signal }) =>
+      getParsed(LibraryVersions, `/library/${id}/versions`, slotId ? { slotId } : undefined, signal),
+  });
+}