Când predați documente adnotate, nu predați doar un PDF care arată curat.

Acest articol oferă o extracție stratificată și o soluție de verificare a securității bazată pe PyMuPDF pentru a aborda problemele de confuzie între text și comentarii, scurgerile de date sensibile și confuzia sistemelor de coordonate în extragerea adnotărilor PDF. Conținutul acoperă principiul stratului de date independent, exemple de programare defensivă, procesarea condițiilor de limită și criteriile de acceptare manuală și explică cum să conectați corect OmniDoc în fluxul de lucru de traducere a documentelor pentru comparare și acceptare bilingvă.

Înainte de a preda adnotările PDF, mulți oameni vor folosi direct page.get_text() pentru a exporta un text cu aspect curat pentru traducere, arhivare sau predare următorului examinator. Dar acest text de obicei nu conține adnotări. Unele metode de extragere vor introduce și comentarii în mijlocul textului, întrerupând semantica; comentariile de modificare și observațiile sensibile din bara laterală pot fi ratate.

Acest articol este scris pentru dezvoltatori și proprietari de documente care trebuie să lucreze cu PDF-uri adnotate. După citire, veți înțelege de ce adnotările sunt straturi de date independente, cum să extrageți text și adnotări în straturi, ce cazuri marginale trebuie tratate defensiv și ce puncte de acceptare trebuie confirmate manual.

Exemplele din acest articol folosesc toate mostre sintetice. Codul a fost verificat într-un mediu izolat, dar aceasta nu este o garanție a tuturor fișierelor reale sau a performanței produsului. Înainte de a procesa documente importante, vă rugăm să păstrați originalele și să le revizuiți în funcție de limitele și elementele de acceptare din text.

Cum se extrage PDF adnotat înainte de predare? O singură propoziție concluzie

Tratați textul și adnotările ca două fluxuri de date independente și extrageți-le separat și efectuați o examinare explicită de securitate a conținutului adnotărilor.

situatia taPractici recomandatemotiv
Folosiți get_text() numai pentru a exporta textulNu-l tratați ca fiind completIeșirea implicită nu conține de obicei adnotări
Comentariile de revizuire ale recenzenților trebuie păstrateIterați individual peste adnotări cu page.annots()Adnotările sunt obiecte independente atașate paginii
Comentariile pot conține numere de identificare și coduri interne.Potriviți după reguli sensibile, marcați redacted=True și înlocuiți cu substituentNotele de revizuire pot conține date sensibile
Pagina este rotităMai întâi utilizați page.rotation_matrix sau page.derotation_matrix pentru a transforma coordonateleDreptunghi de adnotare bazat pe o pagină nerotită
Gata pentru procesul de traducereCurățați mai întâi etichetele de text îmbogățit, apoi verificați manual după traducereEvitați traducerile care conțin cod

De ce adnotările sunt independente de stratul de date al textului

În specificația PDF, fluxul de conținut al paginii (Fluxul de conținut) și dicționarul de adnotări (Annots Array) sunt separate structural. Corpul este format din instrucțiuni de afișare a textului; adnotările sunt obiecte independente atașate paginii, cu propriile coordonate, tip și atribute de conținut. Metoda Page.annots() de la PyMuPDF returnează un generator care traversează această listă de adnotări independente în locul fluxului de text al paginii.

Aceasta înseamnă că nu puteți presupune că tot textul pe care îl vedeți poate fi extras în același mod.

Diferența dintre adnotările pentru clasa de marcare și clasa de conținut

  • Adnotările etichetelor (cum ar fi evidențierea și sublinierea) nu conțin text în sine, ci doar înregistrează zona (Cads/Rects) corespunzătoare textului original. Textul real poate fi obținut doar căutând textul prin coordonate.
  • Adnotările de conținut (cum ar fi notele, textul liber) au propriile șiruri de conținut și pot fi citite direct.
  • Dacă citiți annot.info["content"] direct fără a distinge tipul, veți pierde contextul original indicat de adnotarea clasei de etichete sau veți arunca o excepție dacă conținutul este gol.

Exemplu de sinteză: extragerea stratificată și interceptarea informațiilor sensibile

Pentru a demonstra logica corectă de procesare, am construit un scenariu sintetic care conține trei adnotări tipice în cod. Următoarele intrări sunt exemple construite în cod, nu din fișierele clienților reali și sunt doar în scopuri educaționale demonstrative.

Rezultatul așteptat conține trei câmpuri structurate:

  1. Fragment de text: conține doar textul original al paginii, fără conținut de adnotare.
  2. Lista de adnotări: Fiecare înregistrare include tipul, locația, autorul, ora și conținutul (dacă există).
  3. Marca de securitate: dacă conținutul adnotării corespunde regulilor sensibile prestabilite (cum ar fi numărul ID, codul intern), intrarea este marcată ca redacted=True și conținutul este înlocuit cu un substituent.

Trei tipuri de granițe care trebuie apărate

  • Adnotare de conținut goală: adnotările cu cerneală (cerneală) sau grafice create de unii cititori nu au atribute text. Accesul direct la .info["content"] poate duce la un șir gol sau None, codul trebuie să efectueze verificări defensive și nu poate presupune că toate adnotările au text care poate fi citit.
  • Coordonatele paginii rotite: după ce pagina este rotită cu 90 de grade, dreptunghiul de adnotare se bazează în continuare pe pagina nerotită. Dacă utilizați direct aceste coordonate pentru a decupa sau a poziționa textul, poziția va fi complet dezordonată, iar transformarea coordonatelor trebuie făcută mai întâi.
  • Obiect orfan: dacă documentul este închis sau pagina este reîncărcată în timpul procesului de parcurgere, obiectul actual annot va deveni imediat invalid. Toate operațiunile de citire trebuie finalizate într-o singură pagină de viață.

Implementarea Python: parcurgere și verificare sigură a adnotărilor

Exemplul folosește PyMuPDF pentru a construi un PDF de testare în memorie, demonstrând extragerea ierarhică și logica de bază de mascare. Biblioteca dependentă este PyMuPDF (adică pachetul pymupdf). Rulați-l într-un mediu de dependență blocat. Versiunea trebuie să fie >=1.23.0 pentru a accesa complet atributul annot. Acest cod nu efectuează operațiuni de rețea sau scriere de fișiere, este folosit doar pentru a demonstra logica.

import fitz  # PyMuPDF
import re

# 合成示例:仅在内存中构造,无需外部文件
def create_sample_pdf():
    doc = fitz.open()
    page = doc.new_page()
    # 插入正文
    page.insert_text((72, 72), "Confidential Project Alpha Report", fontsize=12)
    # 添加便签批注(含敏感信息模拟)
    page.add_text_annot((200, 72), "Reviewer: SSN 123-45-6789 approved.")
    # 添加高亮批注(无自身文本,关联正文)
    highlight = page.add_highlight_annot(fitz.Rect(72, 60, 250, 80))
    # 必须调用update()使info变更生效
    highlight.set_info(title="Editor", content="Check this term")
    highlight.update()
    return doc

def extract_with_safety(page, sensitive_pattern=r"\d{3}-\d{2}-\d{4}"):
    body_text = page.get_text("text")
    annotations = []

    # 显式遍历批注生成器
    for annot in page.annots():
        info = annot.info
        # 防御性获取内容,处理None或空字符串
        content = info.get("content", "") or ""

        # 边界处理:敏感词检测与脱敏
        is_sensitive = bool(re.search(sensitive_pattern, content))
        safe_content = "[REDACTED]" if is_sensitive else content

        annotations.append({
            "type": annot.type[1],
            "author": info.get("title", "Unknown"),
            "content": safe_content,
            "is_redacted": is_sensitive,
            # 注意:此为未旋转坐标系,若页面有旋转需配合rotation_matrix使用
            "rect": list(annot.rect)
        })
    return body_text, annotations

# 执行校验
doc = create_sample_pdf()
page = doc[0]
text, annots = extract_with_safety(page)

assert "SSN 123-45-6789" not in str(annots), "敏感信息未被拦截"
assert any(a["type"] == "Highlight" for a in annots), "标记类批注丢失"
assert len(text.strip()) > 0, "正文提取失败"
print(f"Extracted {len(annots)} annotations safely.")

În esență, codul este programarea defensivă: puritatea conținutului adnotărilor nu este de încredere și nici integritatea tipului de adnotare nu este presupusă. Declarația assert este utilizată pentru a verifica logica așteptată, dar aceasta este doar o demonstrație și nu reprezintă o garanție de performanță de la capăt la capăt pentru toate variantele PDF.

Comparația categoriilor de adnotări

Tip de adnotareIndiferent dacă să-ți aduci propriul textCum să obțineți conținutPuncte de reținut la predare
Evidențiați, subliniațiNu, doar zonele de înregistrare (Quads/Rects)Verificați textul folosind coordonateleContextul textului original corespunzător trebuie păstrat
Note, text liberDa, vine cu propriul șir de conținutciteste directVerificați conținutul sensibil
Cerneală, grafică, sigiliiAdesea nici un atribut textEfectuați un apel scurt defensivConfirmați manual dacă este o semnătură sau un sigiliu de aprobare

Criterii de acceptare și limite de revizuire manuală

Extracția automată nu poate acoperi toate carcasele marginale. Următorul tabel listează punctele de acceptare cărora ar trebui să se acorde atenție în timpul predării, făcând distincție între domeniul de aplicare pe care îl poate gestiona codul și scenariile care necesită intervenție manuală.

Observați fenomeneProcesare la nivel de codRevizuirea umană sau luarea deciziilor
Conținutul comentariului este gol, dar pictograma existăTipul de înregistrare este Cerneală sau ștampilă, conținutul este lăsat necompletatConfirmați dacă este o semnătură sau o ștampilă de aprobare și decideți dacă doriți să păstrați instantaneul imaginii
Poziția comentariului depășește CropBoxCoordonatele sunt încă valide, dar randarea nu este vizibilăStabiliți dacă este o adnotare abandonată rămasă din istorie, care poate fi de obicei ignorată.
Comentariile text îmbogățit conțin etichete HTMLExtrageți șirul original, păstrați eticheteleCurățați etichetele sau convertiți-le în text simplu înainte de traducere pentru a evita traducerile care conțin cod.
Numele autorului adnotării este deformatExtrageți așa cum este, fără presupuneri de codificareVerificați metadatele fișierului sursă pentru a confirma dacă este numele unei anumite codificări
Fir de răspuns imbricatPyMuPDF returnează o listă platăReconstruiți arborele de dialog bazat pe ParentID, altfel contextul se pierde

Nu se aplică: această soluție nu se aplică PDF-urilor criptate fără a furniza o parolă, PDF-urilor deteriorate structural și fișierelor care utilizează extensii private non-standard pentru a defini tipurile de adnotări. În aceste situații, scriptul poate sări în tăcere sau să arunce o excepție C++ de nivel scăzut, care trebuie confirmată prin deschiderea manuală a fișierului sursă folosind instrumente profesionale.

Utilizați liste de verificare pentru traducerea documentelor

Mai întâi confirmați ordinea paginii, locația sursei și integritatea textului, apoi trimiteți același eșantion desensibilizat procesului de traducere. După traducere, mai trebuie să verificați dacă titlul, textul și ilustrațiile corespund corect. Nu puteți verifica doar dacă textul este neted.

OmniDoc oferă un portal de traducere a documentelor multi-format, iar site-ul oficial introduce OCR, glosar și funcții de comparare bilingvă. Dacă echipa dorește să înceapă procesarea direct din fișier, această cale poate fi evaluată cu mostre reale. Vă rugăm să utilizați fișiere desensibilizate pe care aveți permisiunea de a le încărca și examinați rezultatele conform elementelor de verificare din acest articol. Nu există nicio pretenție că OmniDoc utilizează bibliotecile open source sau algoritmii interni ai acestui articol și nici exemplul nu înlocuiește testarea performanței produsului.

Referințe și pașii următori

  1. Selectați un fișier de proiect istoric care conține tipuri mixte de adnotări.
  2. Rulați scriptul de verificare de mai sus și numărați proporția de intrări care necesită revizuire manuală.
  3. Dacă raportul depășește așteptările, adăugați un pas de preprocesare la procesul de transfer în loc să vă bazați pe instrumente din aval pentru a oferi răspunsul.

🎯 Ce metodă este potrivită pentru tine?

Dacă trebuie doar să traduceți textul

Puteți extrage direct textul, dar trebuie să confirmați dacă lipsesc adnotări în conținutul exportat.

Dacă doriți să dați documentul altcuiva pentru arhivare

În același timp, păstrați lista principală de text și adnotări și marcați conținutul sensibil ca desensibilizat.

Dacă PDF-ul dvs. are pagini rotite

Mai întâi faceți transformarea coordonatelor și apoi utilizați poziția adnotării pentru a localiza textul.

Dacă fișierul este criptat sau deteriorat structural

Această soluție nu este aplicabilă. Vă rugăm să utilizați manual instrumente profesionale pentru a deschide fișierul sursă pentru a confirma.

❓ Întrebări frecvente (FAQ)

1. De ce get_text() nu conține adnotări?

Ieșirea implicită conține de obicei doar corpul paginii. Adnotările sunt obiecte independente de fluxul de text al paginii și trebuie parcurse separat prin page.annots().

2. Textul tuturor comentariilor poate fi citit direct?

nu poate. Adnotările de tip marcaj, cum ar fi evidențierea și sublinierea, nu conțin text în sine și înregistrează doar zone; Adnotările cu cerneală și grafice pot, de asemenea, să nu aibă atribute de text și să necesite o judecată defensivă.

3. De ce se încurcă poziția paginii după ce este rotită?

Dreptunghiul de adnotare se bazează pe o pagină nerotită. Dacă este folosit direct pentru a poziționa textul, va provoca erori. Mai întâi trebuie să utilizați page.rotation_matrix sau page.derotation_matrix pentru transformarea coordonatelor.

4. Se vor pierde răspunsurile imbricate?

PyMuPDF returnează o listă plată, iar dacă arborele de dialog nu este reconstruit pe baza ParentID, contextul se va pierde.

5. Poate fi procesat PDF criptat cu acest script?

PDF-urile care sunt criptate și nu oferă o parolă nu fac parte din domeniul de aplicare al acestei soluții și necesită confirmare manuală.

📝 Rezumat

Adnotările sunt un strat de date independent în PDF. Înainte de predare, textul și adnotările trebuie extrase separat, iar adnotările trebuie revizuite pentru conținut sensibil. Scripturile automate pot acoperi cazuri obișnuite, dar cazurile marginale și acceptarea finală trebuie încă făcute manual.

Încercați acum: încărcați documentul pentru a începe traducerea, păstrând aspectul original

Actualizat 2026-11-16