XiForge 常见问题 FAQ v1.0
XiForge 常见问题 FAQ v1.0
摘要
本文档汇集 XiForge 开发者平台从选型、安装、开发到售后全流程的 40+ 高频问题。目标读者：Tier1 算法架构师 / OEM 工具工程师 / IDM 客户研发团队 / 独立咨询工程师。 FAE 回答客户时可直接引用。条目定期从工单系统 / 展会问答中提炼更新。
查找方式
- Ctrl+F 关键词
- 8 大类快捷跳转见下方目录
- 找不到请联系
support@xisound.com或开工单
1. 选型（Selection）
1.1 我是 Pro 客户，能用 XiForge 吗？
默认不包含。可选方案： - 加购 XiForge Single Add-on（+30% Pro 订阅费 · 1 席位） - 加购 XiForge Pro+ Add-on（+50% Pro 订阅费 · 含 AI 辅助） - 升级到 Enterprise（5 席位起 · XiForge 默认捆绑）
1.2 Enterprise 客户自动有 XiForge 吗？
是。XiStudio Enterprise 订阅默认包含 XiForge（同 N 席位），无需额外付费。
1.3 IDM 客户能拿 XiForge 源码吗？
是。IDM L3 / L4 授权包含 XiForge 完整源码（Electron + Vue + Backend + 工具链），可自托管 / 自修改。
1.4 XiForge 只能和 XiStudio 一起用吗？
- 推荐：与 XiStudio 联动（JSON-RPC 2.0 插件桥）
- 可独立用：CodeGen + UIEditor 完全离线本地运行 · 生成的代码可用于任何 IDE
- 跨 DSP 移植 功能需 XiStudio 编译器支持
1.5 支持非 XiDSP 芯片吗？
- CodeGen 模板：主要为 XiDSP 优化（D1/D2/D3）
- IDM 客户可扩展模板支持自家 DSP
- v1.5+ 规划：官方支持 ADI SHARC / TI C6000 等（通过 XiAlgo 跨后端）
2. 安装（Installation）
2.1 XiForge 要单独下载吗？
- Enterprise / IDM 客户：随 XiStudio 自动安装
- Pro + Add-on 客户：
www.xisound.com/download/xiforge - 离线安装包：企业客户联系商务
2.2 系统要求是什么？
- OS: Windows 10+ / macOS 12+ / Ubuntu 22.04+ (v1.5+)
- CPU: 4 核（推荐 8 核）
- RAM: 8 GB（推荐 16 GB）
- 磁盘: 5 GB（推荐 20 GB · SSD）
- 网络: AI 辅助需稳定 HTTPS
2.3 支持 Linux 吗？
- v1.0 / v1.1：仅 Windows + macOS
- v1.5+（2028 Q2）：Linux 支持（Ubuntu 22.04 + 其他主流发行版）
2.4 能在公司内网离线使用吗？
完全支持： - CodeGen + UIEditor 离线可用 - 私有仓库可在内网 Git Server 部署 - 仅 AI 辅助（XiMind）需联网（可关闭）
3. CodeGen（Code Generation）
3.1 CodeGen 支持哪些算法模板？
v1.0 提供 20+ 官方模板： - FX 类：PEQ / GEQ / DRC / Limiter / Delay / Reverb / Crossover - NR 类：WindNoise / RoadNoise / AEC / CallNR - Spatial：Pan / 3D-Widening / Crossfeed - Dynamic：AGC / Compressor / Gate - Utility：Mixer / Gain / Mute / Fade
3.2 能添加自定义模板吗？
可以。用户模板目录：
- Windows: %APPDATA%/Xisound/XiForge/templates/
- macOS: ~/Library/Application Support/Xisound/XiForge/templates/
- Linux: ~/.config/xisound/xiforge/templates/
格式：Handlebars（.hbs）+ manifest.json + params.schema.json。
3.3 AI 辅助生成靠谱吗？
- v1.0 不启用 AI（2027 Q2）
- v1.1+ 启用：流程 · 置信度打分 · 强制人工 Review 低置信度
- 不替代工程师 · 是加速器
3.4 Tree-sitter 校验规则能关吗？
- 默认启用（质量底线）
- 可关闭：设置 → CodeGen → Advanced → Disable strict check（不推荐，仅研究用途）
3.5 跨 DSP 移植能自动 100% 成功吗？
不能。典型场景： - 80-95% 自动转换（intrinsic / 类型 / 对齐） - 5-20% 需人工确认（定点精度 / 硬件特性差异） - 移植报告会明确标注"哪些需人工"
4. UIEditor（UI Editor）
4.1 能导入 Figma 设计稿吗？
- v1.0 / v1.1：不能直接导入 Figma
.fig文件 - 变通：Figma 导出 SVG / PNG 作为背景参考图
- v2.0 规划：研究 Figma Plugin 导出
.xyui
4.2 能画任意控件吗？
- 20+ 官方控件：Knob / Slider / Spectrum / EQ Curve / VU / Button / Label / Container
- 自定义 Vue 组件：v1.5+ 支持（v1.0 不支持）
- 变通：用 Container + 自定义 CSS + 内嵌 SVG 实现简单定制
4.3 品牌字体怎么嵌入？
- 主题 → 字体 → 上传 → 选 TTF / OTF / WOFF 文件
- 字体嵌入到
.xyui文件（Base64 编码） - 导出 Electron 时自动打包
4.4 UIEditor 能导出到 Web 吗？
- 浏览器预览：
Preview按钮 → 实时 URL（仅本机） - Web 部署：v1.5+ 规划（Vue 3 运行时 + 参数绑定 JS SDK）
- v1.0：主要导出 Electron 独立客户端 / XiStudio 面板
4.5 100 个控件卡吗？
- 目标 ≥ 60 FPS @ 100 控件
- 超过 100 建议：分页 / 虚拟滚动 / 拆成多个 .xyui
5. 私有仓库（Repository）
5.1 支持 GitHub / GitLab 吗？
- 私有仓库基于标准 Git 协议
- 支持 GitHub / GitLab / Gitea / 自建 Git Server
- SSH Key / HTTPS Token 均支持
5.2 大文件怎么办？
- 用 Git LFS（已集成）
- 默认阈值：> 10 MB 自动 LFS
- 适合：模型 / 音频样本 / 大资源
5.3 审批流怎么配？
设置 → 仓库 → 审批规则： - 选指定分支（main / release） - 设必要 Reviewer（1-N 人） - 配 Webhook 通知（钉钉 / 企业微信 / Slack） - 所有操作审计日志留存
5.4 Reviewer 可以批量审查吗？
- 单个 PR → 审查 + 评论 + 批准
- 批量：v1.5+ 规划（Review Queue 视图）
5.5 私有仓库数据安全吗？
- 部署模式：局域网 / 云托管 / 混合（客户选）
- 加密：TLS 1.3 传输 + 客户端 AES-256 本地加密
- 审计：全部关键操作日志 + GDPR 导出
6. AI 辅助（AI Assistance）
6.1 v1.0 有 AI 吗？
没有。v1.0 GA（2027 Q2）不含 AI 辅助。v1.1（2027 Q4）启用 XiMind AI 集成。
6.2 AI Token 怎么算？
- XiMind 订阅包含每月免费额度
- 超出按 Token 阶梯计费
- Enterprise Tier 默认包含合理额度
- Pro+ Add-on 也含 AI 配额
6.3 AI 生成代码的版权谁的？
- 客户 Prompt 输入的创意 / 描述：客户所有
- AI 生成的代码：客户所有（基于 XiMind Terms of Service）
- 模板原有内容：仍遵循 XiAlgo 许可
6.4 AI 能不能离线？
v1.x 不能（XiMind 是云服务）。本地 AI（Edge AI）在 v3.0+ 预研。
6.5 AI 生成有错误怎么办？
- 置信度 < 0.7：系统强制人工 Review
- Review 不通过：开发者手动修改或重新生成
- 严重错误上报：联系 FAE · XiMind 持续优化
7. 车规 / 合规（Automotive & Compliance）
7.1 生成的代码符合车规吗？
- 代码本身：Tree-sitter 规则禁用 malloc / 系统调用，符合 MISRA-C 大部分要求
- 完整车规认证：需客户整项目走 AEC-Q / ISO 26262 流程
- Safety-Ready 模板：v1.5+ 规划（基于 XiAlgo Pro+ 车规包）
7.2 导出的 UI 能用于车机吗？
- 车机导出：v1.5+ 规划（多设备预览）
- v1.0：主要面向桌面 / 调音工程师，不直接部署到车机 HMI
- 变通：导出 Electron + 客户适配为车机 QT / Android
7.3 支持 ISO 26262 开发流程吗？
- 当前：XiForge 是生产力工具，不做功能安全
- 未来：v2.0+ 规划 ASIL-Ready 签名工作流
8. 技术支持 / 售后（Support）
8.1 技术支持 SLA？
| Tier | SLA |
|---|---|
| Pro + Add-on | 48 小时邮件 |
| Enterprise | 24 小时邮件 + 电话 |
| IDM | 8 小时 + 驻场可选 |
8.2 怎么开工单？
- Enterprise / IDM：CRM 系统（签约开账号）
- Pro：
support@xisound.com（注明合同号） - 社群：Discord / 微信（签约后）
8.3 有中文文档吗？
- 核心文档（概述 / 用户手册 / FAQ）中文优先
- API / tech-arch 中英双版
8.4 有培训吗？
详见 training.md： - L1 新手上手（免费在线 1 天） - L2 深度应用工坊（收费 2-3 天） - L3 架构师认证（定制 5-10 天）
8.5 出 Bug 给 Xisound 时要附什么？
- XiForge 版本 + OS
- 问题重现步骤
xiforge-diag-YYYYMMDD.zip（帮助 → 导出诊断包）- 截图 / 视频（若有）
8.6 能安排 FAE 到现场吗？
- Enterprise：每年 1 次免费 · 其余按工日付费
- IDM：按合同（5-20 工日 / 年）
- 差旅 + 住宿另计
9. 其他（Misc）
9.1 XiForge 与 XiStudio 必须同版本吗？
- Patch / Minor：兼容范围大
- Major：强制同步（XiForge v2 对应 XiStudio v2）
9.2 可以把 XiForge 集成到 CI/CD 吗？
可以。通过 xy-forge CLI：
# 在 GitHub Actions / GitLab CI
xy-forge validate src/*.c
xy-forge gen fx-eq --name AutoEQ --target XiDSP-D2
xy-forge repo publish ./dist
9.3 能用于教学吗？
可以。教育 / 高校 / 开源社区可谈显著优惠（见 pricing.md §7）。
9.4 能跟第三方工具集成吗？
- JSON-RPC 2.0 插件协议开放 · 可接 VS Code / JetBrains
- REST API 开放 · 可被任何 HTTP 客户端调用
- CLI 开放 · 可接 CI/CD pipeline
9.5 找不到答案怎么办？
- 邮箱
support@xisound.com - 工单（Enterprise+）
- Discord / 微信社群
- 每季度更新本 FAQ
10. 附录
10.1 FAQ 更新机制
- 每季度 FAE 团队汇总新问题
- 重大事件（新版本 / 新功能 / 新 PCN）即时补充
- v1.0 → v1.1 目标 2026 Q3
10.2 关联文档
- XiForge 产品概述
- XiForge PRD v1.0
- XiForge 产品规格书
- XiForge 用户手册
- XiForge API 文档
- XiForge 定价单
- XiForge 竞品对比
- XiForge 版本日志
- XiForge 培训材料
10.3 版本历史
| 版本 | 日期 | 要点 |
|---|---|---|
| v1.0 | 2026-05-05 | 首版 · 8 大类 40+ 条问答 |
faq.md · D2-P9-MAN-005 · v1.0 · 2026-05-05 · Xisound 交付中心 · FAE 团队