NewBie-image-Exp0.1新手入门：修改appearance属性生成不同角色

NewBie-image-Exp0.1
本镜像已深度预配置了 NewBie-image-Exp0.1 所需的全部环境、依赖与修复后的源码，实现了动漫生成能力的“开箱即用”。通过简单的指令，您即可立即体验 3.5B 参数模型带来的高质量画质输出，并能利用独特的 XML 提示词功能实现精准的多角色属性控制，是开展动漫图像创作与研究的高效工具。

1. 快速上手：三步生成你的第一张动漫图

如果你刚接触这个镜像，别担心。我们已经把所有复杂的配置都处理好了——不需要手动安装 PyTorch、Diffusers 或者下载模型权重，甚至连常见的运行报错都已经提前修复。你现在要做的，就是运行几条命令，亲眼见证一张高质量动漫图从无到有。

1.1 进入容器并定位项目目录

首先确保你已经成功启动了基于NewBie-image-Exp0.1的容器环境。进入终端后，执行以下命令切换到项目主目录：

cd .. cd NewBie-image-Exp0.1

这一步会带你进入核心工作区。所有的生成脚本和模型文件都在这里。

1.2 执行测试脚本查看效果

接下来，直接运行内置的测试脚本：

python test.py

这条命令会调用预训练的 3.5B 参数模型，使用默认提示词生成一张分辨率为 1024×1024 的动漫人物图像。整个过程通常在几十秒内完成（具体时间取决于 GPU 性能）。

运行结束后，你会在当前目录看到一个名为success_output.png的图片文件。打开它，就能看到第一个由你自己亲手“召唤”出来的虚拟角色！

小贴士：如果出现显存不足错误，请检查是否为容器分配了至少 16GB 显存。这是该模型正常推理的基本要求。

2. 理解核心机制：XML 结构化提示词如何工作

NewBie-image-Exp0.1 最大的亮点之一，是它支持一种类似 HTML 标签的XML 风格提示词系统。这种结构化方式让模型能更准确地理解多个角色之间的关系，尤其是外貌、性别、服装等细节的绑定。

传统文本提示词容易混淆角色特征，比如“蓝发双马尾女孩和红发短发女孩”可能被误解成一个人兼具两种特征。而 XML 格式可以明确划分每个角色的独立属性。

2.1 基础语法结构解析

来看一个标准的 XML 提示词模板：

prompt = """ <character_1> <n>miku</n> <gender>1girl</gender> <appearance>blue_hair, long_twintails, teal_eyes</appearance> </character_1> <general_tags> <style>anime_style, high_quality</style> </general_tags> """

我们来逐行解释它的含义：

<character_1>：定义第一个角色区块。你可以添加<character_2>来引入第二位角色。
<n>miku</n>：昵称字段，用于内部标识，不影响画面内容，但有助于调试。
<gender>1girl</gender>：指定性别标签。“1girl”表示单个女性角色，也可设为 “1boy”、“2girls” 等。
<appearance>...</appearance>：最关键的字段！在这里填写你想呈现的外观特征，如发型、眼睛颜色、服饰风格等。
<general_tags>：全局通用标签，适用于整幅画面，比如画风、质量等级、光照条件等。

2.2 appearance 属性详解：打造个性化角色

appearance是决定角色视觉表现的核心字段。你可以在这个标签里组合各种描述词，控制角色的每一个细节。

常见可配置项包括：

头发：blue_hair,pink_pigtails,silver_short_hair
眼睛：golden_eyes,heterochromia（异色瞳）
服饰：school_uniform,cyberpunk_outfit,maid_dress
表情与姿态：smiling,looking_at_viewer,dynamic_pose
特殊元素：cat_ears,angel_wings,glowing_halo

举个例子，如果你想生成一位“银白色短发、金色眼睛、穿着赛博朋克装甲、面带冷笑”的未来战士少女，可以这样写：

<appearance>silver_short_hair, golden_eyes, cyberpunk_armor, sneering, looking_at_viewer</appearance>

你会发现，生成的角色几乎完全符合预期——这就是结构化提示词的强大之处。

3. 动手实践：修改 test.py 实现自定义角色生成

现在让我们真正动手，改出属于你自己的角色。

3.1 编辑 prompt 变量

找到项目中的test.py文件，用任意文本编辑器打开。定位到包含prompt = """..."""的那一段代码。

将原来的 XML 内容替换为你设计的新角色设定。例如，创建一个双人场景：

prompt = """ <character_1> <n>luna</n> <gender>1girl</gender> <appearance>pink_long_hair, green_eyes, flower_crown, white_dress, barefoot</appearance> </character_1> <character_2> <n>kaito</n> <gender>1boy</gender> <appearance>black_spiky_hair, red_jacket, jeans, smirking, arms_crossed</appearance> </character_2> <general_tags> <style>anime_style, ultra_detail, soft_lighting, garden_background</style> </general_tags> """

保存文件后，再次运行：

python test.py

这次生成的图片中，会出现一男一女两位角色，背景是花园，光线柔和，细节丰富。只要你描述得清楚，模型基本不会搞混谁穿什么、长什么样。

3.2 小技巧：提升生成稳定性

虽然模型很强大，但有些细节仍需注意才能获得理想结果：

避免冲突描述：不要同时写short_hair和long_hair，会导致特征模糊。
关键词优先级：越靠前的词影响力越大，建议把最重要的特征放在前面。
使用英文逗号分隔：必须用半角逗号,分隔每个属性，不能用顿号或空格。
控制总长度：单个appearance字段建议不超过 20 个关键词，太多反而影响聚焦。

4. 进阶玩法：用 create.py 实现交互式生成

除了固定的test.py，镜像还提供了一个更灵活的脚本：create.py。它可以让你像聊天一样输入提示词，实时查看生成结果，非常适合探索创意或快速试错。

4.1 启动交互模式

运行以下命令：

python create.py

程序会提示你输入一段 XML 格式的提示词。你可以复制粘贴之前写好的内容，也可以现场编写。

每轮生成完成后，程序会询问是否继续。输入 "y" 可以再试一次，输入 "n" 则退出。

4.2 批量尝试不同风格

你可以利用这个脚本快速对比不同appearance设置的效果。比如先试试“魔法少女”风格：

<appearance>purple_twintails, starry_eyes, magical_girl_costume, wand_in_hand, floating</appearance>

然后再换成“机甲战士”：

<appearance>mech_suit, red_helmet, glowing_blade, battle_damage, smoke_background</appearance>

通过反复试验，你会逐渐掌握哪些词汇组合更容易出好图，哪些容易导致崩坏。

5. 文件结构一览：了解镜像内部组织

为了方便后续扩展或调试，我们来看看镜像内的主要文件分布：

NewBie-image-Exp0.1/
- test.py：最简化的推理入口，适合初学者快速验证。
- create.py：支持循环输入的交互式生成器，便于批量测试。
- models/：存放模型网络结构定义（如 DiT 架构实现）。
- transformer/：主干 Transformer 模型权重。
- text_encoder/：文本编码器（基于 Jina CLIP + Gemma 3 微调）。
- vae/：变分自编码器，负责图像解码。
- clip_model/：独立 CLIP 模型，用于图文对齐。

这些组件均已本地化加载，无需联网请求外部服务，保证了生成速度和隐私安全。