Files

2.2 KiB

代码存储与视图

本附录说明无源码文件模型中的代码组织约定。它补充 namespace 的逻辑视图,不定义业务数据的存储方式。

独立代码段

代码分别存储为独立代码段,每段关联一个归属 workspace 和至少一级 namespace。S3 承担代码内容的存储职责,索引维护 namespace key 与代码段的成员关系;编写或修改代码的用户身份另行记录。

源码文件不作为代码身份或 module 边界。本书中的 Markdown 文件是文档章节,不对应语言中的源码组织单位。

代码段的具体语法粒度尚未定义,不能将一条声明或一个 S3 对象直接规定为同一种单位。

索引与视图

完整 namespace key
    → 索引中的成员关系
    → S3 中的独立代码段
    → namespace 的可见代码视图

视图是逻辑上的代码集合。它的归属来自 key 与索引,不由对象名或物理目录确定。

S3 对象键不是语言中的 namespace key。bucket 名、对象键和存储接口不属于业务源码语法。

视图与程序结构

程序结构描述视图内导入与声明的语法关系,见程序结构与导入。这一结构不要求将物理对象按文件顺序机械拼接。

视图成员范围、下级 namespace 是否纳入、导入作用范围、声明顺序、版本一致性与编辑映射尚未定义,统一记录在规范状态。

namespace 制

namespace 同时表达归属与查找位置,使业务函数、类型、界面逻辑和 agent 定义遵循一致的组织模型。第一级与后续层级具有相同语义。

基础内容也纳入资源归属方向,但本附录的 S3 代码段约定不自动规定媒体、GIS 数据、对象或 agent 记忆的存储后端。代码视图与完整资源集合的区别见namespace。

这一组织选择不自动决定检查边界、执行位置、权限继承或业务数据存储。相关语义需要由各自规则定义,而不是从 S3 物理布局推导。

相关章节:namespace · 目录