Fix HF README: add YAML frontmatter, update tree/C++ section to prebuilt-only layout

README.md

@@ -1,3 +1,16 @@
+---
+language:
+- en
+license: apache-2.0
+pipeline_tag: audio-classification
+tags:
+- keyword-spotting
+- wake-word
+- axera
+- ax650
+- ax630c
+---
+
 # openWakeWord.AXERA
 
 [openWakeWord](https://github.com/dscripka/openWakeWord) 语音唤醒 AXERA 推理 demo。
@@ -5,7 +18,7 @@
 ## 功能
 
 - 支持 AX650 和 AX630C；
-- 支持 Python 和 C++ 板端推理；
+- 支持 Python SDK 和 C++ 预编译二进制；
 
 ## 目录结构
 
@@ -16,20 +29,25 @@ OpenWakeWord.AXERA/
 │   └── 630C/         # AX630C axmodel
 ├── config/           # STFT/mel 权重
 ├── audio/openwakeword/
-├── scripts/          # Python 推理代码
-├── cpp/              # C++ 源码、编译和运行脚本
+├── scripts/          # Python SDK
+├── cpp/
+│   ├── bin/          # C++ 预编译二进制（ax650 / ax630c）
+│   └── run_*.sh      # 板端运行脚本
 └── README.md
 ```
 
+C++ 源码、构建脚本与 BSP 下载脚本在 GitHub 仓库：
+<https://github.com/AXERA-TECH/openWakeWord.AXERA>
+（HuggingFace 仅发布预编译产物。）
 
 ## Python
 
 ```bash
-创建虚拟环境
+# 创建虚拟环境
 conda create -n OpenWakeWord python=3.10
 conda activate OpenWakeWord
 
-安装 [pyaxengine](https://github.com/AXERA-TECH/pyaxengine/releases/latest)：
+# 安装 pyaxengine（https://github.com/AXERA-TECH/pyaxengine/releases/latest）
 pip install axengine-x.x.x-py3-none-any.whl
 
 pip install -r requirements.txt
@@ -56,67 +74,38 @@ python scripts/openwakeword_ax630c.py \
   --output outputs/openwakeword_ax630c.json
 ```
 
-## C++
-
-### 编译环境
-
-AX650 和 AX630C 共用 Arm GNU 9.2 AArch64 交叉编译器：
-
-<https://developer.arm.com/-/media/Files/downloads/gnu-a/9.2-2019.12/binrel/gcc-arm-9.2-2019.12-x86_64-aarch64-none-linux-gnu.tar.xz>
-
-```bash
-mkdir -p cpp/toolchains
-wget -P cpp/toolchains \
-  https://developer.arm.com/-/media/Files/downloads/gnu-a/9.2-2019.12/binrel/gcc-arm-9.2-2019.12-x86_64-aarch64-none-linux-gnu.tar.xz
-tar -xf cpp/toolchains/gcc-arm-9.2-2019.12-x86_64-aarch64-none-linux-gnu.tar.xz \
-  -C cpp/toolchains
-```
-
-BSP SDK 下载地址：
-
-| 平台 | BSP SDK |
-| --- | --- |
-| AX650 | <https://github.com/ZHEQIUSHUI/assets/releases/download/ax_3.6.2/msp_50_3.10.2.zip> |
-| AX630C | <https://github.com/ZHEQIUSHUI/assets/releases/download/ax_3.6.2/msp_20e_3.0.0.zip> |
+## C++（预编译二进制）
 
-下载并整理到 `cpp/toolchains/`：
-
-```bash
-bash cpp/download_bsp.sh all
-```
+板端直接使用 `cpp/bin/` 下的预编译二进制，无需交叉编译。
 
-### 交叉编译
+AX650：
 
 ```bash
-export TOOLCHAIN_ROOT="cpp/toolchains/gcc-arm-9.2-2019.12-x86_64-aarch64-none-linux-gnu"
-
-bash cpp/build_ax650.sh
-bash cpp/build_ax630c.sh
-```
-
-编译结果：
-
-```text
-cpp/bin/openwakeword_ax650
-cpp/bin/openwakeword_ax630c
+LD_LIBRARY_PATH=<BSP_LIB_DIR> cpp/bin/openwakeword_ax650 \
+  --models-dir models/650 \
+  --mel-weights config/openwakeword_mel_weights.bin \
+  --audio audio/openwakeword/alexa_test.wav \
+  --threshold 0.5
 ```
 
-### 板端批量测试
-
-AX650：
+AX630C：
 
 ```bash
-THRESHOLD=0.5 bash cpp/run_batch_openwakeword_ax650.sh
+LD_LIBRARY_PATH=<BSP_LIB_DIR> cpp/bin/openwakeword_ax630c \
+  --models-dir models/630C \
+  --mel-weights config/openwakeword_mel_weights.bin \
+  --audio audio/openwakeword/alexa_test.wav \
+  --threshold 0.5
 ```
 
-AX630C：
+也可以使用仓库内的批量运行脚本：
 
 ```bash
-THRESHOLD=0.5 bash cpp/run_batch_openwakeword_ax630c.sh
+THRESHOLD=0.5 bash cpp/run_batch_openwakeword_ax650.sh   # AX650
+THRESHOLD=0.5 bash cpp/run_batch_openwakeword_ax630c.sh  # AX630C
 ```
 
 结果分别写入 `outputs/cpp_ax650_batch/` 和 `outputs/cpp_ax630c_batch/`。
-
 详细 C++ 说明见 `cpp/README.md`。
 
 ## 参考
@@ -133,4 +122,3 @@ THRESHOLD=0.5 bash cpp/run_batch_openwakeword_ax630c.sh
   （峰值窗口实测 0.005 / 0.79）；本版本改用包含 TTS 唤醒词正样本的校准集
   （高响应窗口采样），峰值窗口得分恢复到 0.97 / 1.00（alexa/mycroft/timer 保持 1.0）。
   校准与编译配方见 https://github.com/AXERA-TECH/openWakeWord.AXERA/pull/1 。
-