快速开始

前置条件与源码

准备 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 重启。数据库与归档文件应一起保留，数据库记录不能重建已丢失的归档文件。归档与预设说明如何导出可复用配置。