Extract the Nexus runtime from Tessera
This commit is contained in:
@@ -23,6 +23,10 @@ UML 已渲染为普通 PNG 图片,直接嵌入各篇说明,不依赖 Mermaid
|
||||
|
||||
[放大组件图 SVG](uml/rendered/components.svg)
|
||||
|
||||
## 本地 Nexus 抽取
|
||||
|
||||
通用运行时现已在 `vendor/nexus` 作为 GUI 进程内 library 接入,宿主能力经接口注册。当前实现、仍属于 Tessera 的 worker/窗口发布适配,以及未执行的编译/运行回归见 [Nexus 抽取边界](nexus-extraction.md)。本页原有五目录说明和 UML 记录此前 Tessera 内部整理,新增边界以该抽取文档为准。
|
||||
|
||||
## 先抓住四个概念
|
||||
|
||||
1. **对象是程序状态**:共享内容留在 Aster 管理的对象堆内;切换标签不靠重放源码恢复对象。
|
||||
|
||||
@@ -25,9 +25,9 @@
|
||||
| `src/system_ui/mod.rs` | [src/shell/system_ui/mod.rs](../../src/shell/system_ui/mod.rs) | 管理控件模块导出 |
|
||||
| `src/system_ui/theme.rs` | [src/shell/system_ui/theme.rs](../../src/shell/system_ui/theme.rs) | 管理表面颜色和主题 |
|
||||
| `src/system_ui/widgets.rs` | [src/shell/system_ui/widgets.rs](../../src/shell/system_ui/widgets.rs) | 宿主可复用控件绘制 |
|
||||
| `src/tabs.rs` | [src/shell/tabs.rs](../../src/shell/tabs.rs) | 共享标签绘制/命中、密集布局、滚动、拖放及动画 |
|
||||
| `src/tabs/hover.rs` | [src/shell/tabs/hover.rs](../../src/shell/tabs/hover.rs) | 标签、关闭和加号的颜色过渡 |
|
||||
| `src/tabs/motion.rs` | [src/shell/tabs/motion.rs](../../src/shell/tabs/motion.rs) | 标签布局动画及 hover 重绘期限 |
|
||||
| `src/tabs.rs` | [src/shell/tabs.rs](../../src/shell/tabs.rs) | 当前保留页面标签的不可变 ID/标题/选中状态投影;导航由 sidebar 绘制 |
|
||||
| `src/tabs/hover.rs` | 已删除 | 当前没有独立的旧标签 hover 动画模块 |
|
||||
| `src/tabs/motion.rs` | 已删除 | 当前没有独立的旧标签布局动画模块 |
|
||||
|
||||
## runtime
|
||||
|
||||
@@ -37,10 +37,10 @@
|
||||
| `src/api/tests.rs` | [src/runtime/api/tests.rs](../../src/runtime/api/tests.rs) | 保留原 API 测试;只调整嵌入示例路径,不执行测试 |
|
||||
| `src/endor_host.rs` | [src/runtime/endor_host.rs](../../src/runtime/endor_host.rs) | 候选/活跃 VM、编译执行、增量刷新、清理和诊断 |
|
||||
| `src/endor_host/tests.rs` | [src/runtime/endor_host/tests.rs](../../src/runtime/endor_host/tests.rs) | 保留原宿主测试;只调整嵌入示例路径,不执行测试 |
|
||||
| `src/endor_script.rs` | [src/runtime/endor_script.rs](../../src/runtime/endor_script.rs) | 组织 Aster Script/Module 输入及原始源码范围 |
|
||||
| `src/endor_script.rs` | [vendor/nexus/src/source.rs](../../vendor/nexus/src/source.rs) | 组织 Aster Script/Module 输入及原始源码范围 |
|
||||
| `src/event_dispatch.rs` | [src/runtime/event_dispatch.rs](../../src/runtime/event_dispatch.rs) | 托管事件、订阅和 capture/target/bubble 分发 |
|
||||
| `src/events.rs` | [src/runtime/events.rs](../../src/runtime/events.rs) | 原生输入的有界 loopback 传输 |
|
||||
| `src/io_tasks.rs` | [src/runtime/io_tasks.rs](../../src/runtime/io_tasks.rs) | 有界文件/HTTP provider、纯数据完成消息和取消 |
|
||||
| `src/io_tasks.rs` | [vendor/nexus/src/io_tasks.rs](../../vendor/nexus/src/io_tasks.rs) | 有界文件/HTTP provider、纯数据完成消息和取消 |
|
||||
| `src/tasks.rs` | [src/runtime/tasks.rs](../../src/runtime/tasks.rs) | 托管 Task、owner/key 取消和协作任务调度 |
|
||||
| `src/vm_sequence.rs` | [src/runtime/vm_sequence.rs](../../src/runtime/vm_sequence.rs) | 共享 VM 调用序列及同帧迭代驱动 |
|
||||
|
||||
|
||||
@@ -0,0 +1,69 @@
|
||||
# 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、可选性能基准或分发打包;示例、绘制像素、任务、窗口和输入协议由现有集成回归覆盖。
|
||||
Reference in New Issue
Block a user