上面一排彩色圆点是分类。点一下圆点,下面出现彩色积木。按住拖到灰点点的地方,或者轻轻点一下,它就自己跑下去。
积木上的白色小椭圆是「孔」。点开能选:选按钮、选颜色、选数字,不用打字。想写自己的话,选「✎ 自己写」。
蓝色的孔是「值」,点开能搭出像 (计数器 加 1)乘 2 这样的算式,还能一层套一层。彩色孔点开会弹出🎨 调色盘,能拖滑块、能自己调、还能给颜色起名字。
点绿色 🚩 重新看效果,红色 ■ 停下。点 ⬇ 做成网页,得到一个真真正正的网页文件。
那个小绿旗只是编辑器里的「预览重跑」按钮,导出的网页里完全没有它,也没有 ■、没有编辑器外框、没有舞台边框和格子:打开就是一张干净白底的网页,页面加载会自动跑,按钮、输入、按键、全屏变化都会自己响应。点菜单「✨ 看个例子 / 🎨 画布/全屏例子」能看到真网页长什么样。
在 🏷 名字管理 里可以新建、改名、删掉:变量、事件、函数、列表、颜色、图片、页面元素。变量名会真的编译成中文标识符,例如 let 我的分数 = 0;——JavaScript 本来就允许中文变量名。事件名像 JS 的自定义事件:on("过关啦", …) 与 emit("过关啦")。
名字不能重名、不能用保留字(「如果」「重复」「函数」等),不合法时会给出提示并自动转写成安全名字。
导出的文件里没有积木解释器。编译分九步:① 规整 → ② 收集符号 → ③ 建索引/作用域/树体检 → ④ 绑定与定义使用链 → ⑤ 类型推导 → ⑥ 诊断 → ⑦ IR → ⑧ 常量折叠 → ⑨ 生成原生 JS + 源映射。重复→for、如果→if、事件→on/emit、正则→new RegExp、画布→getContext("2d")。
点 🔬 看看怎么编译的 有 13 个页签逐页看;点 🌳 看看积木树 能看可点击的结构大纲,点一行就跳到那块积木。
{
"id":"n42", "op":"setVar", "ver":3,
"kind":"statement", "returns":"void",
"ns":"global", "scope":"sc_n40", // 真的在哪一层作用域
"pos":{ // 结构身份
"parent":"n40", "slot":"body", "index":2,
"path":"root/3.body/2", "depth":2
},
"hash":"a91f3c07", // 内容指纹,用于增量编译
"types":{ // ⑤ 推导结果
"expected":"void", "actual":"void", "inferred":"void",
"coercion":"", "checked":true, "from":"语句"
},
"flow":{ // ④ 定义-使用链
"defs":[], "uses":[{ "sym":"v_3", "key":"var",
"decl":"n12", "distance":1 }],
"decl":"n12", "declScope":"s0", "distance":1,
"shadowedBy":null, "useCount":1
},
"args":{
"var":{
"t":"ref","of":"variable","v":"v_3","label":"我的分数",
"raw":"我的分数","display":"我的分数","dtype":"数",
"token":{"line":0,"col":0},"nullable":false,
"bind":{ "sym":"v_3","kind":"变量","resolved":true,
"decl":"n12","declName":"我的分数","declScope":"s0",
"distance":1,"shadowedBy":null },
"types":{ "expected":"any","actual":"number",
"inferred":"number","coercion":"","checked":true },
"hint":"选一个变量","unit":"","min":null,"max":null,
"enum":[],"validate":"identifier","default":""
},
"val":{
"t":"expr","dtype":"any","label":"(计数器 加 1)乘 2",
"v":{ /* 又是一棵完整的表达式树,同样带 pos/hash/types/flow */ },
"types":{ "expected":"any","actual":"number",
"inferred":"number","coercion":"","checked":true },
"nullable":false,"hint":"搭一个值"
}
},
"slots":{"body":[],"else":[]},
"meta":{
"note":"","comment":"这里以后改成动画","doc":"","alias":"加分处",
"disabled":false,"breakpoint":false,"collapsed":false,
"pinned":false,"colorOverride":null,
"revision":2,"dirty":false,"group":"","author":"",
"createdAt":"…","updatedAt":"…","loc":{"x":0,"y":0},
"tags":["重要"],"diagnostics":[],
"eid":"","symId":"","eventId":"","symName":""
},
"emit":{ // ⑦⑨ 写回
"ir":[{"op":"setVar","path":"root/3.body/2",…}],
"js":["我的分数+=1;"], "src":[42,42],
"cacheKey":"a91f3c07|L0|D2","folded":null,
"recompiled":3,"reused":false
}
}
每个孔带 23 个字段 + 类型推导 + 绑定详情;每个节点带结构路径、指纹、作用域、定义使用链、诊断与它自己生成的那几行 JS。蓝色孔里装的是另一棵完整的树,可以无限层嵌套。
root/3.body/2、深度。挪动积木后路径会变,但 id 和内容指纹不变。定义一件事、挨个拿出来、重复、如果 会真的开出新的一层。引用记录它跨了几层找到定义、有没有被里层的同名变量盖住。数字 塞进要 字 的孔会提示 String(…)。加新积木只要两处:SCHEMA 写形状、中文片段、参数与槽;EMIT / EXPR 写一句生成代码。
「屏幕」分类里有:进入全屏 / 退出全屏 / 切来切去 / 现在是不是全屏 / 屏幕有多宽·有多高 / 窗口有多宽·有多高 / 把屏幕的宽高记到两个变量 / 全屏变了的时候 / 锁定横屏竖屏。编译成 requestFullscreen()、exitFullscreen()、screen.width / screen.height、fullscreenchange。
浏览器规定全屏必须由人手点一下才能进,所以「进入全屏」要放在「当 某个按钮 被点」那一段里,别放在「当页面打开时」。导出的网页带 :fullscreen 样式,全屏后铺满整块屏幕,没有舞台边框、没有格子、没有工具条。
「画布」分类:先放一块画布(自己起名、选宽高),然后画方块、画圆、画线、写字、铺底色、换笔色(调色盘)、调线宽字号、擦干净、把图片画上去、读某一点的颜色。还有「每画一帧」帽子,编译成 requestAnimationFrame 动画循环。
底层就是原生 getContext("2d"):生成的是 fillRect / arc / fillText / drawImage / getImageData,没有任何绘图库。坐标孔里可以塞任意「值」积木,所以能让变量决定圆画在哪。
不用写 \d ^ $ 这些怪符号。「造一条规则」里两个孔都是中文下拉:找什么选「一串数字 / 一串汉字 / 手机号 / 邮箱地址 / 日期 / 网址 / 一行的开头 / 两个词括号各抓一个 / 年月日括号起名叫年、月 …」;怎么找选「只找第一个 / 找出全部 / 不分大小写 / 找出全部·不分大小写 / 每一行都算 / 全都开 …」。小朋友全程只点选项。
其余积木也全是中文:找得到吗 / 找出第一个 / 找出全部 / 第几个字 / 一共几个 / 括号抓到的 / 有名字的括号抓到的 / 把找到的换成…(写 $1 用第一个括号)/ 切成一段段 / 把怪符号变成普通字 / 在找什么(中文说)/ 怎么找(中文说)/ 有哪些有名字的括号 / 用中文讲一遍 / 写得对不对。功能对齐 JS 的 test / exec / matchAll / search / replace / split / groups / named groups。
给大人留了「✎ 自己写图案」「✎ 自己写标志」,可填完整正则与 g i m s u y 任意组合。编译成 new RegExp("图案","标志") 并转义,写错了会在 🔬 看看怎么编译的 → 诊断 里直接指出来。
点菜单 🖼 导入图片,选图或把图片拖进虚线框。文件会被 FileReader.readAsDataURL 读成 data:image/png;base64,…,同时量出宽高和字节数,存进符号表(第 7 类「图片」)。
编译时会把每张图写进生成代码的 IMG 表,同一张图只存一份;「放一张图片」「把图片画到画布上」「图片的数据」这些积木都引用它。所以导出的仍然是一个 .html,图片不依赖外部路径、断网也在。图片越大,导出文件越大,导入面板会实时告诉你 Base64 占了多少。
在「🏷 名字管理 → 图片」里可以改名、删除;删掉后引用它的积木会在诊断里报「指向一个不存在的名字」。