Back to Details

smoke-test

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Smoke Test

冒烟测试

Interactive smoke tests for voxtype. Run after installing a new build to verify core functionality.
为voxtype提供的交互式冒烟测试。在安装新版本后运行，以验证核心功能。

Instructions

操作说明

  1. Read the test procedures from 
    docs/SMOKE_TESTS.md
  2. Use TodoWrite to create a checklist of all test sections
  3. Run each test section in order, marking todos as completed
  4. Report results in a summary table at the end
  1. 从
    docs/SMOKE_TESTS.md
    中阅读测试流程
  2. 使用TodoWrite创建所有测试章节的检查清单
  3. 按顺序运行每个测试章节，标记已完成的待办事项
  4. 在末尾的汇总表格中报告结果

Prerequisites

前提条件

Before starting, verify:
  • voxtype daemon is running: 
    systemctl --user status voxtype
  • Audio device is available
  • Wayland session is active (for wtype/clipboard tests)
开始前，请验证：
  • voxtype守护进程正在运行：
    systemctl --user status voxtype
  • 音频设备可用
  • Wayland会话处于活动状态（用于wtype/剪贴板测试）

Test Sections to Run

需运行的测试章节

Read 
docs/SMOKE_TESTS.md
and execute these test sections:
  1. Basic Verification
  2. Recording Cycle
  3. CLI Overrides
  4. Waybar JSON Output
  5. Single Instance Enforcement
  6. Config Validation
  7. Signal Handling
  8. Rapid Successive Recordings
  9. Service Restart Cycle
阅读
docs/SMOKE_TESTS.md
并执行以下测试章节：
  1. 基础验证
  2. 录制周期
  3. CLI覆盖
  4. Waybar JSON输出
  5. 单实例强制验证
  6. 配置验证
  7. 信号处理
  8. 连续快速录制
  9. 服务重启周期

Results Summary

结果汇总

After running all tests, provide a summary table:
TestResult
Basic verification✓/✗
Recording cycle✓/✗
CLI overrides✓/✗
Waybar JSON✓/✗
Single instance✓/✗
Config validation✓/✗
Signal handling✓/✗
Rapid recordings✓/✗
Service restarts✓/✗
完成所有测试后，提供汇总表格：
测试项结果
基础验证✓/✗
录制周期✓/✗
CLI覆盖✓/✗
Waybar JSON✓/✗
单实例验证✓/✗
配置验证✓/✗
信号处理✓/✗
连续快速录制✓/✗
服务重启✓/✗

Known Issues to Watch For

需要注意的已知问题

  • Broken pipe panic: If piping voxtype output through 
    head
    , may see panic (cosmetic)
  • Language detection: Without speech, Whisper may detect random languages (expected)
  • Empty transcription: Normal when no actual speech is captured
  • Notification icon mismatch: Parakeet binary with Whisper config may show wrong icon
  • 管道破裂恐慌：如果将voxtype输出通过
    head
    管道传输，可能会出现恐慌（仅影响显示）
  • 语言检测：无语音输入时，Whisper可能会检测到随机语言（属于预期情况）
  • 空转录结果：未捕获到实际语音时属于正常现象
  • 通知图标不匹配：搭配Whisper配置的Parakeet二进制文件可能显示错误图标