如何设置Z-Waif角色卡:自定义AI女友性格与形象的完全方法

原创2026-11-16 11:46:5564 阅读

如何设置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/ 目录,切换任务时角色卡之外的行为描述会一并拼入对话,实现"一个女友,多种性格模式"。


进阶:加载器预设与回复性格微调

角色卡决定"她是谁",加载器参数决定"她怎么说话":

🔧 调参建议:先固定角色卡,再小步调整预设参数,每次只改一项,方便定位效果差异。


角色卡设置常见问题快速排查

问题 原因 解决方法
修改后性格没变化 角色卡只在启动时加载 重启 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 角色卡设置完整清单

  1. ✅ 编辑 Configurables/CharacterCard.yaml 写入性格、称呼与行为规则
  2. ✅ 在 .env 中同步 CHAR_NAME / YOUR_NAME 名字参数
  3. ✅ 按需配置 Configurables/CharacterCardVisual.yaml 与 OLLAMA_VISUAL_CARD
  4. ✅ 用 Configurables/Lorebook.json 添加专属记忆条目
  5. ✅ 用 OOBA_Presets/ 预设和 Configurables/Hangout/ReplyPersonality.json 微调语气
  6. ✅ 重启 Z-Waif,开始和全新的 AI 女友聊天吧!

按照这份 Z-Waif 角色卡教程,你就能以完全本地、免费的方式打造出性格定制、记忆深刻的 AI 女友。所有配置均为明文文件,随时可改、随时回退,祝你玩得开心!

登录后查看全文
z-waif