简言简语

文件与入口规则

语言规则，便于按需加载和稳定抽取。

动作流载体

.txt

主推格式，面向大多数用户。首个非空行必须是 # 简言简语 v1。

.jy

专业格式，面向 IDE 识别和工程化管理。当前不强制要求文件头。

.json

结构化定义格式，主要用于程序接入、调试和内部转换。

共同边界

这三类是动作流载体，不改变简言简语本身的语言规则。

.txt 文件头规则

.txt 脚本首个非空行必须是：

# 简言简语 v1

最小 .txt 示例：

# 简言简语 v1

打印 内容="你好，世界"

.jy 规则

.jy 走同一套简言简语语法，但当前不强制要求文件头。

打印 内容="你好，世界"

接口直传正文规则

当前对外接口不再提供“直接提交简语正文执行”的入口。

  • 要复用现成简语动作流文件：走 /action-flows/run 的 script_path 模式。
  • 要程序直接提交 JSON 动作流：走 /action-flows/run 的 steps 模式。
  • 文件落盘成 .txt 时，仍然建议保留文件头。

何时用哪种载体

  • 日常脚本、教程示例、对外发送：优先 .txt。
  • 专业脚本库、IDE 文件关联、工程化归档：推荐 .jy。
  • 程序接入、调试数据、内部转换：使用 .json。