2.5 KiB
代码存储与视图
本附录说明无源码文件模型中的代码组织约定。它补充 namespace 的逻辑视图,不定义业务数据的存储方式。
独立代码段
代码分别存储为独立代码段,以资源 ID 识别并关联归属 workspace。S3 承担代码内容的存储职责,索引维护 namespace key 与代码段的成员关系;一段代码可以具有多个命名入口,编写或修改代码的用户身份另行记录。
移除 namespace 成员入口不删除仍被其他保留程序引用的代码段。资源 ID、存储对象键与 namespace key 分别表达逻辑身份、存储位置和命名入口,具体引用语义见资源引用。
源码文件不作为代码身份或 module 边界。本书中的 Markdown 文件是文档章节,不对应语言中的源码组织单位。
代码段的具体语法粒度尚未定义,不能将一条声明或一个 S3 对象直接规定为同一种单位。
索引与视图
完整 namespace key
→ 索引中的成员关系
→ S3 中的独立代码段
→ namespace 的可见代码视图
视图是逻辑上的代码集合。它的归属来自 key 与索引,不由对象名或物理目录确定。
S3 对象键不是语言中的 namespace key。bucket 名、对象键和存储接口不属于业务源码语法。
视图与程序结构
程序结构描述视图内导入与声明的语法关系,见程序结构与导入。这一结构不要求将物理对象按文件顺序机械拼接。
视图成员范围、下级 namespace 是否纳入、导入作用范围、声明顺序、版本一致性与编辑映射尚未定义,统一记录在规范状态。
namespace 制
namespace 提供归属 workspace 内的组织与查找位置,使业务函数、类型、界面逻辑和 agent 定义遵循一致的组织模型。第一级与后续层级具有相同语义。
基础内容也纳入资源归属方向,但本附录的 S3 代码段约定不自动规定媒体、GIS 数据、对象或 agent 记忆的存储后端。代码视图与完整资源集合的区别见namespace。
这一组织选择不自动决定检查边界、执行位置、权限继承或业务数据存储。相关语义需要由各自规则定义,而不是从 S3 物理布局推导。