MINITRY / 研发中

把文字写成积木,
再把它跑起来。

MiniTry 是一套面向积木程序(Scratch / sb3 生态)的工具链:文本语言 PaIR、编译器、 无头 runner,以及一扇编译运行窗口。它不改写编辑器,而是补上编辑器缺的那一段—— 让程序可以被文本描述、被编译、被运行、被断言。

状态 · 研发中 形态 · Electron 桌面工具 语言 · PaIR v0
定位
文本 ⇄ 积木工具链
覆盖积木
60+ 核心块
自动测试
65 项通过
诊断体系
17 码 / 6 层
问题 / Why

在编辑器里改一个脚本,
怎么知道改对了?

积木程序一直躺在图形界面里:人可以看,但机器很难读、很难比对、很难自动判断对错。 MiniTry 把这段空白补成一条可测的链——文本能描述结构,编译能校验结构,运行能给出确定的结论。

01 / TEXT

文本可描述

一行一句,缩进即子栈。decompile(compile(x)) 与原文逐字相同,程序因此可以被 diff、被生成、被审查。

02 / STRUCTURE

结构可校验

编译产物直接是 project.json,而不是运行时块对象。纯 JSON 意味着可以 golden 比对,也能在载入 VM 之前查完结构。

03 / ASSERT

结果可断言

无头 runner 在 Node 里手动按帧驱动,断言按帧号判定。同一个项目跑两次,报告逐字节相同。

链路 / Pipeline

文本进,报告出。

一条命令跑完整条链:解析、校验、编译、载入、运行、断言。 每一步的产物都是纯数据,可以存成 golden,也可以拿来比对。

count.mini — PaIR v0
# 编译、运行、采样、断言
on flag:
  set 计数 = 0
  repeat 7:
    change 计数 by 2
    if <计数 > 10>:
      say "过半了"
L1–L60 error · 0 warning
运行137 帧 · 412ms · 残留线程 0
计数 0 → 14断言 3 / 3 通过 ✓
  • ✓断言是判据,不是装饰。变量、存活线程、总帧数、无异常,四类断言按帧号判定——用帧而不是毫秒,才能让两次运行的结论一致。
  • ✓熔断兜底。墙钟超时、帧数上限、单帧线程步数异常增长,任一触发即 stopAll,并报告 BUDGET_EXCEEDED。
  • ✓事务性修改。补丁先作用在项目副本上,6 层校验全过才一次性替换;失败则项目不变。
  • ✓能装进主进程。全部工作在 Electron 主进程完成,渲染进程只显示;新增 tw-minitry:// 协议,CSP 与其它窗口一致。
文本 .miniPaIR
project.json编译产物
运行报告断言 / 轨迹
诊断 / Diagnostics

六层校验,17 个诊断码。

每条诊断都带层号、严重级别、行号与独立的 hint 字段。message 只讲哪里错了, hint 单独成字段——它是后续修复循环的直接输入。

层检查抓什么何时跑
L1语法词法 / 语法错误,带行列号编译前
L2目录opcode 存在性、别名唯一性、别名参数个数解析后
L3槽位输入名是否属于该 opcode、必填项是否齐全、菜单槽位能否合成lowering 前
L4符号变量 / 列表 / 广播 / 角色是否存在且作用域合法;同名遮蔽告警lowering 后
L5结构帽子块居首、C 块必须有子栈、[3, null, ...] 非法形态、next / parent 双向一致、无孤儿块lowering 后
L6往返反编译结果与输入 IR 是否等价;load → save → load 语义是否相等提交前
L4 / L5 与 opcode 无关。它能检查任何来源的 sb3——手写的、别的工具生成的、将来由模型产出的, 因为它只查结构不变量与符号一致性。
语法 / Two Layers

同一份 AST,两种写法。

核心语法显式、规则,给机器用;别名层更短、可位置传参,给人用。 两层编译到同一个 AST,别名表是数据(aliases.json),不是代码。

别名层 — 给人写
var 速度 @小球

on flag:
  set 速度 = 3
  forever:
    move (速度)
    if <touching "edge">:
      set 速度 = ((速度) * -1)
核心语法 — 给机器(同一 AST)
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)
    }
  }
已支持 / Supported

核心块与常用语法

  • ✓事件 · flag / click / stageclick / clone / key / broadcast
  • ✓控制 · repeat / forever / if-else / repeatUntil / waitUntil / wait / stop
  • ✓运动 / 外观 · move、turn、goto、say、switchCostume、setSize
  • ✓侦测 / 运算 · touching、keyPressed、timer、四则运算、比较、join、letterOf
  • ✓数据 / 广播 / 克隆 · 变量、列表、send / sendAndWait、createClone
  • ✓菜单阴影 · goto、switchCostume、keyPressed 等槽位自动合成影子块
尚未支持 / Not Yet

明确留到下一阶段

  • ·自定义块 procedures / define
  • ·扩展块 反编译遇到扩展块会明确报错,而不是静默丢脚本
  • ·声音 / 画笔 / 摄像头 相关积木
  • ·monitors 与注释编辑 原样保留,不新增不修改
目录机制是扩展块的接入点:把扩展的 getInfo() 灌进 catalog,扩展块就能自动获得别名、校验与反编译能力。
里程碑 / Milestones

第一阶段已经跑完。

每个里程碑的验收都是 node --test 或一条 CLI 命令,必须是确定性的。看起来对,不算通过。

S1.0 垂直薄片 完成

文本 → 编译 → 保存 sb3 → 载入 VM 运行 → 打印变量,一条最小链先跑通,消除未知。

S1.1 项目模型 核心完成

14 个真实 sb3 往返零差异、保存确定性、错误处理;补丁机制作用在副本上,事务性提交。

S1.2 语法与编译器 完成

60+ 积木、反编译器、语义往返、L1–L6 结构化诊断;缺自定义块(procedures)。

S1.3 无头 runner 完成

帧 / 墙钟熔断、变量与列表采样、断言求值;同一项目两次运行报告完全一致。

S1.4 CLI + 编译运行窗口 完成

CLI 命令齐备,另有 Ctrl+Shift+M 打开的编译运行窗口:左边文字、右边诊断与运行结果。

为什么先做窗口,而不是先做 AI:它把「文字是否好用」变成可验证的, 而且这套三栏布局(文本 / 结果 / 诊断)在第二阶段几乎原样复用为 AI 变更审阅。