Punk IP 文章插图

Punk 是本 Skill 的品牌、作者印记和内置角色预设，不代表只能画 Punk。任何人都可以上传自己的照片创建专属角色，再使用同一个 Skill 给文章配图。

支持两种互斥画风：

• retro-flat-3d：原有的复古彩色扁平 3D 小剧场。
• loose-watercolor：松散线描水彩角色设定卡与小剧场。

画风绑定到角色并写入 manifest。切换角色时同时切换该角色的默认画风；不要在一张图中混合两种视觉语言。内置 Punk 始终绑定 retro-flat-3d。

把本 Skill 作为一个连续工作流使用：先创建角色，等待用户明确确认，再用已确认角色给文章配图。不要拆成两个 Skill，也不要在角色未确认时提前生成文章插图。

每次开始时

1. 读取 references/character-package.md，确定运行目录、角色状态和当前角色。
2. 如果用户本轮没有明确角色或画风，且这是本次使用的入口，先进入“画风选择”，不要同时索要照片或文章。
3. 根据用户输入选择阶段，只读取当前阶段与已选画风需要的其他参考文件。

画风选择

用户只调用本 Skill，或准备新建角色但没有指定画风时，只问下面这一题，不调用图像工具：

这次想使用哪一种插画风格？

1. 松散线描水彩：轻盈手绘线条、薄水彩、纯白留白
2. 复古彩色扁平 3D：原有 Punk 小剧场风格

用户可以直接回复名称或序号。用户明确要求 Punk 时无需再问，固定选择 retro-flat-3d。已经明确指定角色时，默认读取该角色 manifest 中的 style；旧 manifest 缺少该字段时按 retro-flat-3d。只有用户明确要更换画风时才覆盖角色默认值，并按“修订角色”重新生成该画风的设定卡与干净参考图。

首次使用引导

用户选择画风后，没有上传照片或文章，且运行目录中没有已确认角色时，再发送以下简短引导，不调用图像工具：

Hi，我是 Punk，欢迎使用 Punk IP Illustrations。
每个人都是独立的个体，也拥有属于自己的强大 IP。愿你在这里找到自己的品牌价值。

已选择：<松散线描水彩 / 复古彩色扁平 3D>

请上传一张清晰的人物照片，并告诉我角色名称或昵称；也可以直接启用内置 Punk（固定使用复古彩色扁平 3D）。

接下来我会：
1. 按所选画风生成人物角色设定图；
2. 生成干净人物参考图；
3. 请你确认或提出修改；
4. 确认后，用这个角色为文章自动配图。

如果已经存在当前已确认角色，不重复要求上传照片；简短说明当前角色名称，并请用户提供文章、观点、链接或文件。

阶段路由

• 用户只调用 Skill，且没有明确角色或画风：先进入“画风选择”。
• 用户已选择画风、没有提供照片或文章，且没有已确认角色：进入“首次使用引导”。
• 用户上传人物照片并要求创建 IP：进入“创建个人角色”。
• 用户要求直接使用 Punk：进入“启用内置 Punk”。
• 当前角色为 draft，用户提出外观修改：进入“修订角色”。
• 用户明确说“确认”“就用这个”“定稿”：进入“确认角色”。
• 用户提供文章、观点、链接或文件，且存在已确认角色：进入“文章配图”。
• 用户要求列出、导入、切换角色：进入“角色管理”。
• 用户同时提供照片和文章，但没有已确认角色：先创建角色并停在确认环节；不要提前配图，也不要复制文章到角色目录。
• 没有已确认角色却直接要求文章配图：先确定画风，再引导用户上传照片创建角色，或询问是否启用内置 Punk。

创建个人角色

始终读取：

• references/character-package.md
• references/tool-workflow.md

再按已选画风二选一完整读取：

• retro-flat-3d：references/ip-builder.md
• loose-watercolor：references/loose-watercolor-character.md

执行顺序：

1. 确认画风已经选择；未选择时先只询问画风。使用用户上传的真人照片作为唯一身份来源。用户未提供角色名称时，只询问角色名称或昵称这一项。
2. 提炼脸型、五官比例、发型、发际线、肤色、年龄感、体型、固定服装、鞋子、配件和整体气质。
3. 调用图像生成工具，按所选风格参考文件生成角色设定图：3D 风格使用主角色加正面、左侧、背面、右侧；松散水彩使用横向的正面、侧面、背面、3/4 和自然动作五视图。
4. 再生成一张透明背景或纯白背景的干净单人物全身参考图；不得复制设定板标题、边框或多视图排版。
5. 写出 character-spec.md，只记录可观察、可复用的固定视觉特征，不推断敏感属性或私人信息。
6. 把三个产物及所选 style 注册为 draft 角色包。优先运行 scripts/character_registry.py register --style <style>；脚本不可用时按 references/character-package.md 手动建立同等结构。
7. 展示角色设定板和干净参考图，报告角色包路径，并只询问用户是确认还是修改。

角色草稿不得自动激活。不要因为用户同时提供文章就跳过确认。

启用内置 Punk

内置 Punk 已由作者确认，不需要重新生图或等待外观确认。

Punk 永远使用 retro-flat-3d；即使用户先选了松散水彩，只要明确切换到 Punk，就说明此绑定并使用原风格，不把 Punk 转绘为水彩。

1. 读取 references/character-spec.md。
2. 使用以下正式资产：
3. assets/punk-character-sheet.png
4. assets/punk-character-reference-clean.png
5. references/character-spec.md
6. 如果运行目录中还没有 punk，运行 register --style retro-flat-3d 注册这些资产，再运行 confirm。
7. 如果已存在 confirmed Punk，运行 activate。
8. 将 Punk 设置为当前角色后，可以直接进入文章配图。

修订角色

1. 读取当前草稿的设定板、干净参考图、人物规范和 style。
2. 把用户修改转成一个明确视觉变更，未提及的身份特征保持不变。
3. 同时传入待修改图、原始照片（若仍可访问）和当前干净参考图；每次只修正一个主要问题。
4. 重新检查主视图与各角度、动作视图的一致性。
5. 保存为新版本，不覆盖旧文件，再次注册为 draft 并等待确认。
6. 用户要求更换画风时，按新画风重新生成设定卡和干净参考图，把新 style 注册为同一角色的新版本，再等待确认；不要只改 manifest 而继续复用旧画风资产。

确认角色

1. 只有用户明确确认时才执行；内置 Punk 除外。
2. 检查角色设定板、干净参考图和人物规范均存在。
3. 运行 python3 scripts/character_registry.py confirm --root <runtime-root> --slug <character-slug>。
4. 把状态改为 confirmed 并更新 current-character.json。
5. 告知用户角色已可用于文章配图，并给出下一步调用示例。

文章配图

完整读取：

• references/article-workflow.md
• references/tool-workflow.md
• 当前角色包中的人物规范文件

解析角色后，再按 manifest 中的 style 二选一完整读取：

• retro-flat-3d：references/illustration-style.md
• loose-watercolor：references/loose-watercolor-style.md

执行顺序：

1. 使用 scripts/character_registry.py resolve 解析用户指定角色；未指定时解析当前角色。只使用 confirmed 角色，并以返回的 style 确定画风。
2. 读取完整文章或全部输入，不根据标题或片段推测全文。
3. 按信息密度决定图片数量，为每张图选择不同认知锚点。
4. 对每张图分别判断使用“流程拆解”或“核心动作”。
5. 默认把当前角色的干净单人物图作为身份参考；只有侧面、背面或多角度校验时才加入角色设定板。
6. 每个认知锚点独立调用一次图像生成工具，逐张检查并保存；不要用一张拼图替代多张图片。
7. 最终按顺序报告每张图的用途、实际绝对路径和建议插入位置。默认不修改原文。

角色管理

• 列出角色：运行 python3 scripts/character_registry.py list --root <runtime-root>。
• 切换角色：运行 python3 scripts/character_registry.py activate --root <runtime-root> --slug <character-slug>。
• 查看当前角色：运行 python3 scripts/character_registry.py resolve --root <runtime-root>。
• 更换画风：按“修订角色”重新生成设定卡与干净参考图并再次确认，不直接修改 manifest。
• 不允许激活 draft 角色。
• 同名角色的新版本保留历史图像，但 manifest 只指向最新版本。

图像工具要求

• 使用宿主内置的 image generation 工具或等价图片生成/编辑接口。
• 新建图片时传入身份参考图；编辑图片时同时传入待修改原图和身份参考图。
• 创建角色时，人物照片只用于身份参考，不得复制原始背景、其他人物、文字、水印或无关物件。
• 文章配图不得复制角色设定板的背景、标题、边框、方向标签或多视图排版。
• 工具无法保存到目标目录时，保留工具返回的实际路径并如实报告，不伪造路径。
• 宿主没有图像生成能力时，输出完整可执行提示词、参考图路径和保存计划，并明确说明尚未生成图片。

隐私与边界

• 默认不把原始人物照片复制进角色包，不上传照片、文章或生成角色到公开仓库。
• 角色包和文章插图只保存在用户本地运行目录。
• 不根据照片猜测姓名、职业、民族、健康、政治倾向、宗教、性取向或其他敏感属性。
• 不覆盖已有角色资产或插图；使用 -v2、-v3 等版本。
• 只有用户明确要求时才把图片链接写入原文章。