update

tests/unit/main/literature-import-partial-copy.test.ts

@@ -0,0 +1,78 @@
+// tests/unit/main/literature-import-partial-copy.test.ts
+//
+// 行为锁(audit-r243,2026-10-21):**导入失败时不得在 literature/ 里留下
+// 半截文件**。
+//
+// ── 缺陷 ────────────────────────────────────────────────────────────
+//   import.ts 的拷贝走 fs.copyFile(src, dst, COPYFILE_EXCL)。copyFile 先
+//   创建/截断 dst 再拷内容,中途失败(ENOSPC / EIO / 断电)会留下一个
+//   **截断的** dst。旧实现在「非 EEXIST」分支直接抛错,没清 dst。
+//   ⇒ 那半截文件留在 literature/ 里 ⇒ chokidar 'add' ⇒ reload 把它当
+//     正常文献收进 byId + resources 表 ⇒ 用户列表里出现一个打不开的
+//     「文献」,还占着磁盘空间。
+//   (同函数的「拷贝后 size 校验」分支是会 rm dst 的,但 copy 失败这条
+//    路径根本走不到那里。)
+//
+// ── 修法 ────────────────────────────────────────────────────────────
+//   非 EEXIST 失败 ⇒ 先 rm(dst) 再抛。EEXIST 分支**不能**删(dst 是别人
+//   已有的文件,下面要换名重试)。
+import { mkdtemp, writeFile, rm, readdir } from 'fs/promises';
+import { tmpdir } from 'os';
+import { join } from 'path';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+
+// mock 'fs':copyFile 造出「目标端半份残留」后抛 ENOSPC
+vi.mock('fs', async (importOriginal) => {
+  const actual = await importOriginal<typeof import('fs')>();
+  const real = actual.promises;
+  // audit-r253 (2026-10-21):`typeof import('fs')` 里**没有** default 属性
+  //   (@types/node 的 fs 是 CJS 导出,default 由 esModuleInterop 合成,
+  //   不体现在模块命名空间的类型上)⇒ 直接写 actual.default 是 TS2339。
+  //   这里显式把「可能有 default」的形状加回去,运行时语义不变。
+  const withDefault = actual as typeof actual & { default?: typeof actual };
+  return {
+    ...actual,
+    default: withDefault.default ?? actual,
+    promises: {
+      ...real,
+      copyFile: async (src: string, dest: string) => {
+        await real.writeFile(dest, 'PARTIAL', 'utf8');
+        const err = new Error('ENOSPC: no space left on device') as NodeJS.ErrnoException;
+        err.code = 'ENOSPC';
+        void src;
+        throw err;
+      },
+    },
+  };
+});
+
+describe('文献导入:拷贝失败不留半截文件(audit-r243)', () => {
+  let root: string;
+  let srcFile: string;
+
+  beforeEach(async () => {
+    vi.resetModules();
+    root = await mkdtemp(join(tmpdir(), 'rkms-litimport-'));
+    srcFile = join(root, 'paper.pdf');
+    await writeFile(srcFile, 'REAL PDF CONTENT', 'utf8');
+  });
+
+  afterEach(async () => {
+    vi.resetModules();
+    await rm(root, { recursive: true, force: true });
+  });
+
+  it('copyFile 中途失败 ⇒ 抛错 + literature/ 里不残留半截文件', async () => {
+    const { importLiteratureFile, literatureDir } = await import(
+      '../../../src/main/literature/import'
+    );
+    await expect(importLiteratureFile(srcFile, root)).rejects.toThrow();
+
+    const dir = literatureDir(root);
+    const leftovers = await readdir(dir).catch(() => [] as string[]);
+    expect(
+      leftovers,
+      `literature/ 里残留了半截文件:${leftovers.join(', ')} ⇒ 会被 reload 当成正常文献收进索引`,
+    ).toEqual([]);
+  });
+});