用Laper创建剧情框架需先配置CLI环境并初始化项目，再通过YAML定义角色、场景及分支逻辑，最后执行laper play预览。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
用Laper创建剧情框架需要先理解它不提供可视化故事板或拖拽式结构搭建，而是通过YAML语法定义角色、场景和分支逻辑，直接编写文本文件后由引擎解析执行。
准备Laper运行环境
下载最新版Laper CLI工具，解压后将laper.exe（Windows）或laper（macOS/Linux）加入系统PATH；终端输入laper --version确认返回版本号≥0.9.2。
新建空文件夹作为项目根目录，在其中执行laper init生成config.yaml和scenes/目录——这一步必须完成，否则后续所有剧情文件无法被识别。
定义核心角色与初始状态
在scenes/同级目录下新建characters.yaml，按如下格式填写：
- id: hero
name: "林远"
traits: ["冷静", "左撇子", "旧伤复发时会咬嘴唇"]
stats:
sanity: 70
trust: 0
每个角色的id必须全小写且不含空格，这是后续所有分支跳转的唯一标识符；若写成Hero或hero_1，运行时会报错character not found。
搭建第一个剧情场景
在scenes/目录中新建01_opening.yaml，内容如下：
id: 01_opening
title: "雨夜出租车"
description: "后视镜里映出一张陌生女人的脸"
characters: [hero]
dialogue:
- speaker: hero
text: "师傅，去老城区梧桐巷。"
- speaker: driver
text: "……那地方早拆了。"
注意dialogue数组中的speaker值必须与characters.yaml里定义的id完全一致，大小写敏感；driver未在characters.yaml中声明，Laper会自动将其识别为NPC，无需预先定义。
添加分支选项与跳转逻辑
在01_opening.yaml末尾追加choices区块：
choices:
- text: "盯着后视镜看她到底是谁"
effect:
stat_changes: {sanity: -15}
next_scene: 02_mirror_reveal
- text: "低头假装系安全带，避开视线"
effect:
stat_changes: {trust: +5}
next_scene: 03_safe_route
每个next_scene指向的场景ID必须对应scenes/目录下真实存在的YAML文件名（不含扩展名），比如02_mirror_reveal.yaml；【文件名拼写错误或漏掉.yaml后缀会导致运行时直接退出，无任何提示】
启动剧情预览
回到项目根目录，终端执行laper play scenes/01_opening.yaml。
浏览器将自动打开本地预览页，显示首个场景对话及两个选项按钮；点击任一选项后，Laper实时更新角色状态并跳转至对应场景文件——此时你已成功跑通完整剧情框架链路。
