[{"data":1,"prerenderedAt":269},["ShallowReactive",2],{"current-page-zh-cun-zhao":3},{"id":4,"title":5,"body":6,"card_image":89,"cover":67,"description":257,"extension":258,"featured":259,"layout":260,"meta":261,"navigation":259,"og_image":262,"path":263,"seo":264,"stem":265,"tags":266},"directory/zh/dir/cun-zhao.md","寸照",{"type":7,"value":8,"toc":248},"minimal",[9,12,27,30,40,46,60,63,70,74,77,84,90,93,96,102,108,111,117,120,126,129,132,139,142,165,168,171,174,177,190,229,232,236,239,242,245],[10,11,5],"h1",{"id":5},[13,14,15,19,20],"p",{},[16,17,18],"strong",{},"下载安装包","：",[21,22,26],"a",{"href":23,"rel":24},"https://pan.quark.cn/s/62cc6b4437b3",[25],"nofollow","夸克网盘",[13,28,29],{},"也可以用微信扫下面的小程序码，直接打开寸照小程序。",[13,31,33,34],{"align":32},"center","\n  ",[35,36],"img",{"src":37,"width":38,"alt":39},"/projects/cun-zhao/mini-program.jpg",360,"寸照微信小程序码",[13,41,42],{"align":32},[43,44,45],"b",{},"微信扫一扫，打开寸照小程序",[13,47,48,49,54,55,59],{},"办证、考试报名、签证材料，几乎都要交一张电子证件照。网上工具很多，但照片得先上传。寸照基于开源项目 ",[21,50,53],{"href":51,"rel":52},"https://github.com/Zeyi-Lin/HivisionIDPhotos",[25],"HivisionIDPhotos","，是一个完全在本机运行的桌面版。当前版本 ",[56,57,58],"code",{},"0.1.0","。",[13,61,62],{},"选规格、导入照片之后，抠图、单脸校验、裁切、换底都在本地完成，可以导出 PNG 或 JPEG。运行时不装 Python、不要求独显、不发网络请求，照片不出电脑。",[13,64,33,65],{"align":32},[35,66],{"src":67,"width":68,"alt":69},"/projects/cun-zhao/logo.png",128,"寸照 Logo",[71,72,73],"h2",{"id":73},"它解决什么问题",[13,75,76],{},"电子证件照麻烦的地方通常不在「拍一张」，而在规格。一寸、二寸只是最常见的两种，四六级、教资、学信网采集、社保卡、各国签证，像素、底色、文件大小都不一样。",[13,78,79,80,83],{},"寸照把常用规格收进一个列表，目前是 ",[16,81,82],{},"201 种","。首页按分类浏览，也可以直接搜名称或尺寸。",[13,85,86],{},[35,87],{"alt":88,"src":89},"首页：选规格、导入照片、一键换底","/projects/cun-zhao/index-1.png",[13,91,92],{},"界面只有两页：首页选规格，制作页看结果。没有登录、没有订单、没有摄像头拍摄，也不做美颜和换装。部分考试明确写了「不得修图」，这种场景请以报考机构的要求为准。",[71,94,95],{"id":95},"两种用法",[13,97,98,101],{},[16,99,100],{},"导入证件照","：做人脸检测，再按证件框裁切。适合从生活照做成标准电子照。输出标准照、高清照和透明底。",[13,103,104,107],{},[16,105,106],{},"一键换底","：只抠图换底色，不按证件框裁。适合构图已经差不多、只是底色不对的照片。",[13,109,110],{},"制作页左侧是当前规格和原图，中间预览，右侧换底色、导出。底色用规格预设，也可以自己填 HEX。换色只重新合成，不会把推理再跑一遍。",[13,112,113],{},[35,114],{"alt":115,"src":116},"制作页：标准照预览、换底、导出","/projects/cun-zhao/index-2.png",[13,118,119],{},"规格可以按名称、像素、毫米搜索，比如「一寸」「295x413」「教师」。同名规格可能有多条，点进去看备注和尺寸再决定。",[13,121,122],{},[35,123],{"alt":124,"src":125},"搜索规格：例如教师资格相关尺寸","/projects/cun-zhao/index-3.png",[13,127,128],{},"批量也支持：可以多选图片，或在制作页继续拖入 PNG、JPEG、WebP。生成是串行的，某一张没脸或脸太多时只标记那一张。",[71,130,131],{"id":131},"技术上怎么做的",[13,133,134,135,138],{},"HivisionIDPhotos 原仓库是 Python 流水线。桌面版没有包一层 Python，而是把 ",[56,136,137],{},"hivision/creator/"," 这条链路用 Rust 重写，算法对齐原实现。界面用 Tauri 2 + React。",[13,140,141],{},"推理走 ONNX Runtime CPU（1.28）：",[143,144,145,152],"ul",{},[146,147,148,151],"li",{},[16,149,150],{},"MODNet"," 抠图，后面补洞，再用 alpha 引导滤波把发丝软边收一收",[146,153,154,157,158,161,162],{},[16,155,156],{},"RetinaFace"," 做人脸检测，必须恰好一张脸，否则报 ",[56,159,160],{},"NO_FACE"," 或 ",[56,163,164],{},"MULTI_FACE",[13,166,167],{},"IPC 只传文件路径。本机 M 系列上，一张约 576×768 的图，release 全流程大概 0.6 秒；Windows 无独显机器一般 1～3 秒能出一张一寸标准照。",[13,169,170],{},"JPEG 导出时，如果规格写了 KB 上限，会从质量 95 往下减，直到体积落进限制。PNG 会写入 DPI。",[13,172,173],{},"明确没做的：自定义尺寸入口、GPU、美颜、旋转对齐、排版照。",[71,175,176],{"id":176},"下载和安装",[13,178,179,180,183,184,189],{},"源码和说明在项目仓库里。安装包可从 ",[21,181,26],{"href":23,"rel":182},[25]," 下载，也可以在 ",[21,185,188],{"href":186,"rel":187},"https://github.com/yuanmomoya/cun-zhao-package/releases",[25],"cun-zhao-package Releases"," 获取。",[191,192,193,206],"table",{},[194,195,196],"thead",{},[197,198,199,203],"tr",{},[200,201,202],"th",{},"平台",[200,204,205],{},"说明",[207,208,209,221],"tbody",{},[197,210,211,215],{},[212,213,214],"td",{},"macOS 12+（Apple Silicon）",[212,216,217,220],{},[56,218,219],{},".dmg","，未签名，首次请右键 →「打开」",[197,222,223,226],{},[212,224,225],{},"Windows 10/11 x64",[212,227,228],{},"NSIS 安装包，当前用户安装；未签名时 SmartScreen 选「仍要运行」，需要 WebView2（Win11 一般自带）",[13,230,231],{},"建议 64 位 CPU、内存 8GB 左右、磁盘预留约 300MB。不要求独显，不要求本机装 Python。",[71,233,235],{"id":234},"适用以及不适合","适用，以及不适合",[13,237,238],{},"比较适合：自己电脑上临时做一张报名照、换个底色、按像素导出，不想把证件照传到网上。",[13,240,241],{},"不太适合：指望它当修图软件、拍证件照工作室、或者报考机构禁止任何后期处理的场景。人脸必须清晰、单人、正面。",[13,243,244],{},"代码按 Apache-2.0 开源。人脸检测和抠图都在本地，不上传照片。",[13,246,247],{},"开发笔记会放在公众号「程序员小袁」。",{"title":249,"searchDepth":250,"depth":250,"links":251},"",2,[252,253,254,255,256],{"id":73,"depth":250,"text":73},{"id":95,"depth":250,"text":95},{"id":131,"depth":250,"text":131},{"id":176,"depth":250,"text":176},{"id":234,"depth":250,"text":235},"完全在本机运行的证件照工具。选规格、导入照片，抠图、裁切、换底都在本地完成，照片不上传。","md",true,"wide",{},null,"/zh/dir/cun-zhao",{"title":5,"description":257},"zh/dir/cun-zhao",[267,268],"桌面工具","证件照",1791702161548]