diff --git a/backend-java/src/test/java/com/nanri/aiimage/testutil/SourceScanTest.java b/backend-java/src/test/java/com/nanri/aiimage/testutil/SourceScanTest.java
index f553d08ca..78c253c51 100644
--- a/backend-java/src/test/java/com/nanri/aiimage/testutil/SourceScanTest.java
+++ b/backend-java/src/test/java/com/nanri/aiimage/testutil/SourceScanTest.java
@@ -487,4 +487,139 @@ class SourceScanTest {
.hasMessageContaining("遍历")
.hasMessageContaining(vanished.getFileName().toString());
}
+
+ // ---------------------------------------------------------------- N8 只吃 .java
+
+ @Test
+ void exclude_java只计java扩展() {
+ assertThat(SourceScan.moduleSources("modules/appearancepatent"))
+ .as("面内每一支都必须以小写 {@code .java} 结尾——大小写策略见 exclude_大写JAVA后缀被计入")
+ .allMatch(p -> p.getFileName().toString().endsWith(".java"));
+ }
+
+ @Test
+ void exclude_同目录md文件不进面() throws IOException {
+ Path module = Files.createDirectories(tmp.resolve("N8混放/src/main/java/modules/mixed"));
+ Files.writeString(module.resolve("Keep.java"), "class Keep {}", StandardCharsets.UTF_8);
+ Files.writeString(module.resolve("MIGRATION.md"), "# 拆分说明", StandardCharsets.UTF_8);
+ Files.writeString(module.resolve("mapper.xml"), "", StandardCharsets.UTF_8);
+ Files.writeString(module.resolve("notes.txt"), "x", StandardCharsets.UTF_8);
+
+ assertThat(SourceScan.moduleSources(tmp.resolve("N8混放/src/main/java"), "modules/mixed"))
+ .as("真集成同款场景:SourceScan.java:35-39 记过同类事故——注释类文本会把「被禁写法」喂成假绿。"
+ + "正反双向一起断言:留 1 支 .java,同时排除 3 支非 java")
+ .extracting(p -> p.getFileName().toString())
+ .containsExactly("Keep.java");
+ }
+
+ @Test
+ void exclude_大写JAVA后缀被计入() throws IOException {
+ Path module = Files.createDirectories(tmp.resolve("N8大小写/src/main/java/modules/case"));
+ Files.writeString(module.resolve("Lower.java"), "class Lower {}", StandardCharsets.UTF_8);
+ Files.writeString(module.resolve("UPPER.JAVA"), "class UPPER {}", StandardCharsets.UTF_8);
+
+ // 本 task 定口径:**大写 .JAVA 不计**(与仓内现状一致)。正反两条同时钉:
+ // 谁把它改成大小写不敏感匹配,下面那条「不含 UPPER.JAVA」立刻红——这格因此不是恒绿格。
+ List names = SourceScan.moduleSources(tmp.resolve("N8大小写/src/main/java"), "modules/case")
+ .stream().map(p -> p.getFileName().toString()).toList();
+
+ assertThat(names).contains("Lower.java");
+ assertThat(names)
+ .as("口径选择:只认小写 .java。仓内 973 支主源码件实测全是小写后缀,"
+ + "把 .JAVA 也收进来等于给「同一份代码换个大小写再放一遍」开绿灯")
+ .doesNotContain("UPPER.JAVA");
+ }
+
+ @Test
+ void exclude_以java结尾的目录名不误判() throws IOException {
+ Path module = Files.createDirectories(tmp.resolve("N8怪目录/src/main/java/modules/weird"));
+ Path fakeDir = Files.createDirectories(module.resolve("foo.java"));
+ Files.writeString(fakeDir.resolve("Bar.java"), "class Bar {}", StandardCharsets.UTF_8);
+
+ List files = SourceScan.moduleSources(tmp.resolve("N8怪目录/src/main/java"), "modules/weird");
+
+ assertThat(Files.isDirectory(fakeDir))
+ .as("正对照:这个目录确实叫 foo.java,否则下面那条断言是空的")
+ .isTrue();
+ assertThat(files)
+ .as("目录不是源文件:后缀判定必须先过 isRegularFile(walkFileTree 的 visitFile 天然只给文件,"
+ + "但这条换实现就容易踩,所以钉住)")
+ .extracting(p -> p.getFileName().toString())
+ .containsExactly("Bar.java");
+ }
+
+ @Test
+ // plan 原文这格叫「exclude_隐藏文件.java不计入」——含点号做 Java 方法名不合法,改名并在此留痕
+ void exclude_隐藏文件不计入() throws IOException {
+ Path module = Files.createDirectories(tmp.resolve("N8隐藏件/src/main/java/modules/dot"));
+ Files.writeString(module.resolve("Real.java"), "class Real {}", StandardCharsets.UTF_8);
+ Files.writeString(module.resolve(".Shadow.java"), "class Shadow {}", StandardCharsets.UTF_8);
+
+ assertThat(SourceScan.moduleSources(tmp.resolve("N8隐藏件/src/main/java"), "modules/dot"))
+ .as("以点开头的 .java 是编辑器备份(.Foo.java、Foo.java.orig 一族),进面就会把计数喂大。"
+ + "正反双向:真件在、影子件不在")
+ .extracting(p -> p.getFileName().toString())
+ .containsExactly("Real.java");
+ }
+
+ @Test
+ void exclude_空文件被计入但读为空串() throws IOException {
+ Path module = Files.createDirectories(tmp.resolve("N8空件/src/main/java/modules/zero"));
+ Path empty = Files.createFile(module.resolve("Empty.java"));
+ Files.writeString(module.resolve("Kept.java"), "class Kept {}", StandardCharsets.UTF_8);
+
+ List files = SourceScan.moduleSources(tmp.resolve("N8空件/src/main/java"), "modules/zero");
+
+ assertThat(Files.size(empty))
+ .as("正对照:这支确实是 0 字节")
+ .isZero();
+ assertThat(files)
+ .as("有文件但内容为空 ≠ 零文件——这条与 N11「目录里 0 支 .java 才抛」必须分得开,"
+ + "否则 N11 会把「全是空件」的模块误判成「没有文件」")
+ .extracting(p -> p.getFileName().toString())
+ .containsExactlyInAnyOrder("Empty.java", "Kept.java");
+ }
+
+ @Test
+ void exclude_不可读文件抛不静默跳过() throws IOException, InterruptedException {
+ Path root = tmp.resolve("N8不可读/src/main/java");
+ Path module = Files.createDirectories(root.resolve("modules/locked"));
+ Path noList = Files.createDirectories(module.resolve("nolist"));
+ Files.writeString(noList.resolve("Hidden.java"), "class Hidden {}", StandardCharsets.UTF_8);
+
+ Process icacls = new ProcessBuilder("icacls", noList.toString(), "/deny", "*S-1-1-0:(OI)(CI)RX")
+ .redirectErrorStream(true).start();
+ String out;
+ try (var in = icacls.getInputStream()) {
+ out = new String(in.readAllBytes(), StandardCharsets.UTF_8);
+ }
+ int code = icacls.waitFor();
+ try {
+ assertThat(code)
+ .as("icacls 造不出「不可列举目录」⇒ 环境缺口,判红而不是跳过(跳过会新增 Skipped,违反 N99)。"
+ + "输出:%s", out)
+ .isZero();
+ assertThat(Files.isReadable(noList))
+ .as("反证前提:拒绝授权必须真的生效,否则后面那条断言是恒绿的")
+ .isFalse();
+
+ assertThatThrownBy(() -> SourceScan.moduleSources(root, "modules/locked"))
+ .as("列举失败的目录必须把异常冒出来(visitFileFailed ⇒ IllegalStateException),"
+ + "静默跳过 = 那个子树里的被禁写法永远不会被读到")
+ .isInstanceOf(IllegalStateException.class)
+ .hasMessageContaining("遍历");
+ } finally {
+ // 撤销拒绝授权,否则 JUnit 清 @TempDir 会因无删除权限卡住,把一次性件留在机器上
+ new ProcessBuilder("icacls", noList.toString(), "/remove:d", "*S-1-1-0")
+ .redirectErrorStream(true).start().waitFor();
+ }
+ }
+
+ @Test
+ void exclude_面内全部元素isRegularFile为真() {
+ assertThat(SourceScan.moduleSources("modules/shopdatacrawl"))
+ .as("真实集成:51 支的模块里逐支都必须是regular file,形状契约")
+ .isNotEmpty()
+ .allMatch(Files::isRegularFile);
+ }
}