开源 · 免费 · MIT tavern-home 是 tavern-study 的独立维护分支，专注开箱即用。
一间搬进你家的写作书房——预设、世界书、正则、角色卡直接导入就能写，推完的剧情存成连载，配一套完整记忆系统，长剧情到第 999 楼还记得第 1 楼。
本分支的改进：一键启动（run.bat）、更顺手的本地体验、面向新用户的快速上手文档。
双击根目录的 run.bat，自动完成：
- 安装依赖（根目录 + 前端，首次运行会等几分钟）
- 生成
.dev.vars配置模板（首次），填好ANTHROPIC_API_KEY后重新运行一次 - 初始化本地数据库
- 启动后端（
http://localhost:8787）+ 前端（http://localhost:3000） - 自动打开浏览器
之后每次双击
run.bat即可一键拉起，两个服务窗口别关。
npm install
cd frontend && npm install && cd ..
npm run db:init:local
# 若没有 frontend/.env.local，从 frontend/.env.example 复制并填：
# NEXT_PUBLIC_WORKER_URL=http://localhost:8787
# NEXT_PUBLIC_AUTH_TOKEN=<与 .dev.vars 里的 AUTH_TOKEN 一致>
npm run dev # 后端 → http://localhost:8787
cd frontend && npm run dev # 前端 → http://localhost:3000在根目录 .dev.vars 里配置模型供应商：
ANTHROPIC_API_KEY=你的key
AUTH_TOKEN=任意强口令（前端 URL 用的路径 token）
OWNER_TOKEN=另一个强口令（管理/MCP 用）- 书架 📚（私人 · 设定的家）——角色卡、世界观、大纲、散记一条条立上架，世界书长在这些条目上。
- 读书角 📖（共读 · 剧情总结与连载）——推完的剧情整理成章、发布成连载，AI 伴侣来追更、留言。
- 打字桌 ⌨️（主战场 · AIRP 写作台）——导入预设直接开写，状态板、时光带、重摇都在桌上。
- 起个项目门牌 —— project 就是一个名字（比如「雪夜行」），第一次填了以后就出现在下拉里。
- 书架放设定 —— 角色卡、世界观、大纲立上架，配世界书进场方式：常驻 / 关键词 / 在场档。
- 导入酒馆家当 —— 打字桌文具盒有导入口：预设、世界书、正则、角色卡（
.json/.png）整包进来。 - 写核心记忆 —— 给故事写段总纲（几百字即可），权重最高的记忆层。
- 开写作窗，开写 —— 一楼一楼往上盖，不满意就 roll；推完收进读书角变章节连载。
每一楼的「前情」= 核心记忆 + 世界书&角色卡 + 旧章召回 + 时光带摘要 + 近景楼层原文 + 状态板
| 层 | 内容 | 进不进场 |
|---|---|---|
| 核心记忆 | 你手写的故事总纲 | 永远常驻 |
| 世界书&角色卡 | 设定，按关键词/常驻/在场档触发 | 用到才上桌 |
| 旧章召回 | 读书角已发布章节的语义检索 | 写到相关剧情才想起来 |
| 时光带 | 本窗老楼的自动摘要 | 每 20 层折 16 层（有损，原文不删） |
| 近景楼层 | 最近几楼原文一字不落 | 全自动 |
| 状态板 | 谁在场/状态的结构化数据 | 每楼带着 |
- 美化卡 iframe 会执行包内脚本——导入不可信预设包前自己掂量。
- 路径 token / Bearer token 只是参考鉴权，不是生产级门禁，公网部署前自行加固。
- 导入不做自动审查——整包原样进库，内容是否可信由你负责。
MIT，见 LICENSE。版权署名：阿日 & 柒（tavern-study 原作者）。
特别感谢 SillyTavern 社区：预设、世界书、正则这套玩法的开创者。