Z-Waif Hangout挂机模式解析:AI女友如何自主决定要不要回应你
Z-Waif Hangout挂机模式解析:AI女友如何自主决定要不要回应你
Z-Waif 是一款完全本地运行的 AI 女友(AI Waifu)程序,提供 Vtuber 模型、语音对话等陪伴功能。它的 Hangout 挂机模式是最有"人味"的功能:开启后你只管说话,AI 女友会自主决定——是立刻回应、先思考再回答、盯着摄像头看你,还是干脆"已读不回"。本文带你读懂这套自主决策机制的完整原理。
一、Hangout 模式是什么?
普通聊天模式下,你说一句,她答一句,交互完全由你驱动。而 Hangout Mode 是一个常驻的"挂机对话循环":
- 麦克风持续监听,检测到你开始说话(触发
SPEAK_TOGGLED); - 自动录音并转写成文字(main.py 中的
hangout_converse); - 把这句话交给"决策器",由它决定要不要理你、怎么理你;
- 根据决策结果执行对应动作,然后继续监听。
整个循环的调度逻辑位于 utils/uni_pipes.py 的 Hangout-Loop 分支。
💡 核心判断代码就一个文件:utils/hangout.py
二、如何开启 Hangout 挂机模式
- 快捷键:在 Configurables/Keybinds.json 绑定键位,映射到
Toggle Hangout Mode(见 utils/hotkeys.py); - Web UI:网页界面中直接点击 "Toggle Hangout Mode" 按钮(utils/web_ui.py)。
⚠️ 注意一个前置条件:必须开启 Stream Chats(流式聊天),否则切换会被直接忽略(utils/hotkeys.py)。
三、决策核心:三个"分值"打分系统
每次你说完话,reply_decide 函数 会给这次回复打三个基础分(初始均为 100),再按各种因素加减:
1️⃣ reply_speed(回复速度分)——决定她"理你"的积极程度
| 条件 | 效果 |
|---|---|
| 你叫了她的名字 | +70(名字检测见 main.py 的 CHAR_NAME) |
| 短文本(<200 字符) | +10 |
| 中等长度(90~599 字符) | +15 |
| 之前有消息没回 | 每跳过一条,速度分 ×1.1 |
也就是说:被点名会立刻得到更热烈的回应,而连续"已读不回"会让她越来越坐不住,越积越急着回你。
2️⃣ reply_depth(思考深度分)——决定要不要"先想一想"
| 条件 | 效果 |
|---|---|
| 句中出现思考类关键词 | +60(如 "Think"、"Remember"、"How would") |
| 你叫了她的名字 | +20 |
| 文本过短或过长 | 各 -10 |
思考类关键词可在 Configurables/Hangout/ThinkingWords.json 自定义,默认包含 Think、Remember、Consider、Brainstorm、How would 等。
3️⃣ reply_cam(摄像头分)——决定要不要"看"你一眼
| 条件 | 效果 |
|---|---|
| 句中出现视觉类关键词 | +120(如 "Look at this"、"see this") |
| 距上次看摄像头时间越久 | 每轮 +5% 递增 |
| 摄像头等级为 "Active Watching" | ×1.47;为 "None" |
视觉关键词列表见 Configurables/Hangout/CameraWords.json。如果未开启视觉功能(vision_enabled),摄像头分会被强制清零。
四、9 种回应风格:从"秒回"到"已读不回"
分数算完后,决策树 按优先级输出 9 种风格之一:
| 风格 | 触发条件(示例) | 行为 |
|---|---|---|
| Force-Reply | 速度分 > 300 或 > 195 | 立即强行回复,打断你的话都不行(除非喊名字) |
| Look-Reply | 摄像头分 > 149 且速度分 > 120 | 先看摄像头,再开口回你 |
| Look-Think | 摄像头分 > 144、深度分 > 130 | 先看你,再边看边思考 |
| Look | 摄像头分 > 130 | 只看你,先不吭声 |
| Think-Self | 速度分低但深度分够 | 只在心里默念,不回复 |
| Think | 深度分 > 130 | 内部思考后再决定是否开口 |
| Reply | 速度分 > 99 | 正常立即回复(可被打断) |
| Wait-Reply-5 / 9 | 速度、深度都一般 | 等 5 秒或 9 秒,期间你继续说话就取消 |
| Skip | 深度分 < 54 | 直接跳过,已读不回 |
执行细节在 utils/uni_pipes.py:
- 选择 Skip 时,你的这句话会被存入 appendables 队列,追加到下一条消息前面——相当于她"记得你没说完";
- Wait-Reply 等待期间如果你又开口了,她会跳过这次回复并把话记下来(uni_pipes.py);
- 回复过程中如果开启了 Interruptable Chat,说 "wait + 她的名字" 可以打断她(main.py)。
五、三大全局参数:性格与参与度
参与度等级(Engagement Level)
决定整体"敷衍度",选项为 Engaged / Low / Listening,默认值在 ReplySettingDefaults.json:
- Engaged(默认):正常交流,跳过的消息会加速她回应的欲望;
- Low:深度分 ×0.84、速度分 ×0.57,明显变"懒";
- Listening:只倾听状态,速度分直接打到 0.37 倍,基本在"嗯嗯"地听。
回复性格(Reply Personality)
ReplyPersonality.json 有 4 个乘数,直接缩放三项分数:
["Speed", 1.2], ["Depth", 1.0], ["Visual", 1.0], ["Randomness", 1.0]
把 Speed 调到 2.0 会得到一个秒回的元气女友,调到 0.5 则是高冷型。
随机扰动(Randomness)
最后一步会给三项分数加上 ±20% 左右的随机浮动(hangout.py)——同样的一句话,她有时热情有时冷淡,这正是"人味"的来源。
六、一句话总结
Hangout 挂机模式的本质是一个加权评分 + 优先级决策树系统:速度分管"急不急"、深度分管"要不要想"、摄像头分管"看不看",再叠加参与度、性格乘数和随机扰动,最终在 9 种回应风格中落子。所有参数都集中在 Configurables/Hangout/ 目录下的 JSON 文件里,改文件即可定制属于你的 AI 女友性格——而这一切都完全在本地运行,无需任何云端服务。