MIGRATED

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 xyL4

3.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 关联文档

• XiStudio 产品概述
• XiStudio PRD v1.0
• XiDSP 产品规格书
• Xisound 产品矩阵 V1.1
• 研发中心章程

12.2 版本历史

版本	日期	要点
v1.0	2026-05-05	首版 · 四版本矩阵 + 模块架构 + API 全景

---

spec.md · D2-P1-SPEC-001 · v1.0 · 2026-05-05 · Xisound 研发中心 · 平台软件团队