Identity-preserving character replacement for Codex — 人物一致性、Q版角色替换、服饰控制与写真底图库工作流。
PersonaSwap Studio is a reusable Codex skill for placing a stable person or character identity into a new photograph while controlling exactly what changes: face and hair, the whole identity, identity plus wardrobe, or a broader scene recreation.
它解决的不只是“换脸”，而是完整的人物替换流程：先建立稳定角色参考，再确认替换范围、服装规则和底图约束，最后生成并检查人物一致性。
The photographed subject is fully replaced by the supplied 2D chibi character. The beach backdrop, framing, drink, and straw interaction remain recognizable.
| Original base / 原始底图 | Chibi replacement / Q版完整替换 |
|---|---|
 |
 |
The repository includes the authorized 120-image Travel Sand (2005) base set as one downloadable archive, plus a UTF-8 asset index and labeled contact sheet for browsing:
The individual JPEGs are packaged inside the ZIP to keep the repository tree tidy. Most images have a long edge around 1200 px and are best treated as pose, framing, scene, palette, or replacement-method references rather than high-resolution production masters.
- Identity kit with turnaround views and facial close-ups
- Four replacement levels, from face-and-hair edits to identity-led recreation
- Literal 2D/chibi character compositing without unwanted humanization
- Independent wardrobe control: preserve, refresh, specify, or fully restyle
- Indexed base-image library with quality, watermark, and provenance checks
- Explicit scene invariants for pose, gaze, hands, props, crop, and texture
- QA rules for facial drift, pasted edges, malformed hands, and accidental scene changes
- Latest-instruction guard so retracted or conflicting prompts are not reused
| Mode | Changes | Preserves |
|---|---|---|
| A | Face and hair | Body, clothing, pose, props, scene |
| B | Full identity and proportions | Outfit category, pose, props, scene |
| C | Full identity and wardrobe | Scene, camera, pose, gaze, props |
| D | Identity-led recreation | Approved identity and requested direction |
Clone the repository directly into your Codex skills directory:
git clone https://github.com/thjyy/personaswap-studio.git "$env:USERPROFILE\.codex\skills\identity-preserving-photo-replacement"Restart Codex or begin a new task, then invoke $identity-preserving-photo-replacement or describe a person/character replacement request naturally.
- Upload several clear photos or a character turnaround.
- Build and approve the identity reference kit.
- Choose the visual direction, replacement mode, and wardrobe rule.
- Supply a base image or select one from the indexed library.
- Generate the replacement and review identity, hands, props, clothing, and background invariants.
.
├── SKILL.md
├── agents/
│ └── openai.yaml
├── references/
│ ├── base-library-intake.md
│ ├── execution-and-qa.md
│ ├── identity-kit.md
│ └── intake-and-modes.md
├── base-images/
│ └── travel-sand-2005/
│ ├── travel-sand-2005-base-images.zip
│ ├── asset-index.csv
│ ├── contact-sheet.jpg
│ └── README.md
├── RIGHTS.md
└── assets/
├── original-base-example.jpg
└── chibi-scene-swap-example.png
Use images you own or are authorized to edit. Keep third-party watermarks intact; watermarked previews should be treated as composition or mood references rather than final edit targets. Avoid deceptive impersonation and obtain consent when working with identifiable people. The bundled photographic assets have separate rights terms described in RIGHTS.md.
Recommended GitHub topics:
codex-skill · openai-codex · image-generation · image-editing · identity-preservation · character-replacement · face-swap · chibi · ai-photography · prompt-engineering