5.3 KiB
解释执行与平台资源版本
本页记录 Endor 的执行模型与平台资源管理方向。阅读器、AST、基础名称／作用域分析、字节码生成和 VM 已连接；平台资源存储、发布和依赖锁尚未实现。下述版本模型是后续设计方向，不是现有 API 或已定稿的 URI 协议。
解释型语言的执行过程
Endor 由平台解释执行，目标流程为：
源码 → EndorReader → lexer → PEG parser → AST
→ 名称／局部槽与闭包分析 → 生成字节码 → VM 解释执行
生成字节码是解释器内部的执行准备，可以称为内部编译。使用者提交或调用源码资源，由平台完成这些步骤，无需先构建独立程序。现有 VM 解释 wordcode，源码编译沿用该执行器。
Frontend 产出 AST，由独立 Compiler 分析名称并生成代码模板，装载后交给 Core 执行。lyra run 执行基础函数模块，lyra eval 执行表达式，lyra parse 继续只输出 AST；支持范围见 编译链路。源码闭包与数值算术尚未接入，没有 CLI REPL。仓库中的 Cargo／Docker 构建用于构建 Rust 实现和宿主，不是 Endor 使用者的程序构建步骤。
名称、资源与修订
平台目标是将代码存为可发布到 workspace／namespace 的资源，通过 Endor URI 寻找。语言运行不应要求资源对应真实源码文件或一个 Git 项目。本仓库自身仍用 Git 管理 Rust 实现与文档；文件和流也继续作为宿主输入适配。
后续资源模型应区分以下概念，具体持久化结构尚未设计：
| 概念 | 作用 | 变化方式 |
|---|---|---|
| workspace／namespace 名称与 URI | 供使用者查找和组织资源 | 名称可以重命名，入口可以指向新的修订 |
| 资源身份 | 连接同一资源的修订历史 | 应独立于可变名称和实际存储位置 |
| 资源修订 | 标识一次不可变的源码及其相关元数据 | 编辑后产生新修订，保留旧修订供明确选择 |
| 源码内容 hash | 校验或寻址原始文本内容 | 可作为设计选项；算法、字节范围和修订格式未定 |
| 依赖锁 | 固定所选择的依赖资源与修订 | 更新依赖时显式形成新的选择记录 |
| 发布快照 | 把多份资源及依赖选择作为一次一致发布 | 按实际原子发布需求增加，不强制所有资源归为一个项目 |
相同源码可以处在不同的依赖上下文，因此源码 hash 本身不足以确定完整执行输入。原文内容身份、包含依赖的修订身份是否使用同一种 hash，需要另行决定。Reader 会原样保留文本，但当前不计算或验证任何 hash。
重命名或移动存储位置不应迫使已锁定引用改选内容；修改源码则产生新修订。可变 URI 的重新解析可以选到新修订，已有依赖锁应继续指向原资源与修订。实现时还需解决资源保留、权限和删除策略；固定版本不等于永久可访问。
版本选择属于平台资源及依赖元数据，不要求在每个业务语句中写 hash，也没有新增 workspace／namespace／版本锁的语言语法。URI 将来可以提供修订选择方式，具体形式未定。并发编辑时防止覆盖的写入锁或条件更新，与选择执行版本的依赖锁是两项独立机制，当前均未实现。
平台解释器升级
解释器及内部字节码生成器按平台统一发布管理，首版方向不要求每份资源自行选择编译器版本。同一份源码修订 R1，可以由旧解释器生成字节码 A，也可以在平台升级后由新解释器重新处理为字节码 B；升级实现不会因此把源码 R1 改成 R2。
源码与依赖锁回答“选了哪份用户代码”，平台版本回答“由哪套运行语义处理”。锁定源码不保证跨解释器版本、外部数据和宿主能力变化后的结果完全相同。语言语义迁移、升级中正在执行的帧如何处理、是否需要历史运行环境，留待实际兼容性需求设计；当前不承诺热切换执行帧。
现有 host.version、deployment.release、镜像 SHA 和部署目录记录的是 Rust 实现／宿主发布，不能用作 Endor 用户资源的修订或依赖锁。资源版本也不复用 VM 的代际对象句柄。
字节码复用与首版范围
首版源码执行可先不持久化字节码缓存，平台升级后按需重新准备源码，不提前引入编译产物仓库或用户侧产物版本管理。同一进程内可以复用已准备的不可变代码对象；core 当前已有函数共享代码对象的能力，不要求每次函数调用都重新生成字节码。
只有引入跨进程或跨升级的持久化字节码缓存后，才需要明确失效策略。缓存有效性至少取决于相关源码／依赖输入与解释器、字节码格式兼容性；可在平台升级时统一失效，也可使用内部兼容标识。无需把实现版本强塞进每个资源 URI；具体缓存方案尚未选择。
最小源码到 VM 的连接已完成；后续按语言能力和平台接口需求扩展，并设计资源存储、修订与依赖锁。Reader 已提供宿主 provider 扩展点，当前只接收不透明 revision 标签，实际契约见 Endor 阅读器。返回 系统架构 或 文档索引。