{"id":"18f3b55b-bc67-4b48-a0f0-bb7a69acb91e","slug":"ip-studio","kind":"skill","name":"ip-studio","summary":"从零创建、锁定并长期复用 IP 角色，自动生成内容视觉与 Codex v2 桌宠","owner":"CheshireMew","repoUrl":"https://github.com/CheshireMew/ip-studio","license":"MPL-2.0","licenseTier":"weak-copyleft","trust":"community","stars":8,"match":null,"fewStars":false,"format":"skill","createdAt":"2026-07-28T07:12:02.000Z","addedAt":"2026-10-14T06:24:13.982Z","logoUrl":"https://avatars.githubusercontent.com/u/156318350?u=dd7b703235da65c42234469e2d369db41fa211af&v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["design-media"],"tags":["character-design","codex","desktop-pet","image-generation"],"runtime":"binary","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-17T09:22:48.339Z","sample":false,"url":"https://conduits.dev/tools/ip-studio","language":"Python","transports":["stdio"],"install":{},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"# IP Studio\n\n`ip-studio` 是一个可由 Codex 或兼容 AI Agent 加载的角色生产 Skill。你可以交给它零散的身份线索、一张已经认可的角色图，或一个已锁定的角色包；它会把这些材料整理成稳定角色，并继续制作传播视觉、运行时 2D 动态角色素材或 Codex v2 桌宠。\n\n它负责补全角色与运行合同、生图、版本管理和文件校验。角色身份与动态结果会进行所需的看图检查；普通静态衍生视觉在生成后直接交付，不进入角色库，也不会自动筛选或重生。你只需要决定会改变角色身份、内容重点或既有安装的事项。\n\n## 你会得到什么\n\n- **建立或修改角色**：得到完整角色档案、角色说明、单张正式主参考图和可回读的历史版本。\n- **制作衍生视觉**：得到头像、主页横幅、资料卡、文章封面、说明图或正文插图，以及生成前可确认的完整提示词和有序图片输入；成图直接交付。\n- **制作动态角色素材**：根据游戏、网页或应用中的真实状态生产者和消费者，得到静态方向图、循环、单次动作、过渡、效果帧、透明 PNG 图集、逐帧文件、无损预览和运行时 manifest；不会为静态 NPC 或无方向角色虚构动作。\n- **制作 Codex 桌宠**：得到包含九组应用状态、十六个注视方向和 QA 证据的 Codex v2 宠物目录，并可在确认后安装到本机 Codex。\n\n静态衍生视觉、动态角色素材和桌宠都可以读取角色包作为共同身份输入，但只有角色身份和真正可运行的动态包需要长期保存。只用一张已认可角色图制作头像、横幅、封面、说明图或正文插图时也可以直接生成，不强迫先建角色包；无论采用哪种角色来源，普通静态成图都不会写回角色库。\n\n**直接开始：** [安装 Skill，并选择一条可直接复制的请求](#安装与第一次使用)。\n\n## 效果展示\n\n下面用仓库内的“灯灯”示例展示稳定的角色身份、持续复用的内容视觉和 Codex v2 平台适配。动态角色的共同生产链同时适用于游戏小人、应用助手、网页角色和其它离散状态式 2D 角色；角色身份保持不变，状态、方向、动作和输出合同由目标运行环境决定。\n\n<p align=\"center\">\n  <img src=\"docs/images/lantern-fox-banner.webp\" alt=\"灯笼狐个人主页横幅示例\" width=\"100%\">\n</p>\n<p align=\"center\"><sub>主页横幅：角色亲自用灯笼把复杂问题照亮。</sub></p>\n\n<p align=\"center\">\n  <img src=\"docs/images/lantern-fox-master.webp\" alt=\"灯笼狐正式主参考图示例\" width=\"280\">\n</p>\n<p align=\"center\"><sub>正式主参考图：后续视觉共同读取的单张默认角色参考。</sub></p>\n\n<p align=\"center\">\n  <img src=\"docs/images/lantern-fox-cover.webp\" alt=\"灯笼狐文章封面示例\" width=\"100%\">\n</p>\n<p align=\"center\"><sub>文章封面：同一角色继续承担内容传播任务。</sub></p>\n\n<p align=\"center\">\n  <img src=\"docs/images/lantern-fox-explainer.webp\" alt=\"同一 IP 驱动三类内容视觉的说明图示例\" width=\"620\">\n</p>\n<p align=\"center\"><sub>说明图：角色直接参与信息流程，而不是站在内容旁边充当装饰。</sub></p>\n\n<p align=\"center\">\n  <img src=\"docs/images/lantern-fox-illustration.webp\" alt=\"身份先锁定、场景再变化的正文插图示例\" width=\"100%\">\n</p>\n<p align=\"center\"><sub>正文插图：固定角色身份，把动作、场景和氛围留给当前任务决定。</sub></p>\n\n<p align=\"center\">\n  <img src=\"docs/images/lantern-fox-pet-idle.gif\" alt=\"灯笼狐 Codex 桌宠待机动画示例\" width=\"192\"><br>\n  <sub>Codex v2 桌宠：九组应用状态、十六个注视方向和透明边缘检查。</sub>\n</p>\n\n## 安装与第一次使用\n\n将仓库克隆到 Codex 的个人 Skills 目录：\n\n```powershell\ngit clone https://github.com/CheshireMew/ip-studio.git \"$env:USERPROFILE\\.codex\\skills\\ip-studio\"\n```\n\n重新打开 Codex 后，直接描述你要得到的结果。你不需要运行仓库脚本、编辑 JSON、手动编号或整理生成文件。\n\n### 从零建立角色\n\n```text\n$ip-studio 从零为我设计并定稿一个可以长期使用的个人 IP 角色。\n```\n\nIP Studio 默认直接发展一个完整方向，不把角色设计变成三个候选或 Q 版选项题。角色来自已有品牌、作品或公共形象时，它先保留官方主色、角色原型、拟人特征和已经形成公众共识的美术锚点，再在发型、服装、表情、姿势和其它自由层完成原创表达；不会为了显得不同而丢掉共同形象，或给自然人形强加异常四肢和器官。第一张图只根据你的目标、材料、美术锚点、必要输出形式和硬要求生成正常比例、有张力的动漫角色形象；角色形象获你认可后，才从真实图片建立详细档案，再做一致性检查并锁定。只有你明确要求比较时才建立多个方向，只有你明确要求 Q 版角色时才采用 Q 版比例。获批结果写入本仓库已忽略的本地工作区 `ip-studio-output/<角色标识>/`。这个位置由脚本根据 IP Studio 仓库自身确定，不会因为你从另一个项目调用 Skill，就把角色文件写进那个项目。角色包锁定后即停止；只有你同时点名其它结果时，才继续制作衍生视觉、动态素材或桌宠。\n\n### 导入或修改已有角色\n\n```text\n$ip-studio 把这张已经确认的角色图导入为可长期复用的角色包。\n```\n\n```text\n$ip-studio 读取 E:\\path\\to\\character-kit，把斗篷改成墨蓝色；其它固定特征保持不变并生成新版本。\n```\n\n导入时请附上图片，修改时请给出角色包路径。改变固定身份会建立新版本，旧版本和旧主参考图会保留。\n\n### 制作头像、主页视觉或文章配图\n\n```text\n$ip-studio 使用我上传的角色图，为下面的文章制作一张 16:9 封面。文章内容如下：……\n```\n\n这类结果直接使用上传角色图，不建立角色包。需要复用既有角色身份时可以提供角色包路径：\n\n```text\n$ip-studio 使用 E:\\path\\to\\character-kit，为这篇文章制作一张 5:2 封面。文章内容如下：……\n```\n\n角色包只提供当前主参考图和角色版本，生成的静态图片不会归档到角色包。没有指定保存位置时直接交付图像入口输出；指定位置时只复制最终图片到那里。所有衍生视觉都接受用户指定的任意合法 `宽:高` 比例，示例比例只在没有指定时作为默认值。\n\nIP Studio 会把角色参考图、本次成品需要的完整内容材料、必要输出形式和你的硬要求整理成一份实际提示词，在生图前完整展示并等待确认，确认后原样交给图像模型。默认文章封面直接读取 `references/cover-prompt.md`；OKX 与 Binance 品牌编辑视觉则把提炼后的简短风格文字和完整原文交给图像模型，让它在生成前自行判断最值得表达的内容、必须保留和可以省略的信息以及适合的版式，不由 Agent 提前截取标题和数字。项目、仓库、网页或 README 只是取材来源，不会自动整份进入提示词。生成结果直接展示并交付，不再增加“认可候选后归档”的第二轮。仓库当前内置“极简手绘 IP”“OKX Editorial”和“Binance Editorial”三套可选内容视觉语言。例如：\n\n```text\n$ip-studio 使用 E:\\path\\to\\character-kit，根据下面的定稿做一张 1:1 OKX 风格社交配图，把我的 IP 角色融入画面：……\n```\n\n这类请求会验证内置 `style-profile.json`，实际生图提示词只使用其中已经提炼好的 `generation_text`，不复制完整 JSON，也不预选构图或场景。七张来源案例不会在日常生成时打开或传给生图模型；图片输入默认包含角色主图、精确 OKX 白色标记和当前任务素材。\n\n币安风格使用同一套风格资料维护方式，实际生图提示词使用提炼后的币安品牌编辑视觉文字，不预选黄底或深色模式，也不替图像模型决定场景家族。五张来源图中的活动文案、奖励、人物、二维码、界面和物件不会进入新作品；图片输入默认提供黄色和黑色两份精确 Binance 标记，由图像模型根据最终底色二选一使用。\n\n### 制作游戏角色或应用内动态角色\n\n```text\n$ip-studio 使用 E:\\path\\to\\character-kit，读取这个 Godot 项目中主角的真实状态机，只制作实际会触发的四方向站立、行走和工具动作，输出可直接导入的透明素材。\n```\n\n```text\n$ip-studio 把 E:\\path\\to\\character-kit 做成前向应用助手，只需要待机、倾听、处理和完成状态，不要生成方向动画。\n```\n\nIP Studio 会先确认状态由哪里产生、方向怎样选择、哪个组件消费图片、动作效果在哪一帧发生以及用户最终看到什么，再建立 `motion-contract.json`。同一动作的方向和帧放在一张固定网格里整体生成，禁止用另一张图的脸、眼睛或肢体局部拼接“稳定”人物。正式结果包含透明 PNG 图集、逐帧 PNG、APNG、无损 WebP 和运行时 manifest；GIF 只用于临时分享，不承担颜色验收。\n\n如果用户只要素材包，检查完成后停止。如果请求包含项目接入，IP Studio 还会让真实状态生产者、manifest、运行时消费者和最终画面走通；不会从测试端直接伪造最终状态。\n\n### 制作并安装 Codex 桌宠\n\n```text\n$ip-studio 把 E:\\path\\to\\character-kit 制作并安装为可用的 Codex v2 桌宠。\n```\n\nCodex 桌宠是动态角色系统的固定平台适配器。它会额外生成标准化动态合同、九组状态动画、十六个注视方向、动态预览、盲审和透明边缘检查，再输出只包含 `pet.json` 与 `spritesheet.webp` 的正式宠物目录。安装成功后，你只需要重新打开 Codex，并在设置中启用宠物；如果同一宠物标识已被不同内容占用，IP Studio 会先保存旧安装并请你确认是否替换。\n\n制作一般动态角色或桌宠时，工作区 Python 环境需要提供 Pillow 和 NumPy。角色档案和普通静态视觉提示脚本只使用 Python 标准库。\n\n## 角色一致性怎样保持\n\n`character-profile.json` 保存角色可以被重建的结构，档案中登记的单张主参考图提供默认视觉依据。它们共同构成角色身份边界：\n\n1. 角色创建或修改先更新身份，再通过另一姿势和场景检查可复用性。\n2. 静态衍生视觉只读取当前主参考图，不把成图或输入快照写回角色库；动态角色和桌宠按运行时合同保存所需快照。\n3. 当次动作、构图、场景和氛围不会反向写回角色身份。\n4. 角色版本和动态运行时包保留合同要求的输入、校验值和历史；普通静态成图不建立版本链。\n\n## 能力边界\n\nIP Studio 当前支持风格化人形、动物、拟人、物件和幻想生物，以及与同一角色相连的社交主页视觉、文章视觉、离散状态式 2D 动态素材和 Codex v2 桌宠。动态素材可以服务游戏世界小人、应用助手、网页角色或其它逐帧状态角色，但必须存在清楚的状态、方向、事件、锚点和图片消费合同。\n\n照片级数字分身、普通个人品牌策略、没有 IP 角色参与的一般视觉、一般动效、骨骼动画、Live2D、视频和 3D 不属于当前能力范围。其它桌宠或角色平台只有能由离散状态和逐帧 2D 素材完整表达时才适用；它们的安装协议不自动获得授权。只有“制作可用的 Codex 桌宠”默认包含本机 Codex 宠物安装。\n\n## 维护者入口\n\n```text\nip-studio/\n├─ .project-steward/project.json\n├─ SKILL.md\n├─ agents/openai.yaml\n├─ references/\n│  ├─ character-system.md\n│  ├─ visual-production.md\n│  ├─ dynamic-character-production.md\n│  └─ pet-production.md\n├─ assets/visual-languages/\n│  ├─ minimal-handdrawn/\n│  ├─ okx-editorial/\n│  └─ binance-editorial/\n└─ scripts/\n   ├─ character_kit.py\n   ├─ visual_kit.py\n   ├─ motion_kit.py\n   ├─ pet_kit.py\n   ├─ motion/\n   └─ pet/\n```\n\n`SKILL.md` 是工作流、权限边界和交付标准的正式入口；四个顶层脚本分别负责角色包、静态视觉提示与文章配图计划、通用动态素材和 Codex 桌宠适配器的机器可验证合同。修改工作流后，先检查四套命令入口仍可读取：\n\n```powershell\npython scripts/character_kit.py --help\npython scripts/visual_kit.py --help\npython scripts/motion_kit.py --help\npython scripts/pet_kit.py --help\n```\n\n角色的最终验收必须读取脚本正式输出并实际看图；静态衍生视觉要核对正式提示词、有序图片输入和图像入口真实输出，并确认没有写入角色库；一般动态素材还要验证整表生产者、透明帧、图集、manifest 和目标消费者；桌宠继续验证完整 8×11 精灵表、九组动画预览、十六方向语义、盲审和安装目录。只运行帮助命令或静态检查不能代替这些真实链路。\n\n## 隐私\n\nSkill 默认只读取当前请求、当前对话、用户明确提供的材料、角色文件夹，以及动态任务中与状态生产、图片消费和运行时接入直接相关的项目文件。角色包、角色 QA 文件和动态运行记录保存在本仓库的 `ip-studio-output/` 本地工作区。普通静态图片保留在图像入口的输出位置，或只复制到用户明确指定的位置，不会放进角色库。`ip-studio-output/` 已被 Git 忽略，不属于源码，也不会被默认提交。\n\n公开问题或贡献代码前，请确认提交中不包含角色私有素材、文章草稿、品牌资料、绝对路径、访问令牌或生成记录。\n\n## 许可\n\n本项目采用 [Apache License 2.0](LICENSE)。\n"}