XiForge 培训材料 v1.0
XiForge 培训材料 v1.0
摘要
本文档定义 XiForge 开发者平台完整培训体系：L1 新手上手（免费在线 1 天）、L2 深度应用工坊（收费 2-3 天）、L3 架构师认证（定制 5-10 天）+ 三个专题工坊（CodeGen 模板开发 / UIEditor 高级定制 / IDM 源码二次开发）。 目标读者：Tier1 算法工程师 / OEM 工具工程师 / UI 设计师 / 架构师 / IDM 客户研发团队。每级考核合格颁发 XiForge Certified Engineer 证书。
适用对象
- Tier1 算法工程师 / 应用工程师
- OEM / 主机厂 UI 设计师 + 工具工程师
- IDM 客户研发 / 架构团队
- Xisound 内部新员工 Onboarding
1. 培训体系总览
1.1 三级课程 + 三大工坊
graph TB
L1[L1 · 新手上手<br/>1 天 · 免费在线]
L2[L2 · 深度应用工坊<br/>2-3 天 · 收费现场]
L3[L3 · 架构师认证<br/>5-10 天 · 定制]
W1[工坊 A · CodeGen 模板开发<br/>Handlebars + AST]
W2[工坊 B · UIEditor 高级定制<br/>品牌化 + 控件扩展]
W3[工坊 C · IDM 源码二次开发<br/>Electron + Vue 深度]
L1 --> L2
L2 --> L3
L2 -.推荐.-> W1
L2 -.推荐.-> W2
L3 -.推荐.-> W3
class L1 xyL2
class L2 xyL3
class L3 xyL4
class W1,W2,W3 xyL51.2 等级对应能力
| 等级 | 能力描述 | 目标用户 |
|---|---|---|
| L1 | 能用 CodeGen 生成算法骨架 · 能拖拽搭简单 UI · 能用私有仓库 | 新工程师 |
| L2 | 能深度调优算法模板 · 能品牌化 UI 面板 · 能配审批流 | 应用工程师 / UI 设计师 |
| L3 | 能设计工具链架构 · 能评估 IDM 授权 · 能带队整合 | 架构师 / 项目 Lead |
| 工坊 | 单点深度（模板 / UI / 源码） | 对应岗位专家 |
2. L1 · 新手上手（1 天 · 免费在线）
2.1 课程目标
完成本课后学员能： - 安装 XiForge 并激活许可 - 用 CodeGen 从模板生成第一个算法骨架 - 用 UIEditor 拖拽搭建 5 控件调音面板 - 应用品牌主题 - 连接 XiStudio 加载面板 - 发布到私有仓库
2.2 课程大纲（8 学时）
| 时段 | 主题 | 形式 | 产出 |
|---|---|---|---|
| 09:00-10:00 | XiForge 概览 + 双子系统 | 讲授 | 理解 CodeGen + UIEditor 定位 |
| 10:00-11:30 | CodeGen 实战（fx-eq 模板） | 动手 | 生成 MyBassBoost 算法 |
| 11:30-12:00 | Validate + Compile Check | 动手 | 校验通过 |
| 13:00-15:00 | UIEditor 实战（5 控件 + 品牌主题） | 动手 | 完整调音面板 |
| 15:00-16:00 | XiStudio 联动 + 加载面板 | 动手 | 热重载验证 |
| 16:00-17:00 | 私有仓库初体验 + PR | 动手 | 第一个 PR |
| 17:00-18:00 | Q&A + 考核 | 互动 | 选择题 + 实操 |
2.3 前置条件
- 基本 C 语言知识
- 基本音频 DSP 概念
- 笔记本 + XiStudio Community 或 Enterprise Trial
- 无需：Electron / Vue 经验
2.4 考核
- 选择题：10 道（70% 通过）
- 实操：独立完成一次"生成算法 → 搭面板 → 发布"
- 证书：XiForge Certified Engineer · Level 1
3. L2 · 深度应用工坊（2-3 天 · 收费现场）
3.1 课程目标
完成本课后学员能： - 深度调优 CodeGen 模板（参数空间 / 约束） - 品牌化 UI 面板（主题 / 字体 / Logo / 自定义 CSS） - 配置私有仓库审批流 + Webhook - 使用 AI 辅助生成（v1.1+） - 跨 DSP 型号移植算法 - 诊断常见问题
3.2 课程大纲（3 天 24 学时）
Day 1 · CodeGen 深度
| 时段 | 主题 | 产出 |
|---|---|---|
| 上午 | 模板系统深度 · Handlebars 语法 | 自写一个简化 EQ 模板 |
| 下午 | Tree-sitter 规则 + 跨 DSP 移植实战 | 完成 D1 → D2 迁移 |
Day 2 · UIEditor 深度
| 时段 | 主题 | 产出 |
|---|---|---|
| 上午 | 主题系统 + 品牌化 · 参数绑定原理 | 一个品牌专属 UI 原型 |
| 下午 | 导出 Electron + XiStudio 面板 · 多设备预览 | 独立客户端生成 |
Day 3 · 协作 + 考核
| 时段 | 主题 | 产出 |
|---|---|---|
| 上午 | 私有仓库审批流 + Webhook 集成 | 完整协作流程演练 |
| 下午 | AI 辅助生成（v1.1+）+ 考核 | 证书 |
3.3 前置条件
- 完成 L1 或同等
- 1 年+ 算法开发 / UI 开发经验
- 自带笔记本 + Enterprise Trial
- 懂 Git 基础
3.4 考核
- 大作业：给定场景（"为 BrandA 客户做专属 3 段 EQ 插件 + 品牌面板"）
- 评分：模板质量 30% + UI 品牌化 30% + 仓库协作 20% + 文档 20%
- 证书：XiForge Certified Engineer · Level 2
3.5 交付形式
- 现场：客户地点 或 Xisound 培训中心
- 规模：6-10 人 / 班
- 语言：中文为主 · 英文按需
4. L3 · 架构师认证（5-10 天 · 定制）
4.1 课程目标
完成本课后学员能： - 设计企业级工具链架构（Xisound 生态 + 客户生态） - 评估 IDM 授权的技术 + 商务价值 - 带队完成 XiForge 定制 + 部署项目 - 设计自定义模板库 / 控件库 - 处理 Linux / CI/CD 集成
4.2 课程大纲（5 天示例）
Day 1-2 · 架构与生态
- Xisound 全栈架构（XiStudio + XiAlgo + XiDSP + XiAmp + XiForge）
- XiForge 在客户工具链中的角色
- IDM 授权技术 + 商务评估
Day 3 · 自定义扩展
- 自研 CodeGen 模板库
- 自研 UIEditor 控件库（v1.5+ Vue 组件）
- 私有仓库协议深度
Day 4 · CI/CD 集成
xy-forgeCLI 在 Jenkins / GitLab CI 的集成- 自动化测试 + 发布流程
- 多团队协作模式
Day 5 · IDM 源码与商务
- XiForge 源码架构解读
- NRE 项目管理
- 与 Xisound 商务团队对接
4.3 前置条件
- 完成 L2
- 5 年+ 工具链 / 架构经验
- NDA 签署（涉及 IDM 细节）
4.4 交付形式
- 完全定制 · 2-6 人小班
- 可延伸长期技术顾问合同
5. 专题工坊
5.1 工坊 A · CodeGen 模板开发（3 天）
适合对象
Tier1 算法工程师 · 需要自定义算法模板。
课程大纲： - Day 1：Handlebars 语法 + manifest.json Schema - Day 2：Tree-sitter AST 编写规则 - Day 3：模板发布到私有仓库 + 审批流
5.2 工坊 B · UIEditor 高级定制（2 天）
适合对象
OEM / 主机厂 UI 团队 · 需要深度品牌化。
课程大纲： - Day 1：主题系统深度 + 自定义 CSS - Day 2：v1.5+ 自定义 Vue 组件开发预告
5.3 工坊 C · IDM 源码二次开发（5 天 · 限 IDM 客户）
限 IDM 签约客户
涉及 Electron + Vue 源码，仅限签 IDM L3+ 授权客户。
课程大纲： - Day 1：XiForge 源码仓库结构 · Electron + Vue 架构 - Day 2：CodeGen Backend 源码解读（Fastify + Tree-sitter） - Day 3：UIEditor Backend 源码解读（Fabric.js + 状态树） - Day 4：客户自定制实战 - Day 5：发布流程 + 持续同步 Xisound 上游
6. 师资
6.1 讲师来源
- L1：FAE 一线工程师（3-5 年经验）
- L2：资深 FAE + 产品经理（5-10 年经验）
- L3 / 工坊：Xisound 研发 Director + 外部顾问
6.2 讲师认证
- Xisound 内部讲师需内训 + 试讲 + 3 次学员反馈 4.5+/5
- 外部顾问签 NDA + 保密协议
7. 培训资源
7.1 教材
- 《XiForge 实战手册》—— L1/L2 教材（PDF + 配套示例项目）
- 《XiForge 架构师指南》—— L3 教材（Enterprise+ 限定）
- 《CodeGen 模板开发手册》—— 工坊 A
- 《UIEditor 高级定制指南》—— 工坊 B
- 《XiForge IDM 开发者指南》—— 工坊 C（限发）
7.2 实物配套
- L1 / L2 学员每人提供 Enterprise Trial License 30 天
- L3 / 工坊：完整 IDM 源码包（签约客户）
- 云端 Playground 环境（无需本地安装即可练习）
8. 定价与排课
8.1 定价框架
| 课程 | 定价方向 | 备注 |
|---|---|---|
| L1 | 免费 | Community / 营销用 |
| L2 | 每学员收费 · 中等 | 含 Enterprise Trial |
| L3 | 定制 · 项目打包 | 通常与 Enterprise / IDM 合同捆绑 |
| 工坊 A | 每学员收费 · 中等 | 含模板库访问 |
| 工坊 B | 每学员收费 · 中等 | 含 Vue 组件 Demo 库 |
| 工坊 C | 项目打包 · 高 | 限 IDM 客户 |
具体价格
以正式 Quotation 为准。教育 / 高校 / 开源社区可谈显著优惠。
8.2 排课周期
- L1：每月 1 次在线
- L2：每季度 1 次公开班 + 客户内训
- L3：项目级预约（2-4 周准备）
- 工坊：半年 1 次 A / B 公开班，工坊 C 仅 IDM
9. 反馈与持续改进
9.1 课后反馈
- 匿名问卷（5 题）：讲师 / 难度 / 动手 / 推荐 / 建议
9.2 持续改进
- 季度复盘反馈
- 每年 Q1 更新教材
- 讲师评分 < 4.0/5 → 辅导或替换
10. 附录
10.1 关联文档
10.2 报名方式
- 邮箱：
training@xisound.com - 官网：
www.xisound.com/training - Enterprise+ / IDM：CRM 预约
- 新员工：HR 内部系统自动排期
10.3 版本历史
| 版本 | 日期 | 要点 |
|---|---|---|
| v1.0 | 2026-05-05 | 首版 · 三级课程 + 三工坊 + 师资 + 定价 + 反馈 |
training.md · D2-P9-MAN-006 · v1.0 · 2026-05-05 · Xisound 交付中心 · FAE 培训组