跳转至
XiStudio · FAQ

XiStudio 常见问题 v1.0

6 大类 · 50+ 个问答 · 自助排障先行
文档编号：D2-P1-MAN-005 · 版本：v1.0 · 发布：2026-05-05
先查 FAQ · 再提工单 · 省时省力
6
问题分类
50+
问答条目
7x24
社区支持

XiStudio 常见问题 FAQ v1.0

摘要

本文档汇总 XiStudio 用户最常遇到的 50+ 个问题，按 安装激活 / 编辑仿真 / 编译烧录 / 授权商务 / 集成开发 / 协作运维 六大类组织。 提工单前请先搜本 FAQ（Ctrl+F）。未覆盖的问题欢迎反馈到 support@xisound.com。

1. 安装与激活

Q1.1 支持哪些操作系统？

  • Windows 10 1809+ / Windows 11（x64）
  • macOS 13+（Apple Silicon / Intel）
  • Linux 预览版：Ubuntu 24.04 x64（v1.3 起）

详见 spec.md §1.2。

Q1.2 最低硬件要求？

  • CPU 4 核 2.0 GHz 起 · 推荐 8 核 3.0 GHz
  • 内存 8 GB 起 · 推荐 16 GB
  • 存储 10 GB · 推荐 50 GB SSD

Q1.3 是否支持 Windows ARM64 / Apple Silicon？

  • Apple Silicon（M1/M2/M3）：✅ 原生支持
  • Windows ARM64：❌ 暂不支持，Roadmap 2028

Q1.4 Community 版和 Pro 版有什么区别？

见 spec.md §4.1 和 one-pager.md §4。简单说： - Community：免费，流图 + 基础算法 + 仿真 - Pro：年订阅，+ 完整 XiAlgo + 硬件烧录 + JTAG 调试

Q1.5 如何离线激活 Pro 版？

  1. 菜单 帮助 → 激活 → 离线模式
  2. 导出 activation-request.xml
  3. 邮件/U 盘发给 support@xisound.com
  4. 收到 activation-response.xml 后导入

Q1.6 激活码丢了怎么办？

登录客户后台 https://portal.xisound.com → 我的订单 → 重新获取激活码。

Q1.7 Enterprise 版如何搭建 License Server？

见 Enterprise 部署指南（签约后提供，内部文档）。简要： - 选择 Windows Server 2019+ 或 Linux（Ubuntu 22.04+） - 安装 xi-license-server 包 - 配置 license-server.yaml 指向 Xisound License Portal - 客户端通过 XISTUDIO_LICENSE_SERVER 环境变量指向内部 URL

Q1.8 安装后启动即崩溃怎么办？

依次尝试： 1. 更新显卡驱动 2. 启动时加参数 --disable-gpu 3. 删除 %APPDATA%/XiStudio/Cache（Windows）或 ~/Library/Application Support/XiStudio/Cache（macOS） 4. 仍不行 → 附上崩溃日志到工单

2. 编辑与仿真

Q2.1 画布卡顿（项目节点超过 300 个）

v1.0 使用 Canvas2D 渲染，大项目性能有限。解决方案： - 短期：拆分子流图（右键 → 打组 → 导出为子流图） - 中期：等待 v1.3（2028 Q2）WebGL 重构

Q2.2 Undo/Redo 不工作

  • 检查是否有插件抢管了 Ctrl+Z（查看 偏好 → 插件 → 快捷键冲突）
  • 升级到 v1.0.2+ 修复了参数绑定场景的偶发 Bug

Q2.3 粘贴节点后参数丢失

已在 v1.0.3 修复。请升级。

Q2.4 仿真结果和上板不一致

  • 首先确认是 Debug 还是 Release 固件（两者都是位精确，但路径可能不同）
  • 确认输入音频采样率与流图一致（默认 48 kHz）
  • 如仍不一致，这是严重 Bug，请立即反馈（这是位精确仿真的核心承诺）

Q2.5 仿真速度慢

  • v1.0 单线程 ≥ 10× 实时率（48 kHz 单通道），多通道成比例下降
  • v1.3 起支持并行仿真（50×）和 GPU 加速

Q2.6 参数滑块拖不动 / 反应延迟

  • 关闭 偏好 → 性能 → 高频采样（启用会实时 120Hz 上报，性能敏感场景关掉）

Q2.7 能否同时打开多个项目？

  • Community：只能 1 个
  • Pro：最多 5 个
  • Enterprise / IDM：无限制

Q2.8 项目文件可以放网盘 / Git 吗？

  • 可以放 Git（.xiproj 是文件夹，内部是 XML/JSON 友好）
  • 强烈建议 把 .xi/ 子目录加到 .gitignore
  • 网盘（OneDrive/iCloud）会导致文件锁冲突，不推荐

Q2.9 团队成员编辑冲突如何解决？

  • Community / Pro 没有协作能力 → 建议 Git 分支工作流
  • Enterprise XiForge：实时协作，类似 Figma，无需手动合并

Q2.10 能否自定义主题 / 快捷键？

  • 主题：v1.1 起支持深色/浅色/跟随系统三选一
  • 快捷键：v1.2 起支持完全自定义，v1.0 暂不支持

3. 编译与烧录

Q3.1 编译报错 dangling output

流图中某个 AudioOutput 节点没有连接输入。检查右下角 问题 面板定位具体节点。

Q3.2 编译报错 sr mismatch

采样率不匹配。常见原因： - 输入源和算法配置的采样率不同 - 两路信号在 Mixer 处汇合时采样率不一致

解决：插入 Resample 节点，或统一全局采样率到 48 kHz。

Q3.3 编译报错 MIPS over budget

目标芯片算力不足。解决方案（按建议顺序）： 1. 降算法复杂度（比如 AEC 从 512 点到 256 点） 2. 降采样率（48 kHz → 32 kHz） 3. 减少通道数 4. 换更强的芯片（D1 → D2 / D3）

Q3.4 找不到 XiFlash 烧录器

  • 检查 USB 线是否正常
  • Win 10：可能要手动装 xi-jtag-driver
  • macOS：可能要在 系统偏好设置 → 安全性 → 通用 里允许

Q3.5 烧录速度慢

  • USB 模式比 UART 快 10 倍以上，优先用 USB
  • 关闭其他占用 USB 的软件（比如手机调试）
  • 目标板与烧录器距离 < 30 cm，避免长线缆

Q3.6 烧录完成但板子没反应

依次检查： 1. 供电正常（LED 亮） 2. 复位正常（按复位键重启） 3. 输入信号正常（示波器测输入） 4. 是否签名校验失败（Debug 构建会提示） 5. 固件里是否有初始化错误（JTAG 连接后看串口日志）

Q3.7 JTAG 调试断不住

  • 确保是 Debug 构建（Release 会优化掉符号表）
  • 目标板上电顺序：先烧录再上电
  • JTAG 线缆版本：v2.0+ 支持高速模式，旧线缆用 v1.0 模式

Q3.8 如何做 CI/CD 自动构建？

见 api.md §7.1 的完整脚本示例。核心：

xistudio lint project.xiproj
xistudio build project.xiproj --config release --output ./artifacts
xistudio simulate project.xiproj --input pink.wav --output result.wav

Q3.9 能否生成 C 代码而不是二进制固件？

  • Pro / Enterprise 版：只能生成二进制
  • IDM 版：可输出 C 源码（需要客户自己用 DSP 编译器继续编译）

Q3.10 支持 OTA 升级吗？

  • v1.0：不支持（只能通过 USB/UART/JTAG 烧录）
  • v1.2（2027 Q4）：支持通过网络 OTA 下发固件

4. 授权与商务

Q4.1 Pro 版年订阅费多少钱？

具体价格以商务中心正式报价为准（见 pricing.md）。

Q4.2 订阅到期后工程文件会被锁吗？

  • 不会：工程文件（.xiproj）始终可读
  • 到期后无法编译 / 烧录 / 使用高级算法，但仍可打开、查看、导出
  • 续费后立即恢复所有功能

Q4.3 可以退款吗？

  • 年订阅首次购买 14 天内无理由全额退款
  • 续订不支持退款（因为享受了完整年度服务）
  • Enterprise / IDM 合同条款为准

Q4.4 能否转让 License 到其他公司？

  • Pro：不允许跨公司转让
  • Enterprise：席位可在同一公司集团内转移，跨公司需 VP 审批
  • IDM：按合同条款

Q4.5 学生有优惠吗？

  • Community 永久免费（学生主力使用）
  • Pro 学生价：高校邮箱注册可享受显著优惠（需验证）

Q4.6 Tier1 / 主机厂通常采购什么版本？

  • 小型工程团队（≤10 人）：Pro 团队版
  • 中大型 Tier1（10-50 人）：Enterprise
  • 战略合作：IDM

详见 pricing.md §5。

Q4.7 Enterprise License 如何管理席位？

  • 通过 License Server Web 后台
  • 管理员可分配 / 回收 / 临时借用席位
  • 支持 SSO 集成（SAML / OIDC）

Q4.8 IDM 拿到的源码可以自由修改吗？

  • 可以修改（合同明确授权范围内）
  • 不可以转授权给第三方
  • 修改版本仍需遵守 Royalty 条款

Q4.9 合同模板去哪里拿？

Pro：无需合同（订阅协议在线签署）。Enterprise / IDM：见 contract-templates.md。

Q4.10 续订可以谈折扣吗？

可以。续订前 60 天，专属客户经理会主动沟通： - 使用率分析 - 续订优惠建议 - 升级 / 降级建议

5. 集成与开发

Q5.1 Plugin SDK 用什么语言？

TypeScript / C# / Python 三选一。详见 api.md §5。

Q5.2 如何测试自己写的 Plugin？

xistudio plugin test ./my-plugin

会在沙箱里加载插件，不影响正式工程。

Q5.3 Plugin 可以访问网络吗？

可以，但需要在 manifest.json 声明 network.http 权限，并由用户在首次加载时确认。

Q5.4 如何把自研算法打包为 XiStudio 可用的算法块？

  1. 用 SDK 继承 AlgoBlock 类
  2. 实现 process(ctx) 方法
  3. 运行 xistudio plugin pack
  4. 见 api.md §5.3 示例

Q5.5 REST API 的 Rate Limit 如何？

  • 默认 100 req/min per user
  • 构建任务 20 tasks/hour per org
  • 超限返回 429 RESOURCE_EXHAUSTED

Q5.6 gRPC API 在防火墙内如何用？

  • 需要打通 mTLS 证书链
  • 企业内网建议使用 gRPC over HTTPS（端口 443）
  • IDM 客户可要求定制端口

Q5.7 能否把 XiStudio 嵌到自家工具里？

  • Enterprise：可通过 REST API 在自家工具里调用
  • IDM：可基于源码做深度嵌入（有合同约束）

Q5.8 可以调用 ChatGPT / 自家 LLM 代替 XiMind 吗？

  • XiMind 桥接层可替换（IDM 版暴露 AIBridge 接口）
  • Enterprise：可配置代理到自家 AI Gateway
  • 替换后不再享受 Xisound 对调音建议质量的保证

Q5.9 SDK 版本与 XiStudio 版本如何对应？

见 changelog.md。简单规则：SDK 1.x ↔ XiStudio 1.x。

Q5.10 插件签名证书哪里申请？

  • 个人开发者：xistudio plugin generate-key 生成自签名（社区可用）
  • 商用分发：向 Xisound 申请正式签名证书（免费）

6. 协作与运维

Q6.1 XiForge 是什么？

Xisound 的云端协作平台（Enterprise+），让多个工程师实时共同编辑同一个 XiStudio 工程，类似 Figma / VS Code Live Share。

Q6.2 XiForge 是否必须联网？

  • 编辑协作：需要联网
  • 离线写作：可离线写，重连后自动同步

Q6.3 数据存储在哪里？

  • Enterprise 私有化部署：客户自己的服务器
  • Enterprise SaaS：Xisound 云（中国 / 新加坡 / 美东三区）
  • 数据加密：传输 TLS 1.3，存储 AES-256

Q6.4 版本历史保留多久？

  • Pro：最多 30 天本地快照
  • Enterprise：云端永久保留（可按合规要求自定义）

Q6.5 如何回滚到历史版本？

视图 → 历史 → 选择版本 → 回滚。回滚本身也是一次新提交，不会丢失当前版本。

Q6.6 License Server 挂了怎么办？

  • 宽限期：断网 72 小时内仍可工作
  • 配置冗余：支持主备 License Server
  • 长时宕机：降级为 Community 级功能

Q6.7 如何升级 License Server？

  • 主备部署：轮流升级
  • 单机：停机升级，提前通知用户

Q6.8 能否审计用户操作？

  • Enterprise：内置审计日志（登录 / 编辑 / 烧录 / License 变更）
  • 支持导出到 SIEM（Splunk / ELK）

Q6.9 数据如何备份？

  • XiForge 云端：自动每日快照 + 7 天保留
  • 本地：建议用户自行定期 Git 提交或 zip 归档

Q6.10 如果 Xisound 倒闭了，客户怎么办？

  • Pro / Enterprise：源码托管（Source Code Escrow）可选服务（付费）
  • IDM：已有源码，可自主维护

7. 其他

Q7.1 从哪里找培训资料？

见 training.md。内容包括： - 入门教程 - 工坊 / 专题课程 - 认证体系

Q7.2 如何成为认证工程师？

  • 参加 Xisound Academy 在线课程
  • 通过考试
  • 官网公示，享受 认证工程师 标识 + 社区徽章

Q7.3 贡献代码 / 文档怎么走？

Q7.4 为什么叫"羲音"？

致敬华夏上古观天制乐的传说——伏羲氏。寓意"从一开始就构建声音的基础规则"。Xisound 英文拼音直译。

Q7.5 哪些产品会和 XiStudio 一起工作？

  • XiDSP（芯片）
  • XiAlgo（算法）
  • XiForge（协作）
  • XiTune（便携调音）
  • XiTest（测试）
  • XiMind（AI）

详见 overview.md §5。

8. 附录

8.1 本文档维护

  • 更新频率：每次 MINOR 版本发布后更新
  • 反馈入口：docs@xisound.com
  • 补充 FAQ：欢迎 PR 到 docs/D2-products/P1-xistudio/faq.md

8.2 关联文档

8.3 版本历史

版本 日期 要点
v1.0 2026-05-05 首版 · 6 大类 50+ 问答覆盖全生命周期

faq.md · D2-P1-MAN-005 · v1.0 · 2026-05-05 · Xisound 交付中心 · 技术文档组