XiStudio · Software Spec
XiStudio 产品规格书
音频算法可视化开发 IDE · 完整软件能力与接口定义
每一个功能都有边界 · 每一个接口都可引用
4
版本套件
2
OS 平台
REST+gRPC
外部 API
XiStudio 产品规格书
摘要
本文档是 XiStudio IDE 的完整软件规格书，涵盖系统需求、版本能力矩阵、核心模块、API、插件体系、性能与兼容性。 面向架构师、客户集成团队、Tier1 二次开发者。
1. 产品形态
1.1 版本映射
| 版本 | 安装包 | 授权形式 | 可选组件 |
|---|---|---|---|
| Community | xistudio-community-setup.exe / .dmg | 永久免费，在线注册 | 无 |
| Pro | xistudio-pro-setup.exe / .dmg | 年订阅激活码 | XiAlgo Pro 包 |
| Enterprise | xistudio-enterprise-setup.exe / .dmg | 节点激活 License 服务器 | XiForge + 团队协作 |
| IDM | 源码 + SDK 包 | 一次性 + Royalty | 全部 + 源码 |
1.2 平台支持
| OS | 架构 | 最低版本 | 推荐 |
|---|---|---|---|
| Windows | x64 | Win10 1809 | Win11 22H2 |
| Windows | ARM64 | 不支持（Roadmap 2028） | — |
| macOS | ARM64（Apple Silicon） | macOS 13 | macOS 15 |
| macOS | x64（Intel） | macOS 13 | macOS 14 |
| Linux | x64 | Ubuntu 22.04 | Ubuntu 24.04（Roadmap 2027） |
2. 系统需求
2.1 硬件要求
| 项 | 最低 | 推荐 |
|---|---|---|
| CPU | 4 核 / 2.0 GHz | 8 核 / 3.0 GHz |
| 内存 | 8 GB | 16 GB |
| 存储 | 10 GB 可用空间 | 50 GB SSD |
| 显卡 | 集显（支持 OpenGL 3.3） | 独显（支持 OpenGL 4.5 / Metal 2） |
| 显示器 | 1920×1080 | 2560×1440 或 4K |
2.2 软件依赖
- 运行时：.NET 8 / Electron 28（自带，无需单独安装）
- 驱动：如使用 JTAG 烧录，需安装
xi-jtag-driver v1.0+
3. 核心模块
3.1 模块架构
graph TB
UI[UI Shell · Electron]
UI --> EditorCore[流图编辑器核心]
UI --> ParamPanel[参数面板]
UI --> Scope[实时示波器]
EditorCore --> AlgoLib[XiAlgo 算法库]
EditorCore --> Compiler[DSP 编译器]
Compiler --> Codegen[代码生成器]
Codegen --> Sim[位精确仿真器]
Codegen --> Burner[烧录引擎]
Burner --> XiFlash[XiFlash v1.0]
Burner --> JTAG[JTAG 调试器]
UI --> AIBridge[XiMind 桥接]
AIBridge --> Cloud[云端 AI]
UI --> CollabSvc[协作服务<br/>Enterprise+]
class UI xyL5
class EditorCore,ParamPanel,Scope,Compiler,Codegen xyL3
class AlgoLib,Sim,Burner xyL2
class XiFlash,JTAG xyL1
class AIBridge,Cloud,CollabSvc xyL43.2 模块版本
| 模块 | v1.0 能力 | v1.x 计划 |
|---|---|---|
| 流图编辑器 | 拖拽 / 连线 / 组 / 分层 | 实时协作（Enterprise） |
| 参数面板 | 数值 / 曲线 / 下拉 | 自定义控件（XiForge） |
| 示波器 | 波形 / 频谱 / RMS | 声压图 / 3D 可视化 |
| 编译器 | XiDSP-D1 目标 | D2+ / 第三方 DSP |
| 仿真器 | 位精确 · 单线程 | 并行仿真 / GPU 加速 |
| 烧录引擎 | XiFlash USB/串口 | OTA / Ethernet |
| AI 桥接 | 文本 → 算法 / 调音建议 | 语音交互 / 视觉 |
4. 版本能力矩阵
4.1 功能对比
| 功能 | Community | Pro | Enterprise | IDM |
|---|---|---|---|---|
| 流图编辑 | ✅ | ✅ | ✅ | ✅ |
| 基础 XiAlgo（FX 入门） | ✅ | ✅ | ✅ | ✅ |
| 完整 XiAlgo 全套件 | — | ✅ | ✅ | ✅ |
| 硬件烧录（XiDSP） | — | ✅ | ✅ | ✅ |
| JTAG 实时调试 | — | ✅ | ✅ | ✅ |
| XiForge 插件开发 | — | — | ✅ | ✅ |
| 团队协作 | — | — | ✅ | ✅ |
| License 服务器 | — | — | ✅ | ✅ |
| 源码访问 | — | — | — | ✅ |
| 定制化后门 | — | — | — | ✅ |
4.2 项目规模支持
| 项 | Community | Pro | Enterprise | IDM |
|---|---|---|---|---|
| 单项目节点数 | ≤ 50 | ≤ 500 | 无限制 | 无限制 |
| 同时打开项目数 | 1 | 5 | 无限制 | 无限制 |
| 团队协作成员数 | — | — | 按 License | 按 License |
5. API 与集成
5.1 对外 API
命令行 CLI（全版本）
xistudio build <project.xi> # 命令行编译
xistudio flash <firmware.bin> # 烧录
xistudio simulate <project.xi> # 仿真
REST API（Enterprise+）
POST /api/v1/projects：创建项目GET /api/v1/projects/{id}：查询项目POST /api/v1/projects/{id}/build：触发编译- 认证：Bearer Token（JWT）
gRPC API（IDM）
- 低延迟交互，适合集成到客户自有工具链
5.2 插件与 SDK
- 插件格式：
.xiplugin（内部是 ZIP + manifest.json） - SDK 语言：TypeScript / C# / Python（三选一）
- 典型插件类型：自定义算法块、调音 UI、导出格式转换
5.3 工程文件格式
| 格式 | 扩展名 | 说明 |
|---|---|---|
| 项目 | .xiproj | 项目元数据（XML） |
| 流图 | .xiflow | 流图（JSON） |
| 参数 | .xiparam | 参数组（JSON） |
| 固件 | .xifw | 编译输出固件 |
| 烧录包 | .xiflash | 含签名的烧录包 |
6. 性能指标
6.1 启动与响应
| 指标 | 目标值 | 测试条件 |
|---|---|---|
| 冷启动时间 | ≤ 5 s | 推荐硬件 |
| 热启动时间 | ≤ 2 s | |
| 项目打开 | ≤ 1 s / 100 节点 | |
| 编译时间 | ≤ 10 s / 100 节点 | |
| 仿真实时率 | ≥ 10× 实时 | @ 48 kHz 单通道 |
6.2 稳定性
- 崩溃率目标：≤ 0.1%
- 内存泄漏：8 小时连续操作增量 < 100 MB
- CPU 占用（空闲）：< 2%
6.3 安全
- 项目文件 AES-256 加密（Pro+）
- License 使用 RSA-2048 签名
- 云端调用使用 TLS 1.3
7. 兼容性
7.1 XiDSP 型号支持
| XiStudio 版本 | D1 | D2 | D3 | D4 | A1 |
|---|---|---|---|---|---|
| v1.0 | ✅ | — | — | — | — |
| v1.5（2027 Q3） | ✅ | ✅ | — | — | — |
| v2.0（2028 Q2） | ✅ | ✅ | ✅ | — | — |
| v3.0（2029+） | ✅ | ✅ | ✅ | ✅ | ✅ |
7.2 XiAlgo 算法兼容
- 同一套 XiAlgo 算法包可跨 XiDSP 型号运行（ABI v1.0）
- 算法包版本与 XiStudio 版本语义化兼容
7.3 第三方 DSP（Roadmap）
- 2027 Q4：ADI SHARC 系列（部分）
- 2028 Q2：TI C6000 系列
- IDM 版支持客户定制目标
8. 调试与开发支持
8.1 调试能力
- 断点：流图节点 / 生成代码双向断点
- 单步：节点级单步执行
- 变量观察：实时观察算法内部变量
- 性能 Profile：节点级 MIPS / 内存占用统计
8.2 日志与诊断
- 日志级别：ERROR / WARN / INFO / DEBUG / TRACE
- 日志目录：
%APPDATA%/XiStudio/logs（Windows）/~/Library/Logs/XiStudio（macOS） - 崩溃转储：自动生成 dump，可上传至 Xisound 诊断服务
9. 订阅与授权
9.1 授权方式
- Community：免费在线注册（邮箱确认）
- Pro：激活码绑定设备（最多 3 台）
- Enterprise：浮动 License 服务器（局域网）
- IDM：签订主合同 + SLA
9.2 离线使用
- Community/Pro：首次激活需联网，之后可离线 30 天
- Enterprise：可完全内网部署
10. 验收标准
10.1 功能完整性
- 流图编辑完整（所有基础节点可用）
- XiAlgo 基础套件可拖入
- 编译输出固件可被 XiDSP-D1 烧录
- 仿真与真实硬件结果一致（ABS 差异 < 0.1 dB）
- 示波器波形实时刷新
10.2 平台验证
- Windows 10 / 11 双版本通过
- macOS Apple Silicon 通过
- 主流分辨率（1080p / 2K / 4K）UI 正常
10.3 稳定性
- 崩溃率 ≤ 0.1%
- 内存泄漏测试通过
- 压力测试 500 节点项目可运行
11. 风险与已知限制
11.1 v1.0 已知限制
- 不支持 Linux 桌面（Roadmap 2027）
- 不支持手机 / 平板（不在计划内）
- 仅支持 XiDSP-D1（D2 起随产品发布支持）
- 协作功能尚未开放（Enterprise v1.5 起）
11.2 规格变更流程
- 重大变更需：产品 + 研发 + 客户代表 ADR 评审
- 小版本变更（bug 修复、性能优化）由研发中心月度评议
12. 附录
12.1 关联文档
12.2 版本历史
| 版本 | 日期 | 要点 |
|---|---|---|
| v1.0 | 2026-05-05 | 首版 · 四版本矩阵 + 模块架构 + API 全景 |
spec.md · D2-P1-SPEC-001 · v1.0 · 2026-05-05 · Xisound 研发中心 · 平台软件团队