XiForge · Changelog
XiForge 版本更新日志 v1.0
双组件 SemVer · .xyui Schema · AI 路径 · 预告
每一次发布都有轨迹 · 每一次 Schema 变更都保兼容
v1.0
当前 GA
SemVer
版本规则
5 年
Schema 兼容
XiForge 版本更新日志 v1.0
摘要
本文档维护 XiForge 开发者平台的完整版本历史：CodeGen 子系统 SemVer、UIEditor 子系统 SemVer、平台主版本、.xyui 文件格式演进、AI 启用路径、已知问题 / 迁移指南 / 预告。 目标读者：Tier1 / OEM 工具工程师、IDM 客户研发、Xisound 内部团队。每次新版本发布，本文同步更新。
双组件版本管理
XiForge 版本管理采用双组件 + 平台主版本三轨制： - CodeGen SemVer：独立演进（v1.0.0 / v1.1.0 ...） - UIEditor SemVer：独立演进（v1.0.0 / v1.1.0 ...） - 平台主版本：组合发布（XiForge v1.0 = CodeGen v1.0 + UIEditor v1.0） 发布时注明推荐组合。
1. 版本策略
1.1 组件 SemVer 规则
MAJOR.MINOR.PATCH 例：v1.2.3
│ │ │
│ │ └── PATCH：Bug 修复 · 完全兼容
│ └──────── MINOR：新增功能 · 完全兼容
└────────────── MAJOR：破坏性变更 · 可能不兼容
- 每个子系统独立 SemVer
.xyuiSchema 强制兼容 5 年- REST API URL 前缀
/api/v1/在 v1.x 保持兼容
1.2 平台主版本规则
| 平台版本 | 组件组合 | 说明 |
|---|---|---|
| v1.0 | CodeGen v1.0.x + UIEditor v1.0.x | 2027 Q2 GA |
| v1.1 | CodeGen v1.1.x + UIEditor v1.1.x | AI 辅助启用 |
| v1.5 | CodeGen v1.5.x + UIEditor v1.5.x | Linux 支持 |
| v2.0 | CodeGen v2.0.x + UIEditor v2.0.x | 协作实时编辑（破坏性） |
1.3 发布渠道
| 渠道 | 含义 | 适用 |
|---|---|---|
stable |
正式发布 · 签名完整 | 生产 |
beta |
预发布 · Enterprise 客户试用 | Alpha 验证 |
dev |
开发快照 | 内部 |
2. 平台版本历史
2.1 XiForge 主版本
| 版本 | 日期 | 组件 | 状态 | 重点 |
|---|---|---|---|---|
| v0.1 Alpha | 2026-Q4 | CodeGen 0.1 + UIEditor 0.1 | 目标 | 内部 Alpha · 功能完整但不稳定 |
| v0.5 Beta | 2027-Q1 | CodeGen 0.5 + UIEditor 0.5 | 目标 | Enterprise 首批客户试用 |
| v1.0 GA | 2027-Q2 | CodeGen 1.0 + UIEditor 1.0 | 目标 | 首个 GA · 随 XiStudio Enterprise 捆绑 |
| v1.1 | 2027-Q4 | CodeGen 1.1 + UIEditor 1.1 | 目标 | AI 辅助启用（XiMind 集成） |
| v1.5 | 2028-Q2 | CodeGen 1.5 + UIEditor 1.5 | 目标 | Linux 支持 + 自定义 Vue 组件 |
| v2.0 | 2028-Q4 | CodeGen 2.0 + UIEditor 2.0 | 目标 | 协作实时编辑 · 破坏性 |
3. CodeGen 子系统历史
3.1 CodeGen v1.0.x
| 版本 | 日期 | 主要变更 |
|---|---|---|
| v0.1 | 2026-Q4 | 首版 · 10+ 模板 · Tree-sitter 校验 |
| v0.5 | 2027-Q1 | + 10 个官方模板（NR / Spatial 补齐） |
| v1.0 | 2027-Q2 | 首个 GA · 20+ 模板 · 跨 DSP 移植 |
| v1.0.1 - v1.0.x | 季度 | Bug 修复 · 模板更新 |
| v1.1.0 | 2027-Q4 目标 | + XiMind AI 辅助（use_ai: true） |
3.2 CodeGen v1.5 目标（2028-Q2）
- 自定义 Handlebars Helper 注册机制
- 客户自有 Tree-sitter 规则库
- VS Code Extension 版本（独立于 Electron）
3.3 CodeGen v2.0 目标（2028-Q4 · 破坏性）
- 重构 REST API 为 gRPC-Web
- 模板 Schema v2.0（向后兼容 5 年）
- 完整类型系统（TypeScript-first）
4. UIEditor 子系统历史
4.1 UIEditor v1.0.x
| 版本 | 日期 | 主要变更 |
|---|---|---|
| v0.1 | 2026-Q4 | 首版 · 10+ 基础控件 · Fabric.js 画布 |
| v0.5 | 2027-Q1 | + 声学专用控件（Spectrum / EQ Curve / VU Meter） |
| v1.0 | 2027-Q2 | 首个 GA · 20+ 控件 · 主题系统 · 导出 Electron |
| v1.0.1 - v1.0.x | 季度 | Bug 修复 · 控件库扩展 |
| v1.1.0 | 2027-Q4 目标 | 优化画布渲染性能 |
4.2 UIEditor v1.5 目标（2028-Q2）
- 自定义 Vue 组件注册
- 多设备预览（桌面 / 车机 / 移动）
- 动效系统（基础 CSS 动画）
4.3 UIEditor v2.0 目标（2028-Q4 · 破坏性）
- 实时协作编辑（类 Figma · 基于 CRDT）
- 组件库 Marketplace
- 3D 控件（AR / VR 车载调音预研）
5. .xyui 文件格式演进
5.1 Schema 兼容承诺
5 年兼容承诺
.xyui 文件格式在 schema_version v1.x 系列内保证 5 年前向 + 向后兼容。
- 高版本读低版本：✅ 支持（补默认值）
- 低版本读高版本：⚠️ 优雅降级 + 提示升级
- 破坏性变更：升到 schema_version v2.0 · 提供自动迁移工具
5.2 Schema 变更历史
| Schema Version | 日期 | 变更 |
|---|---|---|
| v1.0 | 2027-Q2 | 首版 · 基础 widget / theme / binding |
| v1.1 | 2027-Q4 | + animation / multi-device |
| v1.5 | 2028-Q2 | + custom-component / marketplace-ref |
| v2.0 | 2028-Q4 目标 | 协作元数据 · 破坏性 |
5.3 自动迁移工具
xy-forge migrate-xyui \
--from-schema v1.0 \
--to-schema v1.5 \
--input old.xyui \
--output new.xyui
6. AI 启用路径（XiMind 集成）
6.1 AI 发布节奏
graph LR
V10[v1.0 GA · 2027-Q2<br/>AI 不启用]
V11[v1.1 · 2027-Q4<br/>AI 辅助生成 Alpha]
V11P[v1.1.x · 2028-Q1<br/>AI Beta · Enterprise 开放]
V15[v1.5 · 2028-Q2<br/>AI GA · Pro+ 可加购]
V10 --> V11 --> V11P --> V15
class V10 xyL2
class V11,V11P xyWarn
class V15 xySuccess6.2 AI 启用前提
- XiMind 订阅 Token 已绑定
- Enterprise / IDM Tier 客户默认可用
- Pro 客户可加购 XiForge Pro+ Add-on 获得 AI 辅助
6.3 AI 护栏
- 置信度 < 0.7 强制人工 Review
- Prompt 注入检测
- Token 配额控制 · 超限软降级
7. Errata（已知问题）
7.1 分级
| 级别 | 含义 |
|---|---|
| P0 | 致命 · 立即热修 |
| P1 | 严重 · 下版本必修 |
| P2 | 一般 · 文档注明 |
| P3 | 轻微 · 记录 |
7.2 当前 Errata（v1.0 Beta 预期）
Beta 阶段填充
Beta 发布后发现的 Errata 将在此处列出。
| Errata ID | 严重度 | 描述 | Workaround | 修复版本 |
|---|---|---|---|---|
| ERR-FG-001 | P2 | [Beta 后填] | [手动 workaround] | v1.0.1 |
| ERR-FG-002 | P3 | [Beta 后填] | [文档提示] | v1.0.2 |
7.3 GA v1.0 目标：零 P0/P1
GA Clean 目标
v1.0 GA 发布时目标无 P0/P1 级 Errata；只允许 P2/P3 级文档化限制。
8. 迁移指南
8.1 Patch 升级（v1.0.0 → v1.0.x）
100% 兼容 · 升级即可： 1. XiStudio 自动通知有更新 2. 点击升级 · 自动重启 3. 无需代码调整
8.2 Minor 升级（v1.0 → v1.1）
100% 向后兼容：
- 新增 AI 辅助 · 客户可选是否启用
- 原有项目 / .xyui 文件完全兼容
8.3 Major 升级（v1.x → v2.x）
可能包含破坏性变更：
- .xyui schema 升级需自动迁移工具
- REST API URL 变更（v1 → v2 · 旧版保留 12 个月）
- 过渡期 Xisound 提供 FAE 现场支持
- 参考Migration Guide v2.0（届时发布）
9. 下一版本预告
9.1 XiForge v1.1（2027 Q4）
- XiMind AI 辅助生成（Alpha）
- CodeGen 模板扩展 · 新增 10+ 模板
- UIEditor 性能优化（100+ 控件 60 FPS 保持）
- 私有仓库 Webhook（钉钉 / 企业微信）
9.2 XiForge v1.5（2028 Q2）
- Linux 桌面支持
- 自定义 Vue 组件
- 多设备 UI 预览
- 自动迁移工具 v1.0 → v1.5
9.3 XiForge v2.0（2028 Q4）
- 协作实时编辑（Figma 式）
- 组件库 Marketplace
- 云端 SaaS 版本（WebAssembly）预研
- 完整 TypeScript-first API
10. 附录
10.1 关联文档
10.2 外部标准参考
- Semantic Versioning 2.0.0（SemVer.org）
- JSON Schema Draft-07
- OpenAPI 3.1
10.3 版本历史
| 版本 | 日期 | 要点 |
|---|---|---|
| v1.0 | 2026-05-05 | 首版 · 双组件 SemVer + .xyui Schema + AI 路径 + 迁移指南 |
changelog.md · D2-P9-TECH-003 · v1.0 · 2026-05-05 · Xisound 研发中心 · 工具软件团队