wos

Documentation

Overview

Command wos 是 waiton-script 运行时原型的命令行入口。

子命令：

wos parse <file.wos>   解析并打印 AST 概要（验证解析器）
wos exec  <file.wos> [--key value ...]   解析并执行（默认字节码 VM，--ast 回退解释器），--key value 注入 world 字段
wos unparse <file.wos> 把 AST 重新生成为 .wos 源码（round-trip 验证）
wos addr <file.wos>    列出所有可寻址节点（供结构化编辑器/脚本引用）
wos get <file.wos> <addr>          打印某节点的源码片段
wos set <file.wos> <addr> <snippet> 用 snippet（可解析的源码）替换节点
wos add-field <file.wos> <addr> <name:type> 给 world/record/func 添加字段/参数
wos add-stmt <file.wos> <func.addr> <idx|end> <stmt> 在函数体指定位置插入一条语句
wos remove <file.wos> <addr>       删除节点
wos hot-reload <file.wos> [--field value ...]   运行期 HMR 一次性演示（§9.2）
wos watch <file.wos> [--interval ms] [--field value ...]   文件 watch 热替换（§9.2）

完整执行模型见 spec/plugin-engine-draft.md。

ui.go — wos ui 命令：统一 UI 呈现器入口（host.present.* 契约）。

wos ui [--backend gdi|web|auto] [--host local|first] <file.wos>

--backend 默认 auto：按当前平台选原生后端（Windows→gdi）；平台尚无 原生后端时给出提示并退出（不静默回落 web——web 必须显式指定）。 --host 仅 web 后端有意义（local 直播式 / first 演示式）。

2026-08-24：由 ui-gdi / ui-web 两个子命令合并而来——两者骨架 95% 重复 （engine.New → 注册呈现器 → Load → Stop → 打印输出），脚本侧契约同构， demo 同一份文件；合并后新增后端只需加一个 case。 2026-08-24 v2：web 改为显式指定（auto 不再回落 web）；平台无原生后端 时提示（为 xcb / wayland / mac 后端预留）。