跳转到内容
AggregaAggrega
选择语言: 简体中文
本页面由机器翻译。阅读英文原文。

语言状态

本页是权威参考,说明 Aggrega 的哪些功能面目前可用,哪些已有文档但编译器尚未处理,以及哪些计划在未来的迭代中实现。它对各领域章节进行补充,在一处集中呈现整个语言的就绪状态。

有两类读者会查阅本页。初次编写者在针对不熟悉的功能面进行编写之前查看本页,以确认该功能面目前能够产生渲染输出。查阅参考者在所用功能面的行为出乎意料时查看本页——例如,当 YAML 通过验证却没有产生任何输出时,本页是查询该功能面状态的首选之处。回访读者也会查阅本页,以找出自上次阅读以来状态标签发生变化的功能面。各领域章节和实体参考描述功能面应当如何工作;本页描述它是否已经可以工作。

状态分类

本页中的每个语言功能面都带有以下四种状态标签之一:

  • available(可用)。 schema 接受该功能面;编译器使用它;行为与文档所述契约一致。使用 available 功能面的作者会得到文档所述的契约。

  • accepted but inert(已接受但无效果)。 schema 接受该功能面——针对它编写的内容能通过校验——但编译器尚未对其执行任何操作。编写 accepted but inert 功能面会产生语法有效的构建,但该功能面不产生任何渲染效果;编译器可能会发出一条指明该无效果功能面的警告(推荐的做法),也有部分现有功能面会在不发出警告的情况下被静默跳过。下文各节的条目会说明具体行为。

  • accepted but blocked(已接受但被阻止)。 schema 接受该功能面——针对它编写的内容能通过校验——但编译器会终止构建,而不是渲染它。针对 accepted but blocked 功能面编写的内容会在渲染时失败,并给出一条明确的错误,指出应改为编写什么。阻止可以是永久的:所编写的内容存在歧义,而编译器不会代你消解,因为替你选定一种解读可能会交付你并未要求的东西;阻止也可以只持续到该功能面背后的行为发布为止。无论哪种情况,该标签承诺的都是一样的:schema 接受它,构建拒绝它,错误告诉你如何修复。

  • planned(计划中)。 该功能面已按设计写入文档,但 schema 和编译器目前都还不接受它。针对 planned 功能面编写的内容会在 schema 校验时失败。本页列出计划中的条目,以便作者能够事先规划如何应对它们的缺失,而不是在构建时才发现这一空缺。

状态标签以当前编译器为准进行评估。正在积极开发的功能面可能会在标签之间转变;已知转变计划的,各节条目会加以说明。

Recipe 输入类型

Recipe 由三种输入类型组合出其输出——来源型(sourced)、合成型(synthesized)和制品(artifacts),详见 16-recipe-input-composition.md。各输入类型的状态:

  • source: + valuesMapping:(来源型)——available。 编译器解析 source: URI,求值 valuesMapping 模板(内联、文件 $import: 或库 $import:),并将结果交给目标 provider 进行渲染。由 helm、helm-chart、compose、terraform 和 cloudformation provider 使用。

  • workload:(合成型)——available。 Recipe 可以内联声明 workload:(承载 Workload YAML 的块标量),也可以通过 $import:(文件路径)声明。编译器解析模板化的 Workload,依据内嵌的 Workload schema 对其进行校验,并分派给目标 provider 的 workload 合成器。由 helm 和 compose provider 使用。helm-chart provider 会明确引导作者使用 helm provider 来生成合成的 K8s manifest。若 Recipe 针对不实现 workload 合成的 provider 声明了 workload:,会在渲染时以 CATALOG_ERROR 中止。

  • artifacts:(artifacts)— available。 该字段是一个由命名条目组成的映射;每个条目可以内联编写,也可以通过各条目自己的 $import: 加载。条目在 Workload 解析完成、source 解析完成之后才求值,因此完整的模板上下文(包括 .workload 和 .source)对它们都可用;对于带有 metadata 的文档,条目会将来源信息合并到 metadata.labels 和 metadata.annotations 中(字符集不安全的键 recipe-uri、boundary-path、sync-wave 作为注解写入,与 helm 提供程序采用的拆分方式相同),并作为独立文件输出,与该 Recipe 的 source 渲染输出或 workload 合成输出并列。Provider 分派:扁平的 helm 提供程序将独立文件输出到边界输出目录内、以声明这些文件的组件命名的目录下,因为键只命名文件,并不说明是哪个组件写入了它;compose 提供程序将其输出交给 Release 末端的合并器处理;helm-chart 提供程序使用 [[ ]] Aggrega 分隔符对每个条目求值,使同一文件中 Helm 的 {{ }} 语法得以保留到下游渲染,然后按条目的编写形式放置每个条目:通过 $import: 加载的条目放在 boundaries/<bp>/charts/<nodeID>/templates/<authored-key>(bundle 的文件嵌套在该键之下),与 source 引入的 chart 自身的模板并列;内联内容的条目放在 boundaries/<bp>/charts/<nodeID>/<authored-key>,即 chart 根目录,由 chart 自身的模板通过 .Files.Get / .Files.Glob 读取;terraform 提供程序将每个条目原样写入边界 modules/ 树下该组件自己的目录;cloudformation 提供程序将每个条目(一个堆栈片段)合并到为该输出目录组装的单个堆栈中。不同输入类型来源(source 渲染、workload 合成或 artifact 输出)之间的文件名冲突会在渲染时由跨来源冲突检测器捕获,并产生一个列出所有贡献者的 CATALOG_ERROR。

Recipe 的编写接口和输入类型组合规则见 entities/recipe.md;Recipe 的形态规则见 errors/fatal-halts.md;各 provider 的矩阵见下文 Providers 一节。

映射语言

Recipes(以及 FeatureRecipes)绑定到单个映射字段,用于将 Aggrega 上下文转换为底层 provider 所使用的 values 字典。valuesMapping: 字段支持三种编写模式,按内容形态分派:

  • valuesMapping: — 模式 1-3 可用。 模式 1:内联 Go 模板(块标量)。模式 2:文件 $import:(一个仅包含 $import: 且值为本地文件路径的映射)。模式 3:库 $import:(一个仅包含 $import: 的映射,其值为对某个 MappingLibrary 条目的裸名称身份引用 <Library>#/mappings/<entry>,可选带有 :<version> 下限)。编译器按内容形态分派:块标量分派到模式 1,带文件路径的 $import: 分派到模式 2,带裸名称库引用的 $import: 分派到模式 3。三种模式都在值映射期间针对 Recipe 的模板上下文求值解析后的 Go 模板(Sprig 辅助库已预先注册);模式 3 在本地目录以及所有由锁文件固定的库中解析该条目,带主机的引用会被拒绝。分派机制和完整示例参见 entities/recipe.md 中的“The valuesMapping field — three authoring modes”。

Recipe 的编写接口和映射语言设计参见 entities/recipe.md,支撑模式 3 的库实体参见 entities/mappinglibrary.md。

Inject 语法

inject: 块在每个位置都只有一种语法——组件自身的 inject、uses 连接上的注入,以及附件上的注入。

完整的注入契约规范,包括双状态上下文语义、键冲突规则和完整示例,请参阅 vocabulary/topology-triad.md。

模板引擎

Aggrega 的 Go 模板引擎在 Template Expansion Matrix(模板展开矩阵) 所记录的各站点阶段,针对模板上下文求值 Recipe 和 FeatureRecipe 模板。在渲染器求值的每个位置上,Sprig 辅助函数库都与 Aggrega 自身的辅助函数一同预先注册,只有一个例外:解析结构化的 source: 坐标时只注册 Aggrega 的辅助函数——那里可以使用 optional 和 capitalizedWords,但不能使用 Sprig 的函数,因此在 source: 字段中,或在带有结构化 source: 的实体的 locals: 条目中调用 Sprig 函数,会在解析时中止。参见 errors/fatal-halts.md,其中为该位置单独设有一节。求值、解析和 Sprig 集成目前均已可用。

缺失键行为——值模板中容忍;路径模板、断言和 source: 坐标中严格采用 missingkey=error。 值模板使用 Go 的 missingkey=zero 选项求值,因此引用未绑定键(例如 .values.unset_field)的模板不会报错,该读取渲染为空。{{ .values.optional_field | default "fallback" }} 这类目录惯用写法在此策略下仍然有效,因为未设置的值对 default 而言视为空。路径模板(Release 边界上的 directory: / subDirectory:)针对一个封闭的允许列表,使用 missingkey=error 求值——静默的路径失败会产生损坏的文件系统布局,运维人员只有在构建后才会发现,而严格策略能更早捕获该错误。另有两个位置出于同样的原因采用相同的严格策略:在那里,空渲染会产生错误的判定或错误的锁定,而不是作者可以回读的字段。它们是 Component、Feature、Recipe 或 FeatureRecipe 上的 assertions: 条目,以及 Recipe 或 FeatureRecipe 上结构化 source: 块中的模板化字段。errors/fatal-halts.md 逐一说明了每个位置的策略,并给出了在严格策略下可用的感知存在性的写法。

通过 optional 实现感知存在性的回退。 当 Recipe 作者需要区分“键不存在”与“键存在但值为零 / 空 / false”——这正是 Sprig 的 default 无法做出的区分——渲染器提供了 optional 辅助函数:{{ optional .infra "replicas" 1 }} 在键存在时返回所编写的 infra.replicas(包括所编写的 0),仅在键不存在时回退到 1。完整语义参见 templates/sprig-functions.md。

通过 capitalizedWords 折叠名称。 当目标在用于寻址资源的名称中只接受字母和数字时,{{ capitalizedWords .context.instance_id }} 会把 id 读作由该字母表以外的任意字符分隔的单词,并将每个单词的首字母大写,因此 payments-db 得到 PaymentsDb。折叠会去掉所有分隔符,因此仅标点不同的两个 id 会得到同一个名称;会以同一名称输出两个资源的构建将中止,并指出这两个 id。完整语义参见 templates/sprig-functions.md。

在声明层强制执行参数契约。 Release 未提供的必需参数会在参数契约层产生明确的错误,这是解析首先检查的内容,并附带 file:line 来源信息,指出该参数和契约。类型 / 约束违规也以同样方式报告。这才是实质性的缺失键强制检查:类型在开发者意图所在之处(Aggregate 的 parameters: 声明)检查,而不是在下游模板求值时检查。参见 entities/aggregate.md §“Typed parameter contracts”。

Aggregate parameters: 的单一声明语法。 每个参数槽都以类型化契约对象(key: { type: <type>, default: <value>, ... })的形式编写。裸标量简写(key: <value>)会在 Aggregate 的文档信封处被拒绝,错误会指出该参数并说明期望的是一个对象。类型化契约词汇使 type:、required: 和约束语义在声明层变得明确;Release 的参数填充仍按契约声明的类型使用标量值。

各模板站点的求值矩阵参见 templates/expansion-matrix.md,模板概述参见 05-templates.md。

编译流水线阶段

Aggrega 编译流水线的说明见 ../architecture/10-compilation-pipeline.md。各阶段状态:

  • 解析、拓扑构建、图最终化、静态分析和渲染——可用。
  • 注入映射(injectMapping 渲染前拦截)以及每个基础渲染子阶段——locals 发布、values 映射、workload 合成、artifact 求值、provider 渲染、feature 渲染,以及凭据 FeatureRecipe 资源生成——可用。
  • 插件流水线(pipeline: Wasm 执行)——可用。 声明了非空 pipeline: 步骤的 Recipe 或 FeatureRecipe 会按声明顺序执行每个步骤:编译器针对渲染输出调度该步骤指定的 Wasm 插件,将返回的 JSON Patch 操作应用到所指向的文档,并产生该步骤的副作用。when: 门控渲染为假值的步骤会作为直通被跳过,文档集保持不变。需要 JSONPatch 风格变更(Envoy sidecar 注入、secret VolumeMount 等)的作者通过这一机制实现。

Providers

Aggrega 标准库提供五个渲染 provider——helm、helm-chart、compose、terraform 和 cloudformation。各 provider 的状态:

  • helm——可用。 源模式(通过 Helm SDK 渲染 Helm chart)和合成模式(Workload → 由该 Workload 的 form 选定的控制器对象——Deployment、StatefulSet、DaemonSet、Job 或 CronJob——外加 Services 和 PVCs)均已提供。
  • helm-chart——可用。 源模式(umbrella chart 组合)已提供。合成输入类型不适用于该 provider;需要合成 K8s manifest 的作者应使用带 workload: 的 helm provider。
  • compose——可用。 源模式(compose 片段叠加)和合成模式(Workload → compose 服务 + 卷 + 网络)均已提供。每个边界的 docker-compose.yaml 输出由 Release 级别的组合器组装。
  • terraform——可用。 源模式和制品均已提供;每个边界获得一个根配置 aggrega.modules.tf,它将每个组件声明为一个 module 块,其文件位于 modules/ 下该组件自己的目录中。合成输入类型不适用于此 provider。
  • cloudformation——可用。 源模式和制品(堆栈片段)均已提供;渲染到同一输出目录的所有组件会组装成一个堆栈模板,以纯 JSON 输出。合成输入类型不适用于此 provider。

Provider 渲染由 pluginType: provider 的 Plugin 提供;关于渲染 provider 的 Plugin 编写接口,参见 entities/plugin.md;各 provider 的参考页面参见 06-providers.md。

注解驱动的展开

Manifests 带有一个 features.annotations: 绑定节,它将注解键映射到 Feature 类型,并附带一个按支柱分组的路由表(maps.infra / maps.values),指明每个绑定可以填充哪些 Feature schema 属性。相关文档见 entities/manifest.md 和 providers/well-known-annotations.md;在流水线中的位置见 ../architecture/10-compilation-pipeline.md;目录加载时和 inspect 时的机制见 ../architecture/13-catalog-and-registry.md §“Annotation-driven Feature expansion”。

  • Manifest features.annotations 绑定——可用。 解析阶段的注解展开子阶段已端到端交付。它遍历 Release 边界(由外到内)和 Aggregate 子系统(由外到内),通过级联 + 覆盖计算每个组件的有效注解集,支持整值和按子键的 null 退出;将每个注解值解析为标量、结构化映射或显式的 null;按子键经由绑定的 maps 声明进行路由,并强制区分侧与支柱(Aggregate 侧触发 maps.values;Release 侧触发 maps.infra);根据目标 Feature 的 spec.schema 校验每个叶子的类型;并注入合成的 Feature 附件,IR 图会以 origin: annotation 标记这些附件。跨侧组合在 IR 构建时按支柱、按字段合并,按字段以显式值优先;aggrega inspect 为每个叶子渲染来源括注。目录加载时的绑定目标校验、schema 支柱重叠 lint 和绑定映射重叠 lint 共同把关这一路径。裸 aggrega.ai/ 前缀用作绑定键时会在 Manifest 加载时被拒绝——该前缀保留给平台原生注解;绑定应使用 feature.aggrega.ai/ 或自定义域。

版本匹配

Recipes 和 FeatureRecipes 通过 implements: 关键字声明它们所实现的 Component 或 Feature 接口。implements: 从不选择 Recipe:选择由 Manifest 的映射完成,类型未被任何映射覆盖的实例会以错误中止,该错误会将 implements: 能实现该类型的 Recipes 列为候选。implements: 所驱动的是这样一项检查:每个 Manifest 映射条目的 Recipe 实现了被映射的类型,或该类型 extends 的某个基类型。被映射的类型是条目的键;对于 components.type 键,它还是该键以其未指定的版本所触及的每个组件实例的类型(对于未写版本的键,即它触及的每个实例),版本取构建编译该实例时所用的版本:实例指定的版本,或者对未指定版本的实例而言,目录中该 Component 的最高版本。各形式的状态:

  • 精确(core/api-server:1.0.0)——可用。 被映射的类型必须是该版本。
  • 主版本兼容范围(core/api-server:^1.0.0)——可用。 脱字符形式是一个 SemVer 约束(本例中为 >=1.0.0, <2.0.0);被映射类型的版本必须满足该约束。
  • 无版本(core/api-server)——可用。 该类型的任何版本都满足它。

若映射条目的 Recipe 的 implements: 既不匹配被映射的类型,也不匹配其任何基类型,构建会以 OPS_ERROR 中止,并指出该条目、该 Recipe 及其 implements: 值。若某个键以另一版本触及某个组件实例,而该 Recipe 的 implements: 不满足该实例的版本,构建会以同样的 OPS_ERROR 中止,并指出该实例、其类型(对于未指定版本的实例,还包括其被编译时所用的版本)、该键、该 Recipe 及其 implements: 值。脱字符形式是主版本兼容匹配的规范编写方式。

关于 implements: 的设计,请参阅 vocabulary/inheritance-and-interface.md;关于每个 Manifest 的映射层结构,请参阅 entities/manifest.md。

元数据信封

目录实体信封携带 metadata.labels、metadata.annotations,以及(在 Release 上的)metadata.environment。各部分状态:

metadata.labels 和 metadata.annotations 的可用性——适用于七种类型。 携带这些字段的实体信封有:Component(labels 必需,且须包含必需的 component.aggrega.ai/type 键,annotations 可选)、Feature(两者均可选)、四种库类型 SchemaLibrary、MappingLibrary、WorkloadLibrary 和 ArtifactLibrary(两者均可选),以及 Aggregate(仅 labels,可选)。其余实体——Recipe、FeatureRecipe、Manifest、Release、Plugin——在信封层级不接受 metadata.labels 或 metadata.annotations。

Release 上的 metadata.environment——必需。 Release schema 将 environment 列为必需的 metadata 字段;构建会将其值作为 aggrega.ai/environment 标签写入渲染输出。关于 Environment Metadata 一节中的五个实际用例(OTel/FinOps 成本归因、OTel 追踪/日志过滤、Kubernetes operator 定向、多区域生产环境区分、合规范围划定),请参阅 entities/release.md。

关于适用于 metadata 键的字段大小写规范,请参阅 02-naming-conventions.md;关于每个实体目前接受的信封结构,请参阅各实体的参考页面。

CLI 命令

Aggrega CLI 注册了构建流水线以及内省功能。各命令状态:

  • aggrega build — 可用。 读取 Release 文件,解析 Aggregate + Manifest,运行编译流水线,并将渲染出的制品写入边界输出目录。存在锁文件时,会根据锁文件校验依赖;锁文件不存在时,会停止并要求执行 pull,或者在 --auto-pull 或 auto_pull 要求时先填充锁文件。
  • aggrega inspect — 可用。 检查一个目录实体、一个实体文件、一个发布到注册表中的实体或一个 Release,并报告其解析后的结构。参见 cli/aggrega-inspect.md。
  • aggrega pull — 可用。 解析一个 Release 的所有依赖,并写入一个按 Release 区分的锁文件,将每个目录实体和源制品固定到某个版本和内容摘要,并将该 Release 渲染所请求的每个外部输入固定到某个内容摘要;将获取的内容缓存在 .aggrega/cache 下。--verify 根据当前状态检查已有的锁文件。参见 cli/aggrega-pull.md。
  • aggrega push — 可用。 将目录实体发布到 OCI 注册表;aggrega push --list-kinds 报告它接受哪些类型。参见 cli/aggrega-push.md。
  • aggrega lint — 可用。 以 warn 严重级别对整个目录、某个 Release 的依赖闭包或单个实体运行发布规范规则;对单个实体,--pre-publish 会针对该实体当前已发布的版本增加版本号递增检查,不匹配时构建中止。这些规则以可选启用的 Wasm 插件形式提供。参见 cli/aggrega-lint.md。
  • aggrega serve — 可用。 一个长期运行的编译器即服务守护进程,通过 stdin/stdout 使用 JSON-RPC 2.0 通信,用于编辑器和 IDE 集成。其提供的方法参见 cli/aggrega-serve.md。
  • aggrega version — 可用。 打印 CLI 版本;-o json 输出机器可读的版本对象。
  • aggrega validate — 可用。 检查整个目录、一个 Release 或单个实体的正确性,报告诊断信息,但不渲染制品。
  • aggrega search — 可用。 在已配置注册表的本地索引中搜索已发布的实体;该索引由 aggrega registry update 构建和刷新。
  • aggrega registry — 可用。 管理注册表及其签名信任策略;registry add 记录一个注册表,registry update 构建供 aggrega search 查询的本地索引。
  • aggrega push-artifact — 可用。 将独立的数据制品(例如文档包)发布到 OCI 注册表,与发布实体的 push 并列。
  • aggrega sign — 可用。 对一个或多个已发布的制品签名,并附加其签名。
  • aggrega deprecate — 可用。 为已发布的制品附加一个经过签名的弃用标记。
  • aggrega login 和 aggrega logout — 可用。 向 OCI 注册表进行身份验证并存储凭据,或删除已存储的凭据。
  • aggrega auth — 可用。 管理用于对制品签名的本地签名身份。
  • aggrega config — 可用。 检查和管理工作区配置;其子命令可显示合并后的有效配置及每项设置的来源,使用一个注册表及其签名信任策略生成可用的初始配置,并将对构建至关重要的有效配置冻结到工作区中,使其无需依赖机器的全局配置即可得到完全相同的构建结果。
  • aggrega get-schema — 可用。 打印某个实体或契约类型的 JSON Schema。
  • aggrega plugin — 可用。 检查 CLI 能够解析的 Wasm 插件;其子命令可列出插件、添加和移除已配置的插件、同步插件由机器维护的记录,以及生成插件的目录视图。
  • aggrega cache — 可用。 检查和维护磁盘缓存;其子命令可报告状态、修剪、逐出和清空。
  • aggrega mcp — 可用。 通过 stdio 运行 Model Context Protocol 服务器,或为另一台机器上的客户端通过 HTTPS 运行,将编译器的内省功能开放给 AI 助手集成。
  • aggrega completion — 可用。 为 CLI 生成 shell 自动补全脚本。
  • CLI 扩展子命令 — 可用。 以 pluginType: cli guest 形式发布的 Wasm 插件会被解析并注册为 aggrega 子命令,因此已安装的扩展以 aggrega <extension> 的形式与内置命令并列运行。
  • aggrega import — 可用。 将外部声明式智能体定义源(Langflow、Flowise、n8n)转换为 Aggregate 和 Component 的草稿编写文件,并为每个节点记录一个确定性的、带置信度评分的目录复用决策。特定于格式的映射由工作区为该源格式解析的导入器插件提供——可以是其目录中包含的插件,也可以是编译器的 Langflow、Flowise 和 n8n 导入器之一,这些导入器随每个编译器版本一同构建和发布。二进制文件包含它们的 Plugin 实体,但不包含其模块,因此它们在每个工作区中都能处理各自的格式:当某次导入首次需要本机尚未持有的导入器时,会从工作区的默认注册表获取它,对其进行校验,并保存在内容缓存中供之后的每次导入使用。源文件通过工作区目录为其语法提供的解析器进行解析;若目录未提供解析器,则通过编译器自带的解析器进行解析,因此目录中不含解析器的工作区也能通过其中任一方式完成导入。
  • aggrega scaffold——可用。 根据任意实体类型的 schema 起草该类型的起始文档——包含其要求的每个字段,需要值的地方放置占位符——并将其写入标准输出;使用 --example 时,将文档中的某个可运行示例(从已签名的文档包中读取)写入新目录。
  • aggrega explain——可用。 解释某个短代码(例如 E0007)或描述性代码所指的中止条件。
  • aggrega edit-document——可用。 对文档应用一次有界的结构化编辑——添加组件、附加 Feature、接通一个连接或设置一个值——并保留其未触及的每个字节。
  • aggrega pin——可用。 在 Recipe 或 FeatureRecipe 旁边的 entity.lock 中,为该实体从自身文档之外读取的每个输入记录内容固定值。
  • aggrega skills——可用。 将 Aggrega 技能安装到 AI 助手中。

CLI 概述参见 07-cli.md,各命令的参考页面参见语言参考索引。

编辑器和其他前端

每个前端显示的都是 aggrega 二进制文件编译的结果;没有一个前端自带编译器。各界面的状态:

  • IR 图契约——可用。 IR 图 schema 是每个前端读取图时所依据的契约,作为 Aggrega schema 发行包的一部分发布;参见 IR schema 参考。
  • 从命令读取图——可用。 aggrega build 接受 --ir-graph,给定 Release 的 aggrega inspect 以及 aggrega validate --release 也接受该标志;它会在命令原有输出之外,将该次运行解析出的图以 JSON 形式写入 stdout。守护进程会话可在 aggrega/irGraph 读取同一个图,MCP 服务器的 cli-inspect、cli-build 和 cli-validate 工具则将其作为 ir_graph 参数接受。
  • Visual Studio Code 中的拓扑图——可用。 Visual Studio Code 的 Aggrega 扩展将所选 Release 的 IR 图绘制为交互式图,并从图中附加 Features,这两项都向 aggrega serve 守护进程请求。
  • 无头 CLI 流式模式——计划中。 无头模式将 IR 图以换行分隔的 JSON 输出到 stdout,供前端在拓扑变化时使用。目前发布的是每次调用输出一个文档,而非流:没有任何命令会在拓扑变化时在同一个 stdout 上输出一系列图。

有关编辑器、助手和守护进程如何访问编译器,参见 ../architecture/15-editors-assistants-and-frontends.md。

设计方向

上文的状态分类法按功能面对整个语言的状态进行分类;本节记录架构章节中记载的更广泛设计方向的状态。

全局合规并不是计划中的方向:只需声明一次治理规则,即可使其约束工作区中的每一次构建,这一能力目前已通过治理插槽可用。挂接在工作区配置 plugins.governance 键上的插件会评估该工作区中的每一次构建:裁决角色会拒绝违反规则的图或渲染产物,转换角色则提供开发者无需手动输入的派生元数据。参见 ../architecture/11-governance-and-compliance.md。

  • 接口对等与自动实现——可用。 针对基础 Component 编写的 Recipe 可服务于扩展它的每个 Component,无论继承链有多深,架构师都无需编写重复的 Recipe。扩展的 Component 写入 schema: inherited,因此不会向 values / infra / provides 添加基础 Recipe 无法使用的根键;声明了 extends 却带有自身 schema 的 Component 会在其文档信封处被拒绝。Manifest 仍需用单独的条目映射该扩展类型,当被映射 Recipe 的 implements 指向该类型或其扩展的任一基类型时,映射检查即接受它。详见 ../architecture/02-ecosystem-philosophy.md。
  • 幽灵基础设施跟踪器——可用。 一项渲染阶段的防护机制会在作者声明的某个键到达节点、而绑定的 Recipe 所声明的任何模板都不读取它时发出警告,从而让作者声明却被模板静默丢弃的值被明确指出,而不是悄然丢失。它是同一形状匹配设计中属于渲染阶段的那一半。参见 errors/warnings.md。

架构章节描述设计面;本页跟踪实现状态。