定位:Story 世界书的 YAML 数据模型规范。
通用规则:
| 规格 | 限制 | 标识 |
|---|---|---|
| 一般项 | ≤ 50 字 | — |
| 长句 | ≤ 200 字 | 行尾 # 长句 |
| 列表项 | 见模板注释 | # 最多 N 项 |
别名格式:名称: 主名[别名1, 别名2]。中括号内为关键词匹配别名,最多 8 个。无别名可不带。
引用约束:地点.人物、关键人物.关系.对象 中出现的名字必须已在关键人物列表中。
可扮演角色引用:引用: 关键人物名称 可继承其出身/描述/性格/关系/起始/条件(不继承趋势)。增补项同名覆盖父项。
以下为完整模板,包含所有字段定义、注释和约束说明:
作者: 作者名
名称: 世界书名称
# ═══════════════════════════════════════════════════════════
# 一、世界设定(固定加载 · 每轮注入)
# ═══════════════════════════════════════════════════════════
描述: 东汉末年至三国时期,皇权崩塌群雄逐鹿。基调写实厚重,重谋略轻武力 # 长句
世界运转规则: # 3-6 项
- 世界基于真实历史,禁止穿越架空和超自然设定
- 人物死即永久退场,不复活不诈尸
时间模式:
纪元: 东汉末期
起始: 中平元年(公元184年)二月
规律: 按现实时间推进,时间跳跃幅度由剧情决定
经济模式:
货币: 五铢钱
物价: # 1-6 项
- 项目: 一斗米
价格: 20-30钱
规律: # 1-4 项
- 战乱地区粮价可翻5-10倍
世界演变趋势: # 最多 12 个转折点
转折:
- 184年: 黄巾起义,唐周告密八州举兵
- 189年: 汉灵帝驾崩,宦官外戚同归于尽
资源追踪: # 最多 6 项
- 名称: 钱财[钱, 银子, 盘缠, 铜钱]
单位: 五铢钱
描述: 通用生存资本
- 名称: 名望[声望, 名声, 名气]
单位: 无名/小有名气/名动一方/天下皆知 # 阶段递进表示法
描述: 高名望易获举荐和从者
# ═══════════════════════════════════════════════════════════
# 二、世界内容(关键词匹配 · 动态注入)
# ═══════════════════════════════════════════════════════════
# 注入优先级:关键人物 > 势力 > 地点
# 同类优先级:声明顺序靠前的条目优先
地点: # 最多 20 项
- 名称: 洛阳[洛都, 京城]
区域: 司隶
势力: 东汉朝廷
人物: [何进, 张让, 袁绍] # 最多 10 个,须在关键人物列表
印象: 权力中心,表面繁华暗藏杀机
- 名称: 长安[旧都, 西京]
区域: 雍州
势力: 东汉朝廷
人物: [董卓, 王允, 吕布]
印象: 旧都残破,军阀争夺的战场
势力: # 最多 10 项
- 名称: 东汉朝廷[汉室, 朝廷]
首领: 汉灵帝
领地: 司隶 + 各州名义统治
状态: 宦官、外戚、士族三派互相制衡
- 名称: 黄巾[太平道, 黄巾军]
首领: 张角
领地: 八州潜伏,冀州巨鹿为核心
状态: 叛徒唐周告密,起义被迫提前
关键人物: # 最多 20 项
- 名称: 刘备[刘玄德, 皇叔, 中山靖王]
出身: 织席贩履,自称中山靖王之后
描述: 匡扶汉室为志(目标),绝不负兄弟(底线),待人真诚重信守诺
性格: 外柔内刚,善识人用人,表面谦和内心坚定
趋势: # 最多 6 项
- 184年: 桃园结义,率义兵讨伐黄巾
- 194年: 入主徐州,开始拥有自己的地盘
关系: # 最多 10 项,对象须在关键人物列表
- 对象: 关羽
说明: 结义兄弟
- 对象: 张飞
说明: 结义兄弟
起始:
地点: 涿郡
年龄: 28岁(184年二月)
作为: 在集市以织席贩履为生
条件: # 最多 6 项
钱财: 贫寒(日均十几钱)
名望: 无名
- 名称: 曹操[曹孟德, 曹阿瞒]
出身: 宦官之后太尉之子,洛阳北部尉
描述: 雄才大略以统一天下为志(目标),绝不放下兵权(底线)
性格: 机警有权数,任侠放荡不治行业
趋势:
- 190年: 散家财合义兵,参加讨董联军
- 196年: 迎献帝迁都许昌,挟天子以令诸侯
关系:
- 对象: 袁绍
说明: 旧友,少时交游
起始:
地点: 洛阳
年龄: 20余岁(184年二月)
作为: 任北部尉,在府中处理公务
条件:
钱财: 殷实
名望: 官宦世家
# ═══════════════════════════════════════════════════════════
# 三、可扮演角色
# ═══════════════════════════════════════════════════════════
# 最多 6 项。支持引用关键人物(引用: 名称),继承其出身/描述/性格/关系/起始/条件,
# 在此之上只写增补项即可。
可扮演角色: # 最多 6 项
- 引用: 刘备 # 从关键人物继承全部信息
起始:
场景: 听到旁边有人议论官府贴募兵告示
- 引用: 曹操
起始:
场景: 密探来报黄巾即将起事
- 名号: 理科穿越者[林哲] # 非 NPC 人物,全部信息自写
出身: 21世纪理工科大学生
描述: 带着现代知识和手机穿越到乱世
关系:
- 对象: 刘备
说明: 初识于涿郡集市
起始:
地点: 涿郡
年龄: 25岁(184年二月)
作为: 在涿郡集市游荡
场景: 穿着奇装异服,引来路人侧目
条件:
钱财: 无
手机电量: 67%
描述 同时承载目标、底线、概述,LLM 一次性读取。示例:
# 正例:目标清晰,底线明确
描述: 匡扶汉室为志(目标),绝不负兄弟(底线),待人真诚重信守诺得人心
# 反例:空泛,LLM 不知道角色要什么
描述: 一个善良的人
LLM 读一句话规则比读 key-value 更易理解。规则之间不依赖上下文。
# 好
- 人物死即永久退场,不复活不诈尸
# 不好
death_rule: permanent
起始.条件 的键名必须对应资源追踪中的名称(含别名前缀)。示例:资源追踪有 名望[声望, 名声, 名气],条件中应使用 名望: 无名。
| 形式 | 适用 | 写法 |
|---|---|---|
| 引用 | 历史/已有 NPC | 引用: 刘备 + 增补 场景 |
| 自写 | 穿越者/原创角色 | 名号: xxx + 全量出身/描述/关系/起始/条件 |
YAML → 校验 → 入库缓存 (部署时)
↓
世界设定 → 每轮固定注入 system prompt (推演时)
世界内容 → 关键词匹配 → 动态注入
可扮演角色 → 选择后注入
| 版本 | 日期 | 变更 |
|---|---|---|
| v1.2 | 2026-06-06 | 精简章节,内嵌完整模板 |
| v1.1 | 2026-06-04 | 适配两流程架构 |
| v1.0 | 2026-06-04 | 基于 _template.yaml 重构 |