文本可描述
一行一句,缩进即子栈。decompile(compile(x)) 与原文逐字相同,程序因此可以被 diff、被生成、被审查。
积木程序一直躺在图形界面里:人可以看,但机器很难读、很难比对、很难自动判断对错。 MiniTry 把这段空白补成一条可测的链——文本能描述结构,编译能校验结构,运行能给出确定的结论。
一行一句,缩进即子栈。decompile(compile(x)) 与原文逐字相同,程序因此可以被 diff、被生成、被审查。
编译产物直接是 project.json,而不是运行时块对象。纯 JSON 意味着可以 golden 比对,也能在载入 VM 之前查完结构。
无头 runner 在 Node 里手动按帧驱动,断言按帧号判定。同一个项目跑两次,报告逐字节相同。
一条命令跑完整条链:解析、校验、编译、载入、运行、断言。 每一步的产物都是纯数据,可以存成 golden,也可以拿来比对。
# 编译、运行、采样、断言
on flag:
set 计数 = 0
repeat 7:
change 计数 by 2
if <计数 > 10>:
say "过半了"
每条诊断都带层号、严重级别、行号与独立的 hint 字段。message 只讲哪里错了, hint 单独成字段——它是后续修复循环的直接输入。
| 层 | 检查 | 抓什么 | 何时跑 |
|---|---|---|---|
| L1 | 语法 | 词法 / 语法错误,带行列号 | 编译前 |
| L2 | 目录 | opcode 存在性、别名唯一性、别名参数个数 | 解析后 |
| L3 | 槽位 | 输入名是否属于该 opcode、必填项是否齐全、菜单槽位能否合成 | lowering 前 |
| L4 | 符号 | 变量 / 列表 / 广播 / 角色是否存在且作用域合法;同名遮蔽告警 | lowering 后 |
| L5 | 结构 | 帽子块居首、C 块必须有子栈、[3, null, ...] 非法形态、next / parent 双向一致、无孤儿块 | lowering 后 |
| L6 | 往返 | 反编译结果与输入 IR 是否等价;load → save → load 语义是否相等 | 提交前 |
核心语法显式、规则,给机器用;别名层更短、可位置传参,给人用。 两层编译到同一个 AST,别名表是数据(aliases.json),不是代码。
var 速度 @小球
on flag:
set 速度 = 3
forever:
move (速度)
if <touching "edge">:
set 速度 = ((速度) * -1)
on flag:
data_setvariableto VARIABLE=$速度 VALUE=3
control_forever {
motion_movesteps STEPS=(速度)
control_if CONDITION=<sensing_touchingobject
TOUCHINGOBJECTMENU="edge"> {
data_setvariableto VARIABLE=$速度
VALUE=(operator_multiply NUM1=(速度) NUM2=-1)
}
}
每个里程碑的验收都是 node --test 或一条 CLI 命令,必须是确定性的。看起来对,不算通过。
文本 → 编译 → 保存 sb3 → 载入 VM 运行 → 打印变量,一条最小链先跑通,消除未知。
14 个真实 sb3 往返零差异、保存确定性、错误处理;补丁机制作用在副本上,事务性提交。
60+ 积木、反编译器、语义往返、L1–L6 结构化诊断;缺自定义块(procedures)。
帧 / 墙钟熔断、变量与列表采样、断言求值;同一项目两次运行报告完全一致。
CLI 命令齐备,另有 Ctrl+Shift+M 打开的编译运行窗口:左边文字、右边诊断与运行结果。