hongye007/open-pose-costume

Open Pose & Costume 是一个面向角色设计、绘画练习与 AI 创作的中英文参考工作台。它把姿势、服饰、人物三个参考库放在一起，让你在搭配台组合参考，再把组合描述和原图发送到你自行配置的生图服务。资料库是较稳定的部分；生成结果取决于所选模型与服务。

它提供什么

README 记录的资料规模为 288 组姿势、1,439 个姿势视角、1,407 套服饰、1,499 张人物参考，共 4,345 张参考图，统计截至 2026-10-30，且包含扩展分类（项目 README）。你可以用中文或英文按名称、关键词、编号及多词检索，按分类筛选排序、切换姿势视角、查看缩略图与原图，并把收藏和搭配保存在当前浏览器。分享链接会保留语言、筛选条件和参考选择（项目 README）。

搭配与生成的流程

先选一个姿势和一套服饰，加入搭配台；也可以从人物库选择人物，或上传一张可选人物参考图。人物参考用于保留身份与外貌，姿势和服饰参考控制动作与穿搭。组合描述会随选择更新，可直接复制用于其他工具（项目 README）。

如果要使用站内生成，需在设置中填写生图服务地址、API Key、模型、尺寸与质量。默认服务地址是 https://atomflow.vip，默认模型是 gpt-image-2；接口必须支持 OpenAI 兼容的 multipart POST /v1/images/edits，姿势与服饰原图放入 image[]，选人物参考时再增加一张。浏览器直接请求该服务，因此服务需允许 CORS，网页需使用 HTTPS 或本机 HTTP 地址。姿势和服饰缺一项就不能开始生成；有结果后可编辑描述重新生成，也可在双列或叠加视图中对照。实际效果取决于模型、描述和服务配置，费用由该服务收取（项目 README）。

配置、隐私与数据边界

设置保存在当前浏览器。API Key 默认只存于当前会话；勾选“记住密钥”才写入本地存储，并可在设置中清除。密钥不会进入分享链接或仓库。本地上传的人物参考图（PNG、JPG、WebP，最大 10 MB）只保留在页面内存，关闭搭配台后仍可用，但刷新或关闭页面就会清除；只有点击生成时才会发送到所配置的服务（项目 README）。

网页直接加载原站图片，可用性取决于上游站点。人物库元数据来自 AI Portrait Gallery，人物原图并未打包进本仓库。同步只更新上游元数据，不执行上游网页代码，也不下载图片（项目 README）。

本地运行与授权

本地开发需要 Node.js 22.12+。文档说明默认端口 5199 被占用时进程会退出，可以另选空闲端口。推送到 main 后 GitHub Pages 会先运行测试和构建再部署；dist/ 也可部署到其他静态托管，例如 Cloudflare Pages（项目 README）。

代码使用 MIT 许可，但图片与上游数据各有权利限制（LICENSE）。姿势与服饰原站允许在作品制作中参考、编辑和商用，但禁止再分发、转载或转售图片数据本身，包括加工后的图片。人物库原站标注 CC0 1.0，同时请求不要转载其图片；人物均为 AI 生成的虚构角色，复用素材前请核对来源说明（SOURCES.md、第三方声明）。另有一个配套 Codex skill，可通过自然语言执行同样的姿势+服饰+人物生成流程（配套 Skill）。