XiAlgo · Changelog
XiAlgo 版本更新日志 v1.0
ABI 双轨 · 六套件 SemVer · 迁移指南 · 预告
每一个版本都有轨迹 · 每一次破坏性变更都有指南
v1.0
当前 ABI
6
独立套件
SemVer
版本规则
XiAlgo 版本更新日志 v1.0
摘要
本文档维护 XiAlgo 算法库的完整版本历史：ABI 版本（v1.0 / v2.0 ...）、六套件 SemVer 历史、破坏性变更迁移指南、下一版本预告。 目标读者：算法工程师、XiStudio 后端工程师、Tier1 集成工程师、客户运维团队。每次新版本发布，本文同步更新。
双轨制版本管理
XiAlgo 版本管理采用双轨制： - ABI 版本：决定二进制兼容性（v1.0 / v2.0 ...，破坏性变更才升） - 套件 SemVer：每个套件独立版本（FX v1.2.3 / NR v1.0.5 ...） 套件 SemVer 随月度 / 季度发布迭代，ABI 版本稳定不变（除非必要）。
1. 版本策略
1.1 ABI 版本规则
| ABI | 变更类型 | 频率 | 说明 |
|---|---|---|---|
| v1.0 → v1.1 | 不会（SemVer 规则） | — | ABI 版本号只在 Major 时升 |
| v1.0 → v2.0 | Major（破坏性） | 2-3 年一次 | 接口删除 / 语义变化 / 必要重构 |
1.2 套件 SemVer 规则
XiAlgo-FX v1.2.3
│ │ │
│ │ └── PATCH: Bug 修复 / 性能调优（向后兼容）
│ └──── MINOR: 新算法块 / 新参数（向后兼容）
└────── MAJOR: ABI 变更 / 删除算法块（不兼容）
- 每个套件独立 SemVer
- 同一 ABI 内的 Major 升级非常罕见（仅算法包内的 API 重构）
- 新算法块总是 Minor 版本引入
1.3 发布渠道
| 渠道 | 含义 | 适用 |
|---|---|---|
stable |
正式发布，签名完整 | 生产 |
beta |
预发布，签名完整，用于客户 Alpha 试用 | Tier1 合作客户 |
dev |
开发快照，未签名，仅内部 | Xisound 工程师 |
2. 套件版本历史
2.1 XiAlgo-FX 历史
| 版本 | 日期 | 变更要点 | 兼容 ABI | 支持 XiDSP |
|---|---|---|---|---|
| v1.0.0-alpha | 2026-Q4 | 首版 · 基础 PEQ_5/10/31 · DRC_multi · Limiter · Delay | v1.0 | D1 A0 |
| v1.0.0-beta | 2027-Q1 | 新增 Crossover_⅔way · Reverb · GEQ_31 | v1.0 | D1 A1 |
| v1.0.0 | 2027-Q3 | 首个 GA | v1.0 | D1 B0 |
| v1.0.1 - v1.0.x | 季度 Patch | Bug 修复 · MIPS 微调 | v1.0 | D1 B0+ |
| v1.1.0 | 2027-Q4 目标 | 新增 Delay_per_ch + Spatial_Stereo | v1.0 | D1 B0+ / D2 A0 |
| v1.2.0 | 2028-Q2 目标 | FP32 可选路径（D2+） | v1.0 | D1 / D2 |
2.2 XiAlgo-NR 历史
| 版本 | 日期 | 变更要点 | 兼容 ABI | 支持 XiDSP |
|---|---|---|---|---|
| v1.0.0-beta | 2027-Q1 | 首版 · WindNoise · RoadNoise_NLMS · AEC | v1.0 | D1 A1 |
| v1.0.0 | 2027-Q3 | 首个 GA · 加入 CallNR | v1.0 | D1 B0 |
| v1.1.0 | 2028-Q1 目标 | 新增 TrafficNoise + MotorNoise | v1.0 | D1 / D2 |
| v1.2.0 | 2028-Q3 目标 | ASIL-B 合规 "Safety-Ready" 文档集 | v1.0 | D1-Q / A1 预研 |
2.3 XiAlgo-AI 历史（D2+）
| 版本 | 日期 | 变更要点 | 兼容 ABI | 支持 XiDSP |
|---|---|---|---|---|
| v0.1 | 2027-Q3 目标 | 预研 · AI_Enhance 原型（需 D2 Beta 芯片） | v1.0 | D2 Alpha |
| v1.0.0 | 2028-Q2 目标 | 首个 GA · AI_Enhance + AI_NR + SceneDetect | v1.0 | D2 B0 |
| v1.1.0 | 2028-Q4 目标 | 新增 SourceSep（D3+） | v2.0 | D3 |
2.4 XiAlgo-KTV / Zone / 3D 历史
| 套件 | v1.0 目标 | 说明 |
|---|---|---|
| KTV | 2027-Q4 | KeyShift + Harmony + EchoCancel + Chorus + Reverb |
| Zone | 2027-Q4 | ZoneSplit_2/4 + Crosstalk + PerZoneEQ |
| 3D | 2028-Q4（D3 上市后） | HRTF + AmbisonicsDecode + Virtualizer |
3. ABI 变更历史
3.1 ABI v1.0 定稿内容（2026-Q4）
- 四个生命周期函数：init / process / update_param / destroy
- XiParam 数据模型（5 种类型）
.xipkg包结构 + RSA-2048 签名- XiCore Memory Pool（4 种固定大小）
.xo二进制格式
3.2 ABI v2.0 规划（2028-Q2 预计）
v2.0 将包含以下破坏性变更：
| 变更 | 原因 |
|---|---|
移除 process() 的 frames 参数 |
改为 init 固定，减少运行时开销 |
| 参数更新事务化（原子 / 回滚） | v1.0 仅"尽力而为"，v2.0 事务 ID |
| 内存池动态重分布 | v1.0 启动时固定，v2.0 可运行时调整 |
| 新增 Health Monitor 回调 | 车规功能安全必需 |
| 强制 FP32 选项 | 跟随 D2+ 硬件 |
3.3 ABI 升级指南（v1.0 → v2.0）
迁移工作量
预计客户算法包迁移：每套件 5-15 工程日 - 重新编译算法源码（API 签名变化） - 适配新的内存池 API - 增加 Health Monitor hook - Xisound 将提供自动迁移工具 + FAE 现场支持
4. 算法块级详细变更
4.1 PEQ 系列
| 版本 | 变更 |
|---|---|
| v1.0.0 | 首版 5/10/31 段 PEQ |
| v1.0.1 | 高 Q 值（Q > 10）数值稳定性改进 |
| v1.0.3 | Biquad 实现从 Direct Form I 切到 Transposed Direct Form II，降低定点舍入误差 |
| v1.1.0 | 新增 PEQ_Band_Dyn（动态 EQ，Gain 随 Envelope 变化） |
4.2 DRC 系列
| 版本 | 变更 |
|---|---|
| v1.0.0 | 首版 DRC_multiband（可配 ½/⅗ 段） |
| v1.0.2 | Attack / Release 时间计算从指数拟合切到线性分段，CPU 节省 ~8% |
| v1.0.4 | 修复 HeavyLimit 模式下偶发的 LFE 频率泄漏问题 |
| v1.1.0 | 新增 Lookahead_5ms 选项（用预见缓冲做 Overshoot 控制） |
4.3 NR 系列
| 版本 | 变更 |
|---|---|
| v1.0.0-beta | 首版 RoadNoise_NLMS / WindNoise / AEC / CallNR |
| v1.0.0 | NLMS 步长自适应 · AEC 双讲检测优化 |
| v1.0.2 | 修复 AEC 在极端静音段偶发发散的问题 |
| v1.1.0 | 新增 TrafficNoise（城市路面 · 类似 NLMS 但针对低频间歇性噪声） |
5. Errata（已知问题）
5.1 当前 Errata 清单
Errata 分级
- P0（致命）：可能导致芯片损坏 / 严重音频失真 · 立即通知所有客户
- P1（严重）：功能异常需 workaround · 下版本必修
- P2（一般）：次要功能问题 · 文档注明
- P3（轻微）：体验问题 · 记录备忘
| Errata ID | 严重度 | 影响 | 描述 | Workaround | 修复版本 |
|---|---|---|---|---|---|
| ERR-XA-001 | P3 | FX v1.0.0-alpha | Reverb mix 参数在 0.95-1.0 区间跳变 | 限制 ≤ 0.94 | v1.0.0-beta 已修 |
| ERR-XA-002 | P2 | NR v1.0.0-beta | AEC 采样率切换时首帧失真 | 切换后跳过首 48 帧 | v1.0.0 已修 |
| ERR-XA-003 | P2 | FX v1.0.0 | DRC 极端高 Ratio（>50）时饱和输出方向可能翻转 | Ratio ≤ 30 | v1.0.1 已修 |
5.2 Errata 通报机制
- Enterprise+ 客户：邮件 + CRM 通知（P0/P1 即时）
- Pro 客户：每月发布合并 Errata 邮件
- Free 用户：XiStudio 市场页显示
6. 客户迁移指南
6.1 套件小版本升级（Patch / Minor）
100% 向后兼容 → 升级无需代码调整：
- XiStudio 菜单 → 扩展 → 算法市场 → 找到更新
- 点 升级
- 重新编译项目
- 烧录新固件
- XiTest 回归
6.2 套件 Major 升级（例：FX v1.x → v2.x）
可能需要调整参数格式。Xisound 提供自动迁移工具：
6.3 ABI Major 升级（v1.0 → v2.0）
ABI 升级需系统规划
ABI 升级影响：
- 所有 .xipkg 需重新编译
- 所有客户自研算法源码需适配
- XiStudio 需升级到对应版本
- XiDSP 固件需升级到对应版本
建议节奏：新项目直接用 v2.0；老项目继续 v1.0 维护 2 年，不强制升级。
7. 兼容性矩阵
7.1 ABI × XiDSP × XiStudio
| XiAlgo ABI | 支持 XiDSP | 支持 XiStudio |
|---|---|---|
| v1.0 | D1 / D2 | v1.0+ |
| v2.0（2028+） | D2 / D3 / A1 | v2.0+ |
| v3.0（2030+ 规划） | D3 / D4 / A 系列 | v3.0+ |
7.2 套件 × XiDSP
见 tech-arch.md §3.3 套件 × 芯片 × Tier 交叉矩阵。
8. 下一版本预告
8.1 XiAlgo v1.1（2028 H1 预计）
- 新增 AI 套件（基于 D2 芯片 AI 协处理器）
- FP32 可选路径（D2+）
- 更多场景预设（商用车 / 露营车 / 船舶）
8.2 XiAlgo v1.2（2028 H2 预计）
- Pro+ 车规增强包（Safety-Ready 文档 + Health Monitor）
- 扩展参数事务（部分算法支持原子多参数更新）
8.3 XiAlgo v2.0（2028 Q4 ~ 2029 Q1 预计）
- 新 ABI v2.0（见 §3.2）
- 3D 套件首发（D3 配套）
- 运行时算法热插拔
- 自动迁移工具发布
9. 文档变更历史
本文档自身变更记录：
| 版本 | 日期 | 变更 | 作者 |
|---|---|---|---|
| v1.0 | 2026-05-05 | 首版 · ABI 策略 + 6 套件历史 + Errata 模板 + 迁移指南 + 预告 | 研发中心 · 算法团队 |
10. 附录
10.1 关联文档
10.2 外部标准参考
- Semantic Versioning 2.0.0（SemVer.org）
- ISO 26262:2018（车规功能安全）
- JEDEC JESD46（PCN 行业惯例）
10.3 版本历史
| 版本 | 日期 | 要点 |
|---|---|---|
| v1.0 | 2026-05-05 | 首版 · ABI v1.0 + 六套件版本轨迹 + 迁移指南 + Errata 框架 |
changelog.md · D2-P5-TECH-003 · v1.0 · 2026-05-05 · Xisound 研发中心 · 算法团队