Pre-alpha 文档
采用公共 Alpha,不猜测兼容性。
StateKnot 以统一版本发布整套预览包,要求精确固定,并明确规定语义化版本、持久化数据升级与可复现发布门禁。
精确固定同一套版本
Facade、Core、PostgreSQL Store、Runtime、Integrations、Artifact Store 与资格 Testkit 使用统一版本。持久化 Schema、Registry 与恢复语义按整套版本完成验证, 因此不支持混用不同 StateKnot 产品版本。
Cargo.toml
[dependencies]
stateknot = "=0.1.0-alpha.1" 明确哪些内容可能变化
-
预发布版本
不同 Alpha 标识之间可能包含破坏性 API 变更。每个预览版都要求显式精确固定, 并提供经过评审的 Changelog。
-
稳定版本线
不兼容变更按 Cargo 语义化版本规则提升兼容性版本。除非安全性或正确性要求立即 破坏兼容,移除公共 API 前必须先弃用。
-
MSRV
当前最低支持 Rust 版本为
1.88.0,使用 Edition 2024。 后续提升 MSRV 对受支持使用者按不兼容变更处理。 -
持久化数据
PostgreSQL Migration 只向前。带版本的 Schema、Graph/Agent Identity 与 MCP/A2A Profile 保留各自显式版本,遇到不兼容漂移时失败关闭。
从不可变证据发布
Release 必须来自 main 可达的不可变 Tag,通过跨平台、PostgreSQL
16/17、协议、文档、依赖与网站门禁,并从打包后的 Crate Source 重新构建。 发布按依赖顺序执行,随后下载每个
Archive 并逐一比对 SHA-256。请阅读完整规范策略、变更日志与发布运维手册。