备份语言规范、顶级类型与运行时设计草稿

This commit is contained in:
2026-11-05 00:53:52 +08:00
parent 52f497671e
commit 5e185c53e3
31 changed files with 3594 additions and 64 deletions
+5 -3
View File
@@ -1,6 +1,6 @@
# 3. namespace
namespace 是资源归属、组织与检索的单位。对代码资源,系统使用 namespace key 查找索引,取得对应代码段,并形成可见代码视图。
namespace 是 workspace 内资源命名、组织与检索的单位。对代码资源,系统使用 namespace key 查找索引,取得对应代码段,并形成可见代码视图。资源本身以独立 ID 识别,名称与路径是查找入口。
函数、class 和 agent 定义,以及需要独立保存和引用的基础内容,都纳入这一组织体系。资源类别与变量引用见[资源、类型与类](07-types-and-classes.md);非代码资源的登记和成员定位形式仍待定义,不由代码视图的语法推导。
@@ -24,7 +24,7 @@ key 中的 handle 规则见[Workspace handle 与显示名](02-user-identity.md#2
## 3.2 最小归属
独立登记的资源必须同时具有归属 workspace 和非空 namespace 路径。下列形式缺少必要信息:
通过 namespace 命名入口检索资源时,key 必须具有 workspace handle 和非空 namespace 路径。下列形式缺少必要信息:
| 形式 | 缺少的内容 |
| ---------------------- | ---------------------------------- |
@@ -34,6 +34,8 @@ key 中的 handle 规则见[Workspace handle 与显示名](02-user-identity.md#2
workspace 显示名不能替代 handle。只有 workspace handle 不是完整 namespace key;workspace 本身的管理入口另行定义。
同一资源可以出现在多个 namespace 中,也可以在入口移除后由保留程序继续引用。非空路径是 key 的格式约束,不是资源生存的必要条件;确定引用和回收边界见[资源引用](07-top-level-types/references.md)。
## 3.3 层级语义
workspace 承担类似 repository 的整体资源与授权边界。其下第一级 namespace 与所有后续层级具有相同语义,`shop` 不构成额外权限边界或特殊 module 类型。
@@ -64,7 +66,7 @@ atelier:shop.pricing
引用目标:atelier:shop.pricing
```
当前代码的 key 由外部上下文提供;引用目标写入正文的 `use` 声明。引用不改变归属,也不自动授予访问权限。下一章说明声明与导入的组织方式。
当前代码的 key 由外部上下文提供;引用目标写入源码的 `use` 声明。引用不改变归属,也不自动授予访问权限。
## 3.6 Workspace 与资源成员