Files
endorphin-tessera-gui/vendor/nexus/README.md
T

2.8 KiB

Endorphin Nexus Runtime(本地抽取中)

这是 GUI 进程内运行的 Rust library,包名为 endorphin-nexus-runtime。目前放在 vendor/nexus 普通目录,尚未初始化独立 Git,也没有远程仓库。后续建仓需另获用户明确授权。

依赖方向为 Tessera → Nexus → Aster。Nexus 通过相邻的 vendor/aster 使用与 Tessera 相同版本的语言 crate,没有 Tessera、窗口或渲染依赖。HostRegistration 由 Tessera 的 bridge/nexus_host.rs 实现,为同一个 owning VM 注册 UI 类型和全局能力。

当前已抽取源码分段/位置修正、计划编译与隔离表达式求值、AST 预算、VM 根清理、I/O provider、同帧调用序列以及定时/I/O/协作任务引擎。持久输入通过 VmSession::prepare_input 完整准备后,再由 execute_input 消费执行,保留原全局对象和最后值 _。任务宿主通过 TaskHost 提供作用域存储、资格检查与名义类型,通用引擎不检查 UI payload。Tessera 保留任务/驱动的 UI 策略适配;源码和 I/O 的无用转发模块已删除。

完整程序由 PreparedProgram 统一准备并执行,main/页面策略由宿主决定;with_call_result 负责宿主处理后的返回根清理。会话 VM/根表/环境字段已限制在库内,宿主通过显式借用和根转交接口接入。ConsoleHistory 管理累计预算、原文和接受凭据;UI 代码投影仍由 Tessera 生成。HTTP/原生 worker 属于 Tessera 的宿主组合,不放入通用语言库。实现已接入,并已完成本次本地编译与回归。窗口、Mount 路由、布局/绘制刷新、文档发布与 UI API 属于 Tessera 适配,不能靠 Nexus 反向依赖来搬运。

tests/host_registration.rs 覆盖无 UI 宿主注册、部分失败清理、源码计划的跨片全局与跨度;tests/tasks.rs 通过普通对象宿主覆盖同键替换、交付前资格撤销及退出门闩;tests/console.rs 覆盖持久输入和编译/执行失败边界;tests/program.rs 覆盖完整装载及宿主处理错误后的清理;tests/history.rs 覆盖历史与累计限额;原驱动循环回归随实现保留。本次已获明确本机编译/测试授权:14 个集成回归与 1 个单元回归全部通过,所有目标 Clippy(警告视为错误)通过。Tessera 的 190 个常规测试均覆盖通过,1 个可选性能基准忽略;Aster 完整检查脚本通过。首次沙箱运行中的 11 个 HTTP 用例因禁止监听本地端口失败,允许回环网络后该组 16 个测试全部通过。

后续验证应分别执行 Tessera 的集成测试和 cargo test --manifest-path vendor/nexus/Cargo.toml。Tessera 单独执行 cargo test 不会自动运行依赖库 Nexus 的单元/集成测试;不能把它的通过替代本库验证。