产物格式
编译器、运行时、宿主和调试器共用 manifest 及相关类型，包括页面、组件、样式、资源和编译诊断。
Tiny 引擎内部 · Bridge v1
从编译器到宿主
看清小程序引擎的每一层
Tiny 是一个基于 glass-easel 的小程序引擎。它把小程序源码编译成 manifest 和线程产物，默认用 service、render 两个 iframe 跑起一个小程序，再由 Bridge 协议负责跨线程通信；也可以让每个页面各用一个 render iframe。浏览器相关能力单独放在宿主包里，小程序内核不依赖 window、document 或 iframe。
- 2运行时线程
- 10工作区包
- 207单元测试
- 51浏览器步骤
整体流程
一次编译，产出运行所需的全部产物
编译器只负责生成产物，宿主负责提供运行环境，运行时负责执行小程序语义。三者通过 manifest 和 Bridge 协议衔接，不共享隐式全局状态。
01 · 源码小程序源码
app.json · WXML · WXSS · JS/TS · WXS02 · 编译tools/cli
ProcGen · 作用域 CSS · service bundle03 · 产物manifest.json
@tiny/manifest · schemaVersion 204 · 启动宿主装配
iframe / worker / native · service + render05 · 运行service + render
应用语义 · glass-easel 组件树06 · 观察devtool
控制 · 诊断 · 元素树各层分工
glass-easel 提供组件定义、模板、数据绑定、事件和生命周期；App、页面栈、路由、wx API、setData、组件语义和诊断由 Tiny 自己实现。iframe、MessagePort、DOM canvas、资源 URL 和调试器界面则属于宿主适配层。
接口约定
四类接口，连接编译、运行和调试
改动之前，先分清改的是产物格式、消息协议、线程启动参数，还是宿主注入的能力。
消息协议
Bridge 定义消息信封、帧、调用与回复、事件批处理、超时和 JSON 可序列化校验。
线程启动参数
bootServiceThread / bootRenderThread 接收 transport、manifest，以及 canvas、资源解析、挂载点和内置组件等可选注入。内核本身不依赖浏览器。
宿主注入的能力
apiHandlers 处理需要跨线程的 API，apiExtensions 补充设备信息；canvas、资源 URL 和内置组件分别由宿主提供。
按模块阅读
想改哪一层，就从哪一页开始
每一页都从实际代码出发，说明这一层做什么、和相邻层怎么衔接。
系统分层与状态归属
编译器、运行时、Bridge、宿主和 devtool 各自负责什么，以及一次启动如何串起来。
从源码到 manifest
入口发现、兼容输入配置、WXML 到 ProcGen、WXSS 作用域、TS 转译、service bundle 和产物目录。
双线程如何协作
页面栈、兼容全局、setData、observer、事件、组件语义、渲染适配、内置组件和按需注入的 canvas。
跨线程消息怎么走
消息格式、握手、传输、批处理、错误码、JSON 校验和完整消息列表。
如何接入运行环境
内核约束、host-browser、内置组件宿主、canvas 与资源注入、测试宿主和调试器，以及新宿主的接入步骤。
靠真实小程序验证
207 个单元测试、51 个浏览器步骤、五个测试小程序，以及目前还没有覆盖的部分。
运行时结构
service 管状态，render 管组件树
service 和 render 各自启动，host 分别持有它们的连接；页面和组件状态始终在 service。两条线程加上 Bridge 协议边界，构成小程序内核。
小程序逻辑和平台 API
- App / Page / Component / Behavior 注册，按 manifest 顺序绑定路径
- 页面栈、路由和 onLoad → onShow → onReady
- Behaviors、observers、relations、selectComponent 等组件语义
setData路径更新和事件处理函数调用- 可配置的命名空间：API 全局、别名和诊断名称
- 通过注入的适配器使用 canvas
glass-easel 组件树和 DOM
- ComponentSpace + StyleScopeManager
- 23 个内置组件，AOT 模板和共享 behaviors
- styleIsolation / externalClasses / 页面作用域
- 事件序列化、dataset、target / currentTarget
- 页面挂载、卸载和元素树导出
- canvas 测量与帧绘制由宿主注入
宿主只提供环境
宿主负责 transport、backend、挂载点、宿主 API、canvas 和资源 URL，但不判断页面生命周期，也不直接操作 glass-easel 组件。service 和 render 内核都不引用 window、document 或 iframe。
宿主对比
同一套内核，可以换不同宿主
浏览器宿主、无界面测试宿主和调试器都复用 createTinyRuntime；单元测试甚至不需要 iframe。
| 宿主 | 通信方式 | 渲染后端 | 控制方式 |
|---|---|---|---|
@tiny/host-browser | MessageChannel / iframe | DOM canvas + 调试器覆盖层 | createStandaloneDualThreadHost、DevtoolRuntimeClient |
tests/host | 两个 MessageChannel | CurrentWindowBackendContext | URL ?path=、window.__tinyRuntime |
apps/devtool | 两个 MessageChannel | CurrentWindowBackendContext | DevtoolRuntimeClient + React/Redux |
| runtime 单测 | createInMemoryTransportPair() | EmptyBackendContext | 直接持有 service / render 连接 |
| 原生宿主（未实现） | 需要实现 Transport | 需要实现 GeneralBackendContext | 复用宿主 API 注册表和控制消息 |
新宿主从 createTinyRuntime 接进来
只要提供 service 和 render 两条 transport、manifest 和初始页面，就能启动同一个引擎。@tiny/host-browser 的 createStandaloneDualThreadHost 只是浏览器适配器，不是引擎本身。看完整接入步骤 →
测试覆盖
这些能力都有自动化测试
下面这些行为都在 51 个浏览器步骤里实际点击、输入和断言过。
真实示例小程序
todos、add-todo、组件语义页、ECharts 柱状图、子包页面、组件插槽、import/include/template 和 animation。
Taro 3 产物
webpackJsonp、外部 WXS、递归模板、循环 usingComponents、Enter 提交和 Redux todos。
微信官方示例子集
基础组件索引、button 示例页和 storage API 页；不包含 Skyline 和依赖原生能力的页面。
组件语义
Behavior 合并、observers、property observer、relations、selectComponent、styleIsolation 和 externalClasses。
可替换宿主
内核边界检查；host-browser 注入 iframe、MessagePort、canvas 和资源 URL；在线调试器随站点发布。
Canvas 镜像
宿主 canvas 适配器负责 service 侧 2D 绘制、50ms 节流 PNG 帧和 render 侧 drawImage；ECharts 会检查非空像素。
兼容输入与内部命名
扩展名、指令、API 和注册全局可配置；Tiny 产物内部始终使用固定的 tiny-* 名称。
诊断与元素树
编译、transport、service、render、host 五类诊断统一收集；元素树可以从 DOM 或逻辑树导出。
也要看清没有覆盖的部分
当前测试覆盖核心链路、组件语义、兼容输入、内部命名、样式隔离和五个测试小程序。API 覆盖、分享菜单等页面形态、原生宿主和性能基线仍未完成，现状页会逐项说明。
快速开始
从源码跑到调试器
需要 Node.js 22+ 和 pnpm 9；跑浏览器验收还需要 Chromium。
# 安装并跑完整验收
pnpm install
pnpm accept:glass-easel
# 测试宿主（demo -> tests/host/generated）
pnpm dev:glass-easel
# 调试器（自动预览全部 tests/apps）
pnpm dev:devtool
# 站点（先打包内嵌 devtool，再构建网站）
pnpm site:dev
pnpm site:check
# 检查核心 runtime 是否依赖了浏览器 API
pnpm check:runtime-purity核心链路和组件语义已经跑通
双线程、编译、协议、命名配置、组件语义、样式隔离和调试器都已跑通；宿主 API、页面能力、原生宿主和性能基线仍是主要缺口。
核心链路可用 内核不依赖宿主 组件语义 Taro 3 React API 覆盖有限 仅浏览器宿主
接下来
先补宿主 API 和常用组件，再完善分享菜单等页面形态、canvas 交互和性能基线。