建议补齐 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