PDF 中的一段文字被黑色矩形盖住后画面上可能看不见文件里的文字却未必被删除。判断处理是否生效要检查导出后的文件。下面用 ComPDF Web SDK 对同一份教学 PDF 做三种处理普通矩形遮挡、仅创建密文标记、应用密文。随后重新读取输出核对目标文字和需要保留的内容。先看输出结果教学文件含有两个标记TEST-SECRET-ALPHA是本次处理目标KEEP-PUBLIC-BETA应保持原样。它们是虚构教学文字不是账号、密钥或客户信息。处理方式目标文字能否提取保留标记是否还在普通黑色矩形能在创建密文标记未应用能在应用密文后导出本次未提取到在图三个真实输出 PDF 的独立渲染与文字提取核对。仅创建密文标记不会删除正文导出文件在其他阅读器中的标记外观可能不同不能靠是否出现黑块判断已经应用。这组对照使用 Web SDK 2.9.4。关键 PDF 处理由 ComPDF 完成后面的 Python 读取仅用于独立核验输出。1. 准备最小项目本例在 Node.js 24.18.0、Vite 7.1.9 下运行。创建目录并安装依赖mkdircompdf-redaction-democdcompdf-redaction-demonpminit-ynpminstall--save-exact compdfkit_pdf_sdk/webviewer2.9.4 vite7.1.9mkdir-ppublic/webviewer public/samplescp-anode_modules/compdfkit_pdf_sdk/webviewer/dist/. public/webviewer从SDK 试用许可取得 Web 许可在项目根目录创建.env.localVITE_COMPDF_LICENSEYOUR_WEB_SDK_LICENSE这是 Web SDK 许可不是 Cloud API 的x-api-key。许可配置见添加 Web 许可密钥。公开示例只保留占位符实际许可单独配置。把待检查的 PDF 放到public/samples/redaction-source.pdf。如果需要快速制作与下文坐标对应的最小教学输入可以运行python3-mpipinstallreportlab# make_sample.pyfromreportlab.pdfgenimportcanvas ccanvas.Canvas(public/samples/redaction-source.pdf,pagesize(595,842))c.setFont(Helvetica,18)c.drawString(60,500,TEST-SECRET-ALPHA)c.drawString(60,410,KEEP-PUBLIC-BETA)c.save()python3 make_sample.py配图中的输入另加了品牌和中文教学说明两个标记的位置与上面的最小输入相同。实际文件需要按自己的页面坐标选区域不能照搬矩形。2. 添加普通遮挡再创建密文标记在根目录保存下面的index.html!doctypehtmlhtmllangzh-CNmetacharsetUTF-8titlePDF 密文验证/titlestylebody{font-family:sans-serif;margin:16px;}button{margin:0 6px 10px 0;padding:8px;}#viewer{height:80vh;}/stylebuttonidresetdisabled重新打开原件/buttonbuttonidcoverdisabled添加普通遮挡/buttonbuttonidmarkdisabled创建密文标记/buttonbuttonidapplydisabled应用密文/buttonbuttonidsavedisabled下载当前 PDF/buttonpidstatus正在加载/pdividviewer/divscripttypemoduleimportWebViewerfromcompdfkit_pdf_sdk/webviewer;conststatusdocument.querySelector(#status);constcoreawaitWebViewer.init({path:/,pdfUrl:/samples/redaction-source.pdf,license:import.meta.env.VITE_COMPDF_LICENSE},document.querySelector(#viewer));constdoccore.docViewer;letstagesource;doc.addEvent(documentloaded,(){document.querySelectorAll(button).forEach(bb.disabledfalse);status.textContent原件已打开;});// Web SDK 的页面坐标以左上角为原点pageIndex 从 0 开始。constrect{left:55,top:320,right:310,bottom:353};document.querySelector(#reset).onclickasync(){awaitcore.UI.loadDocument(/samples/redaction-source.pdf);stagesource;};document.querySelector(#cover).onclickasync(){awaitdoc.addAnnotations({type:square,pageIndex:0,rect,borderWidth:0,opacity:1,fillTransparency:1,fillColor:#000000,color:#000000,borderColor:#000000,borderStyle:solid,dashes:[]});stagecovered;status.textContent已添加普通矩形;};document.querySelector(#mark).onclickasync(){awaitdoc.addAnnotations({type:redact,pageIndex:0,rect,fillColor:#000000,erasure:false});stagemarked;status.textContent已标记尚未应用;};document.querySelector(#apply).onclickasync(){awaitdoc.applyRedactions(all);stageredacted;status.textContent已应用请导出后核查;};document.querySelector(#save).onclickasync(){constdataawaitdoc.exportPDF(true);consturlURL.createObjectURL(newBlob([data],{type:application/pdf}));constadocument.createElement(a);a.hrefurl;a.downloadstage.pdf;a.click();setTimeout(()URL.revokeObjectURL(url),10000);};/script/html启动npx vite--host127.0.0.1打开终端显示的本地地址。这里将 SDK 静态资源复制到public/webviewer初始化的path使用/使阅读器入口落到/webviewer/index.html部署到子目录时应一起调整资源与 PDF 路径。按下面顺序操作确保三份输出来自同一原件添加普通遮挡下载covered.pdf。重新打开原件创建密文标记先下载marked.pdf。对当前标记应用密文再下载redacted.pdf。ComPDF 的密文处理分为标记和应用两个步骤。addAnnotations({ type: redact, ... })只是标记区域本例随后调用applyRedactions(all)才处理标记内容。保留原件在副本上完成验证。图本地教学项目嵌入 ComPDF Web SDK 的实际操作界面目标区域已应用密文。下文仍检查导出文件。3. 独立核对导出文件把三份文件放在同一目录安装读取工具python3-mpipinstallpypdf# verify_outputs.pyfrompathlibimportPathfrompypdfimportPdfReaderfornamein[covered,marked,redacted]:text\n.join(page.extract_text()orforpageinPdfReader(Path(name.pdf)).pages)print(name,{target_found:TEST-SECRET-ALPHAintext,retained_found:KEEP-PUBLIC-BETAintext,})python3 verify_outputs.py本次结果covered target_foundTrue retained_foundTrue marked target_foundTrue retained_foundTrue redacted target_foundFalse retained_foundTrue再用另一阅读器打开输出检查目标区域和周围内容。文字提取结果用于核验这组教学标记不证明图片、附件、表单、元数据或历史内容都已经清理。实际文件还需要检查什么这里处理的是电子 PDF 中已知位置的文字区域。扫描图片、隐藏 OCR 层、多页重复信息以及页面外的附件等要作为独立检查项处理。也不要把删除一个关键词当作完整脱敏检查全部目标出现位置、非目标内容是否保留以及接收方拿到的最终文件。先用自己的教学副本跑通“标记 → 应用 → 导出 → 重开核查”确认结果符合任务再接入业务流程。
PDF 中的一段文字被黑色矩形盖住后画面上可能看不见文件里的文字却未必被删除。判断处理是否生效要检查导出后的文件。下面用 ComPDF Web SDK 对同一份教学 PDF 做三种处理普通矩形遮挡、仅创建密文标记、应用密文。随后重新读取输出核对目标文字和需要保留的内容。先看输出结果教学文件含有两个标记TEST-SECRET-ALPHA是本次处理目标KEEP-PUBLIC-BETA应保持原样。它们是虚构教学文字不是账号、密钥或客户信息。处理方式目标文字能否提取保留标记是否还在普通黑色矩形能在创建密文标记未应用能在应用密文后导出本次未提取到在图三个真实输出 PDF 的独立渲染与文字提取核对。仅创建密文标记不会删除正文导出文件在其他阅读器中的标记外观可能不同不能靠是否出现黑块判断已经应用。这组对照使用 Web SDK 2.9.4。关键 PDF 处理由 ComPDF 完成后面的 Python 读取仅用于独立核验输出。1. 准备最小项目本例在 Node.js 24.18.0、Vite 7.1.9 下运行。创建目录并安装依赖mkdircompdf-redaction-democdcompdf-redaction-demonpminit-ynpminstall--save-exact compdfkit_pdf_sdk/webviewer2.9.4 vite7.1.9mkdir-ppublic/webviewer public/samplescp-anode_modules/compdfkit_pdf_sdk/webviewer/dist/. public/webviewer从SDK 试用许可取得 Web 许可在项目根目录创建.env.localVITE_COMPDF_LICENSEYOUR_WEB_SDK_LICENSE这是 Web SDK 许可不是 Cloud API 的x-api-key。许可配置见添加 Web 许可密钥。公开示例只保留占位符实际许可单独配置。把待检查的 PDF 放到public/samples/redaction-source.pdf。如果需要快速制作与下文坐标对应的最小教学输入可以运行python3-mpipinstallreportlab# make_sample.pyfromreportlab.pdfgenimportcanvas ccanvas.Canvas(public/samples/redaction-source.pdf,pagesize(595,842))c.setFont(Helvetica,18)c.drawString(60,500,TEST-SECRET-ALPHA)c.drawString(60,410,KEEP-PUBLIC-BETA)c.save()python3 make_sample.py配图中的输入另加了品牌和中文教学说明两个标记的位置与上面的最小输入相同。实际文件需要按自己的页面坐标选区域不能照搬矩形。2. 添加普通遮挡再创建密文标记在根目录保存下面的index.html!doctypehtmlhtmllangzh-CNmetacharsetUTF-8titlePDF 密文验证/titlestylebody{font-family:sans-serif;margin:16px;}button{margin:0 6px 10px 0;padding:8px;}#viewer{height:80vh;}/stylebuttonidresetdisabled重新打开原件/buttonbuttonidcoverdisabled添加普通遮挡/buttonbuttonidmarkdisabled创建密文标记/buttonbuttonidapplydisabled应用密文/buttonbuttonidsavedisabled下载当前 PDF/buttonpidstatus正在加载/pdividviewer/divscripttypemoduleimportWebViewerfromcompdfkit_pdf_sdk/webviewer;conststatusdocument.querySelector(#status);constcoreawaitWebViewer.init({path:/,pdfUrl:/samples/redaction-source.pdf,license:import.meta.env.VITE_COMPDF_LICENSE},document.querySelector(#viewer));constdoccore.docViewer;letstagesource;doc.addEvent(documentloaded,(){document.querySelectorAll(button).forEach(bb.disabledfalse);status.textContent原件已打开;});// Web SDK 的页面坐标以左上角为原点pageIndex 从 0 开始。constrect{left:55,top:320,right:310,bottom:353};document.querySelector(#reset).onclickasync(){awaitcore.UI.loadDocument(/samples/redaction-source.pdf);stagesource;};document.querySelector(#cover).onclickasync(){awaitdoc.addAnnotations({type:square,pageIndex:0,rect,borderWidth:0,opacity:1,fillTransparency:1,fillColor:#000000,color:#000000,borderColor:#000000,borderStyle:solid,dashes:[]});stagecovered;status.textContent已添加普通矩形;};document.querySelector(#mark).onclickasync(){awaitdoc.addAnnotations({type:redact,pageIndex:0,rect,fillColor:#000000,erasure:false});stagemarked;status.textContent已标记尚未应用;};document.querySelector(#apply).onclickasync(){awaitdoc.applyRedactions(all);stageredacted;status.textContent已应用请导出后核查;};document.querySelector(#save).onclickasync(){constdataawaitdoc.exportPDF(true);consturlURL.createObjectURL(newBlob([data],{type:application/pdf}));constadocument.createElement(a);a.hrefurl;a.downloadstage.pdf;a.click();setTimeout(()URL.revokeObjectURL(url),10000);};/script/html启动npx vite--host127.0.0.1打开终端显示的本地地址。这里将 SDK 静态资源复制到public/webviewer初始化的path使用/使阅读器入口落到/webviewer/index.html部署到子目录时应一起调整资源与 PDF 路径。按下面顺序操作确保三份输出来自同一原件添加普通遮挡下载covered.pdf。重新打开原件创建密文标记先下载marked.pdf。对当前标记应用密文再下载redacted.pdf。ComPDF 的密文处理分为标记和应用两个步骤。addAnnotations({ type: redact, ... })只是标记区域本例随后调用applyRedactions(all)才处理标记内容。保留原件在副本上完成验证。图本地教学项目嵌入 ComPDF Web SDK 的实际操作界面目标区域已应用密文。下文仍检查导出文件。3. 独立核对导出文件把三份文件放在同一目录安装读取工具python3-mpipinstallpypdf# verify_outputs.pyfrompathlibimportPathfrompypdfimportPdfReaderfornamein[covered,marked,redacted]:text\n.join(page.extract_text()orforpageinPdfReader(Path(name.pdf)).pages)print(name,{target_found:TEST-SECRET-ALPHAintext,retained_found:KEEP-PUBLIC-BETAintext,})python3 verify_outputs.py本次结果covered target_foundTrue retained_foundTrue marked target_foundTrue retained_foundTrue redacted target_foundFalse retained_foundTrue再用另一阅读器打开输出检查目标区域和周围内容。文字提取结果用于核验这组教学标记不证明图片、附件、表单、元数据或历史内容都已经清理。实际文件还需要检查什么这里处理的是电子 PDF 中已知位置的文字区域。扫描图片、隐藏 OCR 层、多页重复信息以及页面外的附件等要作为独立检查项处理。也不要把删除一个关键词当作完整脱敏检查全部目标出现位置、非目标内容是否保留以及接收方拿到的最终文件。先用自己的教学副本跑通“标记 → 应用 → 导出 → 重开核查”确认结果符合任务再接入业务流程。
平方复杂度无法被常规优化消除｜TaoToken 统一 Key 通道实测)
