破坏性变更
了解各项目的 API 契约版本和变更历史，提前做好升级准备。
订阅通知
通过 RSS 订阅 获取最新变更通知，或关注 GitHub Discussions 中的 Announcements 板块。
Orchidea Code
v0.28.5 稳定版配置文件格式从 .coderules 迁移到 .orchidearc.yaml，旧格式不再支持
迁移方式： 运行 orchidea migrate config 自动迁移
移除 --legacy 标志，所有模式统一使用新版执行引擎
MCP Server 配置 API 重构，tool_config 字段改为 tools（数组格式）
迁移方式： 更新 MCP Server 配置文件，详见 /docs/code/migration-v0.20
Orchidea Platform
v2.0.0 稳定版GraphQL API 从 /api/graphql 迁移到 /api/v2/graphql，旧端点已废弃
迁移方式： 更新客户端 API 基础路径
ISA-95 DocType 重命名为 ISA95* 前缀（如 Enterprise → ISA95Enterprise）
迁移方式： 数据库迁移脚本自动执行，无需手动操作
移除 REST API v1，统一使用 GraphQL
Orchidea LLoT
v1.0.0 稳定版OPC UA 连接器配置结构变更，endpoint 字段拆分为 host/port/path
迁移方式： 参照 /docs/llot/migration 更新 Helm values
Sparkplug B 桥接 Topic 命名空间从 spBv1.0/ 变更为 orchidea/v2/
Orchidea Director
v1.0.0 测试版Agent 注册协议从 REST 迁移至 ACP (Agent Client Protocol)，旧注册端点已移除
迁移方式： 将 Agent 适配为 ACP 协议，参考 /docs/director/acp-migration
Orchidea Desktop
v0.1.0 测试版插件 API 从 CommonJS 迁移到 ESM 模块系统
迁移方式： 将插件入口文件改为 .mjs 并使用 export 语法
以下项目暂无破坏性变更记录： Tian-Vision、Orchidea Archive、Orchidea Evolution、Orchidea Voice、Orchidea CAD、Orchidea Intel、Orchidea Plex、Orchidea Sonic、Orchidea Code Desktop、Orchidea DevBase、Orchidea Inference、Orchidea Gateway、Orchidea Watch、Orchidea Guard
如何升级
关注变更通知
订阅我们的 更新日志 或通过 RSS 订阅获得最新变更通知。
查看迁移文档
每个破坏性变更都会附带迁移指南，通常位于对应项目的 /docs/<project>/migration 路径下。
版本锁定
在生产环境中建议锁定主版本号。CLI 工具可使用 npm install @orchidea/code@~0.28.0 避免意外升级。
提前测试
在开发/测试环境中先升级验证，确认所有功能正常后再推送到生产环境。