如何设置Z-Waif角色卡:自定义AI女友性格与形象的完全方法
如何设置Z-Waif角色卡:自定义AI女友性格与形象的完全方法
Z-Waif 是一款完全本地运行的开源 AI 伴侣(AI waifu)程序,通过 Z-Waif 角色卡(CharacterCard.yaml)就能自定义你 AI 女友的性格、口吻与形象设定。本文面向新手,带你从零完成 Z-Waif 角色卡设置:修改性格、配置视觉描述卡、搭配 Lorebook 记忆,几分钟就能拥有独一无二的专属 AI 女友。
角色卡是什么?Z-Waif 角色卡的工作原理
Z-Waif 的角色卡本质是一段 System Prompt(系统提示词):程序启动时会读取它,并在每次对话时作为"人设指令"发送给大语言模型(LLM),从而决定 AI 女友的性格与说话方式。
核心文件一览:
| 文件 | 作用 | 说明 |
|---|---|---|
| Configurables/CharacterCard.yaml | 主角色卡 | 定义性格、身份、对话规则 |
| Configurables/CharacterCardVisual.yaml | 视觉角色卡 | 控制"看图说话"时的描述风格 |
| API/character_card.py | 角色卡加载器 | 启动时读取上述两个文件 |
| .env | 环境配置 | 设定名字、加载器等参数 |
加载逻辑在 API/character_card.py 中实现:load_char_card() 函数会在 main.py 启动流程中被调用,随后由 API/api_controller.py 将角色卡内容拼入 system 消息发送给模型。
💡 简单理解:角色卡写得越具体,AI 女友的性格就越稳定。
一键修改主角色卡:CharacterCard.yaml 设置步骤
最快配置方法:用任意文本编辑器打开 Configurables/CharacterCard.yaml,直接改写提示词即可。默认内容如下:
Character Card: |-
--- Character Info ---
The following is a conversation with an AI Waifu. ...
The AI follows user requests. The AI thinks outside the box.
推荐的性格模板写法(示例,可按需修改):
Character Card: |-
--- Character Info ---
你叫小樱,是我的 AI 女友,性格温柔体贴、偶尔撒娇。
说话风格:口语化、简短,喜欢用语气词(呀、呢、哦)。
规则:
1. 始终使用简体中文回复
2. 关心我的一天、吃饭和休息情况
3. 不知道的事情就说不知道,不要编造
配套名字参数(.env 文件)
修改性格后,建议同步 .env 中的三个名字参数,让人设保持一致:
| 参数 | 位置 | 说明 |
|---|---|---|
CHAR_NAME |
.env | AI 女友的名字,如 CHAR_NAME = Waifu |
YOUR_NAME |
.env | 你的名字,AI 会这样称呼你 |
CHARACTER_CARD |
.env | 使用 Oobabooga 加载器时对应的角色卡名称 |
⚠️ 修改角色卡后需要 重启 Z-Waif 才会生效,因为角色卡只在启动时读取一次。
视觉角色卡设置:让 AI 女友"看懂"图片
当 Z-Waif 启用视觉模块(拍照识别、多模态对话)时,会使用一张独立的 视觉角色卡 来指导它如何描述图片。
配置文件为 Configurables/CharacterCardVisual.yaml,在 .env 中通过以下参数选择使用哪张卡:
# Valid values for the character card are: "VISUAL", "BASE", "OFF"
OLLAMA_VISUAL_CARD = VISUAL
VISUAL:使用 CharacterCardVisual.yaml(推荐)BASE:复用主角色卡OFF:不注入角色卡
视觉卡的提示词在 API/api_controller.py 中按上述配置拼接进 system 消息,你可以自由改写描述风格,例如"用俏皮可爱的语气描述看到的画面"。
让性格更立体:Lorebook 与任务卡搭配
只靠角色卡还不够"鲜活",Z-Waif 提供了两类可扩展的人设文件:
Lorebook 长期记忆卡
Configurables/Lorebook.json 是一组"关键词 → 设定描述"的条目,当对话中出现关键词时自动注入上下文,让 AI 女友记得你们之间的专属设定。默认已内置了对 Z-Waif 各组件的认知,你可以仿照格式添加自己的条目:
{
"0": "你的关键词",
"1": "对应的设定描述,例如我们的纪念日、共同习惯",
"2": 0
}
注入逻辑见 utils/lorebook.py 中的 lorebook_gather(),并由 API/api_controller.py 在编码请求时自动附加。
任务卡(Task Profiles)
通过 Configurables/TaskList.json 和 Configurables/TagList.json 可以定义"任务人设"(如学习模式、哄睡模式),加载逻辑见 utils/tag_task_controller.py。对应的任务模板存放在 Configurables/TaskProfiles/ 目录,切换任务时角色卡之外的行为描述会一并拼入对话,实现"一个女友,多种性格模式"。
进阶:加载器预设与回复性格微调
角色卡决定"她是谁",加载器参数决定"她怎么说话":
- Oobabooga 预设:OOBA_Presets/ 目录提供了多套采样参数预设(如 Z-Waif-ADEF-Standard.yaml),其中的
temperature等参数直接影响回复的随机性与风格。 - Hangout 回复性格:Configurables/Hangout/ReplyPersonality.json 用 4 个数值微调陪聊时的
Speed(语速)、Depth(深度)、Visual、Randomness,适合不想大改角色卡时做轻量调整。 - 模型配置:使用 Ollama / LMStudio 加载器时,可编辑 Configurables/OllamaModelConfigs.json 和 Configurables/LMStudioModelConfigs.json 切换模型。
🔧 调参建议:先固定角色卡,再小步调整预设参数,每次只改一项,方便定位效果差异。
角色卡设置常见问题快速排查
| 问题 | 原因 | 解决方法 |
|---|---|---|
| 修改后性格没变化 | 角色卡只在启动时加载 | 重启 Z-Waif |
日志提示 No visual character card found! |
缺少视觉角色卡 | 补建 CharacterCardVisual.yaml,见 API/character_card.py |
| AI 不认自己的名字 | 角色卡与 CHAR_NAME 不一致 |
统一 .env 中的名字 |
| Oobabooga 下角色卡未生效 | CHARACTER_CARD 名称与 Oobabooga 中的角色卡不匹配 |
检查 .env 拼写 |
| 回复过于发散 | 采样随机性过高 | 换用 Standard 等更收敛的预设,或降低 temperature |
总结:Z-Waif 角色卡设置完整清单
- ✅ 编辑 Configurables/CharacterCard.yaml 写入性格、称呼与行为规则
- ✅ 在 .env 中同步
CHAR_NAME/YOUR_NAME名字参数 - ✅ 按需配置 Configurables/CharacterCardVisual.yaml 与
OLLAMA_VISUAL_CARD - ✅ 用 Configurables/Lorebook.json 添加专属记忆条目
- ✅ 用 OOBA_Presets/ 预设和 Configurables/Hangout/ReplyPersonality.json 微调语气
- ✅ 重启 Z-Waif,开始和全新的 AI 女友聊天吧!
按照这份 Z-Waif 角色卡教程,你就能以完全本地、免费的方式打造出性格定制、记忆深刻的 AI 女友。所有配置均为明文文件,随时可改、随时回退,祝你玩得开心!