快速开始

前置条件与源码

你需要 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 重启就行。数据库和归档文件要一起保留——光有数据库记录没法重建已丢失的归档文件。怎样导出可复用配置，看归档与预设。