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

14 lines
2.8 KiB
Markdown

# 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 的单元/集成测试;不能把它的通过替代本库验证。