Skip to main content

AutoKeeper 标题画面:克苏鲁与拉莱耶的彩色字符画

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
同一张照片的四种画法:块字符、点阵、速写、纯 ASCII。另有两种带轮廓线的块字符画法。

同一个地点的画面会随剧情换版本。某人来了、线索找到了、天黑了,画面就换成相应的版本,构图不变,事情过去再换回来;老宅失火这样的长期变化,本局会重画一张。编译时还会给值得细看的东西准备特写,比如卡洛琳地窖里的香炉、废弃农舍墙上的符号。这些版本由 AI 照原图绘制,需要本机装有 Codex。

冬雪之下的画面版本:主街平时与埃里在时(街角停着卡车);农舍墙面在发现线索前后(墙皮下露出烧出的符号)
《冬雪之下》:埃里在主街时,街角多了他的卡车;发现线索后,农舍的墙皮下露出烧出来的符号。

开场、危机和结局用整屏「大场景」呈现。模组缺图的地点、人物和物件,会从公共图库找照片,由读图模型挑选和裁剪;找不到合适的,由 AI 补画(Codex、Nano Banana 或豆包 Seedream)。

追书人开场的大场景:阿诺兹堡早班车,车站照片转成整屏彩色字符画
整屏大场景:《追书人》开场,早班火车停在阿诺兹堡。

实时编写的配乐

配乐不是预先录好的曲子,而是程序边玩边写。守秘人叙述的气氛变了(日常、悬疑、不安、恐怖、紧迫、悲伤、震撼、余波),音乐在下一小节跟着变;战斗、追逐和理智损失由游戏直接处理,室外和夜晚的音色也不同。每局有自己的调性和主题,同一场景每隔几个乐句换一次主奏乐器和节奏,弦乐、钢琴、竖琴、八音盒、管风琴、玻璃琴、长笛、大提琴、圆号、马林巴轮流出现;恐怖时有男声的仪式吟唱,悲伤时有女声无词哼唱。终端和浏览器都能播放,标题画面有自己的曲子。

试听:▶ 悬疑 · ▶ 恐怖 · ▶ 紧迫(各二十多秒,由游戏的作曲与合成代码离线渲染,也可以在项目网页上直接播放)

三段配乐前十二小节的钢琴卷帘图:悬疑、恐怖、紧迫,按乐器分色,标出拍号与重音分组
上面三段试听的前十二小节,按乐器分色。竖线是小节线,淡线是重音分组:3+2+2 就是一个 7/8 小节。

手稿与资料

信件、日记、剪报、电报和典籍各有纸色、墨色和版式,手写的信和日记用斜体,墨迹逐字显现;有原件扫描的,可以在游戏里全屏查看。游戏不替你整理线索清单,发现都在叙述、对话和材料里;你可以把任何一段原文存进自己的笔记(F2)。

道格拉斯·金博尔的日记:米色纸张、红色页边、斜体手写正文 冬雪之下的军队电报:黄色电报纸上贴着一条条打字纸条
《追书人》:道格拉斯的日记 《冬雪之下》:军队电报

照规则书结算

需要检定时,你亲手掷 3D 物理模拟的十面骰,骰子有六种皮肤可选。失败后可以花幸运,也可以说明新的做法孤注一掷,由裁定员复核实际耗时和后果。理智损失、临时与不定性疯狂、重伤与濒死、急救与医学、幕间成长都按规则结算;调查卡住时可以请求灵感检定(Ctrl+L)。

战斗逐轮结算,包括以多打少、射击修正、卡壳、贯穿和濒死;对手只能按它实际看到、听到的行动,跟丢了就追不上。追逐沿地图路线展开,翻墙、钻灌木、撞门各有检定,追逐和战斗可以互相转换,伤势、弹药和掉落的武器一直保留。

追书人书房里的战斗:犬脸的佝偻身影占满画面,旁边是出手先后与伤势,下方是战斗记录、行动选单和被攻击时的应对 墓园里的追逐:调查员追着犬脸的佝偻身影,右侧是到出口的路,下方是灌木的几种过法
书房里的战斗:对手只显示伤势描述,被攻击时按 Tab 切换应对 墓园里的追逐:右侧是通往出口的路线和障碍

手上有规则书的话,可以导入建立本地索引。裁定员遇到引擎没有实现的规则(溺水、坠落、火、法术等)会查原文,你用 /kp 问规则时也会附上原文和页码。施法的魔法值、POW 与理智消耗按法术条目原文结算,学会的法术记在人物卡上。年代不限于 1920 年代,现代团的技能和武器同样能用。

什么故事都能开团

把 PDF、Word、Markdown、纯文本或 ZIP 拖进「导入模组」。AI 读完原文,整理出人物的知识与动机、线索的发现条件、事件日程、房间与平面图、战斗数值和追逐路线,保留原有的插图和手稿,再对照原文复核一遍。年代照原文,现代团、维多利亚时代都可以;别的规则体系的模组或小说也能导入,剧情照原文,机制换成第 7 版。导入中断了,下次接着做。

也可以只给一句设定,由 AI 查资料、写一本原创模组:

autokeeper generate "1931 年上海,一张没有标签的唱片" --id changpian

游戏自带《追书人》《冬雪之下》《有些人油盐不进》三本模组,第一次玩推荐单人入门的《追书人》。

冬雪之下的地图:主街、诊所、教堂、邮局与农场之间的路,右侧是所选地点的说明与路程 追书人金博尔家的平面图:调查员所在的空卧室、走廊与客厅、托马斯的卧室和道格拉斯的书房
地图只画已知的地点和道路,选中地点可以直接前往 在楼里打开地图是平面图,标出每个房间里的人

调查员

开局可以选模组预设的调查员,也可以自己建卡。写一句设想(“落魄的禁酒令私家侦探”),或者给一个历史人物的名字,AI 会查资料、找肖像,结合模组年代问你三个背景问题,再按第 7 版规则算好属性和技能点。已有的卡可以直接导入:骰娘 .st 属性串、Excel、PDF、Word、纸质人物卡的照片,以及酒馆角色卡(PNG / JSON)。

角色库:管理自己创建与导入的人物卡
角色库:自己创建和导入的人物卡,可以编辑、导出,带进新的调查。

更多界面:开房间、选模组、人物卡、存档、模型设置

冬雪之下开房间界面:左侧是座位与调查员选择,右侧是选中调查员的肖像与人物卡
开房间:安排真人与 AI 座位、选择调查员,预览人物卡。

模组选择界面:冬雪之下的故事介绍、调查人数与场景预览 人物卡:调查员的背景、属性与完整技能列表
选模组:故事介绍、人数、时长和场景预览 人物卡:背景、属性与完整技能列表
存档管理:模组、调查员、游戏时间和地点,以及存档预览 模型设置的各分工模型页:守秘人、裁定、NPC、导演等分工与各自的模型
继续调查:存档的时间、地点与预览 模型设置:各分工可以分别指定模型

安装

当前版本 0.0.7.2,支持 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

安装脚本会准备好 uv、Python 3.12 和 AutoKeeper;掷骰需要 Node.js 22+,Windows 脚本会自动安装。装好后在新终端运行 autokeeper,autokeeper serve 可以在浏览器里玩。朋友加入你的房间只需要浏览器,不用安装。

更新时先退出游戏,再运行一次安装命令,存档和设置都会保留。联机时房主和玩家要用同一版本。手动安装和各系统的依赖见游玩指南。

第一局

  1. 运行 autokeeper,在首次配置里选择模型、填写密钥,可以先点「测试连接」。
  2. 选「新的调查」,挑一个模组和调查员。
  3. 在输入框写下行动或台词。需要检定时按提示掷骰;下次启动从「继续调查」接着玩。

支持 DeepSeek、Claude、Codex、Ollama 和 OpenAI 兼容接口;守秘人、NPC、裁定、读图等分工可以分别指定模型(F9)。Ctrl+B 查看用量和估算花费;用 Ollama 可以不联网游玩。

按键 作用 按键 作用
F1 玩法说明 F5 三个行动建议
F2 笔记与资料 F9 模型设置
F3 地图 Ctrl+A 换画法
F4 人物卡 Ctrl+L 灵感检定

联机、规则书、守秘人卡组和全部按键见游玩指南。

文档

  • 游玩指南:模型配置、按键、战斗与追逐、规则书与卡组、联机。
  • 模组格式:手写或修改模组,配置大场景。
  • 规则插件:用插件给模组加特殊机制。

反馈问题请提交 Issue,附上模组名、当轮行动和相关日志。

麻将与诊所会合两张图是玩家提供的实机截图,其余界面图在当前程序里载入固定场景截取。

致谢与许可

终端界面基于 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.7.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distributions (wheels)

Table of built distributions (wheels) for autokeeper 0.0.7.2
File Interpreter ABI Platform Actions
autokeeper-0.0.7.2-cp312-cp312-win_amd64.whl CPython 3.12 CPython 3.12 Windows x86-64 Details for autokeeper-0.0.7.2-cp312-cp312-win_amd64.whl
autokeeper-0.0.7.2-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.28+ x86-64, Linux glibc 2.17+ x86-64 Details for autokeeper-0.0.7.2-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
autokeeper-0.0.7.2-cp312-cp312-macosx_11_0_arm64.whl CPython 3.12 CPython 3.12 macOS 11.0+ ARM64 Details for autokeeper-0.0.7.2-cp312-cp312-macosx_11_0_arm64.whl

Total release size: 69.9 MB

Release files / autokeeper-0.0.7.2-cp312-cp312-win_amd64.whl

Download URL autokeeper-0.0.7.2-cp312-cp312-win_amd64.whl
Size 21.0 MB
Tags CPython 3.12 Windows x86-64
SHA-256 checksum
How to use checksums
2a28943540fc322a77ba894a80088bae3cd478f37d5aeea1777716713a77c6af
BLAKE2b-256 checksum
How to use checksums
3d19f804e11e4346c60fabd5bf2a8f20e87a5609b332647ac007679ae46d842e
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.7.2-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl

Download URL autokeeper-0.0.7.2-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
Size 27.0 MB
Tags CPython 3.12 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
a2453098a2ffef62d804a38d8666cab5162a4b377510b515156cf6b1af098876
BLAKE2b-256 checksum
How to use checksums
3123f26fd08fa390a37904745176a63cfbe1f593db72138f230438159e09b922
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.7.2-cp312-cp312-macosx_11_0_arm64.whl

Download URL autokeeper-0.0.7.2-cp312-cp312-macosx_11_0_arm64.whl
Size 21.9 MB
Tags CPython 3.12 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
b0f03ec42d572f5e2d295ad745e3d52bf9e1fc9f192025cdbad5680f3f0a3d9f
BLAKE2b-256 checksum
How to use checksums
6c8b797183cfe721130771ca877eedd1aecf986cf9987ae8f83bb14b9e8574b4
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.7.2

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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page