纯 MoonBit 实现。一份 .mbt.md 视觉文档是唯一事实源——人类画布操作与 Agent 修改都回写同一份源码，每次预览从源重建；通过 DDP 加密容器安全分发。
没有隐藏的项目数据库，没有旁路缓存。引擎只认 .mbt.md——它是可编译的 MoonBit literate 源码，也是完整的设计文档。
session_history（init/commit/log/undo/redo/checkout/diff）——wasm 会话面直接做撤销重做与版本回放，响应回传 canonical MBT 供宿主持久化。
place <ab> <comp> <id> - x y w h——AgentGate 在最终 bbox 上评估，消除「默认尺寸被拒 → update 修正」的中间态（真实 LLM run 111 次拒绝的根因）。
constrain 错误就地返回 14 种可用意图；unflow 单条删除交互流边。构建工具链升级 moonc ≥ 0.10.14，CI 覆盖检查+测试+示例复现。
从命令行手动驱动，到 IDE 内 Agent 自动驱动——同一引擎，同一事实源。
换行分帧 JSON 协议。一个 CLI 进程 = 一个有状态 Project 会话。模板、操作、交互流、导出、渲染全覆盖。
@moonviz/engine-sdk：MoonViz 会话、Project 高层 API（theme/token/interact/state）、能力字典（tools/ops/themes/tokens）、交互 HTML 导出、DDP 加解密。
stdio JSON-RPC。read_mbt / render_mbt 源侧工具 + lint / critique / infer 设计智能工具，直接接入 MCP 客户端。
SKILL.md 定义 Agent 操作规范：双 Gate 语义、操作命令、约束红线，让任意 coding agent 安全驱动引擎。
DDP1 = Argon2id + XChaCha20-Poly1305 加密容器；DDP2 = 免密压缩容器（zstd + CRC32）。Rust 编解码器独立交付。
deepDesign Studio（Tauri）提供人类画布；ddpView（macOS 原生）只读查看加密 DDP 文档并渲染交互原型。
前置：安装 MoonBit 工具链（moon 可执行）。
# 1. 进入引擎目录
cd moonviz
# 2. 启动有状态 CLI 会话（stdin 逐行下发命令，stdout 逐行返回 JSON）
moon run --target native cli
# 3. 会话内构建一个双画板登录原型
template login t_login 390 844
template dashboard t_home 390 844
update t_login welcome_title text="欢迎回来"
flow t_login t_home login_btn
export-mbt-human # ← HumanGate 校验 + 返回 canonical .mbt.md
# 4. 无会话渲染（AgentGate 级重载）
render-mbt-b64 <base64-mbt>
# 5. 打包 DDP 免密容器（Rust ddp_codec）
echo '{"operation":"encrypt","mbt_b64":"…","password":""}' | ddp/target/release/ddp_codec两种 WASM 产物 + 四平台预编译二进制——按宿主选择，全部由 GitHub Actions 自动构建并归档于 Releases。
浏览器 / Node ≥22 进程内渲染。WASM GC + JS String Builtins，字符串与宿主直通。npm：moonviz-engine-wasm。
纯 WASM MVP（0 imports、线性内存）——宿主中立，wasmtime / wasmi 等任意规范运行时可实例化。字符串 ABI 已实测文档化。
darwin-arm64 / linux-x64 / linux-arm64 / win32-x64 四平台 moonviz-cli + moonviz-mcp，自包含仅链 libc。
引擎已上架 mooncakes.io（MoonBit 官方包中心）：moon add asdshuaishuai/moonviz，任何 MoonBit 工程直接 @sdk 内嵌原型引擎——渲染、双门、op 面同源。
按「能力平权 → 体验深化 → 生态扩展」三层推进——每条路线以「数据模型已支持但边界不可达 / 体验未落地」为线索。完整版见仓库根 ROADMAP.md。
搁浅模块出井：collab 多 Agent 协作、history 版本控制、animation 动画、protest 原型测试——core 已实现的 52 个函数补齐 CLI/MCP/WASM 边界。classic wasm 写路径（Rust 宿主双向调用）。
deepDesign Studio 全面接入新引擎（撤销/组件库/交互面板）；Playground 补动画系统、用户组件编译、原型测试面板；ddpView 只读加密文档查看器。
npm 0.2.0 发版（session API 全量）；在线 API 参考与示例库；collab 落地双 Agent 同源协作；性能基线进 CI。
引擎仓库 docs/ 内含 11 篇架构级文档，覆盖从源码格式到渲染管线的完整链路。
分层设计、模块边界、数据流与架构红线。
literate 源码规则、moonviz:artboard 块、@decl 公开声明解析。
画板、节点、约束的场景图模型。
fixed/flex 布局谓词与推理引擎。
源码 ⇄ 场景图 ⇄ 画布的双向同步一致性。
SVG 渲染管线、主题、线框模式。
Agent 操作协议、双 Gate、debt 机制。
演进计划（ROADMAP）与已知风险台账。
导出 SVG / DDP / 声明物料的生态位。
SVG / PNG / 终端三后端 + 技术栈 + 二进制分发与工具链风险。