ip-studio

IP Studio

ip-studio 是一个可由 Codex 或兼容 AI Agent 加载的角色生产 Skill。你可以交给它零散的身份线索、一张已经认可的角色图，或一个已锁定的角色包；它会把这些材料整理成稳定角色，并继续制作传播视觉、运行时 2D 动态角色素材或 Codex v2 桌宠。

它负责补全角色与运行合同、生图、版本管理和文件校验。角色身份与动态结果会进行所需的看图检查；普通静态衍生视觉在生成后直接交付，不进入角色库，也不会自动筛选或重生。你只需要决定会改变角色身份、内容重点或既有安装的事项。

你会得到什么

• 建立或修改角色：得到完整角色档案、角色说明、单张正式主参考图和可回读的历史版本。
• 制作衍生视觉：得到头像、主页横幅、资料卡、文章封面、说明图或正文插图，以及生成前可确认的完整提示词和有序图片输入；成图直接交付。
• 制作动态角色素材：根据游戏、网页或应用中的真实状态生产者和消费者，得到静态方向图、循环、单次动作、过渡、效果帧、透明 PNG 图集、逐帧文件、无损预览和运行时 manifest；不会为静态 NPC 或无方向角色虚构动作。
• 制作 Codex 桌宠：得到包含九组应用状态、十六个注视方向和 QA 证据的 Codex v2 宠物目录，并可在确认后安装到本机 Codex。

静态衍生视觉、动态角色素材和桌宠都可以读取角色包作为共同身份输入，但只有角色身份和真正可运行的动态包需要长期保存。只用一张已认可角色图制作头像、横幅、封面、说明图或正文插图时也可以直接生成，不强迫先建角色包；无论采用哪种角色来源，普通静态成图都不会写回角色库。

直接开始： 安装 Skill，并选择一条可直接复制的请求。

效果展示

下面用仓库内的“灯灯”示例展示稳定的角色身份、持续复用的内容视觉和 Codex v2 平台适配。动态角色的共同生产链同时适用于游戏小人、应用助手、网页角色和其它离散状态式 2D 角色；角色身份保持不变，状态、方向、动作和输出合同由目标运行环境决定。

安装与第一次使用

将仓库克隆到 Codex 的个人 Skills 目录：

git clone https://github.com/CheshireMew/ip-studio.git "$env:USERPROFILE\.codex\skills\ip-studio"

重新打开 Codex 后，直接描述你要得到的结果。你不需要运行仓库脚本、编辑 JSON、手动编号或整理生成文件。

从零建立角色

$ip-studio 从零为我设计并定稿一个可以长期使用的个人 IP 角色。

IP Studio 默认直接发展一个完整方向，不把角色设计变成三个候选或 Q 版选项题。角色来自已有品牌、作品或公共形象时，它先保留官方主色、角色原型、拟人特征和已经形成公众共识的美术锚点，再在发型、服装、表情、姿势和其它自由层完成原创表达；不会为了显得不同而丢掉共同形象，或给自然人形强加异常四肢和器官。第一张图只根据你的目标、材料、美术锚点、必要输出形式和硬要求生成正常比例、有张力的动漫角色形象；角色形象获你认可后，才从真实图片建立详细档案，再做一致性检查并锁定。只有你明确要求比较时才建立多个方向，只有你明确要求 Q 版角色时才采用 Q 版比例。获批结果写入本仓库已忽略的本地工作区 ip-studio-output/<角色标识>/。这个位置由脚本根据 IP Studio 仓库自身确定，不会因为你从另一个项目调用 Skill，就把角色文件写进那个项目。角色包锁定后即停止；只有你同时点名其它结果时，才继续制作衍生视觉、动态素材或桌宠。

导入或修改已有角色

$ip-studio 把这张已经确认的角色图导入为可长期复用的角色包。

$ip-studio 读取 E:\path\to\character-kit，把斗篷改成墨蓝色；其它固定特征保持不变并生成新版本。

导入时请附上图片，修改时请给出角色包路径。改变固定身份会建立新版本，旧版本和旧主参考图会保留。

制作头像、主页视觉或文章配图

$ip-studio 使用我上传的角色图，为下面的文章制作一张 16:9 封面。文章内容如下：……

这类结果直接使用上传角色图，不建立角色包。需要复用既有角色身份时可以提供角色包路径：

$ip-studio 使用 E:\path\to\character-kit，为这篇文章制作一张 5:2 封面。文章内容如下：……

角色包只提供当前主参考图和角色版本，生成的静态图片不会归档到角色包。没有指定保存位置时直接交付图像入口输出；指定位置时只复制最终图片到那里。所有衍生视觉都接受用户指定的任意合法 宽:高 比例，示例比例只在没有指定时作为默认值。

IP Studio 会把角色参考图、本次成品需要的完整内容材料、必要输出形式和你的硬要求整理成一份实际提示词，在生图前完整展示并等待确认，确认后原样交给图像模型。默认文章封面直接读取 references/cover-prompt.md；OKX 与 Binance 品牌编辑视觉则把提炼后的简短风格文字和完整原文交给图像模型，让它在生成前自行判断最值得表达的内容、必须保留和可以省略的信息以及适合的版式，不由 Agent 提前截取标题和数字。项目、仓库、网页或 README 只是取材来源，不会自动整份进入提示词。生成结果直接展示并交付，不再增加“认可候选后归档”的第二轮。仓库当前内置“极简手绘 IP”“OKX Editorial”和“Binance Editorial”三套可选内容视觉语言。例如：

$ip-studio 使用 E:\path\to\character-kit，根据下面的定稿做一张 1:1 OKX 风格社交配图，把我的 IP 角色融入画面：……

这类请求会验证内置 style-profile.json，实际生图提示词只使用其中已经提炼好的 generation_text，不复制完整 JSON，也不预选构图或场景。七张来源案例不会在日常生成时打开或传给生图模型；图片输入默认包含角色主图、精确 OKX 白色标记和当前任务素材。

币安风格使用同一套风格资料维护方式，实际生图提示词使用提炼后的币安品牌编辑视觉文字，不预选黄底或深色模式，也不替图像模型决定场景家族。五张来源图中的活动文案、奖励、人物、二维码、界面和物件不会进入新作品；图片输入默认提供黄色和黑色两份精确 Binance 标记，由图像模型根据最终底色二选一使用。

制作游戏角色或应用内动态角色

$ip-studio 使用 E:\path\to\character-kit，读取这个 Godot 项目中主角的真实状态机，只制作实际会触发的四方向站立、行走和工具动作，输出可直接导入的透明素材。

$ip-studio 把 E:\path\to\character-kit 做成前向应用助手，只需要待机、倾听、处理和完成状态，不要生成方向动画。

IP Studio 会先确认状态由哪里产生、方向怎样选择、哪个组件消费图片、动作效果在哪一帧发生以及用户最终看到什么，再建立 motion-contract.json。同一动作的方向和帧放在一张固定网格里整体生成，禁止用另一张图的脸、眼睛或肢体局部拼接“稳定”人物。正式结果包含透明 PNG 图集、逐帧 PNG、APNG、无损 WebP 和运行时 manifest；GIF 只用于临时分享，不承担颜色验收。

如果用户只要素材包，检查完成后停止。如果请求包含项目接入，IP Studio 还会让真实状态生产者、manifest、运行时消费者和最终画面走通；不会从测试端直接伪造最终状态。

制作并安装 Codex 桌宠

$ip-studio 把 E:\path\to\character-kit 制作并安装为可用的 Codex v2 桌宠。

Codex 桌宠是动态角色系统的固定平台适配器。它会额外生成标准化动态合同、九组状态动画、十六个注视方向、动态预览、盲审和透明边缘检查，再输出只包含 pet.json 与 spritesheet.webp 的正式宠物目录。安装成功后，你只需要重新打开 Codex，并在设置中启用宠物；如果同一宠物标识已被不同内容占用，IP Studio 会先保存旧安装并请你确认是否替换。

制作一般动态角色或桌宠时，工作区 Python 环境需要提供 Pillow 和 NumPy。角色档案和普通静态视觉提示脚本只使用 Python 标准库。

角色一致性怎样保持

character-profile.json 保存角色可以被重建的结构，档案中登记的单张主参考图提供默认视觉依据。它们共同构成角色身份边界：

1. 角色创建或修改先更新身份，再通过另一姿势和场景检查可复用性。
2. 静态衍生视觉只读取当前主参考图，不把成图或输入快照写回角色库；动态角色和桌宠按运行时合同保存所需快照。
3. 当次动作、构图、场景和氛围不会反向写回角色身份。
4. 角色版本和动态运行时包保留合同要求的输入、校验值和历史；普通静态成图不建立版本链。

能力边界

IP Studio 当前支持风格化人形、动物、拟人、物件和幻想生物，以及与同一角色相连的社交主页视觉、文章视觉、离散状态式 2D 动态素材和 Codex v2 桌宠。动态素材可以服务游戏世界小人、应用助手、网页角色或其它逐帧状态角色，但必须存在清楚的状态、方向、事件、锚点和图片消费合同。

照片级数字分身、普通个人品牌策略、没有 IP 角色参与的一般视觉、一般动效、骨骼动画、Live2D、视频和 3D 不属于当前能力范围。其它桌宠或角色平台只有能由离散状态和逐帧 2D 素材完整表达时才适用；它们的安装协议不自动获得授权。只有“制作可用的 Codex 桌宠”默认包含本机 Codex 宠物安装。

维护者入口

ip-studio/
├─ .project-steward/project.json
├─ SKILL.md
├─ agents/openai.yaml
├─ references/
│  ├─ character-system.md
│  ├─ visual-production.md
│  ├─ dynamic-character-production.md
│  └─ pet-production.md
├─ assets/visual-languages/
│  ├─ minimal-handdrawn/
│  ├─ okx-editorial/
│  └─ binance-editorial/
└─ scripts/
   ├─ character_kit.py
   ├─ visual_kit.py
   ├─ motion_kit.py
   ├─ pet_kit.py
   ├─ motion/
   └─ pet/

SKILL.md 是工作流、权限边界和交付标准的正式入口；四个顶层脚本分别负责角色包、静态视觉提示与文章配图计划、通用动态素材和 Codex 桌宠适配器的机器可验证合同。修改工作流后，先检查四套命令入口仍可读取：

python scripts/character_kit.py --help
python scripts/visual_kit.py --help
python scripts/motion_kit.py --help
python scripts/pet_kit.py --help

角色的最终验收必须读取脚本正式输出并实际看图；静态衍生视觉要核对正式提示词、有序图片输入和图像入口真实输出，并确认没有写入角色库；一般动态素材还要验证整表生产者、透明帧、图集、manifest 和目标消费者；桌宠继续验证完整 8×11 精灵表、九组动画预览、十六方向语义、盲审和安装目录。只运行帮助命令或静态检查不能代替这些真实链路。

隐私

Skill 默认只读取当前请求、当前对话、用户明确提供的材料、角色文件夹，以及动态任务中与状态生产、图片消费和运行时接入直接相关的项目文件。角色包、角色 QA 文件和动态运行记录保存在本仓库的 ip-studio-output/ 本地工作区。普通静态图片保留在图像入口的输出位置，或只复制到用户明确指定的位置，不会放进角色库。ip-studio-output/ 已被 Git 忽略，不属于源码，也不会被默认提交。

公开问题或贡献代码前，请确认提交中不包含角色私有素材、文章草稿、品牌资料、绝对路径、访问令牌或生成记录。

许可

本项目采用 Apache License 2.0。