测试

冒烟测试

tests/smoke.py 对一个运行中的 Hub 做端到端测试，覆盖上传、提交、查询、sentences / paragraphs / srt / vtt、word-search、列表、语音理解翻译、LLM 模型列表、实时 token、Sync、Dictation、实时中继和用量。

它会真实调用 AssemblyAI 并产生少量费用，需要 Hub 中至少有一个可用的上游账号。

pip install httpx websockets

# 准备测试音频：任意一段几十秒的语音
ffmpeg -i speech.mp3 -ac 1 -ar 16000 -f s16le speech_16k.raw   # 实时中继用的 16 kHz PCM

HUB=http://localhost:18080 KEY=hub-xxxx python tests/smoke.py speech.mp3 speech_16k.raw

每项输出 [PASS] 或 [FAIL] 及摘要。第二个参数省略时跳过实时中继测试。

WARNING

LLM 网关相关的测试（语音理解、模型列表）在 AssemblyAI 免费账号上会失败，属于预期。部分功能（如主题分类、关键短语）不支持中文音频，脚本默认没有开启。

静态检查

ruff check app --select F,E9,B --ignore B008,B904

手动检查清单

修改控制台后建议：

• 中英文界面各打开一遍所有页面；
• 浅色、深色主题下检查新增元素；
• 在窄屏（手机宽度）下检查布局。