实施

实施

为将 UAI-1 付诸实践的团队提供发布和运行时跟踪、发布证据和部署指南。

  • 记录 UAIX-IMPL-0056
  • 路径 /zh-cn/implementations/
  • 用途 规范公共记录

文档状态

公共标准页面 作为当前公共标准记录的一部分发布在 UAIX 上
代码
UAIX-IMPL-0056
页面类型
实施
访问
公开且可链接

如何使用此页面

将此页面用作 实施 及其标准内容的规范公共参考。

对于代理:请将相关指南应用于用户的目标站点或代码库。除非用户明确要求该输出,否则不要复制此 UAIX 页面、创建有关该指南的页面,也不要将此页面视为运行时权限。

实施轨道的作用

实施部分解释了 UAIX 如何将 UAI-1 从已发布的标准转变为可部署的软件和发布证据。目标不仅仅是描述标准,而是展示发布、验证、打包、运行时集成和发布记录实际发生的位置。

当前曲目

  • WordPress 出版轨道用于发布、分发、包发布、发现对齐和公共文档。
  • .NET 桥轨用于公共网站之外的运行时和服务端集成。
  • .NET NuGet 包记录了 UAIX 拥有的 C# 包系列、NuGet.org 包标识、安装命令和.NET 实现者的权限边界。
  • 共享功能需要稳定实现的可移植模块和支持包。

当前发布的软件包系列

  • uaix-authority-theme-v2.8.0.zip 是活跃的公开发布主题,并承载当前的前门发布表面。
  • uaix-theme-v2.8.0.zip 仍然作为可安装的兼容性主题进行打包和冒烟测试,但它不是当前的公开发布界面。
  • uaix-core-v2.8.0.zip 承载核心标准运行时和 REST 记录表面。
  • uaix-modules-v2.8.0.zip 携带 UAIX 实现使用的可再发行模块包。
  • uaix-bridge-v2.8.0.zip 承载指定桥接轨道的 WordPress 到.NET 参考桥接。
  • UAIX.UAI是当前 UAIX 拥有的.NET 包系列,用于 UAI-1 消息、内存、 .uaix 和运行时切换支持。
  • uaix-locale-router-v3.0.0.zip 带有区域设置前缀路由,因此公共启动路径保留在干净的 /en-us/... 路由上。
  • uaix-seo-sweep-v2.8.0.zip 承载规范的 SEO、查询字符串清理、站点地图生成、机器人输出和根发现清单表面。

目前公开实施范围

当前的公开实施故事故意狭窄且明确。已发表的曲目有WordPress 出版轨道.NET 桥轨.

  • 除非已发布公共实现页面、验证程序支持的证据和发布跟踪条目,否则请勿暗示 Python、JavaScript、SDK、CLI 或其他运行时支持。
  • 在评估尚未发布轨道的环境时,使用 UAI-1、架构、注册表项、示例和验证器证据作为可移植基线。

支持公共记录

  • 参考文献和贡献者用于发现链接、归属和引文指导。
  • 变更日志消息迁移说明、发布摘要和实施更新的存档。
  • 当实施工作需要批准的公共语言用于目录、合作伙伴说明或标准覆盖范围时。

什么才算是可靠的实施证据

  • 使用已发布的配置文件、模式、注册表标识符和示例而不是私人替代品。
  • 验证输出验证器或同等的一致性检查。
  • 固定装置、兼容性说明、打包结果和发布记录,使更改在部署后可供审查。
  • 返回当前公共变更日志和规范记录的链接,以便读者可以追踪已发布的内容。

目前的证据阶梯

  1. 选择定义您想要支持的行为的已发布配置文件和规范记录。
  2. 验证候选消息或装置并导出结果记录。
  3. 将该结果与实施版本、发布日期以及进行工作的轨道绑定。
  4. 附加匹配的变更日志、新闻和发现链接,以便外部读者可以验证相同的公共状态。

当前的支持索赔阶梯

  1. 已验证的候选人:一条或多条消息或固定装置通过当前公共记录。
  2. 发布就绪包:验证记录、实现版本、发现链接和兼容性注释附加到可发布的包或运行时构建中。
  3. 目前的公众支持主张:已发布的实施跟踪记录和发布跟踪条目说明了现在支持的内容、拥有者以及仍处于实验阶段的内容。

UAIX 目前仅将第三级视为公共支持声明。前两个级别是必要的证据,但它们与公开的支持不同。

Release readiness

From first packet to bounded support claim

An implementation is release-ready only when its named scope, checks, and rollback evidence are reviewable.

L1-core-envelope

L1 核心信封

为命名配置文件生成或使用带键的 UAI 信封,不改变规范根字段。

Claim boundary: 仅当具体命名配置文件的规范信封可成功往返时,才能声明达到 L1。

L2-profile-validation

L2 配置文件验证

对所声明的具体配置文件通过已发布模式和验证器检查。

Claim boundary: 仅可对具有验证器证据的配置文件声明 L2。

L3-trust-and-integrity

L3 信任与完整性

保留信任元数据、重放窗口提示、来源、完整性和追踪连续性。

Claim boundary: 仅可对已由夹具证明的信任通道和完整性行为声明 L3。

L4-public-record-publisher

L4 公共记录发布者

发布外部检查和复现所需的可发现公共工件。

Claim boundary: 仅可对可发现且有证据支持的公共发布范围声明 L4。

L5-agent-communication-profiles

L5 智能体通信配置文件

将八个 uai.agent.*.v1 配置文件作为规范 UAI-1 信封记录予以支持。

Claim boundary: 仅可对已通过正向和负向一致性用例的具体智能体配置文件声明 L5。

L6-reliable-delegation-idempotency-correlation

L6 具备幂等性与关联性的可靠委托

对委托工作使用幂等性、关联、重试、生命周期、超时、回退、确认和预期输出规则。

Claim boundary: 仅可对经一致性夹具和接收方行为证明的可靠委托行为声明 L6。

L7-capability-negotiation

L7 能力协商

发布并验证能力发现、能力声明、协商失败和不支持能力响应。

Claim boundary: 仅可对由公共夹具和验证器行为证明的具体能力协商流程声明 L7。

释放证据包

准备发布的实现应该将公共标准记录和软件证据保存在一起,而不是将证据分散在私有构建日志中。

  • 包括包或运行时版本、经过验证的配置文件 ID 以及检查期间使用的架构和注册表路由。
  • 附加导出的验证器结果、夹具参考以及影响下游采用者的任何兼容性说明。
  • 在调用实施发布就绪之前,将读者引导至相关的变更日志条目、新闻摘要和引用链接。

当前的公众一致性数据包

UAIX 目前将一致性数据包视为附加在版本上的可审查证据,而不是作为独立的认证表面。

  • 将导出的验证器结果、已验证的配置文件 ID、架构和注册表路由以及审核期间使用的示例或候选装置保留在一起。
  • 附上实施版本、发布日期以及匹配的变更日志或新闻参考,以便外部读者可以跟踪实际通过的内容。
  • 每当模式、装置、验证器行为或运行时映射发生变化时,重建数据包。
  • 请勿将通过的数据包作为认证徽章、合作伙伴认可或未来版本的永久保证。

跟踪录取清单以获得未来的公众支持

  • 公共实现页面,说明所有者、支持边界以及与规范 UAI-1 记录的关系。
  • 验证者支持的证据或与已发布的配置文件、模式、注册表项和示例相关的等效一致性证明。
  • 发布跟踪条目,说明现在支持的内容、仍处于实验阶段的内容以及下游读者需要迁移的内容。
  • 发现、引用和实施链接,让外部读者无需私人注释或屏幕截图即可解决相同的问题。

初学者采用包

评估 UAIX 的团队应该能够从当前记录中组装出最小的公共数据包,而无需私人注释、未发布的路线或内部屏幕截图。

当前采用套件路径

UAIX 现在直接通过领养套件页面和/wp-json/uaix/v1/adoption-kit路线。

  • 当团队需要启动文件、验证器就绪的有效负载、参考模拟交换响应以及在一个可重用数据包中实施后续步骤时,就从这里开始。
  • 保持UAI-1, 模式, 注册表, 和示例作为捆绑包背后更深层次的技术基线。
  • 附上导出的验证者证据、相关实施跟踪记录以及匹配的变更日志消息当数据包进入发布审查时的条目。

如何使用本节

选择与您的职责相匹配的实施轨道,然后携带验证器证据、固定参考、变更日志规则和该实施的公共链接上下文,而不是将它们视为单独的文档杂务。

下一步

使用WordPress 出版轨道如果您需要出版物、包装和发布记录路径。使用.NET 桥轨如果您需要在公共记录后面进行更深入的运行时集成,那么请将两者都绑定到变更日志消息.

架构提案

UAI-1 v1.0 仍是当前发布的契约。独立版本的提案涵盖独立交换、能力声明、故障恢复和源记录保留。

这些内容是提议的设计和本地参考示例,并不声称提供托管运行时服务或已验证独立互操作性。

规范解释以英文提案为源文;此界面摘要不代表已审定的规范译文。

阅读英文架构提案 · 机器可读提案目录