快速開始

先執行本機工作台，驗證變數與封存，再設定模型對話。

先決條件與原始碼

準備 Node 22、Corepack 及 Git。以下命令使用 POSIX shell 語法，已在 macOS 檢查。使用新的原始碼目錄及空的 docs-data 目錄；伺服器只在資料庫房間為空時初始化預設房間。

git clone https://github.com/Golenspade/ai_tea-_party.git
cd ai_tea-_party
git checkout --detach 3177dd311461e7e2e2be50237997df534ca23c40
node --version
corepack [email protected] install --frozen-lockfile
mkdir -p docs-data

鎖定安裝會建置獲准的 better-sqlite3 原生相依套件。其他建置指令被忽略的警告，不表示需要全部批准；若具體命令失敗，先定位該錯誤。

啟動後端

在終端機 A 的儲存庫根目錄執行，並保持運作：

HOST=127.0.0.1 PORT=4318   DB_PATH="$PWD/docs-data/tea.db"   ARCHIVE_DIR="$PWD/docs-data/archives"   corepack [email protected] --filter ai-tea-party-backend exec tsx src/index.ts

另一個終端機執行 curl --fail http://127.0.0.1:4318/api/health，應回傳 status 為 healthy 的 JSON。這裡另行指定資料庫及封存目錄，集中保存教學記錄。第一條流程不需要 provider key。

啟動網頁

在終端機 B 的同一儲存庫根目錄執行：

NEXT_PUBLIC_API_BASE_URL=http://127.0.0.1:4318   NEXT_PUBLIC_WS_BASE_URL=ws://127.0.0.1:4318   corepack [email protected] --filter ai-tea-party-frontend dev --hostname 127.0.0.1 --port 3001

開啟 http://127.0.0.1:3001。頁面標題目前是「Index Rerum.」，側欄應出現預設角色、VARIABLES 及 ARCHIVE。第一次頁面編譯可能需要數秒。兩個終端機都保持運作。

取得第一次持久化結果

在 VARIABLES 中保持 Scope 為 Room、Op 為 set。
Name 填入 danger，Value 填入 0，點擊介面的「执行」。
確認 Room 清單及房間狀態區域顯示 danger 0。
點擊 ARCHIVE 區域的 Archive。
確認出現附時間戳記的新封存；重新載入頁面後，變數及封存應仍存在。

這驗證本機狀態與封存，不驗證模型對話。安裝檢查不需要點擊 Commence Auto-Dialogue、Speak 或 Compact，這些屬於模型流程。準備設定模型時再讀房間與對話。

停止與恢復

在各自終端機按 Control-C 停止伺服器。繼續使用相同工作台時，以相同的絕對 DB_PATH 及 ARCHIVE_DIR 重新啟動。資料庫與封存檔案應一併保留，資料庫記錄無法重建已遺失的封存檔。封存與預設說明如何匯出可重用設定。