快速開始

先決條件與原始碼

你需要 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。第一次編譯頁面可能要幾秒。兩個終端機都保持運作。

取得第一次持久化結果

1. 在 VARIABLES 中，Scope 保持 Room，Op 保持 set。
2. Name 填 danger，Value 填 0，點擊介面的「执行」。
3. 確認 Room 清單和房間狀態區域顯示了 danger 0。
4. 點擊 ARCHIVE 面板裡的 Archive。
5. 確認出現一個附時間戳記的新封存項目。重新載入頁面後，變數和封存應該還在。

這一步驗證的是本機狀態和封存，不是模型對話。安裝檢查階段不需要點 Commence Auto-Dialogue、Speak 或 Compact——那些是模型流程的控制項。準備好設定模型時再去看房間與對話。

停止與恢復

在各自終端機按 Control-C 停止伺服器。要恢復同一個工作台，用相同的絕對路徑 DB_PATH 和 ARCHIVE_DIR 重新啟動就好。資料庫和封存檔案要一起保留——光有資料庫記錄沒辦法重建已遺失的封存檔。怎樣匯出可重用設定，看封存與預設。