正史回放
按账本里的场景逐场读原文,对白标注说话人,场景切换带动 3D 画面与节点地图。主线始终是原著。
按账本里的场景逐场读原文,对白标注说话人,场景切换带动 3D 画面与节点地图。主线始终是原著。
每个锚点停一次。原著做法是 canon,其余是处境下合理的别的做法,各有得失、后果旁白,再用一段 bridge 接回原著。
2–4 个属性、一个阶段目标、每章末的空闲行动、明确的失败结局。钱就写书里的钱数,不用 0–100 的空泛评分。
找 NPC 打听,对方真的把要点说出来才解锁之后某个抉择里更好的选项;吊胃口、卖关子不算。
人设来自上一个已结束阶段的角色卡,记忆来自账本,回答里出现玩家没提、且更晚才登场的名字会被打回。
three.js 低多边形实时渲染:人物有心情与姿势,地点按参数生成,锚点有定格。AI 图是可选增强,不是前提。
游戏的主线始终是原著;玩家走偏时,由旁白把他接回下一场。 Soft regression
n2g/
只放对所有中文小说都成立的机制:编码识别、切章、抽取提示词与校验、人物归并、知识账本、角色卡、引擎、NPC 运行时、3D 渲染、门槛。不含任何一本书的词、名或阈值。
games/<slug>/
书型、词表、噪声 / 合并 / 知情 / 地点四类规则、抽取说明、插件、人工金标、笔记;build/ 下是全部产物,可随时重建。
SKILL.md + stage*.md
九份阶段说明与一份问题模式库:每阶段怎么跑、看哪个指标、抽查什么、遇到问题修在哪一层。智能体照它干活,人照它验收。
同一个问题,先判断它属于哪一层,写在最上面能解决它的地方。框架层只有在两本以上的书里都遇到、并且能用通用规则解决时才改;改完在所有书上回归。
左右滑动查看全图
四条横向带:控制面决定按哪个阶段干活、过哪道门槛;批处理是十个步骤,实心点表示这一步要调用模型、计入额度;产物是 build/ 下的数据契约,任何一步都能从上游重建;运行时用同一个 engine.py 同时服务网页和模拟器。虚线是外部依赖或可选增强。
需要 API key 与额度离线免费
每一步都先看指标再过门槛。gate 记录指标与该阶段输入的哈希;改了规则或代码,status 会把受影响的阶段标成 stale——旧的“通过”不算数。
实体名必须在本章原文出现;每条事实附逐字引文;每个引号必须有说话人。不满足就退回模型重做,三轮不过标 unverified,下游(账本、角色卡、NPC 记忆)不当证据用。
八道门槛各有量化指标;金标是人工对照原文确认过的判断(这句谁说的、是不是同一个人、某章在不在场),每次重建自动复查。改了东西,过期检测告诉你哪一步要重跑。
六个落点,从上往下找第一个能解决的。写进框架的修复会污染所有书,所以框架层要两本书都遇到才动,动完全量回归。
一个守卫测试拿每本书的 S/A 级人名、别名、常用地点,反向扫描框架、测试和文档——往框架里写某本书的词,测试会当场失败。
模拟器与网页共用同一个引擎,跑三类玩家:永远选原著(必须活到最后)、按权重规划(必须能赢)、随机(必须可能输)。数值不对就让模型改,最多三轮,留最好的一版。
NPC 回答前只给四样东西:已结束阶段的角色卡、账本里他此刻知道的事、当前场景与玩家已读原文、玩法层的好感与情报。回答后再拦一次“未来名字”。
chinese-novel-to-game/
├── SKILL.md agent 入口:原则、落点表、阶段总览
├── stage0…stage8*.md 9 份阶段手册
├── patterns.md 问题模式库
├── NOTICE.md 法律声明
├── n2g/ 框架,42 个 .py
│ ├── text/ 清洗 · 切章 · 引号 · 噪声
│ ├── extract/ 逐章抽取与校验
│ ├── consolidate/ 人物归并 · 分词词典
│ ├── knowledge/ 角色卡 · 账本 · 地点
│ ├── game/ 引擎 · NPC · 设计 · 模拟 · 3D
│ └── art/ 可选:AI 图
├── tests/ 38 个离线测试
└── examples/ 自写 5 章示例(CC0)
克隆、虚拟环境、依赖,然后把密钥写进 .env。任何 OpenAI 兼容的接口都可以。
仓库自带 5 章自写文本,清洗、切章、书型诊断都不调用模型,不花钱。
长篇先做切片:在 book.json 写 "pilot": "0:30",只在 20–30 章上走通全流程,估好费用再放开。
python -m n2g play --slug demo,浏览器打开 127.0.0.1:8765。
测试全部离线,不读 .env,不需要模型:pytest -q。⓪① 免费;从 ② 起需要 API key 与额度,所有付费命令都支持 --budget。
git clone https://github.com/NorwinYu/chinese-novel-to-game.git
cd chinese-novel-to-game
python3 -m venv .venv && . .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env # 填 base_url / api_key / model
python -m n2g init examples/demo-novel.txt --slug demo --title 示例
python -m n2g ingest --slug demo
python -m n2g profile --slug demo
# 之后按阶段往下,每步先过门槛
python -m n2g extract --slug demo --chapters 0:30 --budget 1
python -m n2g gate extract --slug demo