# core

Endor VM 内核，保持零外部依赖。负责 EndorObject、堆、代际句柄、引用计数／循环回收、基本载荷和小型 wordcode 执行器。公共 Rust API 从 src/lib.rs 导出。Cargo 包名为 core，Rust 引用名为 endor_core，由 Cargo.toml 的 [lib] 设置，避免与标准库 core 重名。

| 内容 | 入口 |
| --- | --- |
| Cargo.toml | 包元数据、endor_core 库目标和工作区 lint；没有外部依赖 |
| [src](src/README.md) | 文件职责、公开接口和常见修改位置 |
| [tests](tests/README.md) | 对象、基本载荷、执行语义与生命周期检查 |

内核通过 Vm::new 从空堆启动；代码对象和全局字典由宿主显式创建，再 execute／call。内核没有环境变量探测、数据库、HTTP、Python type 系统或源码解析；源码 lexer/parser 在独立 [frontend](../frontend/README.md) 包中，尚未接入字节码编译。

对象结果所有权见 [生命周期](../../docs/runtime/lifecycle.md)，对象／字节码设计见 [运行时](../../docs/runtime/README.md)，限额与 UTF-8 边界见 [配置](../../docs/operations/configuration.md)。本地不构建或运行测试，验证入口见 [验证](../../docs/operations/validation.md)。返回 [工作区](../README.md)。