Tech Architecture · Planning · v0.1

XiVST 技术架构设计（规划版）

车载声学行业的 VST · 五子系统协同演进规划

文档版本：v0.1 规划版 · 文档编号：D2-P10-TECH-001 · 发布日期：2026-05-05

Open Plugin Ecosystem for Automotive Acoustics

5

核心子系统

v0.1

规划阶段

2026 Q1

Seed 起点

XiVST 技术架构设计（规划版）

摘要

本规划版阐述 XiVST（羲音生态 · XIYIN Virtual Studio Technology） 的技术架构构想：通过 XVST 协议、SDK、Runtime、Marketplace、认证体系 五个子系统协同，构建一个车载声学行业的「VST 生态」。所有技术细节、性能指标、接口签名均为 v0.1 规划目标，随 2026 Q1–Q2 Seed 阶段原型验证而迭代。本文不承诺任何具体 SLA、兼容矩阵、上线时间表。

规划版边界

本文所述协议版本号、API、沙箱机制均为目标规划，以 Seed 阶段原型实现为准
具体车规认证路径（ISO 26262 / AEC-Q100 / ASPICE）待与认证机构对齐后以正式版本公布
与现有 XiStudio / XiDSP / XiAlgo / XiForge 的集成规划以各产品正式版 Spec 为准

1. 总体架构

1.1 五子系统视图

graph TB
  subgraph S1[📜 XVST 协议层]
    P1[.xvst 包格式]
    P2[清单 manifest]
    P3[参数 / 接口 ABI]
  end

  subgraph S2[🛠 开发者 SDK]
    K1[C/C++ Header]
    K2[Python 绑定]
    K3[脚手架 CLI]
  end

  subgraph S3[⚙️ 运行时 Runtime]
    R1[解析器 Parser]
    R2[沙箱 Sandbox]
    R3[热插拔 Hot-Swap]
  end

  subgraph S4[🏪 Marketplace]
    M1[发布 / 检索]
    M2[支付 / 结算]
    M3[评分 / 评论]
  end

  subgraph S5[✓ 三级认证]
    C1[Community 自动扫描]
    C2[Verified 车规认证]
    C3[Official 官方签名]
  end

  S1 --> S2
  S1 --> S3
  S2 -->|开发产物| S4
  S4 -->|分发 .xvst| S3
  S5 -->|签名 / 标记| S4

  class S1 xyL3
  class S2 xyL4
  class S3 xyL1
  class S4 xyL4
  class S5 xyL5

1.2 与 Xisound 全栈的集成位置

XiVST 作为生态产品组，横向跨 L3 算法层 / L4 工具层 / L5 云端层：

集成点	上游产品	集成方式（规划）
XiStudio IDE	L4 · 工具	在 IDE 内置 Marketplace 面板 · 支持一键安装 `.xvst`
XiForge	L4 · 工具	提供 `.xvst` 打包与认证上传向导
XiAlgo 运行时	L3 · 算法	Runtime 作为 XiAlgo 的可扩展插件容器
XiDSP 固件	L0 · 芯片	Verified/Official 级插件可被编译为芯片内驻算子
XiMind 云端	L5 · 云端	Marketplace 后端 + OAuth/鉴权 + 数据分析

2. 子系统一：XVST 协议层

2.1 `.xvst` 包格式（规划 v0.1）

.xvst 是一个 ZIP 归档，携带清单、二进制实现、元数据与签名。规划结构：

plugin.xvst/
├── manifest.json          # 规划 · 必选 · 插件元信息
├── ui/
│   ├── panel.html         # 规划 · 可选 · 调音面板 UI
│   └── assets/
├── bin/
│   ├── x86_64-linux/      # 规划 · 按架构分发
│   │   └── plugin.so
│   ├── aarch64-linux/
│   │   └── plugin.so
│   └── xidsp-d3/          # 规划 · 芯片 native
│       └── plugin.bin
├── signature.sig          # 规划 · Official 级插件的官方签名
└── README.md

2.2 `manifest.json` 核心字段（规划）

{
  "xvst_version": "0.1",
  "id": "com.example.tuning.warmth",
  "name": "Warmth Tuning",
  "version": "1.2.0",
  "author": {
    "name": "Example Studio",
    "email": "contact@example.com"
  },
  "category": "tuning",
  "tags": ["eq", "warmth", "vintage"],
  "compat": {
    "xivst_runtime": ">=0.1.0",
    "targets": ["x86_64-linux", "aarch64-linux", "xidsp-d3"]
  },
  "license": "MIT",
  "cert_level": "Community",
  "params": [
    { "id": "drive", "name": "Drive", "type": "float", "min": 0.0, "max": 1.0, "default": 0.3 }
  ],
  "ports": {
    "audio_in": 2,
    "audio_out": 2
  }
}

字段详细语义

xvst_version：协议版本号（规划从 0.1 开始）
cert_level：Community / Verified / Official（由认证系统回写）
compat.targets：架构白名单 · 未来支持更多平台（如 xidsp-d4 / rtos-armv8 等）
本 schema 将在正式版提供 JSON Schema 校验器

2.3 ABI 稳定性策略（规划）

主版本不变则保证二进制兼容：例如 xvst_version=0.x 系列内 SDK 升级不破坏已发布插件
Breaking change 需升至 1.0：任何 ABI-breaking 变更需要：① 提前 6 个月公告；② 提供迁移工具
符号白名单：插件二进制只能导出 xvst_* 前缀符号 · 其余符号由 Runtime 拒绝加载

3. 子系统二：开发者 SDK

3.1 SDK 语言矩阵（规划）

语言	地位	覆盖功能
C++ 17	一等公民	完整插件开发 / 沙箱接入 / 打包签名
C 99	一等公民	嵌入式场景 · xidsp-d3 目标
Python 3.10+	辅助	离线测试 · CI 工具链 · 参数调试
Rust（观察中）	2027+	评估 Rust bindgen 集成可行性

3.2 C++ SDK 骨架（规划）

// xvst/plugin.h · 规划版
#include <xvst/types.h>

namespace xvst {

class Plugin {
public:
  virtual ~Plugin() = default;

  // 规划 · 生命周期
  virtual void on_load(const Params& init) = 0;
  virtual void on_unload() = 0;

  // 规划 · 音频处理（block-based · 规划默认 block_size=128）
  virtual void process(const AudioBuffer& in, AudioBuffer& out) = 0;

  // 规划 · 参数热更新（锁无关 · CAS 实现）
  virtual void set_param(ParamId id, float value) = 0;
};

// 规划 · 插件注册宏
#define XVST_EXPORT_PLUGIN(ClassName) \
  extern "C" xvst::Plugin* xvst_create() { return new ClassName(); }

}

3.3 脚手架 CLI（规划 · 命名 `xvst`）

# 规划命令集（子集预览）
xvst init my-plugin --template=tuning-eq      # 创建项目脚手架
xvst build --target=x86_64-linux              # 编译当前架构
xvst build --all-targets                      # 编译所有白名单架构
xvst pack                                     # 打包为 .xvst
xvst test --golden=./test/golden.wav          # 回归测试 (Seed+)
xvst sign --cert=community                    # Community 级自签名
xvst publish --market=https://market.xisound.com

4. 子系统三：运行时 Runtime

4.1 Runtime 职责边界

解析 .xvst · 校验签名、清单、目标架构
沙箱隔离 · 限制文件系统 / 网络 / syscall 白名单
参数总线 · 以 lock-free ring buffer 向插件投递参数更新
热插拔 · 不停主音频流切换插件版本（Seed+ 验证）

4.2 沙箱层级（规划）

graph LR
  A[宿主 Host] --> B[.xvst 解析器]
  B --> C[签名校验]
  C --> D{认证等级}
  D -->|Community| E1[受限沙箱<br/>seccomp + ro-fs]
  D -->|Verified| E2[标准沙箱<br/>seccomp + rw 临时区]
  D -->|Official| E3[特权沙箱<br/>可访问芯片原语]
  E1 --> F[插件进程 / 线程]
  E2 --> F
  E3 --> F

  class A xyL4
  class B,C xyL3
  class D xyWarn
  class E1 xyWarn
  class E2 xyL2
  class E3 xySuccess
  class F xyL3

沙箱安全底线（规划）

Community 级插件禁止：网络访问 / 文件系统写 / 反射调用芯片原语
Verified 级插件允许：临时文件区读写 / 受限日志输出
Official 级插件允许：在官方签名担保下访问芯片级优化 API

4.3 性能目标（规划 · 非承诺）

维度	规划目标	备注
插件加载时延	< 50 ms（x86_64）	Seed 阶段验证
沙箱调用开销	< 5% CPU overhead	对比裸运行
参数更新延迟	< 1 ms（下一 block）	lock-free 设计
并发插件数	规划 ≥ 16	视芯片资源

上述数字为规划目标，Seed 阶段结束后以实测数据替换。

5. 子系统四：Marketplace

5.1 后端服务组成（规划）

graph TB
  U[开发者 / 调音师 / Tier1] --> GW[API Gateway]
  GW --> AUTH[OAuth 2.0 · 鉴权]
  GW --> CAT[Catalog Service<br/>插件检索]
  GW --> PUB[Publish Service<br/>发布流水]
  GW --> PAY[Payment Service<br/>7:2:1 分成]
  GW --> REV[Review Service<br/>评分/评论]

  CAT --> DB[(PostgreSQL)]
  PUB --> OBJ[(对象存储 · .xvst 文件)]
  PAY --> LED[(账本 · 分成记录)]
  REV --> DB

  class U xyEnd
  class GW xyL4
  class AUTH xyWarn
  class CAT,PUB,PAY,REV xyL3
  class DB,OBJ,LED xyL0

5.2 发布流水（规划）

开发者上传 .xvst → Publish Service
自动扫描：静态分析 / ABI 合规 / 明显恶意代码特征（→ Community 级）
人工审核（Verified 起）：车规安全 / 实时性测试台（XiTest）回归
签名颁发：Verified ✓ / Official ◆ 由平台签发
上架发布：进入 Catalog · 可检索 · 可购买
营收流转：Payment Service 按 7:2:1 分成 → 开发者 / 平台 / 芯片伙伴

5.3 分成与结算（规划框架 · 见 pricing.md 详解）

比例：开发者 70% · 平台 20% · 芯片伙伴 10%
结算周期：规划月结 · T+15 日打款
最低提现额：规划 ¥300 起
税务：开发者自行申报 · 平台代扣代缴视所在国地区法规而定

6. 子系统五：三级认证

6.1 认证等级定义

等级	标志	审核方式	适用场景（规划）
Community	（无）	自动扫描	爱好者 / 开源 / 学习场景
Verified	✓	自动扫描 + 车规回归 + 人工抽查	量产后装 / Tier1 验证
Official	◆	全面审核 + 官方共同署名	OEM 前装 / 旗舰集成

6.2 Verified 认证核心项（规划清单）

实时性：在规划目标硬件上通过 XiTest 实时回归 · 无 xrun 事件
ABI 合规：只导出 xvst_* 白名单符号
崩溃率：100 万次参数切换测试 0 crash
资源占用：CPU / RAM / 栈 / 堆在清单声明范围内
可解释性：关键算法参数命名清晰 · 提供 user-manual.md

6.3 Official 认证额外项（规划）

芯片级优化（由 XiDSP 团队联审）
法律合规（专利 FTO 声明 / 第三方依赖许可证审计）
OEM 前装适配承诺（规划 ≥ 7 年安全补丁周期）

7. 安全模型

7.1 威胁模型（规划识别）

威胁	场景	缓解措施（规划）
恶意代码注入	开发者上传带后门的 `.xvst`	静态扫描 + 沙箱 + 认证审核
供应链污染	第三方依赖被投毒	依赖锁定 + SBOM 必填 + CI 审计
签名伪造	攻击者伪造 Official ◆	平台私钥硬件托管 + 公钥内置 Runtime
资源耗尽	插件占满 CPU 导致主音频断流	cgroup 限额 + watchdog 熔断
参数越界	非法参数值导致 DSP 异常	Runtime 校验 + 插件内 assert

7.2 隐私与数据边界（规划）

插件不得访问用户 PII（车主信息 / 车辆标识等）
日志脱敏机制 · 只上报聚合遥测
符合适用地区数据保护法规（如 GDPR / 个保法）要求

8. 开发流水线 CI / CD（规划）

8.1 开发者本地流程

xvst init    # 1. 脚手架
xvst build   # 2. 编译
xvst test    # 3. 本地金样回归
xvst pack    # 4. 打包
xvst publish # 5. 上传 · 触发云端流水

8.2 平台 CI 流水（Seed 阶段规划）

graph LR
  PUB[开发者 publish] --> SCAN[静态扫描]
  SCAN --> UT[单元测试]
  UT --> RT[实时性回归<br/>XiTest HIL]
  RT --> SEC[安全审计]
  SEC --> HUMAN{需要人工?}
  HUMAN -->|Community| PUBD[上架]
  HUMAN -->|Verified/Official| REVIEW[人工审核]
  REVIEW --> SIGN[签名颁发]
  SIGN --> PUBD
  PUBD --> MON[上架后监控]

  class PUB xyEnd
  class SCAN,UT,RT,SEC xyL3
  class HUMAN xyWarn
  class REVIEW xyL4
  class SIGN xySuccess
  class PUBD,MON xyL2

9. 演进路线 · 四阶段里程碑

阶段	时间窗口（规划）	技术里程碑
Seed	2026 Q1–Q2	XVST v0.1 协议定稿 · Runtime 原型 · SDK MVP · 内部 3–5 个种子插件
Growth	2026 Q3–Q4	Marketplace 上线 · 三级认证体系投运 · 开发者 ≥ 500 · 插件 ≥ 200
Scale	2027–2028	跨芯片架构（xidsp-d3/d4 + 第三方 DSP）· 开发者 ≥ 10,000 · 插件 ≥ 2,000
Ecosystem	2029+	Y5 GMV 目标 3 亿+ · 5,000 款插件 · 50,000 开发者 · 行业标准级协议

上述里程碑为规划目标，实际进度以各阶段正式发布的 roadmap 为准。

10. 关键技术风险与对策（规划）

风险	概率（规划评估）	影响	对策
协议 Breaking Change 导致生态分裂	中	严重	ABI 稳定性策略 + 6 个月公告期
车规认证路径超预期	中	中	与认证机构早期对齐 · Verified 先于 Official 落地
冷启动乏力（开发者不足）	高	严重	开发者激励基金 · 校企合作 · 官方种子插件
恶意插件事件	低	严重	沙箱 + 认证 + 上架后监控 + 一键下架
与竞品协议兼容压力	中	中	保持开放态度 · 提供 Steinberg VST / LV2 桥接适配器（规划）

11. 验收

五子系统边界清晰、协同关系完整
.xvst 包格式、manifest schema 规划定稿
认证三级 + 分成 7:2:1 技术落点对齐产品概述
Seed 阶段原型验证（2026 Q1–Q2）
Growth 阶段 Marketplace 上线（2026 Q3–Q4）
正式版（v1.0）发布时本文升级为正式 Spec

附录 A · 术语表

术语	含义
XVST	XIYIN Virtual Studio Technology · 协议 + 技术栈统称
`.xvst`	插件包格式（ZIP 归档）
Runtime	宿主进程内的插件运行时
Marketplace	插件商店 · 发布 + 支付 + 评分
Community / Verified / Official	三级认证等级

附录 B · 参考

XiVST 产品概述（规划版）
XiVST PRD v0.1（规划版）
XiVST 产品规格书 Spec（规划版）
Xisound 产品矩阵 V1.1
上游战略源：AlgoDepartment/06_docs/converttool/ref/doc/曦音-开发者生态战略.html（内部 · 2356 行）

tech-arch.md · D2-P10-TECH-001 · v0.1 规划版 · 2026-05-05 · Xisound AlgoDepartment

XiVST 技术架构设计（规划版）

XiVST 技术架构设计（规划版）

1. 总体架构

1.1 五子系统视图

1.2 与 Xisound 全栈的集成位置

2. 子系统一：XVST 协议层

2.1 .xvst 包格式（规划 v0.1）

2.2 manifest.json 核心字段（规划）

2.3 ABI 稳定性策略（规划）

3. 子系统二：开发者 SDK

3.1 SDK 语言矩阵（规划）

3.2 C++ SDK 骨架（规划）

3.3 脚手架 CLI（规划 · 命名 xvst）

4. 子系统三：运行时 Runtime

4.1 Runtime 职责边界

4.2 沙箱层级（规划）

4.3 性能目标（规划 · 非承诺）

5. 子系统四：Marketplace

5.1 后端服务组成（规划）

5.2 发布流水（规划）

5.3 分成与结算（规划框架 · 见 pricing.md 详解）

6. 子系统五：三级认证

6.1 认证等级定义

6.2 Verified 认证核心项（规划清单）

6.3 Official 认证额外项（规划）

7. 安全模型

7.1 威胁模型（规划识别）

7.2 隐私与数据边界（规划）

8. 开发流水线 CI / CD（规划）

8.1 开发者本地流程

8.2 平台 CI 流水（Seed 阶段规划）

9. 演进路线 · 四阶段里程碑

10. 关键技术风险与对策（规划）

11. 验收

附录 A · 术语表

附录 B · 参考

2.1 `.xvst` 包格式（规划 v0.1）

2.2 `manifest.json` 核心字段（规划）

3.3 脚手架 CLI（规划 · 命名 `xvst`）