跳转至
MIGRATED

XiStudio 版本更新日志

摘要

本文档是 XiStudio IDE 的完整版本发布历史，按 SemVer（MAJOR.MINOR.PATCH）组织。 每次发版包含：Added / Changed / Deprecated / Removed / Fixed / Security 六类变更，以及 Breaking Change 的迁移指南。 当前活跃分支：v1.x（主力） · 下一大版本 v2.0（规划中）。

1. 版本策略

1.1 SemVer 规则

  • MAJOR：API / 工程文件格式不兼容变更
  • MINOR：向后兼容的新功能
  • PATCH：向后兼容的 Bug 修复 / 性能优化

1.2 发版通道

通道 频率 稳定性 适用
Nightly 每日 低 研发内部
Alpha 按需 中低 Xisound QA
Beta 特性完成 中 种子客户
RC Beta 稳定后 中高 回归测试
GA（正式） 规划节奏 高 对外发布
Hotfix 按需 高 紧急修复

1.3 LTS（长期支持）

  • 每年一个 LTS 版本，LTS 提供 24 个月的安全与关键 Bug 修复
  • 非 LTS 版本提供 6 个月支持

1.4 Deprecation 政策

  • 任何 API / 行为废弃至少提前 12 个月公告
  • 废弃期内提供迁移指南和运行时警告
  • 下一大版本（MAJOR）才真正移除

2. 已发布版本

说明

以下为规划版本路线图，具体发版日期以 CTO 发布的《季度发版计划》为准。

2.1 v1.0.0（规划 · 2026-12）

首发 GA · XiDSP-D1 支持 · Pro 版正式发布

Added

  • 流图编辑器：拖拽 / 连线 / 组 / 子流图
  • XiAlgo 基础套件：信号处理、AEC、NS、DRC、Limiter、EQ、Crossover
  • DSP 编译器：目标 XiDSP-D1，SSA 线性 IR
  • 位精确仿真器：v1.0 单线程 ≥ 10× 实时率
  • 烧录引擎：USB / UART / JTAG 三接口
  • CLI：build / flash / simulate / lint 四大命令
  • Plugin SDK：TypeScript / C# / Python
  • 离线工作流：所有核心能力不依赖云端
  • 跨平台：Windows 10+ / macOS 13+
  • 激活：Community（免费注册）/ Pro（订阅码 + 离线激活）

Known Issues

  • 大项目（>300 节点）画布渲染卡顿 → v1.2 规划 WebGL 重构
  • JTAG 驱动在部分 Windows 11 版本需手动安装 → v1.0.2 打算修复

2.2 v1.0.x Patch 系列（规划 · 按月）

v1.0.1

  • Fixed：Windows JTAG 驱动自动安装
  • Fixed：macOS 15 深色模式下图标偏色
  • Performance：冷启动时间从 7s → 5s

v1.0.2

  • Fixed：Undo/Redo 在参数绑定场景下的偶发错误
  • Fixed：项目保存后偶发的 .xiproj XML 空格不一致（不影响加载）

v1.0.3

  • Fixed：粘贴节点时参数面板未刷新
  • Security：升级 Electron 28 → 28.x（CVE-XXXX 补丁）

2.3 v1.1.0（规划 · 2027-Q2）

Enterprise 版首发 · XiForge 协作集成

Added

  • XiForge 协作面板：实时多人编辑（Enterprise+）
  • 评审与评论：节点级评论，支持 @mention
  • 版本历史：云端保留完整提交记录，支持回滚
  • License Server：企业私有化部署
  • REST API v1：完整项目/构建/任务接口（Enterprise+）

Changed

  • UI 配色：品牌色彩系统 v1.1 落地（主色玫瑰金 #D4A574）
  • 编辑器性能：画布局部重绘，300 节点级别流畅度显著提升

Deprecated

  • 旧版 Community 在线遥测开关位置迁移（新位置：偏好 → 隐私）

2.4 v1.2.0（规划 · 2027-Q4）

XiMind AI 辅助 · XiDSP-D2 支持

Added

  • XiMind 桥接：自然语言建议算法链 / 自动调参
  • XiDSP-D2 Codegen 后端：编译器新增 D2 目标
  • 仿真器并行化：v1.0 的 10× → v1.2 的 50× 实时率
  • OTA 烧录：通过网络向 XiDSP 下发新固件

Changed

  • Plugin SDK：新增 hardware.usb 权限声明

Migration（v1.1 → v1.2）

  • AI 辅助默认关闭，启用需 偏好 → XiMind → 启用
  • 旧版 .xiplugin 无需修改即可运行

2.5 v1.3.0（规划 · 2028-Q2）

XiDSP-D3 + 并行仿真 + GPU 加速

Added

  • XiDSP-D3 Codegen 后端
  • GPU 仿真加速（OpenCL / Metal）
  • 大项目渲染：Canvas2D → WebGL 切换完成
  • Linux 预览版：Ubuntu 24.04 x64

2.6 v1.4.0（规划 · 2028-Q4）

第三方 DSP 后端 + XiDSP-A1 车规

Added

  • ADI SHARC 后端（Beta）
  • TI C6000 后端（Beta）
  • XiDSP-A1 车规 Codegen（AEC-Q100 就绪）

Changed

  • 编译器 IR 升级：线性 IR → SSA + Region-based

3. 规划中的大版本（v2.0 预告）

v2.0 为重大版本，含 Breaking Change

v2.0 计划于 2029+ 发布，以下预告仅供参考，最终 Scope 以发版前 Beta 公告为准。

3.1 v2.0 预告要点

  • 编辑器重写：100% 原生 WebGL 渲染，千节点级流畅
  • 工程文件格式 v2：.xiproj v2 / .xiflow v2，向后兼容读取但不兼容写入
  • Plugin SDK 2.0：API 大幅重整，SDK v1 插件需重新编译
  • Linux GA：Ubuntu / RHEL 正式支持
  • 云端 IDE 预览：WebAssembly 版 XiStudio Lite

3.2 Migration Path（v1.x → v2.0）

  • 提供 xistudio migrate 一键升级工具
  • v1.x 工程可无损打开 v2.0；但保存后不能再用 v1.x 打开
  • SDK v1 插件进入 12 个月 Deprecation 窗口，之后移除

4. Hotfix 历史

Hotfix 用于线上 Critical Bug 的紧急修复。

版本 修复 影响版本
v1.0.0-hotfix.1 烧录签名校验偶发失败 v1.0.0
v1.1.0-hotfix.1 XiForge 协作心跳丢失 v1.1.0

5. Security Advisories（安全公告）

日期 ID 影响 状态
— — — 暂无

订阅

安全公告请订阅 security@xisound.com；Pro+ 客户可在后台设置邮件通知。

6. Breaking Change 速查表

历次 Breaking Change 集中列出，方便长期用户评估升级成本。

版本 Breaking 点 迁移指南
v1.2.0 Plugin 权限增加 hardware.usb 如 v1.1 插件需要 USB 访问，Manifest 中补填
v2.0.0 工程文件格式 v2 用 xistudio migrate 工具一键升级
v2.0.0 Plugin SDK 2.0 SDK v1 插件需按 v2 SDK 重编译
v2.0.0 License Server API 变更 Enterprise 客户需升级 License Server 至 v2

7. 如何反馈问题

7.1 Bug 报告

7.2 功能建议

7.3 CVE / 安全问题

  • 私下报告到 security@xisound.com
  • 不要在公开 Issue 中披露未公开的安全漏洞
  • 符合 协调式披露（CVD）原则：修复发布后 90 天内再公开

8. 附录

8.1 关联文档

8.2 版本号与 Git Tag 对应

SemVer Git Tag 构建产物命名
v1.0.0 v1.0.0 XiStudio-1.0.0-win-x64.exe 等
v1.0.0-beta.1 v1.0.0-beta.1 XiStudio-1.0.0-beta.1-...
v1.0.0-hotfix.1 v1.0.0-hotfix.1 XiStudio-1.0.0-hotfix.1-...

8.3 版本历史（本文档本身）

版本 日期 要点
v1.0 2026-05-05 首版 · 规划 v1.0 - v1.4 + v2.0 预告 + Hotfix/Security 模板
v1.1 2026-05-19 新增 §9「IDE 架构文档迭代记录」专列 v1.2.0–v1.2.3-impl 演进

9. IDE 架构文档迭代记录（layout-demo 实现层）

本节与 §2 GA 版本路线的区别

§2 描述的是 XiStudio 产品对外发布的 SemVer 路线（v1.0.0 GA / v1.1.0 / v1.2.0 ... 计划 2026-12 起逐步发版）。

本节则是 docs/02-products/P1-xistudio/v1.2-ide-architecture.md 这一篇架构设计文档自身的迭代历史，反映 layout-demo（vanilla HTML/CSS/JS 骨架）的演进。两条线不合并——产品 GA 版本号 ≠ 架构文档实现版本号；架构文档为 GA 提供"实现规约"参考。

9.1 文档版本表

文档版本 日期 主要变化 layout-demo commit
v1.2.0 2026-05-17 首版 · §0–§11 锁定四件套架构（XiLink/XiForge/XiTune/XiTest）+ 双 Dock 19 面板 + License 三元体系 + 4 决策点 —
v1.2.1 2026-05-17 顶栏 4 行 142px（StageTabs 44 + ToolBar 38 + SubTabs 32） —
v1.2.2 2026-05-17 A 选项落地 · 顶栏压缩 4→3 行（StageBar 44px Pill+ToolBar 合并）· 节省 38px —
v1.2.2-impl 2026-05-17 追加 §12 实现成果沉淀 · 11 commit · 5 ADR · 9 类 postMessage 协议 · VSCode 式窗口管理 28e7ac3 … 808531d
v1.2.3-impl 2026-05-19 追加 §13 顶栏五段动态注入架构 · v4.0 → v4.3 共 4 次迭代沉淀 0e5d450（v4.3）

9.2 v1.2.3-impl（2026-05-19）核心变化

Added · §13 顶栏五段动态注入架构

  • §13.1 五段架构：Stage Pills | mode-switcher | stageToolbar | Shell 通用按钮组 行 1 + sub-tabs-bar 行 2（仅 XL/XT）
  • §13.2 五段职责矩阵：明确各段 DOM 槽位 / 决定者 / 动态性 / 协议
  • §13.3 各 Stage × Mode × stageToolbar 配置矩阵：XL 5 按钮 / XF 3 chips + 双模式动态注入 / XT 3 按钮 + 4 chips / XS 保持现状
  • §13.4 mode-switcher-inject 协议：完整数据契约（chips 数组 + activeKey + 反向 mode-switch-click）
  • §13.5 toolbar-inject 协议增强：新增 toggle:true 字段支持引擎按钮
  • §13.6 全局引擎单例机制：_engineRunning 单例 + _syncEngineButtonsToActiveStage() 跨 stage 状态续接（XL/XT 共享 ▶/■）
  • §13.7 Drawer 双 dock 边界：明确"内容 stage 注入 · 操作 Shell 接管"的责任划分
  • §13.8 与 §12 衔接：commit 索引 0e5d450
  • §13.9 v4.0 → v4.3 演进史：4 次迭代核心变化与决策动因
  • §13.10 v1.2.4 / v1.3 TODO：license 接入 / mode-switcher add-on 联动 / engine-state-changed 广播 等

Changed · 元信息

  • frontmatter version：v1.2.2-impl → v1.2.3-impl
  • frontmatter last_review：2026-05-17 → 2026-05-19
  • frontmatter description：追加"顶栏五段动态注入 / v4.3 stageToolbar 动态注入机制"
  • frontmatter tags：新增 mode-switcher / stage-toolbar
  • §11 一句话总览：末尾追加 v1.2.3-impl 增补摘要（指向 §13）

Implementation · layout-demo 0e5d450 commit 内容

  • Shell index.html：toggleLock 仅切图标（🔒↔🔓）· stageToolbar 单行恢复 · toolbar-inject 支持 toggle:true · 全局单例 _engineRunning（之前已落地，§13 仅做沉淀）
  • stage-xilink.html：5 按钮（保存 / 新建 / 链路更新 / 节点对齐 / 引擎 toggle）
  • stage-xitune.html：3 按钮（保存 / 新建 / 引擎 toggle）+ mode-switcher 4 chips（link 手动 / link 自动 / 兼容 / 反向）+ mode-switch-click 反向 handler
  • stage-xiforge.html：mode-switcher 3 chips（工具布局 / 源码设计 / 仿真验证）+ 动态 stageToolbar 注入（layout/code 4 按钮 · simulation 0 按钮 · 切 mode 时通过 injectToolbarFor(key) 重发 toolbar-inject）+ 新增 simulation pane DOM
  • stage-xitest.html：保持现状（用户在 v4.3 评审时明确决定）

Migration · v1.2.2-impl → v1.2.3-impl

  • 架构文档读者：原 §2.2 StageBar"Pill 左 + ToolBar 右"是架构基线保持不变；§13 是演进沉淀，描述 layout-demo 的最终实际实现
  • Stage 开发者（添加新 stage 时）：可参考 §13.4–§13.6 协议样板 · 注入 mode-switcher / stageToolbar / engine 按钮
  • Vue 3 改造（D4 前端实现手册）：useStageBridge() composable 需新增 mode-switcher-inject / mode-switch-click / toolbar-inject{toggle} / engine-control 类型定义

9.3 v4.0 → v4.3 layout-demo 内部迭代（细分 commit · 沉淀于 §13.9）

迭代 触发动因 主要工作 落地 commit
v4.0 REFACTOR-v4-PLAN.md 评审通过 提出顶栏三段式 + audio-engine 全局组 + 3 协议（mode-switcher-inject / doc-tabs-inject / engine-state-changed） （PLAN 阶段）
v4.1 视觉紧凑化 + 避免双重控制源 mode-chip 改 emoji + 删 chip-tag · 删除 audio-engine 全局组 · 新增 XiMind 顶栏按钮 （已合入累积）
v4.2 Shell 通用按钮组样式统一 .topbar-ico-btn 4 图标按钮（🤖/🪟/🔒/🎨）· 删除 .float-mgr/.lock-toggle/.lic-tag 旧式样式 （已合入累积）
v4.3 "只有一个引擎，不能启动两个"决策（Q6=b） toggleLock 仅切图标 · stageToolbar 单行恢复 · toolbar-inject toggle:true · 全局单例 _engineRunning · 4 stage 改造（XL/XF/XT 接入，XS 保持） 0e5d450

changelog.md · D2-P1-TECH-003 · v1.1 · 2026-05-19 · Xisound 研发中心 · 平台软件团队 · 新增 §9 架构文档迭代记录