建议补齐 HF 模型卡元数据(config.json 标准化 + README frontmatter),并补充两个板端已知问题说明

#1
by inoryQwQ - opened

1. config.json 不符合 HF 模型卡规范

当前 config.json 只有 7 个自定义字段,缺少 HF 标准字段,模型页不会正确渲染
license / pipeline / tags / language。建议补齐为:

{
  "model_type": "keyword-spotting",
  "pipeline_tag": "audio-classification",
  "library_name": "axengine",
  "tags": [
    "keyword-spotting",
    "wake-word",
    "audio-classification",
    "axera",
    "ax650",
    "ax630c"
  ],
  "license": "apache-2.0",
  "language": ["en"],
  "source": "openWakeWord",
  "target_hardware": ["AX650", "AX630C"],
  "runtime": "axengine",
  "sample_rate": 16000,
  "default_threshold": 0.5,
  "mel_backend": "numpy"
}

license 请按仓库实际授权确认(openWakeWord 本体为 Apache-2.0)。

2. README.md 缺少 YAML frontmatter

README 顶部没有 frontmatter,HF 模型卡不会展示标签/许可证。建议在首行加入:

---
language:
- en
license: apache-2.0
pipeline_tag: audio-classification
tags:
- keyword-spotting
- wake-word
- axera
- ax650
- ax630c
---

3. 两个板端实测发现(可选,供文档/模型改进参考)

  • melspectrogram.axmodel 在 AX650/AX630C 板上输出全零:NPU 定点无法表达
    mel 前端的动态范围,config.json 默认 mel_backend=numpy 是正确的选择。
    建议在 README 中注明"mel 请使用 CPU numpy/C++ 实现,不要直接跑
    melspectrogram.axmodel",避免用户误用。
  • hey_rhasspy / weather 的 NPU 分类器在真实触发窗口精度退化
    峰值窗口实测仅 0.005 / 0.79;用 TTS 唤醒词正样本扩展校准集后恢复到
    0.97 / 1.00(alexa/mycroft/timer 保持 1.0)。相关修复与校准音频生成脚本
    见 GitHub PR:https://github.com/AXERA-TECH/openWakeWord.AXERA/pull/1
    (含 timer 在 AX620E/NPU2 下 2D Softmax 需 U16 的编译修复)。

👍👍Thanks!!!

HY-2012 changed discussion status to closed

Sign up or log in to comment