XiVST · Technical Spec (Planning)

XiVST 产品规格书（规划版）

XVST 协议骨架 + SDK API + 沙箱 Runtime + Marketplace 规格

文档编号：D2-P10-SPEC-001 · 版本：v0.1(规划) · 发布：2026-05-05

规划版技术骨架 · 2026 Q1 SDK 首发后迭代

5

核心子系统

2026Q1

SDK 首发

.xvst

插件格式

XiVST 产品规格书（规划版）

规划版提示

本 Spec 是 v0.1 规划版（2026 Q1 SDK 首发目标）。技术细节（协议字段、API 签名、沙箱实现）将在 SDK 1.0 发布后 v1.0 正式版中细化。本文档优先建立协议骨架、子系统接口、文件格式约定。

摘要

XiVST 产品规格书规划五大核心子系统：XVST 协议（.xvst 格式 + 插件清单）、XVST SDK（C/C++ 开发工具链）、XVST Runtime（沙箱插件运行时）、XVST Marketplace（插件商店后端）、认证与审核（三级认证流程）。

1. 总体架构（规划）

1.1 五层架构位置

graph TB
    L5[Layer 5 · 应用层<br/>XiStudio IDE + Marketplace UI]
    L4[Layer 4 · 插件运行时<br/>XVST Runtime · 沙箱]
    L3[Layer 3 · 核心引擎<br/>Audio Graph Runtime]
    L2[Layer 2 · 算法 IP 层<br/>Native + XVST Unified]
    L1[Layer 1 · 硬件层<br/>XiDSP / XiAmp / XiBox]

    L5 --> L4
    L4 --> L3
    L3 --> L2
    L2 --> L1

    class L5 xyL4
    class L4 xySuccess
    class L3 xyL3
    class L2 xyL2
    class L1 xyL0

1.2 子系统总览

graph TB
    subgraph Dev[开发侧]
        SDK[XVST SDK<br/>C/C++/Python]
        CLI[xvst CLI]
    end

    subgraph Cloud[云端平台]
        MP[Marketplace 后端]
        Cert[认证审核系统]
        Billing[分成结算系统]
    end

    subgraph Host[宿主运行]
        Runtime[XVST Runtime]
        Sandbox[插件沙箱]
        Loader[xvst-loader]
    end

    subgraph Deploy[部署目标]
        Studio[XiStudio 桌面]
        Chip[XiDSP 芯片]
    end

    SDK --> CLI
    CLI --> MP
    MP --> Cert
    MP --> Billing
    MP --> Runtime
    Runtime --> Loader
    Loader --> Sandbox
    Sandbox --> Studio
    Sandbox --> Chip

    class Dev xyL5
    class Cloud xyL2
    class Host xyL3
    class Deploy xyL0
    class MP,Cert,Billing xySuccess

2. XVST 协议规范

2.1 插件文件格式（`.xvst`）

.xvst 文件是一个签名压缩包（类似 .vsix / .zip），包含：

my-plugin.xvst
├── plugin.xvst.json       ← 插件清单（metadata）
├── binary/
│   ├── wasm/plugin.wasm   ← 桌面调试 WASM 二进制
│   └── native/plugin.a    ← 车规部署原生二进制（编译后）
├── assets/
│   ├── icon.svg           ← 128×128 矢量图标
│   ├── screenshots/       ← 效果截图
│   └── README.md          ← 中英文档
├── signature.bin          ← Xisound 数字签名
└── LICENSE                ← 许可证（MIT/Apache/Proprietary）

2.2 插件清单（`plugin.xvst.json`）

{
  "$schema": "https://xivst.xisound.com/schema/plugin.v1.json",
  "id": "com.fabdsp.pro-q-auto",
  "name": "Pro-Q Auto",
  "version": "3.1.2",
  "author": {
    "name": "FabDSP Labs",
    "email": "dev@fabdsp.com",
    "url": "https://fabdsp.com",
    "verified": true
  },
  "category": "filter",
  "tags": ["eq", "dynamic", "parametric", "automotive"],
  "description": "30-band dynamic parametric EQ for automotive use.",
  "license": "proprietary",
  "pricing": {
    "tier": "pro",
    "price_cny": 4999,
    "model": "one-time"
  },
  "certification": "verified",
  "compatibility": {
    "xvst_protocol": ">=1.0",
    "xistudio": ">=5.0",
    "target_dsp": ["XiDSP-D1", "XiDSP-D2"]
  },
  "performance_contract": {
    "max_cpu_percent": 8,
    "max_mips": 120,
    "max_latency_ms": 3,
    "max_memory_kb": 512
  },
  "io": {
    "inputs": [{ "name": "audio_in", "channels": 2 }],
    "outputs": [{ "name": "audio_out", "channels": 2 }],
    "sample_rates": [48000, 96000]
  },
  "parameters": [
    {
      "id": "band1_freq",
      "name": "Band 1 Frequency",
      "type": "float",
      "unit": "Hz",
      "min": 20,
      "max": 20000,
      "default": 1000,
      "automation": true
    }
  ]
}

2.3 生命周期接口（C++ 风格）

// xvst/plugin.h
class XVSTPlugin {
public:
  virtual ~XVSTPlugin() = default;

  // 1. 初始化（加载时调用一次）
  virtual XVSTResult init(const XVSTConfig& config) = 0;

  // 2. 实时处理（每帧调用）
  virtual XVSTResult process(
      const XVSTAudioBuffer& input,
      XVSTAudioBuffer& output,
      const XVSTParameterSnapshot& params) = 0;

  // 3. 参数更新（异步）
  virtual XVSTResult set_parameter(XVSTParamID id, float value) = 0;

  // 4. 重置（流状态清空）
  virtual XVSTResult reset() = 0;

  // 5. 关闭（卸载前调用）
  virtual void shutdown() = 0;
};

// 插件工厂（C 接口 · 保证 ABI 稳定）
extern "C" {
  XVSTPlugin* xvst_create_plugin();
  void xvst_destroy_plugin(XVSTPlugin* plugin);
  const char* xvst_get_api_version();
}

2.4 参数协议

参数类型	C++ 类型	JSON 描述	示例
`float`	`float`	`{"type":"float","min":0,"max":1}`	EQ 增益
`int`	`int32_t`	`{"type":"int","min":0,"max":127}`	MIDI 值
`bool`	`bool`	`{"type":"bool"}`	开关
`enum`	`int32_t`	`{"type":"enum","values":["A","B","C"]}`	模式选择
`string`	`const char*`	`{"type":"string","max_length":64}`	预设名称

自动化支持：参数可声明 automation: true，允许宿主实时调制。

3. XVST SDK 规格

3.1 语言支持（规划）

语言	状态	用途
C / C++	v1.0 主推	车规原生开发（必需）
Python	v1.1+	算法原型 · AI 插件（WASM）
Rust	v2.0 评估	内存安全场景

3.2 CLI 工具

# 创建新插件骨架
xvst init my-plugin --template=filter --language=cpp

# 本地开发调试（WASM 桌面）
xvst build --target=wasm --debug
xvst run --host=xistudio --plugin=my-plugin.xvst

# 车规部署编译
xvst build --target=native --release --dsp=XiDSP-D2

# 性能验证
xvst profile my-plugin.xvst --input=test.wav

# 提交 Marketplace
xvst publish --tier=indie --price=299 --category=filter

# 申请 Verified 车规认证
xvst certify --target=verified --submit

3.3 开发工具集成

VS Code Extension：代码提示 / 调试 / 性能分析
XiStudio 集成：插件加载 / 实时 Profiler / 流图可视化
Git Hooks：自动化 Lint / 性能契约检查

3.4 示例插件库（规划 10+ 款）

示例	类别	说明
`hello-eq`	Filter	最小可运行 EQ · 入门示例
`simple-drc`	Dynamics	动态压缩器
`delay-line`	Effect	延迟效果器
`sine-gen`	Input	正弦波生成器（测试用）
`ai-denoiser-lite`	AI	TinyML 降噪（Python SDK 示例）
`reverb-convolution`	Effect	卷积混响
`analyzer-fft`	Utility	FFT 频谱分析器
`mid-side-split`	Utility	立体声 Mid-Side 分离
`tube-saturation`	Effect	电子管失真模拟
`format-converter`	I/O	采样率 / 位深转换

4. XVST Runtime · 沙箱规格

4.1 沙箱能力

能力	说明
CPU 配额	按 `performance_contract.max_cpu_percent` 强制限制
内存配额	按 `max_memory_kb` 分配 · 超出立即终止
文件访问	白名单目录（`~/.xvst/plugins/{id}/data`）· 无主文件系统访问
网络访问	默认禁止 · 需插件明文申请 + 用户同意
系统调用	白名单（仅音频 I/O + 时钟）· seccomp 过滤
崩溃隔离	单插件崩溃不影响其他插件 / 宿主
热更新	支持运行时替换（保留参数）· 失败回滚

4.2 运行时 API（宿主侧）

// xvst/runtime.h
class XVSTHost {
public:
  // 加载插件
  XVSTResult load_plugin(const std::string& path, XVSTPluginID* out_id);

  // 卸载插件
  XVSTResult unload_plugin(XVSTPluginID id);

  // 处理音频（Core Engine 调用）
  XVSTResult process_plugin(
      XVSTPluginID id,
      const XVSTAudioBuffer& input,
      XVSTAudioBuffer& output);

  // 参数更新
  XVSTResult set_plugin_parameter(
      XVSTPluginID id,
      XVSTParamID param,
      float value);

  // 性能监控
  XVSTPerformanceStats get_stats(XVSTPluginID id);

  // 安装事件回调
  void set_crash_handler(XVSTCrashHandler handler);
};

4.3 双栈部署策略

部署场景	运行时	二进制	性能
开发者桌面调试	WASM（wasmtime）	`plugin.wasm`	近原生 80%
XiStudio 模拟运行	WASM	同上	同上
车规量产部署	原生 C++	`plugin.a`（静态库）	100% 原生

关键：同一份源码，通过 xvst build --target=... 编译为不同目标。

5. XVST Marketplace 规格

5.1 Marketplace 后端架构

graph LR
    API[REST API<br/>Gateway]
    API --> Auth[OAuth 2.0<br/>开发者账户]
    API --> Search[搜索<br/>Elasticsearch]
    API --> Store[插件存储<br/>S3 + CDN]
    API --> Cert[认证系统<br/>审核队列]
    API --> Bill[分成结算<br/>月度 Job]

    DB[(PostgreSQL)]
    API --> DB

    class API xyL3
    class Auth,Search,Store,Cert,Bill xyL2
    class DB xySuccess

5.2 核心 REST API（规划）

接口	方法	说明
`POST /api/v1/plugins`	POST	开发者上传插件（`.xvst` 文件 + 清单）
`GET /api/v1/plugins`	GET	搜索插件（按分类/评分/价格）
`GET /api/v1/plugins/{id}`	GET	获取插件详情
`POST /api/v1/plugins/{id}/install`	POST	安装插件（返回下载 URL）
`POST /api/v1/plugins/{id}/review`	POST	提交评价
`POST /api/v1/plugins/{id}/certify`	POST	申请 Verified 车规认证
`GET /api/v1/developer/earnings`	GET	开发者查询分成收益
`POST /api/v1/developer/withdraw`	POST	提现申请

5.3 搜索与发现

分类：Filter · Dynamics · Effect · AI · Input · Output · Utility · 7 大类
认证过滤：All / Verified Only / Official Only / Free Only
排序：Popular · New · Rating · Price Low-High
全文搜索：插件名 / 作者 / 描述 · 中英双语
推荐算法：编辑推荐 + 协同过滤（类似 VS Code Extensions）

6. 认证与审核规格

6.1 三级认证流程

graph TB
    Submit[开发者提交]
    Submit --> Scan[自动化扫描]

    Scan --> ScanCheck{通过基础<br/>检查?}
    ScanCheck -->|否| Reject1[驳回 · 反馈问题]
    ScanCheck -->|是| Com[✓ Community 认证]

    Com --> VerifyReq{申请 Verified?}
    VerifyReq -->|否| Done1[Community 上架]
    VerifyReq -->|是| LabTest[Xisound 实验室<br/>车规测试]

    LabTest --> LabCheck{通过 AEC-Q100/<br/>ISO 26262?}
    LabCheck -->|否| Reject2[退回修复]
    LabCheck -->|是| Review[人工评审]
    Review --> Reviewer{Review 通过?}
    Reviewer -->|否| Reject2
    Reviewer -->|是| Ver[✓✓ Verified 认证]
    Ver --> Done2[可量产部署]

    class Submit,Com,Ver xySuccess
    class Scan,LabTest,Review xyL2
    class ScanCheck,VerifyReq,LabCheck,Reviewer xyL3
    class Reject1,Reject2 xyError
    class Done1,Done2 xyL5

6.2 自动化扫描内容

静态分析：CWE 检查（内存安全 / 未定义行为）
性能契约验证：CPU / MIPS / 延迟 / 内存是否符合声明
API 合规：仅使用 XVST SDK 公开 API
许可证：LICENSE 文件存在 · 许可证有效
元数据完整：清单必填字段齐全
恶意代码：病毒 / 反向连接 / 数据外发扫描
反盗版：比对已上架插件指纹

6.3 Verified 车规认证（Xisound 实验室）

测试项	标准	通过阈值
AEC-Q100	工作温度 -40°C ~ +105°C	全温区稳定
ISO 26262 ASIL-B	功能安全	无高风险缺陷
电磁兼容	IEC 61000-4-3	通过
长时间稳定性	72 小时连续运行	无崩溃 / 无内存泄漏
车内声学	Xisound 标准声学用例	指标达标（频响 / THD+N / SNR）

周期：4-8 周 · 费用：由 Xisound 补贴 Pro Tier 认证（限前 500 款）

6.4 质量淘汰机制

季度评审：评分 < 3.5 的插件被降级
连续低评价：3 个月持续差评下架
违规处罚：发现盗版 / 恶意代码 · 永久封禁账户

7. 分成结算规格

7.1 分成流程

graph LR
    User[用户购买插件<br/>¥299]
    User --> Payment[支付系统<br/>支付宝/微信/PayPal]
    Payment --> Split[7:2:1 拆分]
    Split --> Dev[开发者账户<br/>¥209.3]
    Split --> Platform[Xisound 平台<br/>¥59.8]
    Split --> Chip[芯片伙伴<br/>¥29.9]

    Dev --> Settlement[月度结算<br/>每月 10 日]
    Settlement --> Withdraw[开发者提现<br/>≥¥1000 起付]

    class User xyL5
    class Payment,Split,Settlement xyL2
    class Dev xySuccess
    class Platform xyL3
    class Chip xyL4

7.2 多币种支持（规划）

币种	支付方式	结算方式	汇率
CNY 人民币	支付宝 / 微信 / 银行转账	人民币银行账户	-
USD 美元	PayPal / Stripe	美元 PayPal / 银行转账	中国银行中间价
EUR 欧元	Stripe / SEPA	欧元 SEPA 银行	中国银行中间价
HKD 港币	PayPal / 银行	港元银行账户	-

7.3 税务合规

大陆开发者：Xisound 代扣代缴个人所得税
港澳台开发者：提供完税证明 · 开发者自行申报
海外开发者：填写 W-8BEN / W-9 表格 · 自行申报所在国税务
企业开发者：Xisound 开具发票（增值税专票）

8. 性能与可靠性

8.1 性能规格

指标	目标
插件加载延迟	≤ 10 ms P95（沙箱初始化）
实时处理开销	≤ 5% 相对原生（WASM · 桌面）/ 0%（原生 · 车规）
Marketplace 搜索响应	≤ 500 ms P95
插件下载速度	≥ 100 Mbps（CDN 全球）
认证审核周期	Community 自动 ≤ 1h · Verified 车规 4-8 周

8.2 可靠性

Marketplace 可用性 ≥ 99.9%（SLA）
CDN 全球覆盖 ≥ 50 节点（中美欧亚）
数据备份：插件 + 元数据每日备份 · 30 天保留
故障恢复 RTO：≤ 1 小时
数据恢复 RPO：≤ 1 小时

9. 与其他产品的接口

产品	接口	说明
XiStudio	内置 Marketplace UI + Runtime	宿主 IDE
XiDSP	原生 C++ ABI	部署目标芯片
XiAlgo	统一 Core Engine 调度	原生算法与 XVST 插件并存
XiForge	生成 XVST 插件骨架	加速开发者上手（v1.1+）
XiMind	AI 辅助插件开发	自然语言 → XVST 代码（v1.1+）
XiTest	认证测试集成	Verified 车规认证使用 XiTest HIL

10. 安全规格

10.1 代码保护

编译即上传：开发者本地编译为加密二进制 · 源码不上传
签名必需：所有插件必须 Xisound 数字签名（防篡改）
加密传输：TLS 1.3 · CDN 签名 URL

10.2 运行安全

沙箱隔离：seccomp + namespaces（Linux）· Job Objects（Windows）
资源配额：硬性 CPU / 内存上限（超出即终止）
崩溃隔离：单插件崩溃不影响主进程

10.3 认证与授权

开发者账户：邮箱 + 手机 + 实名认证（大陆）/ KYC（海外）
API Key：短时令牌（1h）+ 长期令牌（30d 轮转）
车端部署：仅 Verified + Official 插件可部署到车规硬件

11. 已知限制与路线

11.1 v1.0 Seed（2026 Q1-Q2）已知限制

仅支持 C/C++ SDK（Python v1.1+）
仅支持 XiDSP-D1 / D2 部署（D3 v1.2）
三级认证中 Official 仅限 Xisound 内部（开发者不可申请）
分成支持大陆人民币（海外结算 v1.1）

11.2 路线图

v1.0 Seed（2026 Q2）：SDK + Marketplace MVP + Community 认证
v1.1 Growth（2026 Q4）：Python SDK + 车规 Verified 认证 + 海外结算
v1.2 Scale（2027-2028）：全球 CDN + AI 编排（XiMind 联动）+ XVST v2（AI 原生）
v2.0 Ecosystem（2029+）：协议标准化 · 授权给其他芯片厂 · 行业 de-facto

12. 附录

12.1 关联文档

XiVST 产品概述
XiVST PRD v0.1 规划版
XiStudio 产品规格书
XiDSP 产品规格书
XiAlgo 产品规格书
XiForge 产品规格书
曦音开发者生态战略（HTML 源）：仓库内 AlgoDepartment/06_docs/converttool/ref/doc/曦音-开发者生态战略.html

12.2 标准与开源组件

WebAssembly（W3C）· wasmtime 运行时
OAuth 2.0 RFC 6749 / JWT RFC 7519
Semantic Versioning 2.0
Model Context Protocol（MCP）兼容
Apache 2.0 / MIT / BSL 许可证

12.3 版本历史

版本	日期	要点
v0.1	2026-05-05	首版（规划版）· 5 子系统规格 + `.xvst` 格式 + 7:2:1 分成架构

spec.md · D2-P10-SPEC-001 · v0.1 · 2026-05-05 · Xisound 研发中心 · 生态与平台团队

XiVST 产品规格书（规划版）

XiVST 产品规格书（规划版）

1. 总体架构（规划）

1.1 五层架构位置

1.2 子系统总览

2. XVST 协议规范

2.1 插件文件格式（.xvst）

2.2 插件清单（plugin.xvst.json）

2.3 生命周期接口（C++ 风格）

2.4 参数协议

3. XVST SDK 规格

3.1 语言支持（规划）

3.2 CLI 工具

3.3 开发工具集成

3.4 示例插件库（规划 10+ 款）

4. XVST Runtime · 沙箱规格

4.1 沙箱能力

4.2 运行时 API（宿主侧）

4.3 双栈部署策略

5. XVST Marketplace 规格

5.1 Marketplace 后端架构

5.2 核心 REST API（规划）

5.3 搜索与发现

6. 认证与审核规格

6.1 三级认证流程

6.2 自动化扫描内容

6.3 Verified 车规认证（Xisound 实验室）

6.4 质量淘汰机制

7. 分成结算规格

7.1 分成流程

7.2 多币种支持（规划）

7.3 税务合规

8. 性能与可靠性

8.1 性能规格

8.2 可靠性

9. 与其他产品的接口

10. 安全规格

10.1 代码保护

10.2 运行安全

10.3 认证与授权

11. 已知限制与路线

11.1 v1.0 Seed（2026 Q1-Q2）已知限制

11.2 路线图

12. 附录

12.1 关联文档

12.2 标准与开源组件

12.3 版本历史

2.1 插件文件格式（`.xvst`）

2.2 插件清单（`plugin.xvst.json`）