MIGRATED

XiVST 用户手册（规划版）

摘要

本规划版从三个典型视角介绍 XiVST（羲音生态） 的使用方式：① 开发者（上传并售卖 .xvst 插件）· ② 调音师 / 工作室（在 XiStudio 中下载并应用插件）· ③ Tier1 / OEM 采购方（批量采购认证插件并集成到车型）。 所有操作步骤、界面示意均为 v0.1 规划，公开发布后以正式 UI / 文档为准。

规划版说明

• 截图 / URL / 命令行参数为规划占位
• Seed 阶段（2026 Q1–Q2）仅内部可见 · Growth 阶段（2026 Q3）对外公开
• 任何与真实界面差异以正式版手册为准

---

1. 三视角总览

graph LR
  DEV[👨‍💻 开发者<br/>Developer / Studio] --> MKT[🏪 Marketplace]
  TUN[🎚 调音师 / 工作室<br/>Tuning Engineer] --> MKT
  T1[🏭 Tier1 / OEM<br/>采购方] --> MKT
  MKT --> CAR[🚗 车载声学系统<br/>XiDSP + XiAmp]

  class DEV xyL4
  class TUN xyL2
  class T1 xyL5
  class MKT xyL3
  class CAR xyL1

视角	核心动作	主要工具
开发者	开发 + 上传 + 获得分成	xvst CLI / XiForge / 开发者后台
调音师	搜索 + 试听 + 购买 + 调参	XiStudio 内置 Marketplace 面板
Tier1 采购方	批量采购 + 认证校验 + 集成	企业后台 + XiForge / XiTest

---

2. 视角 ① · 开发者

2.1 前置准备（规划）

• 注册 Xisound 开发者账户（邮箱 + 企业实名 / 个人实名）
• 完成基础培训认证（Community L1 · 免费 · 规划 ≥ 2 小时课程）
• 安装 SDK + CLI：

# 规划命令（实际命令以 Seed 阶段正式发布为准）
curl -fsSL https://sdk.xisound.com/install.sh | bash
xvst --version   # 期望输出：xvst 0.1.x

2.2 创建与打包插件（规划五步）

# 1) 从模板创建项目
xvst init my-plugin --template=tuning-eq
cd my-plugin

# 2) 编辑 manifest.json（填写 id / name / 参数 / 目标架构）
$EDITOR manifest.json

# 3) 编译（规划 · 可选指定单一目标或 all-targets）
xvst build --target=x86_64-linux

# 4) 本地金样回归（Seed+）
xvst test --golden=./test/golden.wav

# 5) 打包为 .xvst 并自签
xvst pack
xvst sign --cert=community

2.3 上传与认证（规划）

# 规划 · 上传至 Marketplace
xvst publish --market=https://market.xisound.com \
             --target-cert=verified

上传后流程（规划）

1. 平台自动扫描（~ 分钟级）· 结果进开发者后台
2. Verified 认证进入人工审核队列（规划 ≤ 5 工作日）
3. Official 认证额外需 Xisound 官方联审（规划 ≤ 15 工作日）
4. 通过后自动上架 · 开发者后台可开启「可购买」

2.4 开发者后台（规划）

模块	功能（规划）
📊 仪表盘	下载数 / 销量 / 评分 / 分成收入趋势
📦 插件管理	版本列表 / 上架状态 / 发布新版本
💬 评论管理	查看 + 回复用户评论
💰 收入明细	7:2:1 分成记录 · T+15 结算
🔔 消息中心	审核结果 / 系统公告 / 事件推送
⚙️ 账户设置	Webhook / OAuth Client / 支付账户

2.5 最佳实践清单（规划）

• ✅ 清单 (manifest.json) 内所有字段填写齐全 · license 不留空
• ✅ 提供 README.md + 参数说明 + 示意图（会直接展示在商品页）
• ✅ 目标架构选 ≥ 2 个（提升潜在购买者覆盖）
• ✅ 版本发布走 SemVer · PATCH 只修 bug · MINOR 才加新功能
• ❌ 避免在 manifest.json 声明未实现的参数（Verified 审核会不通过）
• ❌ 避免硬编码网络地址 / 写本地非临时目录（沙箱拒绝）

---

3. 视角 ② · 调音师 / 工作室

3.1 在 XiStudio 内打开 Marketplace 面板（规划）

1. 打开 XiStudio IDE（规划 Growth 阶段起内置 Marketplace 入口）
2. 左侧边栏点「🏪 Marketplace」
3. 登录 Xisound 账户（或注册新账户）

3.2 搜索与筛选（规划）

规划的搜索与筛选维度：

• 🔤 关键词：名称 / 标签 / 作者
• 🏷 类别：tuning / fx / nr / ai / spatial / voice / ktv 等
• 🛡 认证等级：Community / Verified ✓ / Official ◆
• 🎚 目标架构：xidsp-d3 / x86_64-linux / aarch64-linux 等
• 💰 价格档：Free / Indie / Pro / Enterprise

3.3 试听与购买（规划）

• 🔊 试听（Preview）：规划提供官方示例音频 A/B 对比（输入 vs 输出）
• 🛒 购买：规划支持微信 / 支付宝 / 对公转账 · 企业客户可走合同 + 发票流程
• ⬇️ 安装：购买后一键安装到当前 XiStudio 工程 · 自动下载匹配架构

3.4 在工程中使用（规划）

# 规划 · XiStudio 工程配置示例（yaml 表达）
pipeline:
  - type: xvst
    plugin_id: "com.example.tuning.warmth"
    version: "1.2.0"
    params:
      drive: 0.35
      tone: 0.55
  - type: xvst
    plugin_id: "com.xisound.eq.parametric"
    version: "2.0.1"
    params:
      bands:
        - freq: 80, q: 0.7, gain: -2.0
        - freq: 2500, q: 1.2, gain: +1.5

3.5 评分与反馈（规划）

• ⭐ 评分 1–5 颗 · 匿名允许 · 规划不允许在购买前评分
• 💬 评论字段：使用场景 / 车型 / 效果主观感受
• 🐛 缺陷上报：直接通过开发者后台推送给作者 · 规划 48h 平均响应

---

4. 视角 ③ · Tier1 / OEM 采购方

4.1 企业账户注册与开票（规划）

• 企业实名 + 对公银行信息（规划）
• 采购方可指定 ≥ 2 个联系人（采购 + 技术）
• 合同 + 发票流程（规划 · 具体合规细节由商务中心对接）

4.2 批量采购与授权（规划）

档位	授权范围（规划）	典型场景
Pro 档	按项目 / 车型号授权	量产后装 · 中小批量
Enterprise 档	OEM 前装 · 多车型批量 · 自定义 Royalty	主机厂前装

规划采购流程

1. 采购方提出清单（包含插件 id + 目标车型 + 预期产量）
2. 平台 / 开发者 / 芯片伙伴三方协商（涉及 7:2:1 分成条款）
3. 签订合同（可含定制需求：联合品牌 / 定制化参数区间）
4. 授权密钥下发（规划 · HSM 硬件令牌或网络许可服务）

4.3 车规认证校验（规划）

Tier1 重点关注 Verified ✓ / Official ◆ 级别插件：

• ✅ 资源声明核对：CPU / RAM / 栈 / 堆占用在车规预算内
• ✅ 实时性证据：XiTest HIL 回归报告 · 无 xrun / 无死锁
• ✅ SBOM 与许可证：第三方依赖清单 + 商用兼容性
• ✅ 长期维护承诺：Official 级规划 ≥ 7 年安全补丁

4.4 集成到前装工程（规划）

graph LR
  PUR[Tier1 采购] --> LIC[授权密钥]
  LIC --> SB[SBOM + 源证]
  SB --> IDE[XiStudio 前装工程]
  IDE --> HIL[XiTest HIL 回归]
  HIL --> OEM[OEM SOP 集成]

  class PUR xyEnd
  class LIC xyWarn
  class SB xyL3
  class IDE xyL4
  class HIL xyL2
  class OEM xySuccess

4.5 企业专属支持（规划）

服务	Pro	Enterprise
工单响应 SLA	规划 24h	规划 4h
专属客户经理	—	✅
现场联合调试	按次计费	规划 N 人日/年
定制化 NRE	走合同	走合同

---

5. 常见工作流

5.1 开发者：从零发布第一款插件

1. 注册账户 → 通过培训认证
2. xvst init 创建项目
3. 开发 + 本地测试
4. xvst pack + xvst sign
5. xvst publish 提交 Community 级（免审）
6. 收到「上架成功」Webhook → 开启可购买
7. 月底收到第一笔分成（T+15 到账）

5.2 调音师：为一台车上线一套音效

1. 打开 XiStudio 工程
2. 在 Marketplace 搜 Verified ✓ tuning
3. 试听对比 3 款 · 购买最合适的
4. 装载到工程 · 通过真车回路调试
5. 导出量产固件

5.3 Tier1：某车型前装选用 Official 级插件

1. 采购经理提交清单（含目标车型 + 年产量）
2. 商务中心对接开发者 + 芯片伙伴三方合同
3. 技术验收：XiTest HIL 回归报告 + SBOM
4. 前装工程集成 · SOP
5. 长期：OTA 更新管道走官方 Official 级更新包

---

6. 安全与隐私提示

• 🔒 所有插件在 Runtime 沙箱内运行 · 默认 无网络访问
• 🔒 插件不得访问用户 PII · 车主信息等
• 🔒 签名校验失败的插件 Runtime 直接拒绝加载
• 🔒 遇到可疑插件行为可直接从开发者后台 / security@xisound.com 上报
• 🔒 所有采购、结算、签名数据走 TLS 1.3 + 平台签名公钥

---

7. 疑难排查（规划 FAQ 速览 · 详见 faq.md）

现象	可能原因	建议动作（规划）
xvst pack 失败 · 提示 manifest 字段缺失	manifest.json schema 未通过	跑 xvst validate 查看缺失字段
插件在 XiStudio 里加载失败	架构不匹配	检查 compat.targets 是否包含目标机
认证长时间挂起	队列高峰 / 审核退回	查开发者后台「审核反馈」
购买后下载失败	网络 / 区域访问	更换区域节点（Growth 阶段起多节点）
参数改了无效果	参数 id 不匹配	对照 manifest.json 的 params[].id

---

8. 验收

• 三视角边界清晰、动作流程完整
• 开发者五步上传流程对齐 tech-arch / api 的规划
• Tier1 采购路径对齐商务中心职责（sales-sop）
• Seed 阶段完成首批手册截图补录
• v1.0 GA 发布时本文升级为正式用户手册

---

附录 A · 参考

• XiVST 产品概述（规划版）
• XiVST PRD v0.1（规划版）
• XiVST 技术架构（规划版）
• XiVST API 规范（规划版）
• XiVST 常见问题 FAQ（规划版）
• 销售流程 SOP

---

user-manual.md · D2-P10-MAN-001 · v0.1 规划版 · 2026-05-05 · Xisound AlgoDepartment + Delivery