Add Endor source reader before lexing with provenance and URI provider

2026-10-19 03:23:38 +08:00
parent 4bf889e5b7
commit 483d9d1717
27 changed files with 667 additions and 37 deletions
@@ -2,7 +2,7 @@

 Rust 编写的 Endor 虚拟机实现。当前具备 EndorObject、稳定对象分配、代际句柄、引用计数、显式循环回收，以及可执行语言函数的小型 wordcode VM。数字统一为无损表示优先的 Number。

-独立 frontend 已提供手写 lexer、peg parser、基础函数／表达式 AST 与 cli parse 文件入口。VM 从空堆启动；尚无 AST 到字节码编译器、Python type／元类体系、数值算术或完整异常传播。数据库连接仅为需要数据库的特殊类保留；普通宿主不连接数据库；基础信息改用 host 包的 UTF-8 JSON 文件，不保存 VM 堆。当前边界见 [系统架构](docs/architecture/README.md)。
+独立 frontend 已提供 Endor 阅读器、手写 lexer、peg parser、基础函数／表达式 AST 与 cli parse 文件／stdin 入口。VM 从空堆启动；尚无 AST 到字节码编译器、Python type／元类体系、数值算术或完整异常传播。数据库连接仅为需要数据库的特殊类保留；普通宿主不连接数据库；基础信息改用 host 包的 UTF-8 JSON 文件，不保存 VM 堆。当前边界见 [系统架构](docs/architecture/README.md)。

 ## 从哪里读

@@ -10,6 +10,7 @@ Rust 编写的 Endor 虚拟机实现。当前具备 EndorObject、稳定对象
 | --- | --- |
 | 查一个功能、设计或代码位置 | [文档总索引](docs/README.md) |
 | 看源码目录与 crate 边界 | [crates](crates/README.md) |
+| 看字符串、流、文件与平台 URI 如何进入 lexer | [Endor 阅读器](docs/runtime/reader.md) |
 | 看源码词法、语法、AST 和解析命令 | [源码前端](docs/runtime/frontend.md) |
 | 看指令、代码对象、执行帧和执行循环 | [字节码 VM](docs/runtime/bytecode.md) |
 | 看 VM／帧／对象如何存活和销毁 | [生命周期](docs/runtime/lifecycle.md) |