世界书格式标准

定位: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%

关键说明

1. 描述字段是灵魂

描述 同时承载目标底线概述,LLM 一次性读取。示例:

# 正例:目标清晰,底线明确
描述: 匡扶汉室为志(目标),绝不负兄弟(底线),待人真诚重信守诺得人心
# 反例:空泛,LLM 不知道角色要什么
描述: 一个善良的人

2. 规则写成一句话

LLM 读一句话规则比读 key-value 更易理解。规则之间不依赖上下文。

# 好
- 人物死即永久退场,不复活不诈尸
# 不好
  death_rule: permanent

3. 初始条件键名对齐资源追踪

起始.条件 的键名必须对应资源追踪中的名称(含别名前缀)。示例:资源追踪有 名望[声望, 名声, 名气],条件中应使用 名望: 无名

4. 可扮演角色两种形式

形式 适用 写法
引用 历史/已有 NPC 引用: 刘备 + 增补 场景
自写 穿越者/原创角色 名号: xxx + 全量出身/描述/关系/起始/条件

5. 推演架构

YAML → 校验 → 入库缓存                   (部署时)
         ↓
世界设定 → 每轮固定注入 system prompt     (推演时)
世界内容 → 关键词匹配 → 动态注入
可扮演角色 → 选择后注入

版本记录

版本 日期 变更
v1.2 2026-06-06 精简章节,内嵌完整模板
v1.1 2026-06-04 适配两流程架构
v1.0 2026-06-04 基于 _template.yaml 重构
返回首页 · 顶部