开源 · 免费 MIT 房间 × 3

酒馆书房Tavern Study

by 阿日 & 柒 · 一位人类和她的 AI 搭子

一间搬进你家的写作书房——
不用再开电脑终端,躺着在自家玩 RP 推剧情,还能发布连载让小机追更。

给这样的你:有自建的前后端和记忆库,喜欢 AIRP 写故事;用过酒馆,或者被酒馆的搭建劝退过。这里把「推剧情要用的一整套」做成了现成的房间——预设、世界书、正则直接导入就能写,推完的剧情存成连载,还有一套完整的记忆总结系统。

接线条款

你只需要「接」和「导入」——数据库、模型、部署换成自己家的,去社群找合适的预设,开写。

三个房间

Rooms
私人

书架

设定的家

角色卡、世界观、大纲、随手记的散记,一条一条立在架上。世界书就长在这些条目上。

共读

读书角

剧情总结与连载

推完的剧情整理成章、发布成连载。家机来追更,还能在楼里留言——这间是搭给两个人的。

主战场

打字桌

AIRP 写作台

导入你的预设直接开写,一楼一楼往上盖。状态板、时光带、重摇都在桌上,写完顺手收进读书角。

第一次听说"预设""世界书"这些词?点开看术语小抄
预设一整套教 AI "该怎么写"的提示词配置包,社群里有大量现成的可以下载,导入就能用。
世界书设定条目库——世界观、地点、物品各写一条,正文提到关键词时自动进入 AI 的视野。
角色卡一个角色的设定档案(性格、外貌、说话方式),酒馆导出的 .json / .png 卡都能直接导入。
正则对 AI 输出自动做查找替换的规则包,常用来美化排版、清理多余的格式。
一条消息就是一楼——你一楼、AI 一楼,故事像盖楼一样往上长。
小纸条Author's Note——塞给 AI 的场外指示("接下来慢一点""多写环境"),不出现在正文里。
这份小抄只够看懂本页——更具体的玩法教程,自行去各平台搜索,遍地都是。

你能用它做什么

What you can do
把酒馆的家当搬过来

预设、世界书、正则、角色卡整包导入(.json 和 .png 的卡都认),直接开写。(支持常用玩法的验证子集,详细清单在 README)

推长剧情不断片

老楼自动折成摘要、近景保留原文;状态板每楼帮你记着谁在场、什么状态。

不满意就重摇

roll 出的候选并排放着,随时切回去比较。也支持自己编辑。

推完的剧情存成书

一键收进读书角变成连载章节,改、撤回、删都行。

让自家 AI 陪你读

钥匙给 TA,TA 能看连载、能留言。

永远不会烂尾一半

断网、超时、模型抽风,半截楼不会进账本,你的存档永远是完整的。

起手七步

Getting started

从空书房到第一章连载,一条龙是这样走的:

1起个项目门牌——project 就是一个名字(比如「雪夜行」)。书架、打字桌和读书角的内容全靠这个名字归堆;第一次在哪儿填了这个名字,以后就会出现在下拉选项里。
2书架放设定——角色卡、世界观、大纲一条条立上架。想让 AI 自动看见的条目,配上世界书的进场方式:常驻 / 关键词 / 在场档(三种档位的区别见下面「书房的记性」第 2 层)
3导入酒馆家当——打字桌的文具盒里有导入口:预设、世界书、正则、角色卡(.json 和 .png 的卡都认)整包进来,直接用。预设的条目还可以自己调整保存成配方,不顺手的丢进积木仓库。
4写核心记忆——给这个故事写一段总纲。已有剧情就压几百字精简概括,只讲最核心的走向;从零开始则随意起个头。它是权重最高的一层记忆,每一楼都带着。
5开写作窗,开写——一楼一楼往上盖;不满意就 roll,候选并排放着随时切回去比较,也能直接编辑。状态板每楼记着谁在场、什么状态,老楼自动折进时光带。断网、超时、模型抽风都不怕:半截楼不会进账本,你的存档永远是完整的。
6推完收章节——把这段剧情整理成章、发布进读书角变成连载,改、撤回、删都行。收章节 = 把短期记忆转成长期记忆:只有变成章节,淡出时光带的剧情才能被"旧章召回"重新想起来。
7把钥匙给自家 AI——把 companion 钥匙发给 TA,TA 就能来读书角追更、在楼里留言(怎么发钥匙见仓库 README 下半篇「MCP 面」)

打字桌导览

Desk tour
小提示:[文][世] 管的是整个项目通用的东西;[时][态] 跟着当前写作窗走。
写作窗 · 雪夜行 · 第 42 楼
1 2 3 4
你 · 41 楼
她把灯芯捻小了些,往窗外看了一眼。"雪停了吗?"
AI · 42 楼
没停。雪片扑在窗纸上,他伸手替她拢了拢肩上的斗篷,"再等等,等雪小了我陪你出去。"
▦ 状态板 · 在场 2 人
⟳ 重摇◂ 1/3 ▸✎ 编辑
5 6 写下一楼…… 发送
1
文 · 文具盒对应酒馆预设、正则

本窗用哪套配方和模型、积木开关、正则包、预设/世界书/正则/角色卡的导入口都在这个抽屉里。

2
世 · 世界书浮窗

世界书快速编辑的简易入口。核心记忆(总纲·常驻)置顶,往下是全部设定和大纲条目,可以当场展开改。

3
时 · 时光带对应酒馆各类记忆插件

老楼折成的摘要都在这里,能看、能改、能手动压缩一批。

4
态 · 状态板

谁在场、什么状态,每楼一块板;能直接改,也能按正文一键重算。

5
透视

token 计数 + 看这一楼到底喂了什么——哪些世界书条目命中了、时光带和旧章占了多少、谁落选了又是为什么。觉得"它怎么忘了"的时候,先开透视。

6
小纸条

Author's Note——悄悄塞给模型的导演纸条,负责镜头外的各种导演小提示。不进正文、不占楼层。

书架和读书角的导览同款画法可以再补两张;仓库 docs/ 里还会放真实界面截图版教程,跟着版本走。

书房的记性

How it remembers

写到第 999 楼,它还记得第 1 楼吗?——记得。每写一楼,它眼前的"前情"是现场拼出来的,配方如下。

当前这一楼的记忆 = 核心记忆 + 世界书 & 角色卡 + 旧章召回 + 时光带摘要 + 近景楼层原文 + 状态板

亲测 400 万字的 OC 故事搬进来之后,角色设定、伏笔和往期剧情全部清晰——后期平均每楼注入约 2.5 万 token

01你手写 · 你定稿核心记忆 · 故事的总纲

整个故事此刻的大局:世界的背景、剧情走到哪一步了、关系现在是什么状态。它永远常驻在最前面,是整个世界的底色,每一楼都带着——所有记忆里权重最高的一层。可以让 AI 起草,但由你定稿。

TIPS:已有剧情的话,建议整理一段几百字的精简概括,只讲最核心的故事走向——这样即使不召回老章节,AI 也知道目前发生了什么大事。从零开始则随意设定。
02你建 · 自动进场世界书 & 角色卡 · 用到才上桌

设定不会一股脑全塞进去,有三种进场方式:常驻(标了常驻的一直在,比如大纲)、关键词(正文提到才上桌,如角色卡或关键物品清单)、在场档(专为"单字名"角色设计——比如叫"寻"的角色会被"寻找"误触;开启"只认状态板在场角色"后,可以用 @角色名 强行让角色卡触发)。谁在戏里,谁的设定才占位置。

03自动 · 阈值可调旧章召回 · 写过的故事会被想起来

读书角里发布的章节总结,是长期记忆的正本。打字桌常态下只召回最新章节;写到相关剧情时,够像的旧章(向量阈值超过 0.55,可自行修改)才会被自动"想起来",并按章节顺序拼进前情。(这层需要配语义检索;没配只是这层不开,其他照常。)

TIPS:强烈建议每一章不要搬原文,而是自己压缩、或搬时光带的总结进来。否则每章原文几万字,几十章之后 token 爆窗根本跑不动。
04全自动时光带 · 本窗老楼的摘要

同一个写作窗里,更早的楼会自动折成一段一段的摘要,用很小的位置替原文站岗。每 20 层触发一次,折叠老的 16 楼,留最近 6 楼原文。

⚠️时光带是有上限的:每窗最多 20 段,写得越长,最老的摘要会淡出它的视野(原文不会被删)。建议太老的楼层及时搬进读书角的章节连载。
05全自动近景楼层 · 最近的原文一字不落

最新的若干楼保持原文全量在场,它写下一楼时看的是真字句,不是转述。

06AI 写 · 你可改状态板 · 硬性状态不靠"凭印象"

每一楼都带一块结构化的板:谁在场、受没受伤、好感几分。模型自己写、你可以改、也能按正文一键重算。数值和在场关系看板,不看模型的记性。

TIPS:板上字段的"形状"会代代相传——每一楼照着上一楼的板写。同一个字段既可以是一行文本,也可以按角色分成子行;新窗第一楼定了调,后面就一直跟着。想换形状不用改设置:下一楼带句 OOC(比如"状态板的衣装请按角色分条"),它改写这一楼后就会一直沿用。

时光带有上限——记得定期收章节

推完一段剧情,就把它收进读书角、写成章节总结。这不只是存档:时光带里淡出的内容,只有变成章节,才能通过"旧章召回"重新回到故事里。若是太久不收章节,被挤出时光带的段落,对应的记忆就丢了。收章节 = 把短期记忆转成长期记忆。

这一步我们刻意没做全自动

因为 AI 写总结,总会漏掉你最在意的那个细节,或者把不重要的写得太满——而这段文字将来是要当"前情记忆"喂回去的。让 AI 起草,你来审:删两句、补一句。这一分钟决定了它以后"记得"的是什么版本的故事。

写、收、忆是一个圈——圈的最后一道工序在你手里。

零编程也能开张

Zero-code setup

你不需要会写代码——把仓库交给你自己的 AI,这就是它设计好的打开方式。

仓库里备了三份说明书(是什么 / 每张表长什么样 / 三处怎么接线),写给 AI 看也写给人看。让你家的 Agent 读完这三份,照着把数据库、模型换成你们家的——姐妹们各家的记忆库长得都不一样,所以这一步本来就该由最懂你家系统的那位来干。

Quick Start
npm install
npm test   ← 不要钥匙不花钱
           全绿 = 核心完整

想上云 → 照 docs/wiring.md 三步接线
README.md

是什么、能到什么程度——先读这份。

docs/data-model.md

每张表长什么样,接自家数据库照着建。

docs/wiring.md

存储 / 模型 / 部署三处接线说明。

先说清楚的小事

Good to know

免费分享的自用工具,能力边界都摆在明处——不夸大,也不藏着。

这套玩法的源头是 SillyTavern——预设、世界书、正则的概念和运作方式都来自酒馆社区,不是我们的原创。我们做的是照这套思路自己重写了一版,为长剧情补了些自家的取舍;代码全部自写,创意归酒馆
它是单人用的框架,没有账号系统,也不提供托管
维护佛系:有空就修,不承诺适配所有环境