OPC STORY · DEEP CASE REPORT · 2026

HivisionIDPhotos 深度案例报告

西电学生开发者林泽毅(Zeyi-Lin):一个「纯 CPU 离线」的轻量 AI 证件照工具
登 GitHub 热榜第一、两年累计 21.7k★、Docker 拉取 100K+ —— 10 条信源逐条核验

开源工具型 OPC CPU-only 轻量推理 开源 + 在线双轨 信源核验报告
21,721★
GitHub 星标(2026-11-13 API 实测)
热榜第一
GitHub Trending(2024-09-05 · 校方稿)
100K+
Docker 镜像拉取量(页面实测)
百万级
衍生小程序「焕影一新」用户(2024-09 口径)
← 返回「国内 AI 一人公司案例墙」

CONTENTS · 目录

壹

案例档案

Case Profile

HivisionIDPhotos 是 2024 年 9 月中国开源圈最出圈的「实用型 AI 工具」样本之一:一个只需 CPU 即可推理的轻量级 AI 证件照制作算法,由西安电子科技大学学生开发者林泽毅主导开源,上线两周内登 GitHub Trending 热榜第一,被机器之心、量子位等 AI 垂类媒体密集报道,随后演化出覆盖 ComfyUI、微信小程序、C++、网页端的开源衍生生态——是国内「开源工具 + 在线服务」双轨路线的早期范本。

项目
轻量级 AI 证件照制作算法(开源):人像抠图 → 多规格标准证件照 / 六寸排版照生成 → 背景更换,支持纯离线或端云推理,纯离线模式下仅需 CPU 即可快速推理;另含美颜(已上线)与智能换正装(规划中)。Apache-2.0 协议,Python 主语言。
信源:[1] [4]
创业者
林泽毅(网名 Zeyi-Lin / ZeYiLin),西安电子科技大学电子工程学院 2023 级博士研究生(2024-09 时为博一,师从吴家骥教授),隶属学校极创工作室;同时是 SwanLab 与 SwanHub 开源社区的创始人之一,热衷全栈、机器学习、UI/UX 与产品顶层设计。
信源:[2] [3]
前身与闭环
证件照算法源自其参与「互联网+」创新创业大赛的成果;开源之前,团队已基于同一套技术上线小程序「焕影一新」,据作者知乎自述国内使用人数接近 100 万,校方新闻稿口径为「百万级用户」——先做闭源产品验证需求,再将算法层开源。
信源:[2] [3]
公司 / 投资状态
未检索到 HivisionIDPhotos 本身的公司注册、营收或融资公开信息;作者当前以「CPO,情感机器」署名出现在 SwanLab 官网推荐语中(该公司与其学生项目的承接关系未公开披露)。项目本体维持个人主导:GitHub 贡献榜第一名 Zeyi-Lin 独占 400 次 commits,第二名仅 12 次。
信源:[8] [1]
贰

来龙去脉 · 时间线

Timeline
开源前(大赛时期)
「互联网+」大赛成果 → 闭源小程序「焕影一新」
证件照制作算法为参赛成果;基于该代码的小程序在国内已被接近 100 万人使用(作者知乎自述)。[2] 校方稿口径「焕影一新已拥有百万级用户」。[3]
2023-06-18
GitHub 仓库创建
Zeyi-Lin/HivisionIDPhotos 建仓(GitHub API 实测 created_at),此后处于低曝光积累期。[1]
2024-09 上旬
连续多日挂在 GitHub 热榜,量子位介入报道
2024-09-04 量子位报道时已「狂揽 3.2K 星标」,文中实测网页 Demo 并披露技术路线:MODNet 抠图模型经证件照数据微调转 ONNX、MTCNN 人脸检测转 ONNX、CPU 可运行、FastAPI API 服务与 Docker 部署。[2]
2024-09-05 → 09-09
登 GitHub Trending 热榜第一,星标一周从 3.2k 冲至 7.9k
校方新闻稿确认 9 月 5 日趋势榜第一;同时登上智源社区、HelloGitHub 等国内外开源平台热榜,「得到机器之心、量子位、GithubDaily 等国内人工智能领域主流媒体推荐」。案例墙锚点 2024-09-15 即取此爆发窗口。[3]
2024-09-16 → 11-20
爆发后的密集迭代(README 更新日志)
两个月内连续上线:人脸旋转对齐、自定义底色 HEX、社区贡献 C++ 版、野兽模式(内存加载策略)、dpi 与 face_alignment API 参数、排版照裁剪线、五寸相纸与 JPEG 300DPI、美颜 API 参数、六寸/五寸/A4/3R/4R 五种打印排版尺寸。[4]
2024 下半年起
生态化:社区衍生项目矩阵 + 多平台在线服务
README 收录社区衍生:ComfyUI 工作流、微信小程序(Java 后端版与 Uniapp 版)、网页版、C++ 版、Windows GUI 版等;算法同时部署到 SwanHub Demo、HuggingFace Spaces、ModelScope 魔搭、Modelers、Compshare 五个在线入口;官方 Docker 镜像 linzeyi/hivision_idphotos 累计拉取 100K+。[4][5][7]
2025 → 2026
作者重心转向 SwanLab 生态,本项目进入维护态
SwanLab 官网显示林泽毅以「CPO,情感机器」署名;HivisionIDPhotos 仓库最后 push 为 2026-07-03(API 实测),Docker 镜像约 9 个月未更新,v1.3.1 成为最新 tag。[8][1][5]
2026-11-13
本报告实测:星标 21,721、fork 2,532、仍在活跃 Star 增长曲线中
HelloGitHub 页面近 6 天新增 21 星;贡献者 24 人,主创 400 commits 一骑绝尘。[1][6]
叁

创业路径复盘

Key Turns
转折一:先闭源验证需求,再开源收割开发者心智
与多数「先开源再找场景」的学生项目相反,林泽毅的顺序是反过来的:算法先在「互联网+」大赛里打磨,再以小程序「焕影一新」完成百万级用户的闭源商业验证,然后才把算法层开源[2][3]。开源时机也经过思考——他在知乎自述:AIGC 浪潮到来后,「证件照制作这个非常偏图像代码工程落地的场景有点 old 了」,并坦言「当年有做线上海马体的想法」[2]。闭源期赚到的用户认知与场景理解,成为开源后两周登顶热榜的势能。
信源:[2] [3]
转折二:以「CPU-only 纯离线」的技术选型击中爆点
2024 年开源 AI 项目的主流叙事是参数量与 GPU 军备竞赛,HivisionIDPhotos 反其道而行:抠图模型(MODNet + 证件照数据微调)与人脸检测模型(早期 MTCNN,v1.3 升级为 retinaface-resnet50)全部转 ONNX,在无 GPU 的普通电脑上秒级推理[2][7]。这让「内网部署 / 离线环境 / 低配机器」三类长尾需求(高校机房、政企内网、个人旧电脑)全部成为它的铺开场景,也是第三方部署教程密集出现的原因[9][10]。热榜第一的爆点不是模型多强,而是把深度学习工具的使用门槛降到了零 GPU。
信源:[2] [7] [10]
转折三:开源个人品牌的复利——从证件照工具到 SwanLab 生态
热榜之后,作者没有走「融资—公司化—商业化闭源」的常规路径,而是把开源声望沉淀为社区身份:林泽毅作为 SwanLab / SwanHub 开源社区创始人之一,HivisionIDPhotos 的在线 Demo 即托管于 SwanHub,后又铺到魔搭与 HuggingFace;校方稿披露其极创工作室的 SwanLab 项目获中国国际大学生创新大赛(2024)陕西赛区高教主赛道总冠军[3]。2026 年的 SwanLab 官网推荐语中,他已以「CPO,情感机器」署名[8]——证件照项目本身未检索到任何收入披露,它更像是作者开源履历中的「破圈代表作」。
信源:[3] [8]

开源促进了知识的共享和传播,带来了更广泛的协作和共享文化……希望 HivisionIDPhotos 将来能成为一个在 AIGC 领域有影响力的工具类项目,集成开源生态中优秀的 matting 模型和 diffusion 模型,让人人都能拥有自己的「线上海马体」。

—— 林泽毅,西电新闻网采访(2024-09-09),转引自 [3]
肆

产品与商业模式

Product & Business
维度内容说明
产品功能抠图 / 多规格生成 / 排版 / 美颜上传一张照片输出标准证件照与高清 4 通道透明 PNG;覆盖一寸二寸及教师资格证、公务员考试、四六级、签证等规格;六寸/五寸/A4/3R/4R 打印排版;美颜已上线,智能换正装长期处于 waiting 状态
技术路线开源模型组合MODNet 人像抠图模型(经开源证件照数据微调)+ 人脸检测模型(早期 MTCNN → v1.3 retinaface-resnet50),统一转 ONNX 加速;FastAPI 后端 + Gradio Demo 前端;纯 CPU 推理,支持纯离线或端云两种模式
部署形态本地 / API / 在线本地:Python 推理脚本与 Docker(官方镜像 linzeyi/hivision_idphotos);API:FastAPI 服务供第三方集成;在线:SwanHub Demo、HuggingFace Spaces、魔搭 ModelScope、Modelers、Compshare 多入口,HF Space 当前状态 Running
面向客群开发者集成 + 个人用户开发者:以 Docker/FastAPI 自部署做二次集成(衍生出小程序、网页版、C++ 版、ComfyUI 工作流等社区项目);个人用户:在线 Demo 免费应急制作
解决痛点证件照拍摄成本线下照相馆单次数十元、换底/换尺寸需重拍重付费;本工具把「随手拍一次、后续换底换尺寸」的边际成本降为零,主打应急与省钱场景
商业模式开源免费 + 变现载体分离算法层 Apache-2.0 完全免费,项目本体未检索到任何收费、订阅或 API 计价公开信息;变现功能由闭源小程序「焕影一新」(百万级用户)承接,其运营主体与收入未公开
💡 「开源工具 + 在线服务」双轨结构
与先行的 pdf2zh(开源翻译 + pdf2zh.com 在线服务)类似,HivisionIDPhotos 的分发是三层的:算法层开源(GitHub 星标生态)→ 自部署层开放(Docker/API,服务开发者与内网场景)→ 在线层免费托管(SwanHub/HF/魔搭,服务个人用户)。在线层本身不收费,但其作用是把个人用户流量导向闭源小程序,并为作者的 SwanLab 开源品牌持续背书——这是国内学生开发者「以工具养品牌、以品牌养生态」的典型双轨打法。
伍

数据表现

Metrics
指标数值时点信源
GitHub 星标3.2k → 7.9k → 21,7212024-09-04 → 09-09 → 2026-11-13(API 实测)[2][3][1]
GitHub Trending热榜第一(9 月 5 日趋势榜截图)2024-09-05[3]
GitHub Forks / Watch2,532 / 932026-11-13 实测[1]
贡献者结构24 人;主创 Zeyi-Lin 400 commits(第二名 12 次)2026-11-13 实测[1][6]
Docker 拉取量100K+(镜像 linzeyi/hivision_idphotos,v1.3.1)2026-11-13 页面实测[5]
HelloGitHub评分 9.8(16 人评分)、168 点赞、近 6 天 +21 星2026-11 查询[6]
HuggingFace Space211 likes、Running 在线2026-11-13 实测[7]
衍生小程序「焕影一新」用户接近 100 万(作者自述)→ 百万级(校方口径)2024-09[2][3]
媒体热榜推荐机器之心、量子位、GithubDaily;智源社区周榜、HelloGitHub 热榜2024-09[3]
📌 数据口径说明
星标为时点值且会随时间变动:3.2k 与 7.9k 分别为量子位报道日(2024-09-04)与校方新闻稿日(2024-09-09)的历史口径;21,721 为本报告 GitHub API 实测值(2026-11-13)。「焕影一新」百万级用户为作者自述与校方新闻稿双重口径,属开源前闭源产品数据,无第三方独立审计。Docker Hub API 直连核验失败(沙箱网络限制,HTTP 000),改经网页端页面实测成功。
陆

同期同类案例横向对标

Peer Benchmark

将 HivisionIDPhotos 放入案例墙「国内高星个人开源工具」坐标系(对标数据均为案例墙既有核验值,时点 2026-10/11,口径为 domestic-pool 主清单;本案星标为本报告 2026-11-13 实测):

对标项目创业者形态星标(时点)「开源 + 在线」双轨布局信源
HivisionIDPhotos林泽毅(西电博士生)AI 证件照工具(CPU 离线推理)21.7k★(2026-11-13 实测)开源 + 五平台在线 Demo + 闭源小程序承接变现[1]
MoneyPrinterTurboharry0703AI 短视频一键生成器133k+★(案例墙核验值)纯开源,未检索到官方在线服务案例墙既有核验值
GPT-SoVITS花儿不哭(RVC-Boss,B 站 UP 主)少样本音色克隆 TTS64k+★(案例墙核验值)纯开源,社区整合包分发案例墙既有核验值
PDFMathTranslate(pdf2zh)ByaiduPDF 学术文档 AI 全文双语翻译38.3k★(案例墙核验值)开源 CLI/GUI/Zotero 插件 + 官方在线服务 pdf2zh.com,入选 EMNLP 2025 Demo案例墙既有核验值
Umi-OCRhiroi-sora开源离线 OCR 软件48.4k★(案例墙核验值)纯开源离线,解压即用案例墙既有核验值

五者同为中国个人开发者的现象级开源工具,但路线分化明显:MoneyPrinterTurbo、GPT-SoVITS、Umi-OCR 是「纯开源」路线,热度来自开源社区本身;HivisionIDPhotos 与 pdf2zh 则是少数走通「开源工具 + 在线服务」双轨的样本——前者把个人用户导流至闭源小程序、把开发者用户导流至自部署生态,后者直接以官网在线服务承接。就「个人主导度」而言,HivisionIDPhotos 的 400/12 commits 头部集中度,在一众高星项目中属于个人属性最纯粹的梯队[1];就「破圈速度」而言,它是案例墙内唯一有校方官方新闻稿确认「GitHub 热榜第一」的项目[3]。

柒

七维深度分析

Seven Dimensions
维度分析信源
1. 产品功能单点工具的克制迭代:核心链路「人像抠图 → 上下补全 → 智能裁切 → 背景更换 → 排版照生成」全部围绕证件照一个场景;爆发期两个月内快速补齐人脸对齐、dpi 参数、300DPI 打印、五种排版纸型等工程细节,美颜从 Demo 承诺落地为 API 参数;「智能换正装」至今停留在 waiting 状态,成为功能叙事中最长的一张空头支票。[4]
2. 面向客群双客群结构:开发者客群通过 Docker/FastAPI 自部署做产品集成(衍生出微信小程序、ComfyUI、C++、网页版等社区项目,其中仅微信小程序衍生仓库即有多版本并行);个人客群通过五平台在线 Demo 免费使用。真正的付费转化发生在闭源小程序层,开源仓库本身不承载变现。[4][5]
3. 解决痛点证件照是低频、刚需、强规格约束的图像处理场景:线下拍摄成本数十元且换底换尺寸须重拍;通用 AIGC 工具又难以保证「标准规格 + 可打印」。本项目的答案是用确定性的传统管线(抠图+几何裁切+排版)而非端到端生成——效果稳定可复现,代价是解决不了原片姿态与光照问题(见第六行负面评价)。[2]
4. 预估年化营收未检索到公开信息(置信度 C)。项目本体免费开源,无收费/订阅/API 计价披露;闭源小程序「焕影一新」百万级用户但运营主体与收入均未公开。以同类在线证件照服务单次 5-20 元的市场惯例推算其潜在收入规模缺乏依据,本报告不做虚构估算。[2][3]
5. 融资进展未检索到公开信息。项目层面无公司实体、无融资披露的任何线索;作者个人层面的新动态是以「CPO,情感机器」身份出现在 SwanLab 官网(SwanLab 仓库主体为 SwanHubX 组织),其与西电极创工作室学生项目的承接关系未披露。[8]
6. 市场评价正面:机器之心、量子位、GithubDaily 推荐,智源社区开源周榜、HelloGitHub 热榜与 9.8 高分、HF Space 211 likes,第三方部署教程覆盖腾讯云开发者社区等主流技术平台。负面(如实收录):量子位实测认为「抠图感比较明显」「完全从随手拍到证件照还差点意思(也需要碰运气)」;36氪评论区质疑「出图分辨率低,不能解决人像 pose 和 lighting 问题,用途受限」「火的有点莫名其妙」。[3][6][7][2][9]
7. 合规风险人脸数据合规(重点):证件照处理的核心对象是人脸图像,人脸信息属《个人信息保护法》界定的敏感个人信息,处理须取得单独同意并遵循最小必要原则。本项目的架构选择与此高度相关——纯离线/自部署模式下人脸数据不出本机,天然规避了云端人脸库风险,这正是其在政企内网、高校机房场景铺开的合规优势;但在线 Demo(HF/魔搭等)与「焕影一新」小程序涉及人脸信息上传,其告知同意、存储期限与删除机制均未见公开披露,构成待验证项。开源许可与商用:Apache-2.0 允许商用、修改与闭源分发,只需保留版权与许可声明——社区衍生小程序的密集出现与此许可宽松度直接相关;但项目依赖的第三方模型权重(MODNet 等适用其自身许可)商用合规需使用方自行确认,仓库层面未检索到统一的模型许可声明。[2][4]
捌

争议与不确定性

Open Questions
⚠️ 商业化程度与维护节奏(截至 2026-11-13 检索)
① 商业化程度未证:项目本体零收入披露,「焕影一新」小程序的运营主体、付费模式与收入均未检索到公开信息,「百万级用户」为作者自述 + 校方口径,无第三方审计——本案例在案例墙中的定位因此是「开源影响力型 OPC」而非「营收型 OPC」。② 维护进入低缓期:仓库最后 push 2026-07-03(API 实测),官方 Docker 镜像约 9 个月未更新、最新 tag v1.3.1,美颜功能承诺多年后仍以 API 参数形式浅层存在,「智能换正装」持续 waiting。③ 星标增速放缓:HelloGitHub 显示近 6 天仅 +21 星,年增量较 2024 年爆发期大幅回落。④ 机器之心报道原文 URL 未检索到,其推荐事实目前仅能追溯至校方新闻稿的转述记载。
📌 身份与口径的两点说明
① 「一人公司」口径:本案例严格说是「学生开发者主导的开源项目」,无公司实体证据,主创 400 commits 对第二名 12 次的碾压式集中度是个人属性最硬的证据;但西电稿署名通讯员即含林泽毅本人,且项目从大赛到小程序均依托学校极创工作室资源,纯粹的「一人」叙事应打上校园孵化协作的补注。② 「热榜第一」口径:校方新闻稿以 9 月 5 日 GitHub 趋势榜截图佐证「热榜第一」,为单一官方信源 + 截图证据,未见 GitHub 官方存档级印证,采信时已按校方一手口径标注。
本案的样本价值
HivisionIDPhotos 证明了 OPC 在「确定性小工具」赛道的独特打法:不卷模型参数,而卷部署门槛(CPU-only)与场景规格(按寸排版);不急着商业化,而让闭源小程序在前台赚钱、开源仓库在后台积累品牌。对一人开发者而言,它示范了「闭源产品验证 → 开源破圈 → 开源品牌反哺下一个生态(SwanLab)」的三段式路径——这也是它与案例墙内纯开源项目(Umi-OCR)、纯营收项目(sitesfy、Leadmore AI)最本质的分野。其隐忧同样典型:单点工具的天花板清晰、维护不可持续,最终以「生态化退出」而非「产品化持续经营」收束,是个人开源项目生命周期的常见终局。
捌

捌·附 · 资料来源与事实核查

Sources & Fact-check

本深度报告共引用 10 条信源,按文中首次出现顺序连续编号。上标颜色与文末徽章同色同义:绿 = 已核验(≥2 独立信源交叉),蓝 = 多源印证(单一权威信源可回溯),黄 = 部分映证(自述/转述/单一 B 级信源)。

事实核查小结:本深度报告共引用信源 10 条。核验标签分布:🟢 已核验(verified)3 条、🔵 多源印证(cross)5 条、🟡 部分映证(partial)2 条。信源评级分布:A 级 2 条(GitHub API 一手实测 + 项目一手 README,原文/原文数据回溯完成)、B+ 级 6 条(量子位/36氪、西电官方新闻稿、Docker Hub、HelloGitHub、HuggingFace、SwanLab 官网)、B 级 1 条、C 级 1 条(均为第三方教程佐证)。关键数字三重交叉:星标 21,721 由 GitHub API 与 HelloGitHub 双平台一致;「热榜第一」由校方新闻稿截图佐证;「百万级小程序用户」为作者自述 + 校方口径双重一致但无第三方审计(已显式标注)。核验失败与处理:① 机器之心报道原文 URL 未检索到——其推荐事实以西电官方新闻稿 [3] 记载为准,正文一律按 [3] 引用,不单独设条目;② Docker Hub API 直连失败(沙箱网络限制,HTTP 000)——改经网页端实测成功,数据可用;③ SwanLab 仓库星标查询因组织名解析失败未获数值——不影响本报告结论,未引用。GitHub README 首次抓取超时一次,改经 GitHub API(Accept: raw)重试成功。全部 URL 为检索过程实际命中页面,未发现伪造链接。