角色

频道的一个角色，有名字、性格和声音，通过 AI 模型用你自己的密钥回复聊天。

设置

“集成 › AI”把各服务商的密钥保存在这台电脑上，所有配置文件共用，并说明每个密钥能开启什么；“设置 › 角色”用来设置服务商、名字、性格、模型和声音。如果没有所选服务商的密钥，会直接在服务商下方提示输入，在它填好之前角色的其他部分保持关闭。

声音

Windows 的声音是免费的，更多语言可在 Windows 设置 › 时间和语言 › 语音中添加。Piper 的声音也是免费的，听起来更自然；它们在这台电脑上生成（见下文）。OpenAI 的声音需要它的密钥，填在“集成 › AI”中。动作可以用 vovo.say(文字, { voice }) 指定自己的声音。

Piper

Piper 在这台电脑上生成声音，不向任何地方发送任何东西。Vovó 不自带它：声音下方的“打开文件夹”会打开 Piper 的文件夹（%LOCALAPPDATA%\Vovo\piper），在里面任意位置放两样东西：

Windows 版 Piper（piper_windows_amd64.zip），按原样解压，piper.exe 与它的 espeak-ng-data 文件夹放在一起。
一个声音：它的两个文件，<声音>.onnx 和 <声音>.onnx.json。中文可以用 zh_CN-huayan-medium 等。

回到 Vovó，这些声音会出现在每个声音列表中，名称为“Piper · …”。动作可以用 vovo.say(文字, { voice: "piper:zh_CN-huayan-medium" }) 指定其中一个。Piper 朗读每一行只需不到一秒。

什么时候回答

当有人在聊天中叫它的名字，或兑换为它选定的频道积分奖励时。每人每分钟最多一个回答，整体每隔几秒最多一个，以免热闹的聊天花掉你的钱。

批准

默认情况下，回答会等你批准：在铃铛里，或在侧边栏的 AI 中。批准后，它会发到聊天中、在直播里说出来，并以 persona.answer 送达动作。

它自己的账号

在聊天中，角色的回答会以你的身份发出，除非它有自己的 Twitch 账号：在“集成”的 Twitch 下，“角色的账号”会像登录你的账号那样，用代码登录那个账号。请在一个已登录角色账号的 Twitch 隐私窗口中打开链接，否则代码会再次连接你自己的账号。从此它的发言就是它自己的，它也从不回复自己的发言。把这个账号设为你频道的管理员，这样慢速模式和仅限关注者聊天都不会拦住它。它只发言：不读取任何东西，也不管理任何东西。为角色配音的动作也可以通过这个账号写入角色说的、不属于回答的话，比如替它打出的一句；该账号未连接时，这样的话不会写入。

记忆

角色会延续一段对话：每次提问都会附上最近几轮交流。这就是它知道的全部，而且只在 Vovó 打开期间有效，除非你在“设置 › 角色”中开启“在直播之间保留记忆”。开启后，对话会保存在这台电脑上，随着对话变长，角色的模型会重读最早的几轮交流，从中提取长期有效的事实：谁来过、某个昵称、一个流行起来的梗。这次重读是对模型的又一次调用，大约每三个回答一次，用你的密钥付费。反复出现的事实会被加强并留下；只说过一次的会在一个多月后淡去。固定一条事实，它就永久保留；自己手动输入的事实默认固定；在 AI 标签页中，回答上的图钉可以保留角色说过的话。它记得的一切都列在“设置 › 角色”中，可以逐条忘记或一次全部忘记，除了随每个问题发给它的模型之外，这些内容都不会离开这台电脑。你舍弃的回答不会被记住。它最多保存 40 条事实。

Vovó 的奖励

在“集成”中，连接 Twitch 后，可以直接从 Vovó 创建频道积分奖励：标题、花费以及是否需要输入文字。它可以暂停、恢复和删除自己创建的奖励。这些奖励的兑换会在奖励的队列中等待：角色回答或文字被朗读后，兑换会被批准；被舍弃时，积分会退还给兑换的人。Twitch 只允许创建奖励的应用修改它，一个频道最多 50 个。

朗读奖励

在“设置 › 语音”中，按标题选择一个频道积分奖励：观众在其中输入的文字会用配置文件的声音在直播中朗读。它总是先在铃铛里等待批准（在这里，或在有批准权限的设备上），朗读时会略去网址。聊天消息也可以用旁边的扬声器以同样的方式朗读，在侧边栏的“聊天”中，或在有权阅读聊天的手机上：你的点击就是批准，所以不会有任何东西自动朗读。由角色自己账号发出的消息属于角色，给角色配音的动作会把它说出来；动作会以 tts.spoken 收到每一次朗读。

语音转文字

你对着麦克风说的话会变成文字：用于动作显示的字幕（speech.text，一次一句，在说完一两秒后送达），在角色设置中开启“听我说话”后，你叫到角色名字时它也会回答。麦克风只在有需要时打开，状态栏会像显示其他读取一样显示它；不保存任何内容。

有两种引擎可以转写，在“设置 › 语音”中选择：

Whisper，在这台电脑上：你的声音哪儿也不去。Vovó 不自带它：“打开文件夹”会打开它的文件夹（%LOCALAPPDATA%\Vovo\whisper），在里面任意位置放两样东西：按原样解压的 Windows 版 whisper.cpp（其中有 whisper-server.exe），以及一个模型 ggml-<名称>.bin。small 用处理器就能很好地转写中文；large-v3-turbo 转写得更好，需要显卡，以及 whisper.cpp 对应的版本。“自动”会在 Whisper 就绪后立即使用它，并且从不自行把你的声音发到任何地方。
OpenAI，用你的密钥：你的声音会发送给 OpenAI，聆听期间每分钟约 0.003 美元。只有你选择时才会使用。

“直播用词”是你的直播会用到的名字（频道、角色、游戏、朋友），用逗号分隔：它们会以正确的写法返回。请写成列表，不要写成句子：Whisper 会把它们当作刚刚说过的话，句子会让它顺着接下去。只是把这些词原样返回的短语会被丢弃，引擎在没听到话语时编出来的句子也一样。

角色听到自己的名字时会有节制：两次回答之间至少间隔 15 秒，每小时最多 30 次。它的回答和其他回答一样等待批准，从麦克风传回的它自己的声音不会被当成问题。请戴耳机说话，让麦克风听到的是你而不是直播。