房间与对话

对话前先配置房间

当前网页界面围绕默认房间工作。后端也提供房间 API，但通过 API 新建房间不代表网页上有房间切换器。预设示例会明确使用这些 API。

侧栏的"添加角色"用来配置 AI 角色，"人设管理"描述你扮演的身份，"世界观管理"提供设定和上下文。角色和用户人设不是同一回事，这些设定也无法保证模型一定遵循你写的每一条要求。

变量与条件

VARIABLES 支持 Room 和 Global 两种范围，以及 set、add、inc、dec 操作。条件判断需要数字时，请使用数值。像 danger = 0 这样的变量本身只是存储状态——只有当世界信息条目、行为规则或工具实际引用它时，它才可能影响叙事走向。条件判断支持 exists、eq、ne、gt、gte、lt、lte、includes、truthy，以及 AND/OR 组合。

房间状态和 Active Branches 面板帮你检查变化。变量更新了，不等于模型已经生成了某个你期望的响应。

有意识地启用模型对话

当前源码按顺序从应用保存的设置、环境变量、已有的 Pi 登录文件中解析 provider 凭据。不创建 .env 不一定就完全禁用了模型访问。不要把凭据写进场景预设或共享归档里。

选好支持的 provider/model，确认你打算发送的上下文之后，用 Speak 让某个角色发言，或用 Commence Auto-Dialogue 启动自动调度。新产生的模型消息才是真正的成功信号——按钮处于运行状态或 socket 已连接都不够。在修改配置或离开应用之前，先用停止按钮结束自动调度。

Agent 使用 Ask 时，ASK 面板会显示一个待回答的问题。在那里选择或输入答案来继续交互。房间在等待回答不一定表示卡住了。具体的问题和后续内容取决于模型，本指南没有对真实 provider 验证这一部分。

Archive 与 Compact

Archive 保存一份可以检查和导出的本地快照。Compact 属于对话摘要流程，不要把它当成备份的同义词。归档里可能包含消息、人设、世界信息和变量，分享之前先检查内容。需要省略历史记录的可复用配置，参考归档与预设。