SemVer
软件版本号管理规范，采用 MAJOR.MINOR.PATCH 三段式格式，分别对应破坏性变更、向后兼容新增功能和向后兼容问题修复，是现代开源软件版本管理的事实标准
核心事实
时间轴 (近 90 天)
SemVer 只是约定而非强制，当依赖被间接升级时仍可能引入行为差异，因此即使是 patch 更新也建议运行测试。
当 patch 发布的原因不是自身代码修复而是依赖升级时，实际引入的变化可能来自被升级的包，因此应关注 lockfile 而非 changelog 版本号。
SemVer 只约束公开 API，依赖更新可能间接改变运行时行为
纯依赖补丁仍可能间接改变运行时行为，因为真正变化的代码藏在依赖树里而非包本身
在依赖驱动的包中，补丁号常常被用作同步上游的载体，包自身源码未动，仅把内部依赖指针指向更新的版本，此时补丁号对应跟随而非修复
对于使用 0.x 版本依赖的团队，建议锁定具体版本并在测试环境中验证后再升级生产环境，同时关注 release notes 和 commit 历史中标记为 breaking change 的提交。
npm 规定当主版本号为 0 时，caret range（如 ^0.0.93）只会匹配同一补丁号范围，即仅允许 0.0.93，不会自动升级到 0.0.94。
根据语义化版本（SemVer）规范，0.y.z 处于初始开发期，任何版本都可能引入破坏性变更，公共 API 不应被视为稳定。
npm 中 ^0.0.93 只匹配 0.0.93 本身，因为主版本为 0 时 npm 对 caret 有特殊处理
对于使用 0.0.x 版本 SDK 的生产环境团队，建议在升级前检查实际的 diff 内容而非盲目跟随版本号升级
还有 40 条时间轴事件
全部知识事实 (20)
补丁版本通常只包含向后兼容的问题修复，不会引入破坏性变更或新特性
90%已验证语义化版本（SemVer）版本号格式为主版本.次版本.补丁版本，补丁版本递增表示向后兼容的问题修复
90%已验证补丁级别更新通常不引入破坏性变更，一般可以直接升级而无需修改现有代码
90%已验证语义化版本控制（SemVer）将版本号定义为 MAJOR.MINOR.PATCH 三段式结构，PATCH 变更仅包含向后兼容的缺陷修复或依赖更新
90%已验证Patch 版本更新（1.0.104 → 1.0.105）意味着向后兼容的 bug 修复或依赖更新，不引入破坏性变更
90%已验证Vercel AI SDK 采用 monorepo（单一代码仓库）管理模式，核心包与各框架适配包共享同一套 CI/CD 流水线与版本管理工具
90%已验证补丁版本更新理论上不包含破坏性变更（Breaking Changes），升级风险较低
90%已验证补丁版本（Patch Release）通常包含向后兼容的问题修复，不会改变现有 API 的行为
90%已验证补丁版本通常不引入破坏性变更，主要用于修复 Bug、优化性能或同步底层依赖，遵循语义化版本控制（SemVer）规范
90%已验证Vercel AI SDK 采用 Monorepo 单一代码仓库管理模式，核心包 ai 与各框架适配包（如 @ai-sdk/vue、@ai-sdk/react、@ai-sdk/svelte）协同发布
90%已验证语义版本号（SemVer）格式为主版本号.次版本号.修订号：主版本号变更意味着不向后兼容的API变化，次版本号变更表示新增功能但保持向后兼容，修订号变更仅包含Bug修复
90%已验证语义化版本控制格式为MAJOR.MINOR.PATCH，MAJOR在不兼容API变更时递增，MINOR在添加向后兼容新功能时递增，PATCH在向后兼容缺陷修复时递增
90%已验证语义化版本规范（SemVer）的版本号格式为MAJOR.MINOR.PATCH，其中PATCH版本专门用于向后兼容的Bug修复
90%已验证根据语义化版本控制（SemVer）规范，Patch级别的更新意味着向后兼容的问题修复
90%已验证根据语义化版本控制规范，1.0.3作为补丁版本意味着更新不会引入破坏性变更，现有项目可安全升级
85%已验证语义化版本控制（SemVer）规范中，版本格式为 MAJOR.MINOR.PATCH，主版本号递增用于标识对现有公开 API 的不兼容修改
85%已验证从 3.0.44 升级到 3.0.45 是安全且低风险的操作，因为 Patch 版本意味着向后兼容的问题修复
80%已验证在 npm 生态中，^3.0.25 这类范围声明会自动接受补丁与次版本升级，执行 npm update 时会自动获取 3.0.26
80%已验证@cline/llms 仍处于 0.x 早期阶段，API 可能尚未完全稳定，升级时可能出现破坏性变更
80%已验证SemVer 格式为 主版本号.次版本号.补丁号，MAJOR 表示不向后兼容的破坏性修改，MINOR 表示向后兼容的新增功能，PATCH 表示向后兼容的问题修复
80%