我用Flutter手寫了一款商業(yè)級文檔掃描App全程本地處理、數(shù)據(jù)不出設(shè)備附完整源碼寫在前面本文分享一款全本地文檔掃描App的完整技術(shù)方案與源碼。從邊緣檢測、曲面展平到離線OCR、PDF加密全部用純Dart算法實(shí)現(xiàn)不調(diào)用任何云端API。文章末尾附完整工程源碼下載分三部分。一、為什么你需要一款不聯(lián)網(wǎng)的掃描App先問三個(gè)直擊靈魂的問題你手機(jī)里裝的掃描App拍照后圖片到底去了哪里身份證、銀行卡、合同……這些最敏感的資料有沒有上傳到某臺云服務(wù)器免費(fèi)版的水印、付費(fèi)版的訂閱、會(huì)員才能用的高清導(dǎo)出你受夠了沒有市面上99%的文檔掃描App走的都是同一條路線拍照 → 上傳云端 → 服務(wù)器做邊緣檢測/透視矯正/OCR → 結(jié)果回傳手機(jī) ↑ 你的敏感數(shù)據(jù)在這里裸奔這條路開發(fā)簡單、算力充足但代價(jià)是用戶隱私。而我開發(fā)的這款安心掃描走的是一條截然相反的路拍照 → 全部本地處理 → 結(jié)果直接存手機(jī) ↑ 零隱私風(fēng)險(xiǎn)零聯(lián)網(wǎng)依賴核心承諾正式安裝包不申請 INTERNET 權(quán)限。從系統(tǒng)層面杜絕數(shù)據(jù)外泄。無賬號、無云同步、無統(tǒng)計(jì)埋點(diǎn)。二、六大功能覆蓋日常所有掃描場景功能一句話說明核心算法文檔掃描拍照/相冊導(dǎo)入→自動(dòng)裁邊→透視矯正→曲面展平→濾鏡→導(dǎo)出PDF五級級聯(lián)邊緣檢測 角點(diǎn)精化 RANSAC曲面展平證件復(fù)印身份證正反面拍一張自動(dòng)排版到A4可加防濫用水印邊緣檢測 A4模板合成證件照拍照→自動(dòng)摳像→換底色白/藍(lán)/紅/黑→標(biāo)準(zhǔn)尺寸裁剪YCbCr膚色保護(hù) 自適應(yīng)洪水填充文字提取離線OCR中英文可復(fù)制存TXTTesseract本地引擎 專業(yè)預(yù)處理管線?圖片壓縮目標(biāo)KB一鍵達(dá)標(biāo)報(bào)名表/網(wǎng)傳材料剛需二分搜索 維度遞降圖片水印斜向平鋪中文水印防資料二次濫用預(yù)渲染圖塊 主線程同步合成三、技術(shù)選型為什么是純Dart不是OpenCV很多人第一反應(yīng)圖像處理為什么不用OpenCV維度OpenCV純Dartimage包包體積30MB0跨平臺編譯需配CMake/NDKAndroid/iOS各一遍零配置調(diào)試需C環(huán)境Dart斷點(diǎn)直達(dá)性能更快文檔掃描場景完全夠用文檔掃描的核心運(yùn)算邊緣檢測、透視變換、二值化在手機(jī)端4ms即可完成純Dart的性能綽綽有余。省下的30MB包體積和跨平臺編譯痛苦才是更大的收益。核心依賴dependencies:flutter:sdk:flutterimage:4.1.7# 純Dart圖像處理pdf:3.11.0# PDF生成 RC4-128加密printing:5.12.0# 本地打印image_picker:1.1.2# 相冊多選provider:6.1.2# 狀態(tài)管理flutter_tesseract_ocr:0.4.31# 本地OCRcrypto:^3.0.3# MD5摘要PDF加密用四、四層架構(gòu)職責(zé)分明依賴單向┌─────────────────────────────────────────┐ │ UI層 (Screens Widgets) │ │ home / camera / crop / pages / export │ │ corner_editor / brush_canvas... │ ├─────────────────────────────────────────┤ │ 狀態(tài)層 (Provider) │ │ ScanProvider RecentsProvider │ │ linkRecents() 雙向聯(lián)動(dòng) │ ├─────────────────────────────────────────┤ │ 服務(wù)層 (Services) │ │ storage / pdf_export / ocr / watermark │ │ compress / id_copy / portrait... │ ├─────────────────────────────────────────┤ │ 算法層 (Processing) │ │ edge_detection / dewarp / perspective │ │ filters / spot_removal / id_composer │ └─────────────────────────────────────────┘每一層只與相鄰層通信UI不直接調(diào)算法算法不關(guān)心UI狀態(tài)。這種隔離讓算法可以獨(dú)立測試UI可以靈活替換。五、核心算法一五級級聯(lián)邊緣檢測4ms搞定80%場景單一Otsu二值化在低對比度場景會(huì)徹底失敗。安心掃描用五級級聯(lián)掩碼逐級兜底/// 五級檢測掩碼依次嘗試任一成功即返回Uint8List?_detectLevel(Uint8Listgray,int w,int h,int level){switch(level){case0:return_otsuLight(gray,w,h);// Otsu亮背景case1:return_otsuDark(gray,w,h);// Otsu暗背景case2:return_gradientFloodFromMag(mag,w,h,thr:30);// 梯度洪水填充case3:return_morphGradient(gray,w,h);// 形態(tài)學(xué)梯度case4:return_textureAnalysis(gray,w,h);// 紋理分析兜底}}配合級聯(lián)早退策略得分超過閾值2.8立即返回不再執(zhí)行后續(xù)級別。實(shí)測模式分辨率耗時(shí)說明實(shí)時(shí)250px4ms五級級聯(lián) 早退覆蓋80%場景精細(xì)500px~30ms五級全開 stdMap無早退六、核心算法二曲面展平——RANSAC 位移映射書本、票據(jù)彎曲導(dǎo)致的文字扭曲用RANSAC擬合文本行拋物線曲率再通過位移映射矯正/// 文本行曲率擬合 位移映射/// 曲率上限 8%防止字形過度拉伸/// 水平校正已禁用數(shù)學(xué)證明 sxx 不引起失真步驟算法作用文本行檢測峰值檢測minPeakGap dh/60定位每行曲率擬合RANSAC二次拋物線找出彎曲趨勢位移映射自然三次樣條 三次Hermite插值平滑矯正重采樣Catmull-Rom雙三次文字邊緣銳利七、核心算法三離線OCR預(yù)處理管線Tesseract原版直接用效果一般關(guān)鍵在預(yù)處理原圖 → 自動(dòng)裁切 → 放大 → 投影輪廓糾偏 → Sauvola二值化 → PSM6識別預(yù)處理圖原圖各一次取較長結(jié)果八、性能實(shí)測數(shù)據(jù)指標(biāo)實(shí)測值Release APK體積99.9 MBDebug APK體積223.9 MB邊緣檢測實(shí)時(shí)4ms250px水印預(yù)覽1200px50ms水印導(dǎo)出3200px~1s圖標(biāo)Tree-shaking99.3%1.6MB→12KB九、競品對比憑什么選擇它維度安心掃描CamScanner白描 數(shù)據(jù)隱私全程本地不出設(shè)備云端OCR需上傳云端OCR需上傳 網(wǎng)絡(luò)權(quán)限正式包不申請INTERNET需要需要 曲面展平RANSACCatmull-Rom閉源無/基礎(chǔ) OCRTesseract離線內(nèi)置云端付費(fèi)云端 PDF加密RC4-128本地付費(fèi)無 水印本地?zé)o廣告水印免費(fèi)版強(qiáng)制水印無 證件復(fù)印A4正反面自動(dòng)排版支持不支持 收費(fèi)免費(fèi)訂閱買斷內(nèi)購十、完整工程源碼下載本項(xiàng)目完整源碼已上傳CSDN因體積限制分為三個(gè)部分下載后請按說明合并 第一部分核心算法庫 數(shù)學(xué)工具下載地址https://download.csdn.net/download/u010972645/93684889包含lib/core/— 數(shù)學(xué)基礎(chǔ)庫image_math.dart形態(tài)學(xué)/Otsu/凸包/softGainlib/services/processing/— 五大核心算法edge_detection.dart— 五級級聯(lián)邊緣檢測dewarp.dart— 曲面展平perspective.dart— 透視矯正filters.dart— 濾鏡 墨跡消除spot_removal.dart— 污點(diǎn)修復(fù)id_composer.dart— 證件A4合成scan_pipeline.dart— 統(tǒng)一處理管線 這部分是整個(gè)項(xiàng)目的算法基石單看這部分就能理解文檔掃描的核心實(shí)現(xiàn)。 第二部分業(yè)務(wù)服務(wù)層 狀態(tài)管理 數(shù)據(jù)模型下載地址https://download.csdn.net/download/u010972645/93684899包含lib/services/— 業(yè)務(wù)服務(wù)pdf_export_service.dartpdf_encryption.dartRC4-128加密ocr_service.dart、watermark_service.dart、compress_service.dartportrait_service.dart人像摳圖、id_copy_service.dartstorage_service.dart、export_flow.dartlib/providers/— ScanProvider RecentsProvider 雙Provider聯(lián)動(dòng)lib/models/— 可序列化數(shù)據(jù)模型scripts/— OCR語言包下載腳本 第三部分UI界面層 平臺工程 完整工程配置下載地址https://download.csdn.net/download/u010972645/93684908包含lib/screens/— 全部頁面首頁/相機(jī)/裁邊/編輯/多頁/證件/導(dǎo)出lib/widgets/— 自定義組件四角編輯器/涂抹畫筆/證件引導(dǎo)框android/ios/— 平臺工程含隱私配置、tessdata資源pubspec.yaml、README.md、完整目錄結(jié)構(gòu)十一、如何合并三部分源碼# 1. 下載三個(gè)壓縮包到同一目錄# 2. 解壓第一部分到項(xiàng)目根目錄# 3. 解壓第二部分到同一根目錄覆蓋合并# 4. 解壓第三部分到同一根目錄覆蓋合并# 5. 安裝依賴flutter pub get--offline# 6. 運(yùn)行flutter run# 7. 打包確認(rèn)無INTERNET權(quán)限flutter build apk--release??環(huán)境要求Flutter 3.44.8stable channel JDK 17 Android SDK 36十二、寫在最后這款A(yù)pp我從0到1開發(fā)了數(shù)月每一行算法代碼都經(jīng)過真實(shí)場景打磨。無論你是計(jì)算機(jī)視覺學(xué)習(xí)者— 想了解純Dart實(shí)現(xiàn)邊緣檢測、曲面展平的工業(yè)級方案Flutter開發(fā)者— 想借鑒四層架構(gòu)、雙Provider聯(lián)動(dòng)、Isolate異步的實(shí)戰(zhàn)經(jīng)驗(yàn)需要一款放心掃描App的用戶— 不想再把身份證上傳到云端這套完整源碼都值得你下載研究。全部本地處理、數(shù)據(jù)不出設(shè)備、永久免費(fèi)。立即下載第一部分核心算法 | 第二部分服務(wù)層狀態(tài)管理 | 第三部分UI平臺工程如果覺得有幫助歡迎點(diǎn)贊、收藏、關(guān)注后續(xù)會(huì)更新16篇系列技術(shù)文章逐篇拆解每個(gè)核心算法的實(shí)現(xiàn)細(xì)節(jié)。