【开源评测】AI Pose Gallery 中文版:图库、生成工作台与 ComfyUI 接线,许可不能只看 MIT
文章版本:V2.4.0
取证基准:commit19ea0e586b32f8cac588b6fdfbed4cfd15db05b7(2026-11-01 取证)|L3 有界静态取证通过|无运行实测
项目:anhao/ai-pose-gallery-zh|累计 Stars 4,693|近 7 天新建仓库总 Stars 排序第 2(非 Weekly Trending 名次)|源代码有限范围 MIT,素材另受权利限制
作者:Valhalla Matrix治理实验室
文章目录
- 【开源评测】AI Pose Gallery 中文版:图库、生成工作台与 ComfyUI 接线,许可不能只看 MIT
- 一、前言:先拆穿一个常见误读
- 1.1 这个项目不只是“中文翻译图库”
- 1.2 目标读者
- 1.3 行业痛点
- 二、项目整体概况
- 2.1 核心定位
- 2.2 取证快照元数据(客观可核验)
- 2.3 技术形态一句话画像
- 三、技术拆解:数据如何流向 Web 与节点
- 3.1 整体数据流
- 3.2 同一份素材同时接入 Web 与节点工作流(2.1)
- 3.3 前端不只是一个索引页(2.2)
- 3.4 本地存储的可观测性观察点(2.3,重点)
- 3.5 数据规模数字的口径(2.4)
- 四、L3 取证与可复现边界
- 4.1 取证方式(合规浅克隆,不全量抓取)
- 4.2 完整性证据
- 4.3 L3 取证门含义
- 五、风险、许可与不可越过的结论
- 5.1 许可红线:MIT 只覆盖源码,不覆盖素材(核心)
- 5.2 内容合规与未成年人保护
- 5.3 费用、隐私与链路透明度
- 5.4 不能越过的结论
- 六、落地建议
- 6.1 借鉴工程结构,替换授权素材
- 6.2 分场景最小验证路径
- 6.3 上线前检查清单
- 七、评测结论
一、前言:先拆穿一个常见误读
1.1 这个项目不只是“中文翻译图库”
仓库名容易让人以为它只是把一个姿势参考图库翻译成中文。核对固定 commit 的实际文件后可以确认,当前 README 描述的形态已经超出静态翻译:
- 三类图库整合:姿势库、服装库、人像库,并提供组合配方;
- 生成工作台:前端可直接组织参考图与参数;
- ComfyUI 节点接线:提供 Python 节点,把图库素材接进本地绘图工作流。
因此评估时必须把三件事分开记账:代码可复用性、素材授权状态、外部模型接线方式——尤其最后两项,正是这个仓库最容易被“MIT”标签一笔带过、却最容易踩坑的地方。
1.2 目标读者
AIGC 应用开发者、ComfyUI 工作流搭建者、前端/全栈工程师、开源选型与法务合规人员、素材库类产品架构师。
1.3 行业痛点
做 AI 绘图参考库类产品,常见三个工程与合规盲区:
- 把“源码 MIT”误读成“整仓随便商用”,忽略图片、原始数据的独立权利声明;
- 只看到前端页面跑得通,没核查本地存储失败反馈、外部请求链路等静默行为;
- 直接把第三方图库素材打包进商业产品,埋下侵权与未成年人保护隐患。
本文基于 SafeNet 合规浅克隆与 L3 有界静态取证,原创拆解其前后端与节点实现、存储行为观察点和授权边界,不转载 README 长文,不启动模型、不上传图片、不展示任何敏感素材。
二、项目整体概况
2.1 核心定位
AI Pose Gallery 中文版是一个以参考图库为数据底座、向前端工作台与 ComfyUI 双端输出素材的应用:同一份图库数据既服务浏览器内的浏览、配方组合与生成调用,也通过插件节点进入 ComfyUI 工作流。
2.2 取证快照元数据(客观可核验)
| 项目 | 本次观察(快照时点) |
|---|---|
| 仓库 | anhao/ai-pose-gallery-zh |
| 排名口径 | 近 7 天新建仓库按累计总 Stars排序第 2,不是Weekly Trending 名次 |
| Stars | 4,693(累计总数,不是本周新增数) |
| 代码版本 | 19ea0e586b32f8cac588b6fdfbed4cfd15db05b7 |
| Git 文件树 | 8,805 个条目;仅用于目录选取,不代表全部文件被读取 |
| 有界检出 | 28 个文件,逐文件 Git blob 与 SHA-256 已复核 |
| 素材规模声明 | README 声明 4,345 条参考数据 + 8,690 张本地图片(作者声明,本次未下载复算) |
| 许可证 | 源代码有限范围 MIT;图片与原始数据不适用 MIT,含不得商用限制 |
| 运行与测试 | 未执行:未编译、未启动、未调用模型、未上传图片、未启动 ComfyUI |
2.3 技术形态一句话画像
前端 React/TypeScript 应用 + 浏览器扩展数据访问层 + ComfyUI Python 节点 + 服务端代理接线,背后是大规模本地参考图库。它更接近“素材数据 + 双端接线样本”,而不是一个从零自研的生图模型。
三、技术拆解:数据如何流向 Web 与节点
3.1 整体数据流
3.2 同一份素材同时接入 Web 与节点工作流(2.1)
核对comfyui_plugin/nodes.py、routes.py与前端extension.js后,可以确认仓库确实存在两侧实现:一侧是 ComfyUI 插件节点,一侧是浏览器扩展/前端交互层,目标是让同一套图库数据被两种消费方式复用。
边界说明:本次没有启动 ComfyUI,因此只确认了节点代码存在与接线位置,不判定节点兼容性“通过”;节点能否在具体版本 ComfyUI 中正常加载,需要作者/使用者自行实机验证。
3.3 前端不只是一个索引页(2.2)
package.json、src/main.tsx、路由文件与src/api/gallery.ts构成应用入口与数据访问面;worker.ts与functions/api/proxy.ts还暴露出外部请求相关接线(本地任务线程与服务端代理)。
这意味着项目存在联网调用第三方模型的潜在链路,而不只是纯静态本地展示。本次没有发送任何模型请求、也没有上传图片,因此费用产生位置、数据出站范围、失败返回形态都属于后续必须实测确认的验收点,不能凭源码结构直接下结论。
3.4 本地存储的可观测性观察点(2.3,重点)
src/lib/idbStorage.ts基于 IndexedDB 实现生成历史的读写事务,静态阅读发现两点行为特征:
- 读取错误时返回
undefined:调用方拿到的是“空值”,而非显式错误状态; - 写入异常被忽略:写入失败没有向上抛出或给出可见反馈。
由此带来的工程含义是:页面看起来正常,不等于生成历史已经成功落库。用户可能在不知情的情况下丢失历史记录。
定性声明:以上是静态代码行为观察,用于提示后续验收方向,不是安全漏洞结论;是否构成实际缺陷,需结合真实 IndexedDB 异常场景(配额不足、隐私模式、存储被清除等)复现验证。
3.5 数据规模数字的口径(2.4)
README 声明 4,345 条参考数据、8,690 张本地图片;Git 树共有 8,805 个条目。但本次仅检出关键文件做静态核验,没有下载图库图像,也没有独立复算记录总数。
因此在任何对外文章或选型文档中,这两个规模数字都必须标注为**“作者声明值”**,不能写成“实测确认规模”。
四、L3 取证与可复现边界
4.1 取证方式(合规浅克隆,不全量抓取)
gitclone--depth1--filter=blob:none --no-checkout --no-tags\[https://github.com/anhao/ai-pose-gallery-zh.git](https://github.com/anhao/ai-pose-gallery-zh.git)- 路由:命中 GH Proxy Primary,仅使用 SafeNet 规划候选;
- 官方对照:GitHub 官方 Git 数据 API 的 commit 与根 tree SHA 已与本地核对;
- 本地取证目录:
repos/anhao__ai-pose-gallery-zh; - 清单文件:
repos/anhao__ai-pose-gallery-zh/.valhalla-l3-manifest.json。
4.2 完整性证据
- Manifest SHA-256:
1ca21decee9a2c44e5bfe071f491fe15677a2a41cd2762118d88d90f5ece98a3 - 所选文件完整性覆盖 100%;这是所选文件覆盖率,既不是全仓代码覆盖率,也不是测试覆盖率。
4.3 L3 取证门含义
L3 = 固定 40 位 commit + 逐文件 blob 校验 + 所选证据覆盖率 ≥ 90% + canonical manifest 绑定,只证明被检查材料可追溯、未被篡改,不授予功能正确性、安全性、生产部署或商业许可认证。
五、风险、许可与不可越过的结论
5.1 许可红线:MIT 只覆盖源码,不覆盖素材(核心)
- LICENSE 明确写出:图片与原始数据不适用源代码 MIT,并带有不得商用的限制;
- GitHub API 返回的许可证字段只能概括源代码部分,不能用“仓库是 MIT”一句话概括整仓;
- 新版素材目录范围可能变动,二次使用前必须逐目录核对素材权利来源与授权条款,不能依赖历史快照结论;
- 结论:源码可按 MIT 参考复用,但图库图片、原始参考数据不得据此直接商用或打包分发。
5.2 内容合规与未成年人保护
- 图库包含敏感成人向素材,项目以 SFW 默认过滤作为前端开关;本次未下载、未展示此类图片;
- 前端开关属于展示层过滤,对面向未成年人的产品并不充分,不能把“默认过滤”当成内容安全合规的完整方案;
- 若做公开产品,需叠加年龄分级、服务端内容策略、访问控制与审核机制。
5.3 费用、隐私与链路透明度
- 第三方模型调用、API Key、上传照片与生成结果均可能产生费用,需明确哪些操作联网、数据交给哪个服务;
- 生成结果与原始照片涉及隐私,应落实最小化收集、留存期限与删除机制;
- 外部请求失败目前缺乏清晰可见的反馈设计,费用扣费与请求失败状态可能用户不可见,上线前必须补全错误提示与对账记录。
5.4 不能越过的结论
- 不把作者声明的素材数量当作实测数据;
- 不把静态观察到的存储行为描述成“已确认漏洞”;
- 不随文搬运图库图片作为文章配图,不宣传未授权素材;
- 不把节点代码存在等同于“ComfyUI 兼容性已验证”。
六、落地建议
6.1 借鉴工程结构,替换授权素材
- 若只学习其“图库 → 配方 → 双端工作流”的工程组织方式,可参考前后端与插件目录划分;
- 素材必须替换为自己拥有明确权利或已获授权的内容,不要把整个图库打包进商业产品;
- 建立独立素材清单:每张图/每条数据登记来源、授权范围、可否商用、可否二次分发。
6.2 分场景最小验证路径
- 本地 ComfyUI 链路:使用合法、已授权的非敏感测试图,验证节点加载、参数映射与出图稳定性,记录版本兼容矩阵;
- 云协议链路:在独立测试环境验证
proxy.ts类代理请求,记录每次请求的费用、超时与失败返回; - 存储可靠性:先修复/补强 IndexedDB 失败反馈(错误提示 + 导出备份),再扩展更多生成入口,避免历史静默丢失。
6.3 上线前检查清单
- 素材授权逐目录复核,源码 MIT 与数据权利分开声明
- SFW 过滤之外补充服务端内容策略与未成年人保护措施
- 联网请求清单(接口、数据内容、费用、留存周期)
- 存储读写失败可见通知与备份导出
- ComfyUI 节点在目标版本的兼容性实测记录
七、评测结论
AI Pose Gallery 中文版的工程价值在于提供了一条从参考图库、组合配方到 Web 工作台与 ComfyUI 节点的完整接线样本,目录分层清晰、双端复用思路明确,值得前端与 AIGC 应用开发者参考其架构组织。
它最大的约束同样突出:素材权利边界严于源码许可——MIT 只覆盖源代码,图库图片与原始数据另有不得商用限制;叠加敏感内容过滤、第三方模型费用与隐私、本地存储可观测性等问题,决定了它适合作为“结构参考与学习样本”,不适合直接整体打包商用。
选型一句话结论:学它的工程骨架,换掉它的素材来源;先补可见性与合规,再谈产品化。
标签:ComfyUI、AI 绘画、前端工程、开源项目评测、开源合规
推荐分类:人工智能 → AIGC / 图像生成,或 前端开发 → 项目实战
合规声明:本文仅对固定 commit 做静态结构分析,未启动项目、未调用模型、未上传图片,未下载或展示任何图库素材;源码许可与素材权利严格分账,任何商用、二次分发须自行完成素材授权与内容合规审查。