8.6 KiB
Nexus 本地抽取边界
目标依赖为 Tessera → Nexus → Aster。Nexus 是 GUI 进程内 Rust library,不是另起进程;Tessera 的 bridge 仍可显式使用同一版本的 Aster 类型。Tessera 通过 HostRegistration 向 Nexus 的 owning VM 注册 UI 能力,Nexus 不导入 Tessera 模块。
本地库暂放 vendor/nexus,包名 endorphin-nexus-runtime。它是普通源码目录,没有独立 Git 或远程仓库。后续是否建仓、所有者和可见性需用户另行授权。迁移在 Tessera 的独立工作分支上提交。
当前 Tessera 适配分支为 codex/nexus-runtime,从注释交付 6d1ffdb 建立,依赖 Tessera PR #10 与其引用的 Aster PR #3。经 Gitea 当前状态核对,两个注释 PR 均已合并;本次没有执行 PR 合并或向 main 推送。
已抽取
| 原实现 | Nexus 实现 | Tessera 保留的适配 |
|---|---|---|
runtime/endor_script.rs |
source.rs |
调用方直接引用 Nexus;原 GUI 转发模块及无用别名已删除 |
runtime/io_tasks.rs |
io_tasks.rs |
任务引擎直接使用 Nexus provider;原 GUI 转发模块及无用别名已删除 |
runtime/vm_sequence.rs |
vm_sequence.rs |
FunctionHost 适配桌面 Function 名义身份及 <tessera> 诊断来源 |
endor_host::Candidate 与错误映射 |
VmSession、runtime_error |
UI 会话借用同一 Aster VM,视觉刷新状态仍由 Tessera 持有 |
AST 预算、计划编译与 evaluate |
budget.rs、program.rs |
UI 编译前显式提供宿主全局名;隔离表达式不安装 UI |
runtime/tasks.rs 通用任务引擎 |
tasks.rs |
TaskHost 适配 owner 作用域、展示资格和 Task 类型;原 install/cancel_owner 签名保持不变 |
| Console 计数、原文历史和来源 | ConsoleHistory、AcceptedInput;共享 source::line_starts |
Tessera 只读历史建立 Sources 投影;接受凭据消费一次后进入真实 VM |
| 完整程序准备与顶层执行 | PreparedProgram、VmSession::execute_program |
显式提供宿主名称,main 查找/调用与页面策略仍由 Tessera 决定;保留 Session/Execution 两种代码根生命周期 |
| 宿主调用返回值清理 | VmSession::with_call_result |
在回调内解释返回值,刷新/展示返回错误也归还返回根 |
| Console 输入准备与执行循环 | console.rs 的 PreparedInput、VmSession::prepare_input/execute_input |
先完整编译,再保留宿主清理、输入记录、代码投影、刷新、错误标注及发布的原次序 |
| 新会话 UI 安装 | HostRegistration 调用协议 |
bridge/nexus_host.rs 实现注册,领域类型/窗口能力仍由 Tessera 定义 |
搬移保留原有源码位置、预算值、指令顺序、根清理次序、I/O 线程池/租约与诊断文本。Cargo 使用相邻同一份 vendor/aster,不引入注册表的第二套语言实现。锁文件只新增本地包及其引用,没有升级已有依赖。
Tessera 保留的宿主边界
| 模块 | 保留原因 | Nexus 接口 |
|---|---|---|
runtime/api.rs 与 api/worker.rs |
有界 HTTP/原生请求、回应端、submission/namespace、文档/窗口命令的一致发布;worker 线程组合这些宿主协议 | 通过 endor_host 使用 Nexus 会话,原子执行后只继续 UI 刷新;不另建通用语言队列 |
runtime/api/guide.rs |
Tessera 的在线路由和 UI API 文档 | 不属于运行时内核 |
runtime/events.rs |
窗口/会话/布局版本/Mount 信封、原生手势合并和版本追随 | 不跨线程传递 VM 根 |
runtime/event_dispatch.rs |
capture/target/bubble、Event/Subscription 和 Mount 路由等 UI 协议 | 复用 Nexus 调用序列,不另写解释器 |
runtime/endor_host.rs |
UI 入口策略、代码树、布局/绘制续体、故障画面、文档和窗口生命周期 | 完整准备、输入历史、执行与 VM 根清理由 Nexus 负责;宿主经显式访问接口接入 |
runtime/tasks.rs、vm_sequence.rs |
UI owner 的有效性和名义类型附着 | TaskHost、FunctionHost |
api/worker.rs 不直接使用 VM、代码模板装载或指令执行接口;其继续状态携带的是 Tessera 请求、UI 刷新元数据或独立候选。请求队列的容量、关闭优先级和发布复核继续在 Tessera,Nexus 不依赖 tiny_http、winit、NamespaceState 或窗口输入结构。
ConsoleHistory 统一持有累计次数、AST 总量、原文和输入来源;Sources 的 CodeNode 与发布文档仍由 Tessera 生成。接受凭据拥有准备结果,只能借用它生成投影并消费执行;输入失败后的历史和预算不回滚。原文本追加和 CRLF/CR 字节行索引在字段访问替换后与原实现逐 token 等价。宿主开始执行前的纯历史记录和原程序 CodeNode 转移现为两个相邻步骤,不改变业务执行或发布顺序。
交付边界
Tessera 的适配改动与 Nexus 源码一并保存在 codex/nexus-runtime 分支。Nexus 作为 Tessera 仓库内的 Rust 库交付。
源码复核中记录的既有行为问题保留为后续独立工作,不在本次迁移中夹带效果分析或 Scene3D 依赖算法改动。本次不声称所有潜在行为问题均已解决。
验证状态
源码分段和 I/O 按完整实现搬移;驱动引入宿主函数类型适配。任务引擎的 owner/key、协程、await、配额和取消顺序保留;三个 UI 策略函数逐 token 对照未变,通用引擎在还原显式宿主接口替换后逐 token 等价。TaskHost 不可藏有未 trace 的托管句柄,原生函数通过 captures 保活注册域;Scheduler 仅借用该域,宿主必须在释放域前停止使用调度器。为兼容现有诊断,任务 payload 的 tessera-task 类别文本暂保持原值。
持久执行循环、显示值转换和真实全局名称枚举在调整候选/输入字段访问后逐 token 等价。PreparedInput 私有字段保持原文、AST 与模板同源,消费后不能由该对象重复执行;它不携带 VM 根。模板也不携带目标堆根,提前在执行返回时释放编译准备数据不会释放已加载的代码/函数身份。宿主在准备和执行之间不得另行改动全局名称契约。库入口另外检查输入字节数,未初始化环境返回错误,累计预算使用饱和加法以拒绝异常大的外部计数。
完整程序的两种执行循环在代入代码根策略后分别与原路径逐 token 等价,宿主全局名称集合不变。with_call_result 额外修复宿主刷新/展示返回错误时可能跳过 main 返回根释放的路径;这项清理加强单独由析构可观察的回归覆盖,不作为纯搬移宣称等价。GUI 改用显式会话访问接口的前后整文件 token 对照,在还原 accessor 和十处回收闭包后通过。
原同帧循环回归随实现进入 Nexus;新增无 UI 宿主测试覆盖注册、部分安装失败的资源清理、脚本跨片全局和原文跨度。另有 tests/tasks.rs 使用普通对象宿主覆盖同 key 替换、真实回调次数、资格撤销、终态作用域清理和退出门闩。tests/console.rs 覆盖持久全局/函数身份、编译失败无副作用、运行失败保留先前写入和预算拒绝。tests/program.rs 覆盖两种代码根策略、装载不隐式调用入口、失败写入和宿主错误返回根清理。tests/history.rs 覆盖接受/失败历史、256 次输入、累计 AST、完整源码字节预算及 Unicode/CRLF/CR 位置。
2026-11-15 用户明确授权本次本机编译和测试,已执行:
| 检查 | 结果 |
|---|---|
Nexus cargo test --offline --manifest-path vendor/nexus/Cargo.toml |
14 个集成测试、1 个单元测试通过 |
Nexus cargo clippy --offline --manifest-path vendor/nexus/Cargo.toml --all-targets -- -D warnings |
通过 |
Tessera cargo test --offline --locked |
179 通过、11 个 HTTP 用例受沙箱端口权限限制失败、1 个可选基准忽略 |
| Tessera HTTP 组允许回环网络后重跑 | 16/16 通过;与首轮合并覆盖全部 190 个常规测试 |
Tessera cargo clippy --offline --locked --all-targets -- -D warnings |
通过 |
Aster CARGO_NET_OFFLINE=true sh scripts/check.sh |
生成器一致性、4 个 Python 回归、Rust/PEG 格式、workspace 测试/文档测试及全部目标 Clippy 均通过 |
首次联网依赖解析因 DNS 失败,随后使用本机缓存完成离线编译。Tessera 首次测试编译发现测试转发器缺少显式 VmError 导入,补齐后编译和回归通过。实际执行结果不包含手动操作原生 GUI、可选性能基准或分发打包;示例、绘制像素、任务、窗口和输入协议由现有集成回归覆盖。