工装
UAIX 工具支持 UAI 和 UAI-1 的验证、检查、夹具测试、一致性审查、机器可读发现和实施入门。
哪些工具应该有帮助
- 检查消息结构、配置文件声明和兼容性声明。
- 在发布之前验证架构、示例、出处字段、注册表链接和发现路径。
- 在部署之前，表面上隐藏着与已发布语义的分歧。
- 将验证结果导出为可审查的记录，可以进入 CI、发行说明或审核日志。
- 支持跨多个环境采用 UAIX 的团队的入职培训。
主要刀具路径
大多数读者应该从 验证器，然后返回到 示例 或转发到 实施轨道 取决于下一个需要是调试还是部署。
工具输出属于公共记录的位置
- 保留导出的验证器结果和相关内容 实施轨道 跟踪或发布包。
- 使用 变更日志 当工具或一致性姿势变化影响下游迁移工作时。
- 使用 新闻 有关工具更改的公开发布摘要。
- 使用 参考资料与贡献者 当您需要围绕工具驱动的更新提供持久的发现、引用和归因表面时。
当前面向机器的路线
公共工具表面包括面向人的验证器页面以及面向机器的 REST 路线，用于自动化和发布检查。
/wp-json/uaix/v1/catalog和/wp-json/uaix/v1/discovery公开当前的标准目录和发现清单。/wp-json/uaix/v1/status和/wp-json/uaix/v1/modules公开运行时状态和模块库存。/wp-json/uaix/v1/schemas,/wp-json/uaix/v1/registry， 和/wp-json/uaix/v1/examples公开已发布的机器可读记录系列。/wp-json/uaix/v1/validate是 JSONPOST自动化验证端点；使用 验证器 当人们需要工作台体验时的页面。
回归就绪一致性检查
- 使用已发布的 示例 作为可重复验证器运行的基线装置。
- 当架构、注册表映射、验证器行为或实现代码更改时，重新运行基线测试样例和更改的候选消息。
- 将导出的验证器结果和受影响的记录路径一起保存为可重用的一致性数据包，以供发布审核。
- 将这些检查视为公共证据和回归证明，而不是单独的认证计划。
入门示例 一致性路径
- 选择已发布的一项 例子 固定或准备一条与已知公众形象相关的候选人信息。
- 在运行检查之前解析匹配的架构、注册表和规范路由，以便其他审阅者可以重现相同的数据包。
- 运行 验证器 并将结果导出为可审查的记录。
- 将该结果带入 实施轨道，变更日志, 新闻， 和 参考资料与贡献者 当支票支持公开发布或支持声明时。
- 每当架构、注册表映射、验证器行为或运行时映射发生更改时，请重复运行。
发现和站点地图表面
自动化和公共 QA 应该能够从根发现表面和区域设置前缀的路由空间解析相同的页面清单。
- 使用
/.well-known/uaix.json作为首选的机器可读清单。 - 使用
/sitemap.xml和/sitemap.html作为持久的根爬行和目录表面。 - 使用
/en-us/sitemap.xml和/en-us/sitemap.html当本地化读者或工具需要通过英语路线空间进行相同的库存时。 - 即使以区域设置为前缀的站点地图路由也处于活动状态并经过测试，也将根站点地图文件视为规范的公共 SEO 表面。
发现表面
自动化应该从当前的 UAIX 发现清单和标准目录开始。
[uaix_protocol_discovery]