docs: clarify interpreted execution and platform resource versions
Verify databases and deploy Aster VM / verify-and-deploy (push) Successful in 6m46s
Verify databases and deploy Aster VM / verify-and-deploy (push) Successful in 6m46s
This commit is contained in:
@@ -34,11 +34,11 @@ Read 阶段的 SourceReadError 与词法/语法 Diagnostic 分开:Io 保留
|
||||
|
||||
## 平台 URI 边界
|
||||
|
||||
EndorSourceProvider::load(&str) 返回 io::Result<ResolvedEndorSource>。ResolvedEndorSource 包含 bytes 和非空 revision;宿主负责名称解析、权限检查、版本选择与实际存储访问,失败直接返回相应错误。例如权限不足可使用 PermissionDenied,不存在可使用 NotFound。
|
||||
EndorSourceProvider::load(&str) 返回 io::Result<ResolvedEndorSource>。ResolvedEndorSource 包含 bytes 和非空 revision;宿主负责名称解析、权限检查、版本选择与实际存储访问,失败直接返回相应错误。接口要求 bytes 与 revision 对应同一次选定的读取结果,Reader 无法自行验证这种对应关系。例如权限不足可使用 PermissionDenied,不存在可使用 NotFound。
|
||||
|
||||
Reader 只校验 scheme 为不区分大小写的 endor、冒号后非空,且 URI 不含原始空白/控制字符。它不固定 workspace/namespace 的 URI 路径形式,不解码百分号、不实现相对 URI,也不规定修订选择器或 hash 算法。scheme 以外的协议校验由宿主执行,原 URI 不重写。每次读取只调用一次 provider,之后词法和语法处理不再解析 URI。
|
||||
|
||||
revision 是宿主返回的原样标签;Reader 只拒绝全空白标签,不验证标签是否为内容 hash、不验证内容与 hash 的对应关系,也不实现资源历史、依赖锁、发布快照或签名。当前没有内置平台 provider、网络客户端、数据库存储或 CLI URI 执行入口。具体版本模型仍需另行设计。
|
||||
revision 是宿主返回的原样标签;Reader 只拒绝全空白标签,不验证标签是否为内容 hash、不验证内容与 hash 的对应关系,也不实现资源历史、依赖锁、发布快照或签名。当前没有内置平台 provider、网络客户端、数据库存储或 CLI URI 执行入口。资源身份、源码内容 hash、依赖锁与发布快照的区别,以及平台统一升级的方向,见 [解释执行与平台资源版本](../architecture/execution-and-versions.md)。这些机制不由当前标签或 SourceUnit 自动实现;URI 具体形式和持久化模型仍待设计。
|
||||
|
||||
## CLI 与交互输入
|
||||
|
||||
|
||||
Reference in New Issue
Block a user