m = vars("张".repeat(120), "361029200907295110", "身份证");
+ String n = svc.renderName(null, m, ".jpg");
+ assertTrue(n.length() <= 90, "Windows 路径 260 限制，正文要给目录留空间: " + n.length());
+ assertTrue(n.endsWith(".jpg"), "截断不能吃掉扩展名");
+ }
+
+ @Test
+ void sanitize_空白给未命名_全非法字符收拢成单个下划线() {
+ // "///" → "___" → 收拢成 "_"（不是「未命名」：未命名只留给纯空白，
+ // 全非法字符收拢后仍是可写盘的合法名字）
+ assertEquals("_", FileProcessService.sanitize("///"));
+ assertEquals("未命名", FileProcessService.sanitize(" "));
+ assertEquals(null, FileProcessService.sanitize(null));
+ }
+
+ @Test
+ void sanitize_连续分隔符收拢() {
+ assertEquals("a_b", FileProcessService.sanitize("a___b"));
+ assertEquals("a-b", FileProcessService.sanitize("a---b"));
+ }
+}
diff --git a/backend/xt-server/src/test/java/cn/tianbaotong/fill/support/IdentityNormalizerTest.java b/backend/xt-server/src/test/java/cn/tianbaotong/fill/support/IdentityNormalizerTest.java
new file mode 100644
index 0000000..2fbc550
--- /dev/null
+++ b/backend/xt-server/src/test/java/cn/tianbaotong/fill/support/IdentityNormalizerTest.java
@@ -0,0 +1,51 @@
+package cn.tianbaotong.fill.support;
+
+import org.junit.jupiter.api.Test;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
+/**
+ * {@link IdentityNormalizer} 的最小单测（《08》F-9：先给纯函数补单测，其余继续靠 E2E）。
+ *
+ * 选这三条规则断言，是因为每一条背后都有一个真实踩过的坑：
+ *
+ * - 姓名去空白、但不去间隔号 —— 少数民族姓名里的「·」是真实的；
+ * 顺手"清一清"会弄坏一部分人的名字（F-20 的另一面：规范化规则不能互相借用）；
+ * - 全角转半角 —— 手机输入法常给全角数字，而它进校验位算法就是错的；
+ * - 证件号小写 {@code x} 收尾要统一成大写 —— 名册比对按字符串等值。
+ *
+ */
+class IdentityNormalizerTest {
+
+ @Test
+ void 姓名去所有空白_含全角空格() {
+ assertEquals("张三", IdentityNormalizer.name("张 三"));
+ assertEquals("张三", IdentityNormalizer.name("张 三")); // 全角空格 U+3000
+ assertEquals("张三", IdentityNormalizer.name(" 张\t三\n"));
+ }
+
+ @Test
+ void 姓名里的间隔号必须保留() {
+ // 阿依古丽·买买提：间隔号是姓名的一部分，清掉等于改了人家的名字
+ assertEquals("阿依古丽·买买提", IdentityNormalizer.name("阿依古丽·买买提"));
+ assertEquals("阿依古丽·买买提", IdentityNormalizer.name("阿依古丽 · 买买提"));
+ }
+
+ @Test
+ void 全角ASCII转半角_其余不动() {
+ assertEquals("123X", IdentityNormalizer.toHalfWidth("１２３Ｘ"));
+ assertEquals("中文不变", IdentityNormalizer.toHalfWidth("中文不变"));
+ assertEquals("", IdentityNormalizer.toHalfWidth(null));
+ }
+
+ @Test
+ void 证件号去空白_转大写_全角可入() {
+ assertEquals("36102920090729511X", IdentityNormalizer.idCard("3610292009 0729511x"));
+ assertEquals("36102920090729511X", IdentityNormalizer.idCard("３６１０２９２００９０７２９５１１Ｘ"));
+ }
+
+ @Test
+ void 姓名空值返回空串而不是NPE() {
+ assertEquals("", IdentityNormalizer.name(null));
+ }
+}