Ph'nglui mglw'nafh Cthulhu R'lyeh wgah'nagl fhtagn.
我以为,世上最仁慈的事,莫过于人类的心智无法把它所知的一切关联起来。
H. P. 洛夫克拉夫特,《克苏鲁的呼唤》
《克苏鲁的呼唤》第 7 版 · AI 守秘人
真彩字符画 · 程序配乐 · 单人与联机 · 终端 / 浏览器
AutoKeeper 是一款中文跑团游戏。AI 担任《克苏鲁的呼唤》第 7 版的守秘人(KP,跑团的主持人),你扮演调查员,用自然语言行动、交谈和探索。AI 负责备团、扮演人物、裁定检定、安排遭遇,并按调查进展掌握节奏。可以一个人玩、带上 AI 同伴,也可以让朋友用浏览器加入同一场故事。
- 模组只是起点:玩家走到原作没写的地方,守秘人会补出新的人物、线索和支线。世界引擎记下每个人在哪、手里有什么、说过什么、答应过什么,后面的故事接着用。
- 规则照书执行:检定、孤注一掷、理智与疯狂、战斗和追逐按第 7 版规则结算,骰子由物理模拟投出。
- 看得见,也听得见:照片转成真彩字符画,画面随时间、天气和剧情变化;配乐由程序实时编写。
- 什么故事都能开团:导入自己的模组,AI 整理成可以直接玩的版本;也可以只给一句设定,让 AI 写一本原创模组。
《追书人》:在阿诺兹堡图书馆翻旧报。检定的骰子落定后,守秘人讲出报上的内容;右栏是人物状态、调查经过和玩家自己的笔记。
游戏特色
一局跑团怎么进行
《追书人》从早班火车驶入阿诺兹堡开始。委托人托马斯住在小镇尽头的公墓旁,你可以先向站务员问路、在餐馆吃早饭,或者去图书馆翻旧报纸。在输入框写下想做的事,比如“请管理员拿来十多年前的旧报合订本”,守秘人判断要不要检定、花多少时间、能发现什么,再把结果讲给你听。
旅途、闲谈和人物关系也是故事的一部分,不必每一步都直奔线索。守秘人决定何时留出交谈和休整的空间,何时让异状出现、危险逼近。叙述的篇幅、节奏和恐怖程度可以调整;想严格按原作玩,可以关掉即兴。
有自己打算的人物
每个 NPC 都有动机、秘密和没做完的事。他们会帮忙、隐瞒、撒谎、抢先一步,也会被说服、威胁或打动而改变主意。说“钥匙不在我这里”的人可能在撒谎,钥匙在谁手里以实际交接为准;答应“我陪您去”,就得真的同行。不在场的人按自己的日程行动,你换个场景或过一段时间再回来,事情可能已经变了。
撞开的门、掉在地上的武器、受过的伤、打空的弹匣,都会留到下一次遭遇。游戏每回合自动存档,续玩时整局的世界和经历都还在。
模组之外的故事
下面两张是玩家游玩《冬雪之下》的实机截图。
一局麻将。 玩家在饭桌上提议打麻将,原模组没有这段。多琳问起玩法,门廊边的年轻人也接过话头,守秘人顺着凑一桌的需要让人物入局,一场临时起意的消遣成了结识 NPC 的机会。
会合之后。 两组玩家分头调查后在诊所会合,有人把贝尔当成了诊所的护士,医生在交谈中纠正:她是来查病情的。各组分头得到的见闻,通过对话汇进了同一个场面。
和朋友一起:分头行动,各看各的
房主开好房间,把网址发给朋友,对方用浏览器就能加入,不用安装,也不用配置模型。每个座位可以是真人,也可以交给 AI 调查员。
分头调查时,各组同时推进,各自看到所在现场的叙述;个人观察、私信、图片和手稿只发给实际的收件人,玩家之间可以保留信息差。各组共用同一个世界:同一个 NPC 不会同时出现在两处,一组拿走的东西,另一组就找不到了。检定结果要不要公开、要不要接受队友替你提的行动,都由你自己决定。有人断线时,AI 暂时替他行动,重连后交还。浏览器加入的人在设置里只能改自己的画面,只在本次连接中生效,看不到也改不了房主的密钥、模型和路径。
同一局《冬雪之下》里两位玩家的屏幕:一人在主街向铲雪的人打听,一人在布鲁彻农场跟着雷吉去牛棚。各自只看到自己现场的叙述,右栏显示队友在哪。
画面跟着故事变
模组里的照片和插图会转成真彩字符画。天色随游戏时间变化,雨、雪、雾叠在画面上;在场人物的小像嵌在画面一角,色调跟着场景走。按 Ctrl+A 换画法:
同一张照片的四种画法:块字符、点阵、速写、纯 ASCII。另有两种带轮廓线的块字符画法。
同一个地点的画面会随剧情换版本。某人来了、线索找到了、天黑了,画面就换成相应的版本,构图不变,事情过去再换回来;老宅失火这样的长期变化,本局会重画一张。编译时还会给值得细看的东西准备特写,比如卡洛琳地窖里的香炉、废弃农舍墙上的符号。这些版本由 AI 照原图绘制,需要本机装有 Codex。
《冬雪之下》:埃里在主街时,街角多了他的卡车;发现线索后,农舍的墙皮下露出烧出来的符号。
开场、危机和结局用整屏「大场景」呈现。模组缺图的地点、人物和物件,会从公共图库找照片,由读图模型挑选和裁剪;找不到合适的,由 AI 补画(Codex、Nano Banana 或豆包 Seedream)。
实时编写的配乐
配乐不是预先录好的曲子,而是程序边玩边写。守秘人叙述的气氛变了(日常、悬疑、不安、恐怖、紧迫、悲伤、震撼、余波),音乐在下一小节跟着变;战斗、追逐和理智损失由游戏直接处理,室外和夜晚的音色也不同。每局有自己的调性和主题,同一场景每隔几个乐句换一次主奏乐器和节奏,弦乐、钢琴、竖琴、八音盒、管风琴、玻璃琴、长笛、大提琴、圆号、马林巴轮流出现;恐怖时有男声的仪式吟唱,悲伤时有女声无词哼唱。终端和浏览器都能播放,标题画面有自己的曲子。
试听:▶ 悬疑 · ▶ 恐怖 · ▶ 紧迫(各二十多秒,由游戏的作曲与合成代码离线渲染,也可以在项目网页上直接播放)
上面三段试听的前十二小节,按乐器分色。竖线是小节线,淡线是重音分组:3+2+2 就是一个 7/8 小节。
手稿与资料
信件、日记、剪报、电报和典籍各有纸色、墨色和版式,手写的信和日记用斜体,墨迹逐字显现;有原件扫描的,可以在游戏里全屏查看。游戏不替你整理线索清单,发现都在叙述、对话和材料里;你可以把任何一段原文存进自己的笔记。
| 《追书人》:道格拉斯的日记 | 《冬雪之下》:军队电报 |
线索板
按 F2 打开线索板。板上只有实际到你手里的东西:收到的材料原样一张,见过的人是告诉过你的名字和见到的样子,去过的地方是名字和场景图,再加上你自己写的笔记。游戏不写总结,也不替你连线。卡片随手拖动摆放,从图钉拖到另一张卡片拉一条红线,线上可以写标签,卡片下面可以写批注;双击材料,按发到手时的样子重看。线索板比窗口大,拖动空白处移动视野。终端支持 Sixel 时,红线和图钉画得更细。
照规则书结算
需要检定时,你亲手掷 3D 物理模拟的十面骰,骰子有六种皮肤可选。失败后可以花幸运,也可以说明新的做法孤注一掷,由裁定员复核实际耗时和后果。理智损失、临时与不定性疯狂、重伤与濒死、急救与医学、幕间成长都按规则结算;调查卡住时可以请求灵感检定(Ctrl+L)。
失去理智时,屏幕上的部分文字变成乱码,片刻后变回来,损失越大越多;手稿开着时,等你关上再播放。疯狂期间,读到的叙述一直夹杂乱码,直到恢复或通过现实认知检定。
| 失去理智 | 临时疯狂 |
战斗逐轮结算,包括以多打少、射击修正、卡壳、贯穿和濒死;对手只能按它实际看到、听到的行动,跟丢了就追不上。追逐沿地图路线展开,翻墙、钻灌木、撞门各有检定,追逐和战斗可以互相转换,伤势、弹药和掉落的武器一直保留。
| 书房里的战斗 | 墓园里的追逐 |
手上有规则书的话,可以导入建立本地索引。裁定员遇到引擎没有实现的规则(溺水、坠落、火、法术等)会查原文,你用 /kp 问规则时也会附上原文和页码。施法的魔法值、POW 与理智消耗按法术条目原文结算,学会的法术记在人物卡上。
规则也不限于第 7 版。规则插件可以改动核心规则本身,不只是追加效果。游戏附带绿色三角洲(Delta Green)的规则包,照《特工手册》结算毅力、崩溃点、适应、重要关系、致死率和幕间的私人规划;挂上它的模组按绿色三角洲的规则跑,人物卡上也显示这些数值。
什么故事都能开团
把 PDF、Word、Markdown、纯文本或 ZIP 拖进「导入模组」。AI 读完原文,整理出人物的知识与动机、线索的发现条件、事件日程、全镇地图、建筑的平面图、战斗数值和追逐路线,保留原有的插图和手稿,再对照原文复核一遍。年代照原文,现代团、维多利亚时代都可以;别的规则体系的模组也能导入:有规则包的(如绿色三角洲)按原体系写,挂上规则包照它的规则跑;没有的,剧情照原文,机制换成第 7 版。小说同样能导入,也可以只给一句设定,由 AI 查资料、写一本原创模组:
autokeeper generate "1931 年上海,一张没有标签的唱片" --id changpian
导入后的模组可以打成 .akmod 文件分享(autokeeper library pack 模组ID)。同一张图如果出现在多个地点,分享包只存一份,安装时会恢复原有的素材路径。
游戏自带《追书人》《冬雪之下》《有些人油盐不进》三本模组,第一次玩推荐单人入门的《追书人》。
按 F3 打开地图。全镇地图是纸色的手绘图,按模组自己的地理摆放:导入时根据原书的地图图片或文字决定各地点的位置和道路,并检查一遍。在楼里按 F3 看到的是平面图,可以切换楼层,标出每个房间里的人。
| 全镇地图 | 楼内平面图 |
调查员
开局可以选模组预设的调查员,也可以自己建卡。写一句设想(“落魄的禁酒令私家侦探”),或者给一个历史人物的名字,AI 会查资料、找肖像,结合模组年代问你三个背景问题,再按第 7 版规则算好属性和技能点。也可以手动车卡:在规则书样式的人物卡上掷骰或分配属性、按年龄调整、从《调查员手册》的职业表选职业,自己分配职业技能点和兴趣技能点,规则会随时检查。已有的卡可以直接导入:骰娘 .st 属性串、Excel、PDF、Word、纸质人物卡的照片,以及酒馆角色卡(PNG / JSON)。
单人开局选「我的卡」后,可以直接使用原背景,也可以选「适配模组背景」。确认前可预览改编,采用的背景只随这局保存。
角色库:自己创建和导入的人物卡,可以编辑、导出,带进新的调查。
...这是什么?
屏幕一角掠过一抹虹彩。
安装
当前版本 0.0.9.6,支持 Windows(x64)、macOS(Apple 芯片)和 Linux(x86_64)。
# Linux、macOS、WSL
curl -fsSL https://raw.githubusercontent.com/satoshinji2992/autokeeper/main/install.sh | bash
# Windows PowerShell
irm https://raw.githubusercontent.com/satoshinji2992/autokeeper/main/install.ps1 | iex
开局
- 运行
autokeeper,在首次配置里选择模型、填写密钥,可以先点「测试连接」。 - 选「新的调查」,挑一个模组和调查员。
- 在输入框写下行动或台词。需要检定时按提示掷骰;下次启动从「继续调查」接着玩。
支持 DeepSeek、Claude、Codex、Ollama 和 OpenAI 兼容接口;守秘人、NPC、裁定、读图等分工可以分别指定模型(F9)。Ctrl+B 查看用量和估算花费;用 Ollama 可以不联网游玩。
| 按键 | 作用 | 按键 | 作用 |
|---|---|---|---|
F1 |
玩法说明 | F5 |
三个行动建议 |
F2 |
线索板 | F9 |
模型设置 |
F3 |
地图 | Ctrl+A |
换画法 |
F4 |
人物卡 | Ctrl+L |
灵感检定 |
联机、规则书、守秘人卡组和全部按键见游玩指南。
存档与回放
从标题页「回放」打开打过的局,按空格暂停、方向键跳轮、V 切换全桌或调查员视角。新版联机回放按各席实际收到的消息播放,能重看当时各自见到的场景、幻觉文字和收到的私信。AI 调查员的试玩也能回放,全程无需连接模型。
新存档和写满的回放分卷会自动无损压缩。退出游戏后,可以整理已有存档和回放:
autokeeper compact-saves
autokeeper replay 存档名 --compact
开发者后台
在游戏里按 F12,或在终端运行 autokeeper dev,会打开一个只读的本机网页(只有这台电脑能访问),按回合列出这一局发生了什么:掷骰和结果、交给谁的叙述和台词、世界记录的改动、哪里出了错,以及耗时和花费。中央是这一局的人物、地点、线索和事件,每一项都能点开。后台显示的是守秘人才知道的内容,开着它玩会剧透;联机时只有房主能打开。
| 一回合的实时视图 | 调用具体行动 |
文档
反馈问题请写明模组名和当轮行动,在 Issues 提交。需要完整记录时,用 autokeeper report 生成报告,确认其中的对局内容后私下发给开发者。
致谢与许可
终端界面基于 Textual 构建,照片转字符画使用 chafa,掷骰与骰娘指令使用 BCDice,智能体编排与原文检索分别基于 LangGraph、LangChain 与 LightRAG。
AutoKeeper 程序不开源。本仓库公开玩法文档、项目网页、模组格式与样例、自带模组,授权见 LICENSE;examples/module/ 是 CC0 格式样例。自带模组《追书人》(改编自 Chaosium 出版、Bret Kramer 著 Paper Chase)、《冬雪之下》与《有些人油盐不进》均为同人改编,原作版权归各自原作者与出版方所有,仓库不含原模组文本与原版插图;模组选用的历史照片均来自 Wikimedia Commons,署名与授权见各模组的 art/credits.yaml(追书人、冬雪之下、有些人油盐不进)。「画面跟着故事变」截图中的农舍墙面照片为 A S M Jobaer 的 Weathered brick wall with peeling plaster 02(CC BY-SA 4.0),其差分图依原照片改画,同样按 CC BY-SA 4.0 提供;主街的差分图依 Steve Shook 的照片(CC BY 2.0)改画。标题画面背景取自 Dominique Signoret 的画作 Cthulhu and R'lyeh(CC BY-SA 3.0,Wikimedia Commons)。Call of Cthulhu 是 Chaosium Inc. 的注册商标,本项目与 Chaosium 无关。
Metadata
Release files for autokeeper 0.0.9.6
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| autokeeper-0.0.9.6-cp312-cp312-win_amd64.whl | CPython 3.12 | CPython 3.12 | Windows x86-64 | Details for autokeeper-0.0.9.6-cp312-cp312-win_amd64.whl |
| autokeeper-0.0.9.6-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl | CPython 3.12 | CPython 3.12 | Linux glibc 2.17+ x86-64, Linux glibc 2.28+ x86-64 | Details for autokeeper-0.0.9.6-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl |
| autokeeper-0.0.9.6-cp312-cp312-macosx_11_0_arm64.whl | CPython 3.12 | CPython 3.12 | macOS 11.0+ ARM64 | Details for autokeeper-0.0.9.6-cp312-cp312-macosx_11_0_arm64.whl |
Total release size: 91.5 MB
Release files / autokeeper-0.0.9.6-cp312-cp312-win_amd64.whl
| Download URL | autokeeper-0.0.9.6-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 27.2 MB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
0c201cc5db2b10387a48066fbe02a5f2cdabf0beb729603cd8ee51da757a33b2
|
|
BLAKE2b-256 checksum How to use checksums |
45ef10d536bf0c15a151dbf8bd6a443735feaeb2ab5a1daa5449560f312ef87d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.4 {"installer":{"name":"uv","version":"0.13.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / autokeeper-0.0.9.6-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
| Download URL | autokeeper-0.0.9.6-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 35.8 MB |
| Tags | CPython 3.12 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
66e59e5883b501e31d9408b4e953f1fac107680b76a867768c28633165957860
|
|
BLAKE2b-256 checksum How to use checksums |
6add0df5ec16d01cc88372da89db972011f0683f8be98387c47b9fed3974edb6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.4 {"installer":{"name":"uv","version":"0.13.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / autokeeper-0.0.9.6-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | autokeeper-0.0.9.6-cp312-cp312-macosx_11_0_arm64.whl |
|---|---|
| Size | 28.6 MB |
| Tags | CPython 3.12 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
21340097e3966e7e532d65f6a7b8606ecfc94a19d2d73c6fd9502206a2192f04
|
|
BLAKE2b-256 checksum How to use checksums |
9b8607240fef6b96330c27a7c068493a0b5349b4fceb0786589eef87795b804a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.4 {"installer":{"name":"uv","version":"0.13.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for autokeeper 0.0.9.6
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.