事件按住拖到下面,或点一下
按住 ⠿ 拖动
🗑 拖到这里丢掉
选一块放进里面
搭一个值
点一个,就塞进刚才那个白框里
🎨 调色盘
颜色
起过名字的颜色会存进「名字管理 → 颜色」,别的积木也能选它。
🏷 名字管理
名字自己起,中文、字母、数字、下划线都行;像 JS 的标识符一样,不能重名、不能用保留字。
🔬 看看怎么编译的

  
🖼 我的图片
📥 点这里选图片,或把图片拖进来会自动转成 Base64,跟着积木一起打包进导出的网页
导入后,去「素材」分类里就能拖「图片①」到积木上了;也可以点每张图下面的「放进页面」。
⬇ 做成一个网页文件
📖 怎么用

给小朋友

上面一排彩色圆点是分类。点一下圆点,下面出现彩色积木。按住拖到灰点点的地方,或者轻轻点一下,它就自己跑下去。

积木上的白色小椭圆是「孔」。点开能选:选按钮、选颜色、选数字,不用打字。想写自己的话,选「✎ 自己写」。

蓝色的孔是「值」,点开能搭出像 (计数器 加 1)乘 2 这样的算式,还能一层套一层。彩色孔点开会弹出🎨 调色盘,能拖滑块、能自己调、还能给颜色起名字。

点绿色 🚩 重新看效果,红色 ■ 停下。点 ⬇ 做成网页,得到一个真真正正的网页文件。

那个小绿旗只是编辑器里的「预览重跑」按钮,导出的网页里完全没有它,也没有 ■、没有编辑器外框、没有舞台边框和格子:打开就是一张干净白底的网页,页面加载会自动跑,按钮、输入、按键、全屏变化都会自己响应。点菜单「✨ 看个例子 / 🎨 画布/全屏例子」能看到真网页长什么样。

名字可以自己起,像 JS 一样

在 🏷 名字管理 里可以新建、改名、删掉:变量、事件、函数、列表、颜色、图片、页面元素。变量名会真的编译成中文标识符,例如 let 我的分数 = 0;——JavaScript 本来就允许中文变量名。事件名像 JS 的自定义事件:on("过关啦", …) 与 emit("过关啦")。

名字不能重名、不能用保留字(「如果」「重复」「函数」等),不合法时会给出提示并自动转写成安全名字。

它真的会编译,不是播放器

导出的文件里没有积木解释器。编译分九步:① 规整 → ② 收集符号 → ③ 建索引/作用域/树体检 → ④ 绑定与定义使用链 → ⑤ 类型推导 → ⑥ 诊断 → ⑦ IR → ⑧ 常量折叠 → ⑨ 生成原生 JS + 源映射。重复→for、如果→if、事件→on/emit、正则→new RegExp、画布→getContext("2d")。

点 🔬 看看怎么编译的 有 13 个页签逐页看;点 🌳 看看积木树 能看可点击的结构大纲,点一行就跳到那块积木。

语法树有多细(AST v4)

{
  "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。蓝色孔里装的是另一棵完整的树,可以无限层嵌套。

这一轮给树补了什么

加新积木只要两处:SCHEMA 写形状、中文片段、参数与槽;EMIT / EXPR 写一句生成代码。

🖥 全屏与获取屏幕宽高

「屏幕」分类里有:进入全屏 / 退出全屏 / 切来切去 / 现在是不是全屏 / 屏幕有多宽·有多高 / 窗口有多宽·有多高 / 把屏幕的宽高记到两个变量 / 全屏变了的时候 / 锁定横屏竖屏。编译成 requestFullscreen()、exitFullscreen()、screen.width / screen.height、fullscreenchange。

浏览器规定全屏必须由人手点一下才能进,所以「进入全屏」要放在「当 某个按钮 被点」那一段里,别放在「当页面打开时」。导出的网页带 :fullscreen 样式,全屏后铺满整块屏幕,没有舞台边框、没有格子、没有工具条。

🎨 Canvas2D 画布

「画布」分类:先放一块画布(自己起名、选宽高),然后画方块、画圆、画线、写字、铺底色、换笔色(调色盘)、调线宽字号、擦干净、把图片画上去、读某一点的颜色。还有「每画一帧」帽子,编译成 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("图案","标志") 并转义,写错了会在 🔬 看看怎么编译的 → 诊断 里直接指出来。

🖼 导入图片 → 自动 Base64

点菜单 🖼 导入图片,选图或把图片拖进虚线框。文件会被 FileReader.readAsDataURL 读成 data:image/png;base64,…,同时量出宽高和字节数,存进符号表(第 7 类「图片」)。

编译时会把每张图写进生成代码的 IMG 表,同一张图只存一份;「放一张图片」「把图片画到画布上」「图片的数据」这些积木都引用它。所以导出的仍然是一个 .html,图片不依赖外部路径、断网也在。图片越大,导出文件越大,导入面板会实时告诉你 Base64 占了多少。

在「🏷 名字管理 → 图片」里可以改名、删除;删掉后引用它的积木会在诊断里报「指向一个不存在的名字」。

现在有什么(15 类)

📝 这一块的备注
编译时跳过,但积木还留着
生成代码里留一个 ⏸ 标记
只影响编辑时看着清爽
🌳 积木树