package collector import ( "archive/zip" "bytes" "errors" "os" "path/filepath" "strings" "testing" ) // 這一組測的是**接線**,不是轉檔本身(那在 convert_test.go)。 // // 為什麼要獨立測:t73 的教訓是「零件完成 ≠ 功能完成」——convert.go 寫得再對, // 沒接進 ExtractWithGemma 就等於不存在。這裡驗的是**用戶真的會走的那條路**: // 檔案落在資料夾 → scan 收不收 → 萃取前有沒有真的過轉檔層。 func writeDocx(t *testing.T, path, bodyXML string) { t.Helper() var buf bytes.Buffer zw := zip.NewWriter(&buf) w, _ := zw.Create("word/document.xml") w.Write([]byte(` ` + bodyXML + ``)) zw.Close() if err := os.WriteFile(path, buf.Bytes(), 0o644); err != nil { t.Fatalf("寫檔失敗: %v", err) } } // scan 必須把 .docx 當成要處理的檔案收進來——否則轉檔層再好也輪不到它。 func TestWiring_scan收得到docx(t *testing.T) { dir := t.TempDir() writeDocx(t, filepath.Join(dir, "合約.docx"), `內容`) os.WriteFile(filepath.Join(dir, "筆記.md"), []byte("# 標題"), 0o644) os.WriteFile(filepath.Join(dir, "圖.png"), []byte("\x89PNG"), 0o644) m := &Manifest{FolderID: "test-folder-id", Entries: map[string]*ManifestEntry{}} payload, err := Scan(dir, m, ScanOptions{}) if err != nil { t.Fatalf("scan 失敗: %v", err) } var got []string for _, ev := range payload.Events { got = append(got, filepath.Base(ev.Path)) } joined := strings.Join(got, ",") if !strings.Contains(joined, "合約.docx") { t.Errorf(".docx 應被 scan 收進來,實得: %v", got) } if !strings.Contains(joined, "筆記.md") { t.Errorf(".md 應被收,實得: %v", got) } if strings.Contains(joined, "圖.png") { t.Errorf(".png 不該被收,實得: %v", got) } } // 接線的核心:ExtractWithGemma 讀完檔之後,送進 LLM 的必須是**轉好的文字**, // 不是原始位元組。這裡不打真 API——用「缺 API key 會在轉檔之後才失敗」來反證 // 轉檔確實發生在送出之前。 func TestWiring_docx轉檔發生在送LLM之前(t *testing.T) { dir := t.TempDir() rel := "合約.docx" writeDocx(t, filepath.Join(dir, rel), `維修費用 350,000 元`) // 空 API key → 函式最前面就擋下,證明不了轉檔。給假 key 讓它走到轉檔那一步。 _, err := ExtractWithGemma("fake-key-for-test", "", dir, rel, testOrigin()) if err == nil { t.Fatal("用假 key 不該成功") } // 關鍵斷言:錯誤不可以是「轉檔失敗」——那代表轉檔層把正常的 docx 擋掉了。 if strings.Contains(err.Error(), "轉檔失敗") { t.Errorf("正常的 docx 不該在轉檔層失敗,實得: %v", err) } // 也不該是「讀原稿失敗」——檔案是存在的。 if strings.Contains(err.Error(), "讀原稿失敗") { t.Errorf("檔案存在卻讀不到: %v", err) } // 走到這裡代表:讀檔 ok → 轉檔 ok → 死在 API 呼叫(預期,因為 key 是假的) t.Logf("如預期死在 API 階段(證明轉檔已通過): %v", err) } // 掃描件 PDF 的行為契約:轉不出文字要**明確失敗**並說得出原因, // 不能靜默當成空內容送給 LLM(那會產生一張空卡,用戶以為成功了)。 func TestWiring_抽不出文字要明確失敗不靜默(t *testing.T) { dir := t.TempDir() rel := "空的.docx" writeDocx(t, filepath.Join(dir, rel), ` `) _, err := ExtractWithGemma("fake-key-for-test", "", dir, rel, testOrigin()) if err == nil { t.Fatal("抽不出文字應該失敗") } if !strings.Contains(err.Error(), "轉檔失敗") { t.Errorf("應該明確說是轉檔失敗,實得: %v", err) } if !errors.Is(err, ErrNoText) { t.Errorf("應可用 errors.Is 判定為 ErrNoText(呼叫端才能給對的訊息),實得: %v", err) } } // 不支援的格式(例如 .ppt 舊式二進位格式)要回 ErrUnsupported, // 訊息要跟「掃描件」區分開——給用戶的說法不同。 func TestWiring_未支援格式與無文字要能區分(t *testing.T) { dir := t.TempDir() rel := "簡報.ppt" os.WriteFile(filepath.Join(dir, rel), []byte("\xD0\xCF\x11\xE0\xA1\xB1\x1A\xE1fake"), 0o644) _, err := ExtractWithGemma("fake-key-for-test", "", dir, rel, testOrigin()) if err == nil { t.Fatal("未支援格式應該失敗") } if !errors.Is(err, ErrUnsupported) { t.Errorf("應為 ErrUnsupported,實得: %v", err) } if errors.Is(err, ErrNoText) { t.Error("未支援格式不該同時是 ErrNoText(兩者給用戶的說法不同)") } } // .md 走純文字直通,不可因為接了轉檔層而壞掉(迴歸保護)。 func TestWiring_md不受轉檔層影響(t *testing.T) { dir := t.TempDir() rel := "筆記.md" os.WriteFile(filepath.Join(dir, rel), []byte("# 標題\n\n內容"), 0o644) _, err := ExtractWithGemma("fake-key-for-test", "", dir, rel, testOrigin()) if err == nil { t.Fatal("假 key 不該成功") } if strings.Contains(err.Error(), "轉檔失敗") { t.Errorf(".md 不該進轉檔層失敗路徑,實得: %v", err) } }