简言简语

语言规则总览

语言总规则和页面分工。

语言定位

语言层

简言简语 是语言层,负责脚本结构、变量、表达式、控制流、参数写法和文件入口规则。

产品层

FengshenBot 是产品层,负责注册和执行具体自动化动作。动作库不等于语言本体。

命名与参数规则

动作名

正式文档和示例优先写中文动作名。动作是否存在、参数有哪些,由 FengshenBot 动作索引确认。

参数名

正式脚本优先写命名参数,参数名必须来自对应动作的真实参数表,不能自造近义词。

一行一动作

简言简语逐行解析。常见结构是:动作名 参数1=值 参数2=值

中文优先

当前可兼容部分英文名,但对外文档、教学示例和模型生成建议统一主写中文。

文件与入口规则

.txt

主推格式。首个非空行必须是 # 简言简语 v1

.jy

专业格式。当前不强制要求文件头。

.json

结构化定义格式。主要用于程序接入、调试和内部转换,不作为普通脚本文本入口。

接口正文

接口直传的是脚本文本正文,按简言简语正文解析,不强制要求 .txt 文件头。

变量与控制流摘要

变量

变量常见写法是 设置、裸赋值、{变量} 占位引用和 保存为

控制流

正式支持 如果 / 再如果 / 否则 / 结束 / 循环 / 遍历 / 无限循环 / 跳出 / 继续

信息不足时如何保守生成

先读语言规则,再读动作能力

先用语言规则确定语法结构,再按需加载某一类 FengshenBot 动作索引页。

先写已知必填项

不确定时宁可只保留必填参数,也不要自造动作名、参数名和默认值。

优先复用稳定骨架

先生成变量、条件、循环等语言骨架,再补充具体动作。不要把动作实现细节写成语言规则。

不要把解释当脚本

条件、参数、动作名位置只能放脚本文本本体,不要塞自然语言解释。

如何选择后续页面

  • 继续看语言规则时,直接从左侧点到对应规则页。
  • 需要查动作能力时,直接从左侧动作索引进入目标类别页。
  • 动作索引页只回答产品能力,不负责定义语言语法。