跳转至
Example · L1B Showcase

L1B 级 · 主题重磅文档

简洁渐变 Hero · 所有 MD 规范元素一次展示
作者：AlgoDepartment · 版本：v1.0 · 日期：2026-05-02

L1B 示例 · 主题级文档

本文定位

L1B 是最常用的豪华级别，适用于产品 Datasheet、白皮书、架构总览、规范类文档。 本页同时充当「MD 规范全特性一次演示」——如果本页渲染完美，规范就是可行的。

1. Admonition 八色全家福

note · 注记

中性的笔记内容，适合补充说明。

info · 信息

背景知识、参考资料链接。

tip · 最佳实践

经验之谈：先使用 Community 版熟悉流程再升级 Pro。

success · 验收通过

XiDSP-D2 通过 AEC-Q100 Grade 2 车规认证。

warning · 注意事项

XiDSP-D4 旗舰版需提前 6 个月预订。

danger · 严重警告

芯片流片后不可修改 —— 请务必完成 SignOff 再 Tapeout。

example · 示例

import xi
chain = xi.Chain().add('EQ', bands=10).add('Limiter')

quote · 引用

"伏羲制乐，定五音六律" —— 《史记》

2. 可折叠 Admonition

点击展开 · XiAlgo 六大套件详解
  • XiAlgo-FX：EQ / 动态 / 混响等常规音效
  • XiAlgo-NR：风噪 / 路噪 / ANC
  • XiAlgo-AI：语音增强 / 场景识别
  • XiAlgo-KTV：卡拉 OK 场景链路
  • XiAlgo-Zone：多音区独立播放
  • XiAlgo-3D：沉浸式三维音频

3. 表格

英文名 中文名 层级 定位
XiStudio 羲音工坊 L4 可视化音频算法 IDE
XiForge 羲音锻造台 L4 算法 + UI 双自定义工坊
XiAlgo 羲音算法库 L3 核心 IP 资产（6 套件）
XiDSP 羲音芯 L0 车规级音频 DSP
XiAmp 羲音功放 L1 车载量产功放
XiMind 羲音智脑 L5 云端 AI Agent

4. Mermaid 流程图（Flowchart · 带判断/分支）

最常用的 flowchart

带判断菱形、多分支、子图分组的 flowchart 示范——你在产品/算法文档里 90% 的流程图都能套这个模板。

flowchart TB
    Start([用户启动 XiStudio]) --> Login{已登录?}
    Login -- 否 --> Auth[跳转 XiMind 登录]
    Auth --> Login
    Login -- 是 --> Home[进入工作区]

    Home --> Choose{选择动作}
    Choose -- 新建项目 --> New[选择模板]
    Choose -- 打开项目 --> Open[项目列表]
    Choose -- AI 辅助 --> AI[[XiMind Agent]]

    subgraph Build [编译 & 烧录闭环]
        direction LR
        Compile[编译算法链] --> Target{目标芯片?}
        Target -- XiDSP-D2 --> FlashD2[烧录 D2]
        Target -- XiDSP-D4 --> FlashD4[烧录 D4]
        FlashD2 --> Run((运行 & 采声))
        FlashD4 --> Run
    end

    New --> Build
    Open --> Build
    AI --> Build
    Run --> Report[生成测试报告]
    Report --> End([完成])

    classDef start fill:#E8F4F1,stroke:#5DDECF,stroke-width:2px,color:#1A2332
    classDef decision fill:#FBF4E8,stroke:#D4A574,stroke-width:2px,color:#1A2332
    classDef action fill:#F5F2EA,stroke:#D4A574,stroke-width:2px,color:#1A2332
    classDef agent fill:#F0E6FA,stroke:#9D4EDD,stroke-width:2px,color:#1A2332
    classDef finalNode fill:#D8F0EA,stroke:#2E8D7E,stroke-width:2px,color:#1A2332

    class Start,End,Run start
    class Login,Choose,Target decision
    class Auth,Home,New,Open,Compile,FlashD2,FlashD4,Report action
    class AI agent

4.1 六层产品矩阵（graph TB 模板）

graph TB
    L5["🌐 L5 · XiMind 云端智脑"]:::layer5
    L4["🎨 L4 · XiStudio + XiForge"]:::layer4
    L3["🧩 L3 · XiAlgo 算法资产库"]:::layer3
    L2["🔬 L2 · XiTune + XiTest + XiMic + XiCal + XiProbe"]:::layer2
    L1["🔊 L1 · XiAmp + XiBox"]:::layer1
    L0["💾 L0 · XiDSP + XiCore"]:::layer0

    L5 --> L4 --> L3 --> L2 --> L1 --> L0

    classDef layer5 fill:#F0E6FA,stroke:#9D4EDD,stroke-width:2px,color:#1A2332
    classDef layer4 fill:#FAE8F0,stroke:#C77DFF,stroke-width:2px,color:#1A2332
    classDef layer3 fill:#F5F2EA,stroke:#D4A574,stroke-width:2px,color:#1A2332
    classDef layer2 fill:#FBF4E8,stroke:#E8C9A0,stroke-width:2px,color:#1A2332
    classDef layer1 fill:#E8F4F1,stroke:#5DDECF,stroke-width:2px,color:#1A2332
    classDef layer0 fill:#D8F0EA,stroke:#2E8D7E,stroke-width:2px,color:#1A2332

5. 时序图

sequenceDiagram
    participant User as 👤 调音师
    participant Studio as 🎨 XiStudio
    participant Cloud as 🌐 XiMind
    participant Amp as 🔊 XiAmp

    User->>Studio: 拖拽 EQ 节点
    Studio->>Cloud: 请求 AI 辅助
    Cloud-->>Studio: 返回推荐参数
    Studio->>Amp: 烧录固件
    Amp-->>User: 声场实时反馈

6. Tabs · 多视角代码

import xi

chain = (
    xi.Chain("XiAmp-Pro12")
      .add("EQ", bands=10)
      .add("Dynamics", mode="multiband")
      .add("Limiter", threshold=-1.0)
)
chain.compile(target="XiDSP-D2")

#include <xi/chain.h>

xi_chain_t* chain = xi_chain_new("XiAmp-Pro12");
xi_chain_add_eq(chain, 10);
xi_chain_add_limiter(chain, -1.0f);
xi_chain_compile(chain, XI_TARGET_XIDSP_D2);

chain:
  name: XiAmp-Pro12
  target: XiDSP-D2
  nodes:
    - type: EQ
      bands: 10
    - type: Limiter
      threshold: -1.0

7. 代码块 · 行号 + 高亮

1
2
3
4
5
def mix(left, right, gain=1.0):
    # 输入校验
    assert left.shape == right.shape, "声道形状必须一致"
    # 核心混合
    return (left + right) * gain * 0.5

8. 任务清单

  • 规范 v1.0 正式发布
  • L1A / L1B / L2 三份示例上线
  • Notion 自动同步脚本（v1.1 计划）
  • Mermaid 架构图统一配色包（v1.2 计划）

9. 定义列表

XiStudio
羲音工坊 · L4 开发工具层
可视化音频算法 IDE，提供流图编辑、AI 辅助、编译烧录
XiForge
羲音锻造台 · L4 开发工具层
让客户/合作伙伴打造专属算法与调音工具的双自定义平台

10. 键盘按键 & 行内样式

  • 快捷键保存：Ctrl+S
  • 命令面板：Ctrl+Shift+P
  • 行内代码：XiDSP-D2 的核数是 2
  • 高亮文本 与 删除线 与 上划线

11. 脚注

XiSound 的品牌内核来自伏羲1，命名取"羲"字承载华夏文明"制乐定律"的文化意象。

12. 公式

信号噪声比定义：

\[ SNR_{dB} = 20 \cdot \log_{10}\left(\frac{A_{signal}}{A_{noise}}\right) \]

13. 验收

L1B 页面应满足

  • 顶部有简洁渐变 Hero，包含 label / title / sub / meta
  • 所有 Admonition 呈现为彩色卡片
  • Mermaid 图按三字法典配色渲染
  • Tabs 切换流畅，代码块有复制按钮
  • 表格、定义列表、任务清单样式规整

  1. 伏羲，华夏文明始祖，相传制乐定律、创八卦，详见《史记·补三皇本纪》。 ↩