laper中主角必须用【main】在首行声明且唯一,配角用cast批量定义并严格缩进;验证需看状态栏提示、@补全及运行时高亮。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在Laper中创建主角和配角需要先定义角色类型,再通过特定语法声明实例,否则后续对话逻辑无法识别角色身份。
创建主角
主角必须且只能有一个,用 【main】 关键字声明,位置需在文件最上方、任何对话块之前。
在Laper脚本开头第一行写:main: 主角名
例如:main: 林晚。这行代码不能缩进,不能加引号,不能写成“主角:林晚”或“main = 林晚”,否则解析器会报错并跳过角色初始化。
创建配角
配角用 cast 关键字批量声明,支持中文名、英文名或混合命名,一行一个,名字间无需逗号分隔。
方法一:基础声明
cast:
陈默
苏砚
Dr. Lee
注意:cast: 后必须换行,每个配角名独占一行,前面用全角空格(或两个半角空格)缩进,缩进不统一会导致部分角色未被加载。
方法二:带类型标注(可选)
cast:
陈默 → friend
苏砚 → rival
Dr. Lee → authority
箭头右侧的类型会影响AI对角色关系的理解权重,但不是必需字段;若填写,类型词必须是Laper内置关键词之一,填错类型不会报错但会降权处理。
验证角色是否生效
第一步:保存文件后,在编辑器右下角查看状态栏是否显示 “✅ 1 main + 3 cast loaded”
第二步:在任意对话块中输入「@主角名」或「@配角名」,如果出现高亮提示且能触发自动补全,则角色已成功注册。
第三步:运行测试时,若某角色名在对话中始终显示为灰色未识别状态,说明该角色未被 cast 正确加载,需返回检查缩进和换行——【cast 块内空行会截断后续所有角色声明】。











