沉浸脚本引擎 infileap/Inimerse

Inimerse / Infiverse

Inimerse 是脚本引擎，Infiverse 是它的 Tauri 桌面客户端。

状态、路线图与版本裁定：docs/STATUS.md —— 唯一权威。
语言、API 与平台事实：docs/API.md —— 唯一权威。
当前发布基线：0.5.2（git tag v0.5.2）。v0.6 的「已完成」声明已被逐条废止，清单见 docs/STATUS.md §3.2。

目录结构

- src/ —— C 引擎：VM、词法分析器、语法分析器、编译器、优化器、运行时、平台层和内置模块。
- selfhost/ —— 用 .im 编写的自举编译器。
- mods/ —— 引擎扩展。
- Infiverse_standard/ —— Rust + Tauri 桌面应用（冻结在 v0.3.0）。
- docs/ —— 当前文档；docs/archive/ 存放历史版本说明。
- future/ —— 研究愿景与设计草案（不代表实现状态）。
- tools/ —— Python 与 Node 工具：基准测试、bindgen、Wasm 宿主、协议参考及其测试。
- vtest/、scripts/、*.im —— 示例与回归测试。
- examples/ —— 重新归置的示例、回归、旧版 UI 与基准脚本；来源见 docs/HYGIENE.md §4/§6.2。

构建引擎（Linux / POSIX）

cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j"$(nproc)"
ctest --test-dir build --output-on-failure -j4 # expected: 100% tests passed, 0 failed -- the count is pinned as EXP_CTEST in tools/gate.sh

生成的二进制文件：build/inimerse。请始终使用这个路径，不要用仓库根目录下任何过期的副本。

上面这些，再加上 §43.5 经济迁移测试套件、DSH 桥接插件、文档链接和反引号里的 docs/… / future/… 路径，全都由一条命令搞定：tools/gate.sh（见 docs/BOARD.md §3）。

构建引擎（Windows）

powershell -NoProfile -ExecutionPolicy Bypass -File .\build.ps1

运行与编译脚本

build/inimerse run script.im
build/inimerse compile script.im out.inim
build/inimerse buildc --incremental script.im out.inim

P1 最小 Layer 循环由两个独立进程组成，只通过 stdin/stdout 通信：

build/inim-server root main # authoritative side: canonical-JSON request per line
build/inim-client root main scenario # forks its own inim-server and drives it

inim-server 自己分配 seq/rev，拒绝任何试图提供这两个字段的请求；持久提交指针与日志不匹配时，它直接拒绝打开会话。见 docs/API.md §10.6。

JS 侧协议测试不在 CTest 里，必须单独运行：

node tools/upp_reference.test.js
node tools/crp_reference.test.js
node tools/vverse_validate.test.js

构建桌面客户端

冻结在 v0.3.0；不再加新功能。见 docs/STATUS.md §6。

cd Infiverse_standard\src-tauri
cargo build --release --offline

制作 Windows 安装包（旧版）

先安装 Inno Setup 6，然后运行：

& 'C:\Program Files (x86)\Inno Setup 6\ISCC.exe' installer.iss
这条路径只适用于 Windows，而且仍然包含本地绝对路径，不属于当前交付线。

数据与密钥

运行时数据存放在 userdata/，有意不纳入版本跟踪。OAuth 客户端密钥必须通过环境变量提供，绝不要提交到仓库。

文档

| 文档 | 用途 |
| docs/STATUS.md | 状态、路线图与版本裁定（唯一事实来源） |
| docs/API.md | 语言、内置功能、语法糖、平台支持 |
| docs/REQUIREMENTS_ANALYSIS.md | 需求与现实差距矩阵，以及文档冲突 |
| docs/archive/README.md | 历史版本说明与已撤回声明清单 |
| future/README.md | 研究愿景与设计草案 |

许可证

见 LICENSE。