房間與對話

對話前先設定房間

目前的網頁介面圍繞預設房間運作。後端也提供房間 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 屬於對話摘要流程，不要把它當成備份的同義詞。封存裡可能包含訊息、人設、世界資訊和變數，分享之前先檢查內容。需要省略歷史記錄的可重用設定，參考封存與預設。