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
1 parent 8013196e3f
commit ceb66f8c77
@@ -0,0 +1,121 @@
+import { mkdir, readdir, readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { afterAll, beforeAll, describe, expect, it } from "vitest";
+import { executeRecord } from "../../src/modules/acquisition-organize/services/organize.ts";
+import { createFmHarness, type FmHarness, key, pgAvailable, seedEntity } from "./harness.ts";
+
+const skip = !(await pgAvailable());
+
+describe.skipIf(skip)("files 整理人工集号校验", () => {
+  let h: FmHarness;
+  let show: string;
+  let film: string;
+  const path = "Some.Show.S01E02.mkv";
+  const bytes = "x".repeat(64);
+
+  beforeAll(async () => {
+    h = await createFmHarness("overrides");
+    show = await seedEntity(h.db, { kind: "series", title: "Some Show", year: 2022 });
+    film = await seedEntity(h.db, { kind: "movie", title: "Film", year: 2021 });
+    await writeFile(join(h.dl, path), bytes);
+    await mkdir(join(h.dl, "Season"));
+    await writeFile(join(h.dl, "Season", path), bytes);
+  });
+  afterAll(async () => h?.close());
+
+  const facts = async () => ({
+    entities: await h.db.selectFrom("media_entity").select("id").orderBy("id").execute(),
+    identities: await h.db.selectFrom("external_identity").select("id").orderBy("id").execute(),
+    plans: await h.db.selectFrom("artifact").select("id").where("title", "=", "files_plan").orderBy("id").execute(),
+    records: await h.db.selectFrom("organization_record").select("id").orderBy("id").execute(),
+    tasks: await h.db.selectFrom("task").select("id").orderBy("id").execute(),
+    jobs: h.engine.enqueued.length,
+    library: await readdir(h.lib, { recursive: true }),
+  });
+
+  it.each([true, false])("非连续集号在 dryRun=%s 时整批拒绝,不创建作品、计划、记录或文件", async (dryRun) => {
+    const before = await facts();
+    const r = await h.api("POST", "/files/organize", {
+      idempotencyKey: key(),
+      action: "copy",
+      dryRun,
+      items: [
+        // 排在坏输入前的远端候选也不能创建作品或发起 TMDB 请求。
+        { root: h.dlRoot, path, external: { provider: "tmdb", externalId: "136315", kind: "tv" } },
+        { root: h.dlRoot, path, mediaEntityId: show, season: 2, episodes: [5, 7] },
+      ],
+    });
+    expect(r.status).toBe(400);
+    expect(r.body.error.message).toMatch(/bad_request:.*集号 5,7 不连续/);
+    expect(await facts()).toEqual(before);
+    expect(await readFile(join(h.dl, path), "utf8")).toBe(bytes);
+  });
+
+  it("远端剧集候选的不连续集号也在建档前拒绝", async () => {
+    const before = await facts();
+    const r = await h.api("POST", "/files/organize", {
+      idempotencyKey: key(),
+      action: "copy",
+      dryRun: true,
+      items: [
+        { root: h.dlRoot, path, external: { provider: "tmdb", externalId: "136315", kind: "tv" }, episodes: [2, 4] },
+      ],
+    });
+    expect(r.status).toBe(400);
+    expect(r.body.error.message).toContain("不连续");
+    expect(await facts()).toEqual(before);
+  });
+
+  it.each(["local", "external"])("%s 剧集目录指定集号时明确拒绝,不保存计划", async (source) => {
+    const before = await facts();
+    const entity =
+      source === "local"
+        ? { mediaEntityId: show }
+        : { external: { provider: "tmdb", externalId: "136315", kind: "tv" } };
+    const r = await h.api("POST", "/files/organize", {
+      idempotencyKey: key(),
+      action: "copy",
+      dryRun: true,
+      items: [{ root: h.dlRoot, path: "Season", ...entity, season: 1, episodes: [2] }],
+    });
+    expect(r.status).toBe(400);
+    expect(r.body.error.message).toContain("目录项不能指定集号");
+    expect(await facts()).toEqual(before);
+  });
+
+  it("连续人工季集覆盖原解析,预览与执行路径一致", async () => {
+    const items = [{ root: h.dlRoot, path, mediaEntityId: show, season: 2, episodes: [4, 3, 4] }];
+    const dry = await h.api("POST", "/files/organize", { idempotencyKey: key(), action: "copy", dryRun: true, items });
+    expect(dry.status).toBe(200);
+    const group = dry.body.data.groups[0];
+    expect(group.error).toBeNull();
+    expect(group.warnings).toEqual([]);
+    expect(group.files).toHaveLength(1);
+    expect(group.files[0].target).toMatch(/Season 2\/Some Show - S02E03-E04 - 第 3-4 集\.mkv$/);
+    const exec = await h.api("POST", "/files/organize", {
+      idempotencyKey: key(),
+      action: "copy",
+      dryRun: false,
+      items,
+      planIds: [group.planId],
+    });
+    expect(exec.status).toBe(200);
+    expect(exec.body.data.groups[0].error).toBeNull();
+    expect(exec.body.data.groups[0].files).toEqual(group.files);
+    expect(exec.body.data.recordIds).toHaveLength(1);
+    const result = await executeRecord(h.module.deps().ao, exec.body.data.recordIds[0]);
+    expect(result.status).toBe("succeeded");
+    expect(await readFile(group.files[0].target, "utf8")).toBe(bytes);
+  });
+
+  it("电影仍忽略季集覆写并提示", async () => {
+    const r = await h.api("POST", "/files/organize", {
+      idempotencyKey: key(),
+      action: "copy",
+      dryRun: true,
+      items: [{ root: h.dlRoot, path, mediaEntityId: film, season: 1, episodes: [2, 4] }],
+    });
+    expect(r.status).toBe(200);
+    expect(r.body.data.groups[0].warnings).toEqual([expect.stringMatching(/电影不适用季\/集覆写/)]);
+  });
+});