SuperAPI AI 工具集

release-versioning

通用与其它

查看项目

更新于 10-16 07:18

技能介绍

用途:定义 xberg 的版本同步与发布流程,确保所有清单与根 Cargo.toml 版本一致,避免手工改动造成漂移。

主要能力:根 Cargo.toml 的 version 是唯一权威版本(含 -rc.N 预发布后缀),其余版本均由它派生。task version:sync(别名 task versions:sync)按顺序执行两步:alef sync-versions 更新 alef 管理的绑定清单(如 packages/python、packages/ruby、crates/xberg-node、packages/go、cli-proxy),目标由 alef.toml 的 [workspace.sync] extra_paths 指定;python3 scripts/sync_integration_versions.py 更新 integrations/ 下的集成包,这些不由 alef 管理。task version:bump:major|minor|patch 与 task version:set -- <version> 会自动串联上述两步,task version:check 则对两者做 dry-run 并在漂移时失败。

集成包与核心版本锁步:integrations/ 下的包随核心一起发布到三个生态——Python(PyPI:langchain、llama-index readers/node-parser、crewai、txtai、surrealdb)、Java(Maven Central:io.xberg:spring-ai-xberg)、npm(@xberg-io/*:n8n-nodes-xberg、langchain-xberg、llamaindex-xberg)。同步脚本为每个清单设置自身版本(pyproject 用 PEP 440 形式,pom 与 package.json 用原生形式)以及 xberg 依赖下限或精确锁定,使集成始终要求与其一同发布的核心版本。

用法:通过 task version:bump:* 或 task version:set 升级,然后把同步后的清单与 Cargo.toml 一起提交以保证原子性;在 CI 中运行 task version:check。新增集成需将其清单加入 scripts/sync_integration_versions.py 的 VERSION_TARGETS,若依赖 xberg 还需加入 XBERG_DEP_MANIFESTS(npm 清单统一收集在 NPM_MANIFESTS,同时供给两个列表);llama-index 开发聚合器为 dep-only,不是版本目标。

限制与禁忌:不要手工编辑包清单版本或集成的 xberg 依赖锁定;不要把集成清单加入 alef.toml 的 [workspace.sync],否则其派生布局会被 alef 覆盖。其他细节(如具体发布步骤、CI 配置)暂未提供。