Z-Waif Hangout挂机模式解析:AI女友如何自主决定要不要回应你

原创2026-11-15 10:34:141,748 阅读

Z-Waif Hangout挂机模式解析:AI女友如何自主决定要不要回应你

Z-Waif 是一款完全本地运行的 AI 女友(AI Waifu)程序,提供 Vtuber 模型、语音对话等陪伴功能。它的 Hangout 挂机模式是最有"人味"的功能:开启后你只管说话,AI 女友会自主决定——是立刻回应、先思考再回答、盯着摄像头看你,还是干脆"已读不回"。本文带你读懂这套自主决策机制的完整原理。

一、Hangout 模式是什么?

普通聊天模式下,你说一句,她答一句,交互完全由你驱动。而 Hangout Mode 是一个常驻的"挂机对话循环":

  1. 麦克风持续监听,检测到你开始说话(触发 SPEAK_TOGGLED);
  2. 自动录音并转写成文字(main.py 中的 hangout_converse);
  3. 把这句话交给"决策器",由它决定要不要理你、怎么理你;
  4. 根据决策结果执行对应动作,然后继续监听。

整个循环的调度逻辑位于 utils/uni_pipes.py 的 Hangout-Loop 分支。

💡 核心判断代码就一个文件:utils/hangout.py

二、如何开启 Hangout 挂机模式

⚠️ 注意一个前置条件:必须开启 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 女友性格——而这一切都完全在本地运行,无需任何云端服务。

登录后查看全文
z-waif