如何测试一个会发声的项目peon-ping的BATSPester双测试体系与Mock音频后端技巧【免费下载链接】peon-pingWarcraft III Peon voice notifications ( more!) for Claude Code, Codex, IDEs, and any AI agent. Stop babysitting your terminal. Employ a Peon today.项目地址: https://gitcode.com/gh_mirrors/pe/peon-pingpeon-ping是一款为 Claude Code、Codex 等 AI 编程代理播放《魔兽争霸III》Peon 音效的声音通知工具。当 AI 完成任务、需要授权或卡住时它会发声提醒让你不必一直盯着终端。但正因为它要调用系统播放器发声音、发桌面通知、访问网络测试起来格外麻烦——今天带你拆解它BATS Pester 双测试体系和Mock 音频后端的完整技巧这也是测试任何会发声命令行项目都能直接套用的方法论。为什么会发声的项目难测试peon-ping 的测试代码全部集中在 tests/ 目录规模横跨三大平台测试栈目标平台主要文件BATSBash Automated Testing SystemmacOS / Linux / Git Bash约 30 个.bats文件如 tests/peon.batsPesterPowerShell 测试框架Windows如 tests/peon-engine.Tests.ps1Python跨平台辅助如 tests/test_antigravity_watcher.py难点在于被测代码会调用afplaymacOS 播放器、osascript、curl发推送、xdotool聚焦窗口等系统命令。真实跑一遍测试就会真的叮叮当当响成一片还会发出真实的手机推送。解法就一个字Mock。技巧一PATH 劫持 Mock 音频后端BATS 侧核心所有 BATS 测试共享一个环境工厂 tests/setup.bash它做三件事建隔离沙箱mktemp -d创建临时目录把CLAUDE_PEON_DIR指过去绝不触碰用户真实配置伪造资产写入迷你版config.json、manifest.json和一批空音频文件文件存在但 0 字节PATH 劫持创建一个mock_bin/目录并前置到PATH里面塞满了假命令。最关键的假命令就是 Mock 音频后端 tests/setup.bash#L144-L150# Mock afplay — 记录调用参数而不播放声音 echo $ ${CLAUDE_PEON_DIR}/afplay.log真正的afplay被这个同名替身拦截后测试代码就不再看是否发声而是改看日志断言。setup.bash 随后封装了一组断言助手把验证成本压到一行afplay_was_called—— 声音是否被播放afplay_sound—— 播放的是哪个音频文件对应哪个事件分类afplay_call_count—— 播放次数验证防抖、防连发tts_was_called/call_order—— TTS 调用与播放顺序。一个完整测试的形态 tests/install-windows.bats#L160-L166test Windows: SessionStart maps to session.start { run_peon_ps1 {hook_event_name:SessionStart,...} afplay_was_called [[ $(afplay_sound) */packs/peon/sounds/Hello* ]] }读起来几乎是自然语言会话开始事件 → 必须播放 Hello 开头的音频。技巧二Fixture 驱动的 Mock一套环境测所有场景Mock 如果只是永远成功的哑巴能测的很有限。peon-ping 的 Mock 用标记文件fixture切换行为例如 tests/setup.bash#L190-L250 的假system_profiler存在.mock_headphones_connected→ 返回耳机已连接的音频设备信息存在.mock_speakers_only→ 只返回扬声器假cmux可以第一次调用失败、第二次成功专门验证错误重试逻辑假curl能模拟注册表下载、中继服务器/play请求、ntfy 推送甚至返回 404 错误码。测试用例只需touch $TEST_DIR/.mock_xxx就切换了世界状态。这套 fixture 模式同样适用于网络请求类 Mock——把 tests/fixtures/hook-logging/ 下的 input/expected 文件对当作输入输出快照来比对是验证日志解析逻辑的低成本手段。技巧三Pester 测试 Windows 原生引擎Windows 侧的引擎是 PowerShell 脚本peon.ps1但它以 here-string 形式内嵌在 install.ps1 中。tests/windows-setup.ps1 这个共享 Pester harness 解决了测试的三个前置问题提取Extract-PeonHookScript用唯一标记注释锚定 here-string把peon.ps1从安装脚本中抽出并先用PSParser做零语法错误自检——harness 自身也被测试见 tests/peon-engine.Tests.ps1#L17-L38隔离New-PeonTestEnvironment在临时目录重建完整目录结构配置、状态、声音包并生成非空的 0 字节 WAV写入 RIFF 头因为 Windows 的SoundPlayer拒绝空文件Mock 播放替身 win-play.ps1 把每次播放写成路径|音量追加进.audio-log.txt断言时读日志即可。在 Windows 机器上一条命令即可运行Invoke-Pester -Path tests/技巧四没有 Windows 机器怎么测 Windows 逻辑这是 peon-ping 测试体系最聪明的部分CI 跑在 macOS 上却要为 PowerShell 逻辑提供覆盖。tests/install-windows.bats 的做法是——用 Python 复刻peon.ps1的控制流事件识别、状态管理、分类映射然后把映射结果交还给真正的peon.sh完成选音与播放。这样Windows 特有逻辑与音频选择逻辑各自被验证无需 Windows CI 节点。同理tests/amp.bats 用 Mock 的fswatch/inotifywait在任意平台上模拟文件监视器适配器的行为。技巧五连 TTS 语音都用 Mock 后端验证顺序TTS文字转语音模式下声音链路变成音效 → 语音或语音 → 音效。tests/setup.bash#L491-L532 提供了install_mock_tts_backend一个假的tts-native.sh把voice/rate/vol参数和 stdin 文本写进tts.log。于是 tests/tts.bats 能验证三件事参数顺序是否正确voice, rate, volume文本是否通过 stdin 传入播放顺序借助共用的call_order.log断言afplay与tts谁先出现精确覆盖sound-then-speak、speak-only、speak-then-sound三种模式。如何运行 peon-ping 的测试# macOS / LinuxBATS 全量 bats tests/ # WindowsPester 全量 Invoke-Pester -Path tests/提交 PR 前请先跑通测试具体约定见 CONTRIBUTING.md。总结可复用的 5 条 Mock 测试心法同名替换 PATH 前置把发声变成写日志副作用瞬间可观测空文件占位音频不需要真实内容touch即可Windows 除外记得写 RIFF 头Fixture 标记文件切换 Mock 行为一个环境覆盖成功、失败、重试等所有场景顺序断言用共享的call_order.log验证多后端调用的先后关系harness 自测提取、隔离、Mock 这些基础设施本身也要写测试否则测试会静默失效。掌握这套 BATS Pester 双体系与 Mock 音频后端技巧后无论你的项目是发声音、发通知还是调系统 API都能让测试又快又安静。【免费下载链接】peon-pingWarcraft III Peon voice notifications ( more!) for Claude Code, Codex, IDEs, and any AI agent. Stop babysitting your terminal. Employ a Peon today.项目地址: https://gitcode.com/gh_mirrors/pe/peon-ping创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 如何测试一个会发声的项目？peon-ping的BATS+Pester双测试体系与Mock音频后端技巧
如何测试一个会发声的项目peon-ping的BATSPester双测试体系与Mock音频后端技巧【免费下载链接】peon-pingWarcraft III Peon voice notifications ( more!) for Claude Code, Codex, IDEs, and any AI agent. Stop babysitting your terminal. Employ a Peon today.项目地址: https://gitcode.com/gh_mirrors/pe/peon-pingpeon-ping是一款为 Claude Code、Codex 等 AI 编程代理播放《魔兽争霸III》Peon 音效的声音通知工具。当 AI 完成任务、需要授权或卡住时它会发声提醒让你不必一直盯着终端。但正因为它要调用系统播放器发声音、发桌面通知、访问网络测试起来格外麻烦——今天带你拆解它BATS Pester 双测试体系和Mock 音频后端的完整技巧这也是测试任何会发声命令行项目都能直接套用的方法论。为什么会发声的项目难测试peon-ping 的测试代码全部集中在 tests/ 目录规模横跨三大平台测试栈目标平台主要文件BATSBash Automated Testing SystemmacOS / Linux / Git Bash约 30 个.bats文件如 tests/peon.batsPesterPowerShell 测试框架Windows如 tests/peon-engine.Tests.ps1Python跨平台辅助如 tests/test_antigravity_watcher.py难点在于被测代码会调用afplaymacOS 播放器、osascript、curl发推送、xdotool聚焦窗口等系统命令。真实跑一遍测试就会真的叮叮当当响成一片还会发出真实的手机推送。解法就一个字Mock。技巧一PATH 劫持 Mock 音频后端BATS 侧核心所有 BATS 测试共享一个环境工厂 tests/setup.bash它做三件事建隔离沙箱mktemp -d创建临时目录把CLAUDE_PEON_DIR指过去绝不触碰用户真实配置伪造资产写入迷你版config.json、manifest.json和一批空音频文件文件存在但 0 字节PATH 劫持创建一个mock_bin/目录并前置到PATH里面塞满了假命令。最关键的假命令就是 Mock 音频后端 tests/setup.bash#L144-L150# Mock afplay — 记录调用参数而不播放声音 echo $ ${CLAUDE_PEON_DIR}/afplay.log真正的afplay被这个同名替身拦截后测试代码就不再看是否发声而是改看日志断言。setup.bash 随后封装了一组断言助手把验证成本压到一行afplay_was_called—— 声音是否被播放afplay_sound—— 播放的是哪个音频文件对应哪个事件分类afplay_call_count—— 播放次数验证防抖、防连发tts_was_called/call_order—— TTS 调用与播放顺序。一个完整测试的形态 tests/install-windows.bats#L160-L166test Windows: SessionStart maps to session.start { run_peon_ps1 {hook_event_name:SessionStart,...} afplay_was_called [[ $(afplay_sound) */packs/peon/sounds/Hello* ]] }读起来几乎是自然语言会话开始事件 → 必须播放 Hello 开头的音频。技巧二Fixture 驱动的 Mock一套环境测所有场景Mock 如果只是永远成功的哑巴能测的很有限。peon-ping 的 Mock 用标记文件fixture切换行为例如 tests/setup.bash#L190-L250 的假system_profiler存在.mock_headphones_connected→ 返回耳机已连接的音频设备信息存在.mock_speakers_only→ 只返回扬声器假cmux可以第一次调用失败、第二次成功专门验证错误重试逻辑假curl能模拟注册表下载、中继服务器/play请求、ntfy 推送甚至返回 404 错误码。测试用例只需touch $TEST_DIR/.mock_xxx就切换了世界状态。这套 fixture 模式同样适用于网络请求类 Mock——把 tests/fixtures/hook-logging/ 下的 input/expected 文件对当作输入输出快照来比对是验证日志解析逻辑的低成本手段。技巧三Pester 测试 Windows 原生引擎Windows 侧的引擎是 PowerShell 脚本peon.ps1但它以 here-string 形式内嵌在 install.ps1 中。tests/windows-setup.ps1 这个共享 Pester harness 解决了测试的三个前置问题提取Extract-PeonHookScript用唯一标记注释锚定 here-string把peon.ps1从安装脚本中抽出并先用PSParser做零语法错误自检——harness 自身也被测试见 tests/peon-engine.Tests.ps1#L17-L38隔离New-PeonTestEnvironment在临时目录重建完整目录结构配置、状态、声音包并生成非空的 0 字节 WAV写入 RIFF 头因为 Windows 的SoundPlayer拒绝空文件Mock 播放替身 win-play.ps1 把每次播放写成路径|音量追加进.audio-log.txt断言时读日志即可。在 Windows 机器上一条命令即可运行Invoke-Pester -Path tests/技巧四没有 Windows 机器怎么测 Windows 逻辑这是 peon-ping 测试体系最聪明的部分CI 跑在 macOS 上却要为 PowerShell 逻辑提供覆盖。tests/install-windows.bats 的做法是——用 Python 复刻peon.ps1的控制流事件识别、状态管理、分类映射然后把映射结果交还给真正的peon.sh完成选音与播放。这样Windows 特有逻辑与音频选择逻辑各自被验证无需 Windows CI 节点。同理tests/amp.bats 用 Mock 的fswatch/inotifywait在任意平台上模拟文件监视器适配器的行为。技巧五连 TTS 语音都用 Mock 后端验证顺序TTS文字转语音模式下声音链路变成音效 → 语音或语音 → 音效。tests/setup.bash#L491-L532 提供了install_mock_tts_backend一个假的tts-native.sh把voice/rate/vol参数和 stdin 文本写进tts.log。于是 tests/tts.bats 能验证三件事参数顺序是否正确voice, rate, volume文本是否通过 stdin 传入播放顺序借助共用的call_order.log断言afplay与tts谁先出现精确覆盖sound-then-speak、speak-only、speak-then-sound三种模式。如何运行 peon-ping 的测试# macOS / LinuxBATS 全量 bats tests/ # WindowsPester 全量 Invoke-Pester -Path tests/提交 PR 前请先跑通测试具体约定见 CONTRIBUTING.md。总结可复用的 5 条 Mock 测试心法同名替换 PATH 前置把发声变成写日志副作用瞬间可观测空文件占位音频不需要真实内容touch即可Windows 除外记得写 RIFF 头Fixture 标记文件切换 Mock 行为一个环境覆盖成功、失败、重试等所有场景顺序断言用共享的call_order.log验证多后端调用的先后关系harness 自测提取、隔离、Mock 这些基础设施本身也要写测试否则测试会静默失效。掌握这套 BATS Pester 双体系与 Mock 音频后端技巧后无论你的项目是发声音、发通知还是调系统 API都能让测试又快又安静。【免费下载链接】peon-pingWarcraft III Peon voice notifications ( more!) for Claude Code, Codex, IDEs, and any AI agent. Stop babysitting your terminal. Employ a Peon today.项目地址: https://gitcode.com/gh_mirrors/pe/peon-ping创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考