房间与对话

对话前先配置房间

当前网页围绕默认房间工作。后端另有房间 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 属于对话摘要流程，不能当成备份的同义词。归档可能包含消息、人设、世界信息与变量，分享前检查正文。需要省略历史的可复用配置时，参考归档与预设。